14.6. Configuration of controls common properties
You can build a panel using controls which there are on the left side
of the main view of the application. You should press only a selected control
and click with the left mouse button above the area of the panel. When you
draw a rectangle area instead of clicking the mouse, a control fills this
rectangle area itself. You can use the controls as follows:
The first button isn't a button of a control but it allows you to unselect a
pressing button of a given object.
If you press the button
,
and choose any control or double click above the area of a control with the
left mouse button, you can configure a choosing object. For all controls
a window with 3, 4 or 5 tabs is appears. Main, Style
and Specific tabs
appear for each controls. Actions tab almost always shows while Frame
tab shows only in same cases. A list of displaying tabs for particular
controls is shown below in the table
in the next part of the document.
Main, Style, Actions and Frame
tabs look similarly for all controls (an exception is Main tab and remotely Actions
tab) while Specific tab is different for each of controls.
In Main tab is placed Object name field, that lets you specify an object name.
An object with the name will be available for other controls and the panel. You can
set also a kind of a font (Fonts button) different from default one. If an object
is connected with SNMP i.e. if it is used as an argument of Read action or Write
action, you can pass its ID string. If an object is used to set a value of SNMP
(Write action), you must set a type of this variable by choosing an option of Object
type field. You should set Accept incoming Pdu to update an appearance of the object
basis of working results of Read actions. Sometimes you can want to paste
an additional OID to ID string. Then you must set Accept ID string sticking
in object properties. You should pass also a session name in
Belongs to session to use an object in any action Read or Write type.
In Text/value on timeout field you can pass a value that a control will
receive when it doesn't receive a response from a polling device in expected time.
This value will be interpreted as a text when a control (i.e. Label) expects these
values otherwise the value will be interpreted as a numerical value.
In Text/value after timeout field you can pass a
value that a control will be received after timeout when it doesn't
receive a response from a polling device.
Style tab includes a field of choice that gets you four possibilities
of receiving of Focus for a given controls: a lack of focus, focus by pressing Tab key,
focus by pressing the mouse button and two last options together. In Caption dialog you
can pass an inscription which is displayed on a given control (it concerns a part of
objects). In ToolTip dialog you can pass a text which is displayed in an response
dialog above the object when you drag the mouse cursor on it (empty inscription
means a lack of a response). Turning on Enabled option allows you to set a given
control in an accessible state by the mouse or the keyboard.
Three buttons are placed on the tab and they helps you to set free color for any controls.
Each of the buttons let you specify color which is characteristic for a state in which any
controls can be (active, passive and normal).
In Actions tab for each event you can specify a list of actions
that will be done. Events for controls mostly can be in two kinds: pressing the
left mouse button while the Enter key stays pressed and double clicking the left
mouse button. The second event in the case of the mouse always must be preceded
the first one. It can cause a situation that actions joined to a double clicking
cannot occur or they quickly occur after actions for a single clicking. For this
reason you shouldn't define actions for this both events in the case of the same
object.
A user has five different kinds of actions at his disposal. Only some type
of objects have all kinds of actions. Close action allows you to finish a work
of the panel. If the panel is like a dialog, it only closes itself. If it is
like a main panel, a work of the whole application is finished. Read action
lets you read data of specified objects to update their current view on the
panel. Write action passes this data to a managed device.
Program specification Program specification window
defines Exec action and it allows you to specify the program and its
parameters that will be run during a given event is done. When you
specify a program and its parameters, you can pass names preceded $
sign. A name can be: an environmental variable that will be defined
during the panel is working, a control name which a value we want
to use, a keyword as HostName, ReadCommunity, WriteCommunity,
FileName, StickingIDString including appopriate input parameters of
xdnnv.
Network Node View parameters window
defines Dialog action and it allows you to pass names of a configuration
file for xdnnv describing the main panel.
You can choose Stick this ID string
option and pass OID that will be pasted to controls of a given panel. As in
case of Exec action, you can use $ sign and pass after it names of controls
or keywords (you can't use environmental variables). Dialog action runs a
service of a specified panel in a modal dialog in contrast to Exec action
which runs some program.
The buttons of Actions tab allows you to manipulate a list of actions for a given event.
The button
lets you define a new action among described above.
You can specify Read and Write actions in the same way like the
panel configuration.
Frame tab lets you configure a frame style of an object
and its line width that a frame will be built. In Style
group you have some possibilities at your disposal: No Frame, Box,
Panel, WinPanel, HLine,
VLine, Styled Panel,
PopupPanel and frame styles as: Plain,
Raised and Sunken. In Line
group you can define an outside line width of a frame and in Midline
group - a middle line width. An effect of current settings is shown on the preview.
14.6.5. Tabs for particular controls