The SalListBox type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
 | SalListBox |
Constructs a SalListBox object.
|
Methods
| Name | Description | |
|---|---|---|
| AddListItem |
Adds a string to a list box or combo box.
|
| BringWindowToTop |
Brings a window to the top of all overlapping windows.
|
| CenterWindow |
Centers a window. If the window is a top-level window, it centers it on the
desktop. If the window is a child window, it centers it on top of its parent.
|
| Clear |
Clears the value from a data field, multiline field, or table window column.
|
| ClearCursor |
Clears a window's cursor.
|
| ClearList |
Deletes all entries from a list box or combo box.
|
| DeleteListItem |
Deletes a list box or combo box entry.
|
| DestroyWindow |
Destroys a form window, a top-level table window, or a modeless dialog box created
with SalCreateWindow.
|
| DisableWindow |
Disables keyboard and mouse input to a window. If the window contains text (for example,
a push button), the text is grayed. If the window is a data field, it cannot
receive the focus.
|
| DisableWindowAndLabel |
Disables keyboard and mouse input to a window and grays out its associated label.
A label is the label control that immediately precedes the window in the outline.
The label control must have a mnemonic. If the window contains text (for
example, a push button), the text is grayed. If the window is a data field, it cannot
receive the focus.
|
| EnableWindow |
Enables keyboard and mouse input to a window.
|
| EnableWindowAndLabel |
Enables keyboard and mouse input to a window and enables its associated label as
well. A label is the label control that immediately precedes the window in the
outline.
|
| FindChild |
This function finds a child window of a given name in the specified window.
|
| FormUnitsToPixels |
Computes the number of pixels in the number of form units. Form units
are a unit of measurement used by functions which move and position
objects. Form units are computed using physical units (pixels) in conjunction
with the window's font size.
|
| GetClassName |
Return the name of a window's class as a string.
|
| GetControlType |
Returns an object's type.
|
| GetDataType |
Returns a data field's or table window column's data type.
|
| GetFirstChild |
Returns the handle of the first child window of the specified type. You can use this
function to get the handles of MDI child windows.
|
| GetFont |
Gets a window's font name, size, and enhancements.
|
| GetLabel |
Retrieves the window handle of the label (label control) that is associated with the hWndTarget parameter.
There must be a mnemonic in that label, and it must immediately precede hWndTarget in the outline, or this function will fail.
|
| GetLabelText(SalNumber) |
Retrieves the text of the label associated to a control. Important: The label control does not
require a mnemonic for the functions listed above to operate.
|
| GetLabelText(SalString%, SalNumber) |
Retrieves the text of the label associated to a control. Important: The label control does not
require a mnemonic for the functions listed above to operate.
|
| GetListItemsCount |
Returns the number of list box or combo box entries.
|
| GetListItemState |
Determines whether the specified list box or combo box entry is selected.
|
| GetListItemText(SalNumber) |
Returns the text of the specified item.
|
| GetListItemText(SalNumber, SalString%) |
Returns the text of the specified item.
|
| GetListItemTextLength |
Returns the length of a list box or combo box entry.
|
| GetListSelectedFile()()()() |
Fetches the selected directory or file name from a list box or combo box.
|
| GetListSelectedFile(SalString%) |
Fetches the selected directory or file name from a list box or combo box.
|
| GetListSelectedIndex |
Returns the index of the selected entry in a combo box or single-selection list box.
|
| GetListSelectedItems |
Returns an array of index numbers of selected list box entries.
|
| GetListSelectedItemsCount |
Returns the number of selected entries in a multiple-selection list box. Specify
single- or multiple-selection in the list box's customizer.
|
| GetLocation |
Returns a window's current position on the X and Y axes.
|
| GetName()()()() |
Gets the name of an object.
|
| GetName(SalString%) |
Gets the name of an object.
|
| GetNextChild |
Returns the handle of the next child window that matches a specified type.
|
| GetParent |
Returns the handle of an object's parent window.
|
| GetProperty(SalString) |
Gets the value of a named property.
|
| GetProperty(SalString, SalString%) |
Gets the value of a named property.
|
| GetSize |
Returns a window's size.
|
| GetText(SalNumber) |
Retrieves the text of a window.
|
| GetText(SalString%, SalNumber) |
Retrieves the text of a window.
|
| GetWindowColor |
Gets a window's color.
|
| GetWindowState |
Returns a window's current state.
|
| HideWindow |
Hides a window.
|
| HideWindowAndLabel |
Hides a window and its associated label.
|
| InsertListItem |
Inserts an entry into a list box or combo box at a specified position.
|
| InvalidateWindow |
Causes a window to be repainted.
|
| IsDerivedFromClass |
Determines whether a window is an instance of the specified class.
|
| IsEnabled |
Determines whether a window is enabled for mouse and keyboard input.
|
| IsModified |
Returns the setting of the Field Edit Flag for a data field, multiline field, combo
box, table window's context row cell, or picture.
|
| IsVisible |
Determines whether a window is currently visible.
|
| KillTimer |
Destroys an object's system timer.
|
| MoveWindow |
Moves a window a given number of form units on the X and Y axes relative to its current
position.
|
 | OnDoubleClick | (Overrides Control..::..OnDoubleClick(EventArgs).) |
