====== BEGINEDIT method (PropertyGrid) ======


 
==== Description ====
 
 
Activates the item editor for an item in the property grid, optionally loading it with data and setting focus.
 
 
 
 
==== Syntax ====
 
<code>
EditorActive = Exec_Method( CtrlEntID,   
                            "BEGINEDIT", 
                            Name,        
                            Value,       
                            SelectAll,   
                            SetFocus )
</code>
 
 
==== Parameters ====
 
 
 
 
 
 
 
^Name^Required^Description^
|Name|No|Name of the property item to edit.  If null then the current item is used.|
|Value|No|Initial Value to put into the editor.  If null then the existing item value is used.|
|SelectAll|No|If TRUE$ then all text in the item editor is selected.|
|SetFocus|No|If TRUE$ then the focus is set to the item editor.|

 


 
==== Returns ====
 
 
TRUE$ if the item editor was activated.
 
 
 
 
==== Remarks ====
 
 
Not all item types can be edited – see the notes on property item types above for more details on which types support editing.
 
 
 
 
==== Example ====
 
<code>
 
$Insert PS_Property_Grid_Equates

   $Insert Logical

   

   CtrlEntID = @Window : ".PRG_MAIN"

   

   // Set the full list of items...   

   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_PGIT_BUTTON$$ : @Vm : ""

   

   Call Set_Property_Only( CtrlEntID, "LISTX", Pgl )

   // Open up the "SubTitle" item for editing, use the original text, select it and

   // and move the focus there

   EditorActive = Exec_Method( CtrlEntID, "BEGINEDIT", "SubTitle", "", TRUE$, TRUE$ )
 
 
 

</code>

 
==== See Also ====
 
 
EDITORHANDLE property, ENDEDIT method.