Skip to content

Load_Buffer_msg - dbList_

Handle of optional message sent to invoking object during list activation

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

Syntax

Property Integer Load_Buffer_msg
Access Type Syntax
Read Access: Get Load_Buffer_msg to IntegerVariable
Write Access: Set Load_Buffer_msg to IntegerVariable/Value

Description

The Load_Buffer_Msg property should be set to the ID of a custom procedure to handle custom loading of the list buffer when the list is invoked. The message is sent by the list to the invoking object.

If this property is zero, Request_Entry_Update is sent to the server of the invoking object. Thus, when creating a custom message to handle the loading of the list buffer, you may want to also send Request_Entry_Update in your augmented message.

The above happens provided that: - The Main_File of the dbList is set to the same table as the Data_File of the invoking object. - Move_Value_Out_State and Seed_List_State are both True.

If the invoking object does not have a server, the Entry_Update is sent to the invoking object.

Sample

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 LoadingTheList
        Send Info_Box "List is being loaded"
    End_Procedure

    Procedure Prompt_Callback integer hPrompt
        Set Load_Buffer_Msg Of hPrompt To Msg_LoadingTheList
    End_Procedure

In a deployed program, you probably do not want to display a message box to the user. If you use this method, think about the fact that the selection list will not show the current record shown in the invoking object anymore. If you want that behavior also, you could do the following:

Procedure LoadingTheList
    Handle hoServer
    Integer iFile

    Get Server To hoServer
    If (hoServer > 0) Begin
        Get Data_File To iFile
        Send Request_Entry_Update Of hoServer iFile 1
    End
End_Procedure