Skip to content

Form_Button_Value - DfBaseForm

Determines the contents of a form prompt-button

Type: Property
Access: Read/Write
Data Type: String
Parameters: None

Parameters

Parameter Type Description
iItem Integer

Syntax

Property String Form_Button_Value
Access Type Syntax
Read Access: Get Form_Button_Value to StringVariable
Write Access: Set Form_Button_Value to StringVariable/Value

Description

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 ''".