Skip to content

Class: cWebSelectionForm

Properties | Events | Methods | Index of Classes

Selection form that lets users choose a single value from suggestions

Hierarchy

cObject > cWebBaseObject > cWebObject > cWebBaseUIObject > cWebBaseDEOServer > cWebBaseControl > cWebBaseDEO > cWebBaseForm > cWebForm > cWebBaseSelectionForm > cWebSelectionForm

Show full hierarchy and direct subclasses

Library: Web Application Class Library

Package: cWebSelectionForm.pkg

Description

cWebSelectionForm is a selection control that shows suggestions while the user types and updates the control when a suggestion is selected. It is useful for single-value selection fields such as customers, contacts, products or other lookup-style values.

Use a cSelectionSource object or augment OnFindSuggestions to provide the suggestion rows.

Object oCustomerSelection is a cWebSelectionForm
    Set psLabel to "Customer"
    Set pbShowSuggestionsOnFocus to True

    Object oSelectionSource is a cSelectionSource
    End_Object
End_Object

When the user selects a suggestion, OnSelectSuggestion is called. Augment this event when the application needs to react to the selected item.

Procedure OnSelectSuggestion tSuggestion Suggestion
    Forward Send OnSelectSuggestion Suggestion

    // React to the selected row id or displayed value.
End_Procedure

Because cWebSelectionForm is based on cWebBaseSelectionForm, it also supports suggestion action rows, create-new behavior and advanced search prompts.

See Also

cWebBaseSelectionForm | cSelectionSource