# SalListBox

Namespace: **PPJ.Runtime.Windows**

Assembly: **PPJ.Runtime.49** (4.9.0.0)

ListBox implementation.

{% tabs %}
{% tab title="C#" %}

```csharp
public class SalListBox : ListBox, ISalWindow, ISalControl, ISalListControl, IConvertible
```

{% endtab %}

{% tab title="VB.NET" %}

```visual-basic
Public Class SalListBox
    Inherits ListBox
    Implements ISalWindow, ISalControl, ISalListControl, IConvertible
```

{% endtab %}
{% endtabs %}

## Constructors

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SalListBox()

Constructs a SalListBox object.

## Properties

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Label

[Control](https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.control): Returns/Sets the label associated with this control.

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)NamedProperties

[SalNamedProperties](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox): Returns the collection of named properties.

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ReadOnly

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Returns/Sets the ReadOnly flag for the ListBox control. When the ListBox is ReadOnly, it can still get the focus and be scrolled. (Default: `False`)

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SelectedIndex

[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32): Index of selected item. -1 if none

## Methods

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)AddListItem(sName)

Adds a string to a list box or combo box.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **sName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)BringWindowToTop()

Brings a window to the top of all overlapping windows.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)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.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Clear()

Clears the value from a data field, multi line field, or table window column.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ClearCursor(type)

Clears a window's cursor.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **type**  | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ClearList()

Deletes all entries from a list box or combo box.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DeleteListItem(nIndex)

Deletes a list box or combo box entry.

| Parameter  | Type                                                                                                    | Description |
| ---------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DestroyWindow()

Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)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.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)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.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)EnableWindow()

Enables keyboard and mouse input to a window.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)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.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FindChild(windowName)

This function finds a child window of a given name in the specified window.

| Parameter      | Type                                                                                                    | Description                           |
| -------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| **windowName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | The name of the child window to find. |

**Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FireWindowActions(msg, mywParam, mylParam)

Dispatches the specified message (Window Actions) directly to the control's WindowActions event handlers, without going through Windows message loop.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **msg**      | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FormUnitsToPixels(formUnits, vertical)

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                                                                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **formUnits** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  | The number of form units.                                                                                                          |
| **vertical**  | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE. |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetClassName()

Return the name of a window's class as a string.

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetControlType()

Returns an object's type.

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetDataType()

Returns a data field's or table window column's data type.

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetFirstChild(typeMask)

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                                                                                            |
| ------------ | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **typeMask** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | One or more window types combined (using the OR (\|) operator) to create a mask of child window types. |

**Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetFont(name, size, enhancement)

| Parameter       | Type                                                                                                     | Description |
| --------------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **name**        | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **size**        | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **enhancement** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)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.

**Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLabelText(sText, nMaxLength)

| Parameter      | Type                                                                                                     | Description |
| -------------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **sText**      | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **nMaxLength** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLabelText(nMaxLength)

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** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListItemsCount()

Returns the number of list box or combo box entries.

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListItemState(index)

Determines whether the specified list box or combo box entry is selected.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **index** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListItemText(index, text)

| Parameter | Type                                                                                                     | Description |
| --------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **index** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |             |
| **text**  | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListItemText(index)

Returns the text of the specified item.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **index** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListItemTextLength(index)

Returns the length of a list box or combo box entry.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **index** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListSelectedFile(fileName)

| Parameter    | Type                                                                                                     | Description |
| ------------ | -------------------------------------------------------------------------------------------------------- | ----------- |
| **fileName** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListSelectedFile()

Fetches the selected directory or file name from a list box or combo box.

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox). Name of the selected file in t he control.

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListSelectedIndex()

Returns the index of the selected entry in a combo box or single-selection list box.

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListSelectedItems(nSelectedArray)

Returns an array of index numbers of selected list box entries.

