SalListBox
PPJ.Runtime.Windows.SalListBox
Last updated
PPJ.Runtime.Windows.SalListBox
Last updated
Namespace: PPJ.Runtime.Windows
Assembly: PPJ.Web.49 (4.9.0.0)
Represents a control that shows a lost of values that the user can select.
Constructs a SalListBox object.
SalNamedProperties: Returns the collection of named properties.
Adds a string to a list box or combo box.
| Parameter | Type | Description |
|---|---|---|
sName |
Returns: SalNumber.
Brings a window to the top of all overlapping windows.
Returns: SalBoolean.
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.
Returns: SalBoolean.
Clears the value from a data field, multiline field, or table window column.
Returns: SalBoolean.
Clears a window's cursor.
| Parameter | Type | Description |
|---|---|---|
nType |
Returns: SalBoolean.
Deletes all entries from a list box or combo box.
Returns: SalBoolean.
Deletes a list box or combo box entry.
| Parameter | Type | Description |
|---|---|---|
nIndex |
Returns: SalNumber.
Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.
Returns: SalBoolean.
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.
Returns: SalBoolean.
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.
Returns: SalBoolean.
Enables keyboard and mouse input to a window.
Returns: SalBoolean.
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.
Returns: SalBoolean.
This function finds a child window of a given name in the specified window.
| Parameter | Type | Description |
|---|---|---|
sWindowName |
Returns: SalWindowHandle.
Dispatches the specified message (Window Actions) directly to the control's WindowActions event handlers, without going through Windows message loop.
| Parameter | Type | Description |
|---|---|---|
nMsg | ||
nMywParam | ||
nMylParam |
Returns: SalNumber.
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.
| Parameter | Type | Description |
|---|---|---|
nFormUnits | ||
bVertical |
Returns: SalNumber.
Return the name of a window's class as a string.
Returns: SalString.
Returns an object's type.
Returns: SalNumber.
Returns a data field's or table window column's data type.
Returns: SalNumber.
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.
| Parameter | Type | Description |
|---|---|---|
nTypeMask |
Returns: SalWindowHandle.
| Parameter | Type | Description |
|---|---|---|
sName | ||
nSize | ||
nEnhancement |
Returns: SalBoolean.
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.
Returns: SalWindowHandle.
| Parameter | Type | Description |
|---|---|---|
sText | ||
nMaxLength |
Returns: 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.
| Parameter | Type | Description |
|---|---|---|
nMaxLength |
Returns: SalString.
Returns the number of list box or combo box entries.
Returns: SalNumber.
Determines whether the specified list box or combo box entry is selected.
| Parameter | Type | Description |
|---|---|---|
nIndex |
Returns: SalBoolean.
| Parameter | Type | Description |
|---|---|---|
nIndex | ||
sText |
Returns: SalNumber.
Returns the text of the specified item.
| Parameter | Type | Description |
|---|---|---|
nIndex |
Returns: SalString.
Returns the length of a list box or combo box entry.
| Parameter | Type | Description |
|---|---|---|
nIndex |
Returns: SalNumber.
| Parameter | Type | Description |
|---|---|---|
sFileName |
Returns: SalBoolean.
Fetches the selected directory or file name from a list box or combo box.
Returns: SalString.
Returns the index of the selected entry in a combo box or single-selection list box.
Returns: SalNumber.
Returns an array of index numbers of selected list box entries.
| Parameter | Type | Description |
|---|---|---|
nSelectedArray |
Returns: SalBoolean.
Returns the number of selected entries in a multiple-selection list box. Specify single- or multiple-selection in the list box's customizer.
Returns: SalNumber.
| Parameter | Type | Description |
|---|---|---|
nX | ||
nY |
Returns: SalBoolean.
| Parameter | Type | Description |
|---|---|---|
sText |
Returns: SalBoolean.
Gets the name of an object.
Returns: SalString.
Returns the handle of the next child window that matches a specified type.
| Parameter | Type | Description |
|---|---|---|
nTypeMask |
Returns: SalWindowHandle.
Returns the handle of an object's parent window.
Returns: SalWindowHandle.
| Parameter | Type | Description |
|---|---|---|
sName | ||
sValue |
Returns: SalBoolean.
Gets the value of a named property.
| Parameter | Type | Description |
|---|---|---|
sName |
Returns: SalString.
| Parameter | Type | Description |
|---|---|---|
nWidth | ||
nHeight |
Returns: SalBoolean.
| Parameter | Type | Description |
|---|---|---|
sText | ||
nMaxLen |
Returns: SalNumber.
Retrieves the text of a window.
| Parameter | Type | Description |
|---|---|---|
nMaxLen |
Returns: SalString.
Gets a window's color.
| Parameter | Type | Description |
|---|---|---|
nColorIndex |
Returns: SalNumber.
Returns a window's current state.
Returns: SalNumber.
Hides a window.
Returns: SalBoolean.
Hides a window and its associated label.
Returns: SalBoolean.
Inserts an entry into a list box or combo box at a specified position.
| Parameter | Type | Description |
|---|---|---|
nIndex | ||
sAdd |
Returns: SalNumber.
Causes a window to be repainted.
Returns: SalBoolean.
Determines whether a window is an instance of the specified class.
| Parameter | Type | Description |
|---|---|---|
tClass |
Returns: SalBoolean.
Determines whether a window is enabled for mouse and keyboard input.
Returns: SalBoolean.
Returns the setting of the Field Edit Flag for a data field, multiline field, combo box, table window's context row cell, or picture.
Returns: SalBoolean.
Determines whether a window is currently visible.
Returns: SalBoolean.
Destroys an object's system timer.
| Parameter | Type | Description |
|---|---|---|
nIDEvent |
Returns: SalBoolean.
Moves a window a given number of form units on the X and Y axes relative to its current position.
| Parameter | Type | Description |
|---|---|---|
nXOffset | ||
nYOffset |
Returns: SalBoolean.
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.
| Parameter | Type | Description |
|---|---|---|
nNumPixels | ||
bVertical |
Returns: SalNumber.
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.
| Parameter | Type | Description |
|---|---|---|
hSql | ||
sSelect |
Returns: SalBoolean.
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.
| Parameter | Type | Description |
|---|---|---|
hSql | ||
sSelect | ||
errorHandler |
Returns: SalBoolean.
| Parameter | Type | Description |
|---|---|---|
ctrlPath | ||
sPathName | ||
nAttributes |
Returns: SalBoolean.
Posts the specified message to a window by adding nMsg to hWndReceiver's message queue.
| Parameter | Type | Description |
|---|---|---|
nMsg | ||
nMywParam | ||
nMylParam |
Returns: SalBoolean.
Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.
| Parameter | Type | Description |
|---|---|---|
nMsg | ||
nMywParam | ||
nMylParam |
Returns: SalNumber.
Sends a message to all child items of a form window, dialog box, table window, or MDI window.
| Parameter | Type | Description |
|---|---|---|
nMsg | ||
nMywParam | ||
nMylParam |
Returns: SalBoolean.
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
| Parameter | Type | Description |
|---|---|---|
sMenuName | ||
nFlags |
Returns: SalBoolean.
Defines a named popup menu that displays automatically when a window receives SAM_ContextMenu.
| Parameter | Type | Description |
|---|---|---|
menuType | ||
nFlags |
Returns: SalBoolean.
Sets a window's cursor.
| Parameter | Type | Description |
|---|---|---|
nResourceId | ||
nType |
Returns: SalBoolean.
Sets a window's cursor from a string variable.
| Parameter | Type | Description |
|---|---|---|
sBlob | ||
nType |
Returns: SalBoolean.
Sets an application-defined cursor for the specified window. Use this function to set the cursor from an image stored in a file.
| Parameter | Type | Description |
|---|---|---|
sFile | ||
nType |
Returns: SalBoolean.
Sets the focus to a specified window.
Returns: SalWindowHandle.
Sets a window's font, font size, and font enhancements.
| Parameter | Type | Description |
|---|---|---|
sName | ||
nSize | ||
nEnhancement |
Returns: SalBoolean.
Sets the text of the associaetd label control.
| Parameter | Type | Description |
|---|---|---|
sText |
Returns: SalBoolean.
Selects or deselects a combo box or single-selection list box entry.
| Parameter | Type | Description |
|---|---|---|
nIndex |
Returns: SalBoolean.
Selects or deselects a combo box or multiple-selection list box entry.
| Parameter | Type | Description |
|---|---|---|
nIndex | ||
bSelect |
Returns: SalBoolean.
Finds and selects a combo box or single-selection list box entry.
| Parameter | Type | Description |
|---|---|---|
nIndexStart | ||
sText |
Returns: SalNumber.
Moves a window to a new position (x, y) on the X and Y axes.
| Parameter | Type | Description |
|---|---|---|
nX | ||
nY |
Returns: SalBoolean.
Sets or clears the field edit flag for an editable data field, combo box, multiline text field, table window column, or picture.
| Parameter | Type | Description |
|---|---|---|
bSet |
Returns: SalBoolean.
Sets the value of a named property.
| Parameter | Type | Description |
|---|---|---|
sName | ||
sValue | ||
nLength |
Returns: SalBoolean.
Resizes a window.
| Parameter | Type | Description |
|---|---|---|
nWidth | ||
nHeight |
Returns: SalBoolean.
Sets the text of a window.
| Parameter | Type | Description |
|---|---|---|
sText |
Returns: SalBoolean.
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.
| Parameter | Type | Description |
|---|---|---|
nIDEvent | ||
nElapseMilliSec |
Returns: SalBoolean.
Sets a window's color.
| Parameter | Type | Description |
|---|---|---|
nColorIndex | ||
nColor |
Returns: SalBoolean.
Makes a window visible.
Returns: SalBoolean.
Makes a window and its associated label visible. A label is the label control that immediately precedes the window in the outline.
Returns: SalBoolean.
Creates pop-up menus at runtime.
| Parameter | Type | Description |
|---|---|---|
sMenuName | ||
nFlags | ||
nX | ||
nY | ||
callback |
Returns: SalBoolean.
Creates pop-up menus at runtime.
| Parameter | Type | Description |
|---|---|---|
menuType | ||
nFlags | ||
nX | ||
nY | ||
callback |
Returns: SalBoolean.
Forces the update of a window.
Returns: SalBoolean.
| Name | Description |
|---|---|
| Name | Description |
|---|---|
All SAL controls implement this interface. | |
SAL List controls implement this interface. | |
All Sal windows (Child windows, Forms, Dialogs and MDIs) implement this interface. |
