Dialog box¶
How It Appears
![../../../_images/ref_Dialog_ex.gif](../../../_images/ref_Dialog_ex.gif)
Applications
Typically used to create dialog messages, for example confirmation messages following an action in the Q Application or messages related to particular machine conditions.
Configuring the object
To show/hide this object at runtime, other objects should call specific methods.
Configure window display using button
Create a Button object.
Associate the MouseClick Event event of the button with the Open dialog window method (Commands > UI Commands > Open dialog window)
Configure window closing using button
Create a Button object inside the window.
Associate the MouseClick Event event of the button with its Close method.
Properties¶
Name |
BrowseName |
DataType |
Description |
---|---|---|---|
Modal dialog window | Modal |
Enable/disable the behavior as modal window. |
|
Horizontal alignment | HorizontalAlignment |
Alignment of the object on the horizontal axis. Left = the left side is positioned on the left side of the container, except for the left margin; Right = the right side is positioned on the right side of the container, except for the right margin; Center = the center of the object is positioned in the center of the container, except for the left and/or right margins; Stretch = object width equals container width, except for the left and/or right margins. |
|
Vertical alignment | VerticalAlignment |
Alignment of the object on the vertical axis. Top = the top side is positioned on the top side of the container, except for the top margin; Bottom = the bottom side is positioned on the bottom side of the container, except for the bottom margin; Center = the center of the object is positioned in the center of the container, except for the top and/or bottom margins; Stretch = object height equals container height, except for the top and/or bottom margins. |
|
Visible | Visible |
Show/hide the window.
(Inherited from Element)
|
|
Enabled | Enabled |
Enables/disables the interaction with the user (True = enabled; False = disabled).
(Inherited from Element)
|
|
Opacity | Opacity |
Opacity level (0 = transparent)
(Inherited from Element)
|
|
Left margin | LeftMargin |
(Only if Horizontal Alignment = Left or Center or Stretch) Distance between the left edge of the object and the left edge of its container.
(Inherited from Element)
|
|
Top margin | TopMargin |
(Only if Vertical Alignment = Top or Center or Stretch) Distance between the top edge of the object and the top edge of its container.
(Inherited from Element)
|
|
Right margin | RightMargin |
(Only if Horizontal Alignment = Right or Center or Stretch) Distance between the right edge of the object and the right edge of its container.
(Inherited from Element)
|
|
Bottom margin | BottomMargin |
(Only if Vertical Alignment = Bottom or Center or Stretch) Distance between the bottom edge of the object and the bottom edge of its container.
(Inherited from Element)
|
|
Width | Width |
Width of the window. It can assume values greater than or equal to zero. The Auto value sets the width equal to the width of the content (in this case, in the absence of content the object collapses).
(Inherited from Element)
|
|
Height | Height |
Height of the window. It can assume values greater than or equal to zero. The Auto value sets the height equal to the height of the content (in this case, in the absence of content the object collapses).
(Inherited from Element)
|
|
Rotation | Rotation |
Rotation of the object around its center point. Positive values indicate clockwise arc degrees.
(Inherited from Element)
|