VALUE property (PropertyGrid)

Gets or Sets the value of the currently selected property item, or an individual property item when specifying an index value.

The VALUE property depends on the type of the selected property item. If the property item has a type of PGIT_COLOR$ then the VALUE property will be an RGB color value, if the property item has a type of PGIT_EDIT$ then the VALUE property will be a string, and so on.

At runtime an individual property may be referenced via a row index value using the normal Get/Set_Property index parameter. The index value may the Name of the property item (case-insensitive) or the Position of the property item in the fully expanded property list.

 
$Insert PS_Property_Grid_Equates

   $Insert Logical

   

   CtrlEntID = @Window : ".PRG_MAIN"

   

   // Set the full list of items...

   //

   // Data

   //    Title    - Yadda

   //    SubTitle - Whatever

   // UI

   //    Visible - TRUE$

   //    Color   - 0xFF (red)

   

   Pgl     = "Data" : @Vm : "Title"    : @Vm : PS_PGI_EDIT$     : @Vm : "Yadda"

   Pgl<-1> = "Data" : @Vm : "SubTitle" : @Vm : PS_PGI_EDIT$     : @Vm : "Whatever"

   Pgl<-1> = "UI"   : @Vm : "Visible"  : @Vm : PS_PGI_CHECK$    : @Vm : TRUE$

   Pgl<-1> = "UI"   : @Vm : "Color"    : @Vm : PS_PGI_COLORDLG$ : @Vm : 0xFF

   

   Call Set_Property_Only( CtrlEntID, "LISTX", Pgl )

   

   // Select the second item in the list (this will select "SubTitle")

   Call Set_Property_Only( CtrlEntID, "SELPOS", 2 )

   

   // Get the VALUE property - this will return "Whatever"

   Val = Get_Property( CtrlEntID, "VALUE" )

   

   // Collapse the "Data" category

   Call Exec_Method( CtrlEntID, "COLLAPSE", "Data" )

   

   // Select the first item in the list (this will select "Visible")

   Call Set_Property_Only( CtrlEntID, "SELPOS", 1 )

   // Get the VALUE property - this will return TRUE$

   Val = Get_Property( CtrlEntID, "VALUE" )
 
 
 

VALUES property