Mouse Down Button widget

The Mouse Down Button widget is supported in NiagaraAX-3.4 and later, only. When configured as part of a Px page, this widget allows for buttons to adjust the camera iris and the focus so that they are functionally equivalent to the Iris and Focus buttons that are provided in the Live Video view (see Live Video view ).

Camera controls do not operate unless they are Enabled. Each of these controls must be enabled by selecting the option box for each control under the PTZ Support property on the camera property sheet. The default setting for these controls is Disabled (or, not selected).

The Mouse Down Button widget is available in the videoDriver palette, as shown in Figure 42. You can drag it directly from the palette onto a Px page where you can adjust the widget size and shape to fit the desired area on the page. You can also adjust the Camera widget colors by editing the properties, as described in Common videoDriver widget properties.

After dragging the Camera widget to the Px page, you can set the Hold Down Px binding (Video Ptz Binding) to the desired video camera. to enable live video display.

Figure 42. Mouse Down Button widget

For a description of the Mouse Down Button widget properties, see Types of Mouse Down Button properties.

Types of Mouse Down Button properties

In addition to the common properties, described in Types of videoDriver Px widgets, the following list provides a description of the Video Player widget properties:

Text

This property contains the text that displays on the button.
Image

This property allows you to choose an image to display on the button widget.
Font

This property allows you to select the font to use for the display text.
Foreground

This option allows you to specify the color of the display text.
Background

This property provides a way to specify the color of the button, using a solid color, a gradient, an image, or the default background color.
Halign and Valign

These two properties specify the alignment characteristics of the display text.
Text to Icon Align, Text to Icon Gap

These two properties specify how any image (specified using the image property) displays in relation to the text (text property).
Blink

When set to true, this property causes the Mouse Down Button to blink.
Focus Traversable

The default value (true) allows the selected widget to be included in the set of Mouse Down Buttons that can sequentially receive focus when the Tab key is pressed in a Px view containing the button. It the false value is selected, focus on that particular button cannot be set using the Tab key.

Figure 43. Button focus indicator is available when Focus Traversable property is set to true
Button Style

Two options are offered with this property. Choose the default Normal option to display a common interface button and choose Toolbar to use a button that is more appropriate for displaying along a toolbar menu.
Keep Down Interval

This property causes the corresponding slot to be engaged on this periodic basis provided that the mouse is clicked (held down) on the button. For example, if this property is set to 1 second, then when a “Dim” action is invoked by clicking, dimming occurs for 1 second, as long as the button is held down for at least one second. If it is held down for more than 1 second, the dim action is still limited to 1 second.
binding

The binding property contains the following parameters:
- Ord
  
  This field allows you to specify the Ord of the camera that you want to bind to the widget.
- Degrade Behavior
  
  This property allows you to choose between three options to use for cases where the connection to the bound Ord is lost (due to an invalid Ord or an inadequate permission level).
  - None: When this option is selected, no change in widget appearance occurs when the binding is lost (the widget just does not work).
  - Disable: When this option is selected, the widget is visible but is disabled when the binding is lost.
  - Hide: When this option is selected, the widget is hidden when the binding is lost.
- On Mouse Down (available in NiagaraAX-3.4 and later)
  
  This property specifies the action to be taken when the mouse button is held down. If an appropriate Ord property value is set, you can choose Slot and Value settings from the On Mouse Down dialog box that appears when you click in the property field (from the Px Editor view).
- On Mouse Release (available in NiagaraAX-3.4 and later)
  
  This property specifies the action to be taken when the mouse button is released. If an appropriate Ord property value is set, you can choose Slot and Value settings from the On Mouse Release dialog box that appears when you click in the property field (from the Px Editor view).