Form_Button_Value - DfBaseForm

Parameter	Description
iItem (Optional)	The item number (0 if omitted).

 Property String Form_Button_Value

Read Access:	Get Form_Button_Value [iItem] to StringVariable
Write Access:	Set Form_Button_Value [iItem] to StringVariable/Value

This is a low level interface. If you need a prompt button or a spin button, sub-classes have been provided to support this at a higher level (SpinForm, dbSpinForm, dbForm). You should use Prompt_Button_Mode and/or Prompt_Button_Value for this in most cases.

Form_Button_Value determines the contents of a form prompt button. The value will only appear when the value of form_button is form_button_prompt.

Set Form_Button 0 to Form_Button_Prompt
Set Form_Button_Value 0 to "."

Form Buttons in Grid

Form_Button_Value can also be used to determine what text will appear in the embedded prompt button in a grid. This is set on a column-by-column basis and, by default, is blank.

Procedure FillList
    integer i iCell

    // add 10 rows of data
    For i From 0 to 9
        Get Item_Count to iCell
 
         // set first column to use a prompt button
         Send Add_Item 0 ("Name"+string(i))
         Set Form_Button iCell to FORM_BUTTON_PROMPT
 
         // set second column to use a spin form
         Send Add_Item 0 i
         Set Form_Button (iCell+1) to FORM_BUTTON_SPIN_WRAP
         Set Form_Button_Value (iCell+1) to "..."
    Loop
End_Procedure

Default is ''".