| OnKeyPress | (Overrides Control..::..OnKeyPress(KeyPressEventArgs).) |
| OnMouseDown | (Overrides Control..::..OnMouseDown(MouseEventArgs).) |
| OnReadOnlyChanged |
Called when the ReadOnly property has changed.
|
| PixelsToFormUnits |
Computes the number of form units based on the number of pixels.
Form units are a unit of measurement used by functions that move and position objects.
Form units are computed using physical units (pixels) in conjunction
with a window's font sizes.
|
| PopulateList(SalSqlHandle, SalString) |
Populates a list box or combo box with a result set. SalListPopulate overrides any
settings made with SalListSetTabs. If the SELECT statement returns data from multiple
columns, each column's data displayed in a list box is separated by tabs.
However, due to a Microsoft Windows limitation, each column's data displayed in
a combo box is separated by a single '|' character. There is no space between
one column's data, the separator character, and another column's data.
|
| PopulateList(SalSqlHandle, SalString, WhenSqlErrorHandler) |
Populates a list box or combo box with a result set. SalListPopulate overrides any
settings made with SalListSetTabs. If the SELECT statement returns data from multiple
columns, each column's data displayed in a list box is separated by tabs.
However, due to a Microsoft Windows limitation, each column's data displayed in
a combo box is separated by a single '|' character. There is no space between
one column's data, the separator character, and another column's data.
|
| PopulateListFiles |
Populates a list box or combo box with a directory of files.
|
| PostMessage |
Posts the specified message to a window by adding nMsg to hWndReceiver's message
queue.
|
| SendMessage |
Sends the specified message to a window. SalSendMsg does not return until the processing
for the message is complete.
|
| SendMessageToChildren |
Sends a message to all child items of a form window, dialog box, table window, or
MDI window.
|
| SetContextMenu(Type, SalNumber) |
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
|
| SetContextMenu(SalString, SalNumber) |
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
|
| SetCursor(Int32, SalNumber) |
Sets a window's cursor.
|
| SetCursor(SalResourceCursor, SalNumber) |
Sets a window's cursor.
|
| SetCursor(SalString, SalNumber) |
Sets a window's cursor from a string variable.
|
| SetCursorFile |
Sets an application-defined cursor for the specified window. Use this function to
set the cursor from an image stored in a file.
|
| SetFocus |
Sets the focus to a specified window.
|
| SetFont |
Sets a window's font, font size, and font enhancements.
|
| SetLabelText |
Sets the text of the associaetd label control.
|
| SetListRedraw |
Redraws entries in a list box or combo box, or prevents them from being redrawn.
|
| SetListSelectedIndex |
Selects or deselects a combo box or single-selection list box entry.
|
| SetListSelectedItems |
Selects or deselects a combo box or multiple-selection list box entry.
|
| SetListSelectedText |
Finds and selects a combo box or single-selection list box entry.
|
| SetListTabStops |
Sets tabs in a list box.
|
| SetLocation |
Moves a window to a new position (x, y) on the X and Y axes.
|
| SetModified |
Sets or clears the field edit flag for an editable data field, combo box, multiline
text field, table window column, or picture.
|
| SetProperty |
Sets the value of a named property.
|
| SetSize |
Resizes a window.
|
| SetText |
Sets the text of a window.
|
| SetTimer |
Creates a system timer for a given object. When a timer event occurs, sends
SAM_Timer messages to the object in specified intervals. Timers are a limited
global resource. Your application must check the value returned by SalTimerSet
to verify that the timer was created.
|
| SetWindowColor |
Sets a window's color.
|
| SetVisibleCore | (Overrides Control..::..SetVisibleCore(Boolean).) |
| ShowWindow |
Makes a window visible.
|
| ShowWindowAndLabel |
Makes a window and its associated label visible. A label is the label control that
immediately precedes the window in the outline.
|
| TrackPopupMenu(Type, SalNumber, SalNumber, SalNumber) |
Creates pop-up menus at runtime.
|
| TrackPopupMenu(SalString, SalNumber, SalNumber, SalNumber) |
Creates pop-up menus at runtime.
|
| UpdateWindow |
Forces the update of a window.
|
| WinHelp |
Starts the Windows help system.
|
| WndProc |
Redirect Windows message to the implementation object.
(Overrides ListBox..::..WndProc(Message%).) |
| Yield |
Processes messages for this control.
|
Fields
| Name | Description | |
|---|---|---|
 | _derived |
Instance of the derived object that inherits this class
as a second base in a multiple inheritance tree.
|
Properties
| Name | Description | |
|---|---|---|
 | DesigntimeVisible |
Returns true if the object was designed as visible.
|
| Label |
Returns/Sets the label associated with this control.
|
| NamedProperties |
Returns the collection of named properties.
|
| ReadOnly |
Returns/Sets the ReadOnly flag for the ListBox control.
When the ListBox is ReadOnly, it can still get the focus and be scrolled.
|
| SelectedIndex | (Overrides ListBox..::..SelectedIndex.) |
Events
| Name | Description | |
|---|---|---|
 | MessageActions | |
| ReadOnlyChanged |
Fired when the ReadOnly property is altered.
|
