Display_Buffer_msg - dbList_

Handle of an optional message that can be sent to the invoking object when a selection is complete

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

Syntax

Property Integer Display_Buffer_msg

Access Type	Syntax
Read Access:	Get Display_Buffer_msg to IntegerVariable
Write Access:	Set Display_Buffer_msg to IntegerVariable/Value

Description

By default, selection lists return a value(s) from the selected record to the invoking item. Where you desire special handling at such a point, you can define a message in the invoking object and place the ID of that message in the value of the Display_Buffer_Msg property. Then, in addition to returning the selected value, the selection list will send the message to the invoking object.

Sample

In the event Prompt_Callback (send by the selectionlist attached to the customer.customer_number column) we assign the method id of UserSelectedARecord (defined in this object) to the property. When the user selected a record and the information is copied to the view our method will be called. In a real time situation you probably want to do something else than displaying a messagebox. You probably want to store information such as copying information from one record buffer to another. When the selectionlist dialog is closed the property will be reset to its initial value that it had when the selectionlist was invoked (see restore_defaults)

Object oOrderHea_Customer_Number is a dbForm
    Entry_Item Customer.Customer_Number
    Set Label to "Customer Number:"
    Set Size to 13 42
    Set Location to 4 201
    Set peAnchors to anTopRight
    Set Label_Col_Offset to 2
    Set Label_Justification_Mode to jMode_Right

    Procedure UserSelectedARecord Handle hoList
        Send Info_Box "The user selected a record"
    End_Procedure

    Procedure Prompt_Callback Integer hPrompt
        Set Display_Buffer_Msg Of hPrompt To Msg_UserSelectedARecord
    End_Procedure

Note

The message referened in the Display_Buffer_Msg is sent as part of the Move_Value_Out message. If that event does not take place (Move_Value_Out_State = False or Select_Mode = Multi_Select), the property value is not used and the message is not sent.