guides:programming:programmers_reference_manual:propertybypos_method_propertygrid

PROPERTYBYPOS method (PropertyGrid)

Returns the property item for the specified position in the "visible" list.

item = Exec_Method( ctrlEntID,       
                    "PROPERTYBYPOS", 
                    itemPos )
 
NameRequiredDescription
itemPosYesPosition of the property item in the "visible" list. If 0 is passed all visible property items are returned.

The @vm structure for the specified property item, or an @fm-delimited list of property item structures if "0" is passed in the itemPos parameter.

This method is the equivalent of using the LIST property.

 
$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 )

   

   // Hide all "Data" items...

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

   

   // Get the details of the "Color" item, now at position 2)

   Item = Exec_Method( CtrlEntID, "PROPERTYBYPOS", 2 )
 
 
 
  • guides/programming/programmers_reference_manual/propertybypos_method_propertygrid.txt
  • Last modified: 2023/10/25 10:50
  • by 127.0.0.1