| Parameter          | Type                                                                                                               | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ | ----------- |
| **nSelectedArray** | [SalArray\<SalNumber>](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetListSelectedItemsCount()

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](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLocation(x, y)

| Parameter | Type                                                                                                     | Description |
| --------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **x**     | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **y**     | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetName(text)

| Parameter | Type                                                                                                     | Description |
| --------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **text**  | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetName()

Gets the name of an object.

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetNextChild(typeMask)

Returns the handle of the next child window that matches a specified type.

| Parameter    | Type                                                                                                    | Description                                                                                            |
| ------------ | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **typeMask** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | One or more window types combined (using the OR (\|) operator) to create a mask of child window types. |

**Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetParent()

Returns the handle of an object's parent window.

**Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetProperty(name, value)

| Parameter | Type                                                                                                     | Description |
| --------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **name**  | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |             |
| **value** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetProperty(name)

Gets the value of a named property.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **name**  | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetSize(width, height)

| Parameter  | Type                                                                                                     | Description |
| ---------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **width**  | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **height** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetText(text, maxLen)

| Parameter  | Type                                                                                                     | Description |
| ---------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **text**   | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **maxLen** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetText(maxLen)

Retrieves the text of a window.

| Parameter  | Type                                                                                                    | Description |
| ---------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **maxLen** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetWindowColor(colorIndex)

Gets a window's color.

| Parameter      | Type                                                                                                    | Description |
| -------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **colorIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetWindowState()

Returns a window's current state.

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)HideWindow()

Hides a window.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)HideWindowAndLabel()

Hides a window and its associated label.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)InsertListItem(nIndex, sAdd)

Inserts an entry into a list box or combo box at a specified position.

| Parameter  | Type                                                                                                    | Description |
| ---------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **sAdd**   | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)InvalidateWindow()

Causes a window to be repainted.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsDerivedFromClass(typeClass)

Determines whether a window is an instance of the specified class.

| Parameter     | Type                                                            | Description |
| ------------- | --------------------------------------------------------------- | ----------- |
| **typeClass** | [Type](https://docs.microsoft.com/en-us/dotnet/api/system.type) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsEnabled()

Determines whether a window is enabled for mouse and keyboard input.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsModified()

Returns the setting of the Field Edit Flag for a data field, multi line field, combo box, table window's context row cell, or picture.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsVisible()

Determines whether a window is currently visible.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)KillTimer(idEvent)

Destroys an object's system timer.

| Parameter   | Type                                                                                                    | Description |
| ----------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **idEvent** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MoveWindow(xOffset, yOffset)

Moves a window a given number of form units on the X and Y axes relative to its current position.

