Modal_State - FloatingPanel

Defines whether an object should behave as a modal object or not

Type: Property

Access: Read/Write

Data Type: Boolean

Parameters: None

Syntax
 Property Boolean Modal_State

Read Access: Get Modal_State to BooleanVariable
Write Access: Set Modal_State to BooleanVariable/Value


Description

Modal_State should never be set in a Windows application. Modality is managed by the DataFlex Windows Framework (see Popup_Modal and Activate) and developers should never directly set this property.



This property is set True by the Popup_Modal procedure or when this object is the argument of a UI_Accept statement, and False when the object popped up by Popup_Modal is deactivated. When this property is set to True, the following properties are set:

Block_Mouse_State True
Attach_Parent_State False
Scope_State True
Ring_State True
Popup_State True

When this property is set to False, the following properties are set:

Block_Mouse_State False
Attach_Parent_State True

Normally you will not set this property to False, since this is the default. If you need to alter these individual property settings, you can either augment the 'Procedure Set Modal_State' or you can simply adjust any of the individual properties after you have set the Modal_State.

If you wish to toggle an object's modality during runtime, it is suggested that you not set this property. You will need the object in its default modeless state. The object can then be activated non-modally by sending it the activate message and activated modally by sending it the Popup_Modal message.

Default is False.