CONTAINER Gadget
- Last UpdatedNov 07, 2024
- 2 minute read
Members
|
Member Name |
Type |
Purpose |
|---|---|---|
|
type |
STRING Get/Set |
Gadget type as string 'Container'. |
|
control |
REAL Get/Set |
Integer handle of external control. |
|
popup |
MENU Get/Set |
Pop-up menu associated with the control. |
Methods
|
Method Name |
Result |
Purpose |
|---|---|---|
|
ShowPopup (!x is REAL, !y is REAL ) |
NO RESULT |
Show the associated popup at the specified position. Position is the integer pixel position within the enclosed control. |
|
FullName( ) |
STRING |
Get the full gadget name, i.e. "!!Form.gadget". |
|
Name( ) |
STRING |
Get the name of the gadget. |
|
Owner( ) |
FORM |
Get owning form. |
|
GetPickedPopup( ) |
MENU |
Returns the last picked popup menu for the gadget. |
|
Shown( ) |
BOOLEAN |
Get 'Shown' status. |
Command
The Container gadget allows the hosting of an external Control, for example, a PMLNet, control inside a PML-defined form. It allows you to add an external .Net control, which may raise events that can be handled by PML. In order to customize the context menus of the .NET control, the Container may have a PML pop-up menu assigned to it. This is shown when the .NET control raises a pop-up event.
.--<-----.
/ |
>---- CONTAINER gname -+- NOBOX ---|
+- INDENT --*
|
'- PMLNET/CONTROL -+- handle -.
'----------|
.----<------------------------*
|
| .----<-----------------.
|/ |
+-- tagtext -------------|
+-- <fgpos> -------------|
+-- <fganch> ------------|
+-- <fgdock> ------------*
|
+-- <vshape> -.
'-------------'-->
Notes:
-
By default, the Container will be enclosed in a box, but you can select NOBOX or INDENT.
-
Only PMLNet controls are supported.
-
'handle' is the integer token identifying the control.
-
Positioning must be specified before size (<vshape>).
-
Dock and Anchor are supported to allow intelligent resize behavior. The enclosed control must support resizing and is usually set as Dock fill, so that it follows size changes of the Container.