Skip to content

OnDefineDescription - cWebParentCombo

Provides hook to change the value of a combo-item's description

Type: Event

Parameters

Parameter Type Description
ByRef sDescription String Passes the column value. This value is passed ByRef and may be changed within this event.

Syntax

Procedure OnDefineDescription ByRef String sDescription

Description

Normally, a cWebParentCombo control populates the combo data with the value of each parent record's column value as defined by its Entry_Item command. This can be customized by augmenting the OnDefineDescription event.

Sample

Normally, this object's combo data could contain a list of SalesP.ID values. OnDefineDescription is augmented to show the sales-person's ID and name.

Object oSalesPID is a cWebParentCombo
    Entry_Item SalesP.ID

    Set piColumnSpan to 3
    Set piColumnIndex to 5
    Set psLabel to "Salesperson:"
    Set peLabelAlign to alignRight

    Procedure OnDefineDescription String ByRef sDescription
       Move (SalesP.ID - ":" * SalesP.Name) to sDescription
    End_Procedure

End_Object