| Parameter   | Type                                                                                                    | Description |
| ----------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **xOffset** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **yOffset** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PixelsToFormUnits(numPixels, vertical)

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                                                                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **numPixels** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |                                                                                                                                    |
| **vertical**  | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE. |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PopulateList(hSql, sSelect)

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**    | [SalSqlHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **sSelect** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)    |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PopulateList(hSql, sSelect, errorHandler)

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**         | [SalSqlHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)        |             |
| **sSelect**      | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)           |             |
| **errorHandler** | [WhenSqlErrorHandler](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PopulateListFiles(ctrlPath, pathName, attributes)

| Parameter      | Type                                                                                                     | Description |
| -------------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **ctrlPath**   | [Control](https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.control)                      |             |
| **pathName**   | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **attributes** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PostMessage(msg, mywParam, mylParam)

Posts the specified message to a window by adding nMsg to hWndReceiver's message queue.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **msg**      | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SendMessage(msg, mywParam, mylParam)

Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **msg**      | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SendMessageToChildren(msg, mywParam, mylParam)

Sends a message to all child items of a form window, dialog box, table window, or MDI window.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **msg**      | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetContextMenu(sMenuName, nFlags)

Defines a named popup menu that displays automatically when a window receives SAM\_ContextMenu.

| Parameter     | Type                                                                                                    | Description |
| ------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **sMenuName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **nFlags**    | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetContextMenu(menuType, flags)

Defines a named popup menu that displays automatically when a window receives SAM\_ContextMenu.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **menuType** | [Type](https://docs.microsoft.com/en-us/dotnet/api/system.type)                                         |             |
| **flags**    | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursor(resource, type)

Sets a window's cursor.

| Parameter    | Type                                                                                                            | Description |
| ------------ | --------------------------------------------------------------------------------------------------------------- | ----------- |
| **resource** | [SalResourceCursor](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **type**     | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)         |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursor(resourceId, type)

Sets a window's cursor.

| Parameter      | Type                                                                                                    | Description |
| -------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **resourceId** | [Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)                                       |             |
| **type**       | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursor(blob, type)

Sets a window's cursor from a string variable.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **blob**  | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **type**  | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursorFile(file, type)

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 |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **file**  | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **type**  | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetFocus()

Sets the focus to a specified window.

**Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetFont(name, size, enhancement)

Sets a window's font, font size, and font enhancements.

| Parameter       | Type                                                                                                    | Description |
| --------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **name**        | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **size**        | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **enhancement** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetLabelText(sText)

Sets the text of the associated label control.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **sText** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetListRedraw(redraw)

Redraws entries in a list box or combo box, or prevents them from being redrawn.

| Parameter  | Type                                                                                                    | Description |
| ---------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **redraw** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetListSelectedIndex(index)

Selects or deselects a combo box or single-selection list box entry.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **index** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetListSelectedItems(index, select)

Selects or deselects a combo box or multiple-selection list box entry.

| Parameter  | Type                                                                                                     | Description |
| ---------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **index**  | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)  |             |
| **select** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetListSelectedText(indexStart, text)

Finds and selects a combo box or single-selection list box entry.

| Parameter      | Type                                                                                                    | Description |
| -------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **indexStart** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **text**       | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetListTabStops(tabStops)

Sets tabs in a list box.

| Parameter    | Type                                                                                                               | Description |
| ------------ | ------------------------------------------------------------------------------------------------------------------ | ----------- |
| **tabStops** | [SalArray\<SalNumber>](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetLocation(x, y)

Moves a window to a new position (x, y) on the X and Y axes.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **x**     | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **y**     | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetModified(bSet)

Sets or clears the field edit flag for an editable data field, combo box, multi line text field, table window column, or picture.

| Parameter | Type                                                                                                     | Description |
| --------- | -------------------------------------------------------------------------------------------------------- | ----------- |
| **bSet**  | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetProperty(name, value, length)

Sets the value of a named property.

| Parameter  | Type                                                                                                    | Description |
| ---------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **name**   | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **value**  | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **length** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetSize(width, height)

Resizes a window.

| Parameter  | Type                                                                                                    | Description |
| ---------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **width**  | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **height** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetText(text)

Sets the text of a window.

| Parameter | Type                                                                                                    | Description |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **text**  | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetTimer(idEvent, elapseMilliSec)

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 |
| ------------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **idEvent**        | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **elapseMilliSec** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetWindowColor(colorIndex, color)

Sets a window's color.

| Parameter      | Type                                                                                                    | Description |
| -------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **colorIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **color**      | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowWindow()

Makes a window visible.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowWindowAndLabel()

Makes a window and its associated label visible. A label is the label control that immediately precedes the window in the outline.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)TrackPopupMenu(menuName, flags, x, y)

Creates pop-up menus at runtime.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **menuName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **flags**    | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **x**        | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **y**        | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)TrackPopupMenu(menuType, flags, x, y)

Creates pop-up menus at runtime.

| Parameter    | Type                                                                                                    | Description |
| ------------ | ------------------------------------------------------------------------------------------------------- | ----------- |
| **menuType** | [Type](https://docs.microsoft.com/en-us/dotnet/api/system.type)                                         |             |
| **flags**    | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **x**        | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **y**        | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)UpdateWindow()

Forces the update of a window.

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)WinHelp(file, command, numData, strData)

Starts the Windows help system.

| Parameter   | Type                                                                                                    | Description |
| ----------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| **file**    | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **command** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **numData** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |
| **strData** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) |             |

**Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox).

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Yield()

Processes messages for this control.

## Events

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MessageActions

[SalMessageHandler](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) Message Actions

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ReadOnlyChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the ReadOnly property is altered.

### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)WindowActions

[WindowActionsEventHandler](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) Window Actions

## Inherited By

| Name                                                                                                                 | Description                    |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| [SalQuickToolTipListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | List box with tool tip support |
| [VisColorListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)        |                                |
| [VisDirListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)          |                                |
| [VisDriveListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)        |                                |
| [VisFileListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)         |                                |
| [VisFontListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)         |                                |
| [VisFontNameListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)     |                                |
| [VisListBoxBase](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)         |                                |
| [VisPictureListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)      |                                |
| [VisRadioListBox](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)        |                                |

## Implements

| Name                                                                                                          | Description                                                                        |
| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [ISalControl](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)     | All SAL controls implement this interface.                                         |
| [ISalListControl](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox) | SAL List controls implement this interface.                                        |
| [ISalWindow](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/ppj.runtime.windows.sallistbox)      | All Sal windows (Child windows, Forms, Dialogs and MDIs) implement this interface. |