ShowSuggestion - cDbCJGridColumnSuggestion
Called to add a line to the suggestion list control (advanced use)
Type: Procedure
Parameters
| Parameter | Type | Description |
|---|---|---|
| SuggestionData | tSuggestion | The value to be added to the list (most likely in SuggestionData.aValues[0]) |
| sSearch | String | The current value of the form |
Syntax
Procedure ShowSuggestion tSuggestion SuggestionData String sSearch
Call Example
Send ShowSuggestion SuggestionData sSearch
Description
As the suggestion list control is being displayed, ShowSuggestion is called for each line to add to the list.
This procedure must take the tSuggestion SuggestData information, format it and add it to the Windows control that shows the list. This is a complicated mechanism, because the class used to build the suggestion list control is private and the interface for formatting the data and adding it to the control is private. Therefore, ShowSuggestion should almost be treated as a private method itself. It is exposed to allow the developer some control over the formatting of the list.
Augmenting this should be considered advanced usage. If you attempt this, you will want to study the code in WinSuggestion.pkg, paying particular attention to the current ShowSuggestion code. You will then probably need to make a copy of that code within your augmentation and then carefully make changes.