# VisListBoxExtension

Namespace: **PPJ.Runtime.Vis**

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

Common list box extension class

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

```csharp
public class VisListBoxExtension : SalGeneralWindow
```

{% endtab %}

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

```visual-basic
Public Class VisListBoxExtension
    Inherits SalGeneralWindow
```

{% endtab %}
{% endtabs %}

## Constructors

### ![](/files/dBIrS7XBDGmrzmTRbSI6)VisListBoxExtension(derived)

Multiple Inheritance Constructor

| Name        | Type                                                                              | Description |
| ----------- | --------------------------------------------------------------------------------- | ----------- |
| **derived** | [ISalWindow](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

## Fields

| Name           | Type                                                                             | Description   |
| -------------- | -------------------------------------------------------------------------------- | ------------- |
| **hFont**      | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **hItem**      | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **hPicNormal** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **hPicSelect** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **nColor**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **nFlags**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) | from cOutline |
| **nIdx**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) | from cOutline |
| **nIndex**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **nItemFlags** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **nLevel**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **nStyle**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **nValue**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |
| **sText**      | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |               |

## Methods

### ![](/files/dBIrS7XBDGmrzmTRbSI6)AddColor(sText, nColor)

Adds an item to the list and displays it in the specified color.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)AddColorValue(sText, nColor, nValue)

Adds an item to the list, displays it in the specified color and associates the specified value with the item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)AddFont(sText, hFont)

Adds an item to the list control and displays it in the specified font.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **sText** | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hFont** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)AddFontValue(sText, hFont, nValue)

Adds a new item with the specified font and value.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hFont**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)AddPicture(sText, hPicNormal, hPicSelected)

Adds an item to the list control and specified an image for the normal and selected state.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **sText**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)AddPictureValue(sText, hPicNormal, hPicSelected, nValue)

Adds an item to the list control and specified an image for the normal and selected state, and a value to associate with the item.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **sText**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)Collapse(nIndex)

Collapses all descendant items.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)DeleteChild(nIndex)

Deletes the child item from the tree control.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)DeleteDescendents(nIndex)

Deletes all descendants (children, grandchildren, and so on) of the specified child.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)Demote(nIndex, hPicNormal, hPicSelected)

Moves an item and all descendants right in the outline by making the item become the last child of the previous sibling. If the new parent node was not already a parent, the images are also updated. Otherwise the images are ignored.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)DisableItem(nIndex, nColor)

Disables the specified item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)DoDragDrop(nSourceIndex, target, nTargetIndex, nDropMode)

Moves the source item to the new location, providing support for dragging tree items.

| Parameter        | Type                                                                                | Description |
| ---------------- | ----------------------------------------------------------------------------------- | ----------- |
| **nSourceIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)    |             |
| **target**       | [Control](https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.control) |             |
| **nTargetIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)    |             |
| **nDropMode**    | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)    |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)EnableItem(nIndex, nColor)

Enables the specified item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)EnumChildren(hItem, hItems)

Enumerates child item handles for a specified item.

| Parameter  | Type                                                                                        | Description |
| ---------- | ------------------------------------------------------------------------------------------- | ----------- |
| **hItem**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)            |             |
| **hItems** | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)EnumDescendents(hItem, hItems)

Enumerates descendant (children, grandchildren, and so on) item handles for a specified item.

| Parameter  | Type                                                                                        | Description |
| ---------- | ------------------------------------------------------------------------------------------- | ----------- |
| **hItem**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)            |             |
| **hItems** | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)Expand(nIndex)

Expands an outline one level at the index specified.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)ExpandDescendents(nIndex)

Displays all descendants of an item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)FindItemValue(hItem, nValue)

Finds the item with the specified value in the descendants of the specified node.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)FreeChild(hItem)

Frees memory for the item specified and for all its descendants.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)FreeDescendents(hItem)

Frees memory for all descendants of the item specified.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/69uzLyEV3ANF4GK6pznb)FromHandle(hWnd)

Fully qualified expressions operator.

| Parameter | Type                                                                                   | Description |
| --------- | -------------------------------------------------------------------------------------- | ----------- |
| **hWnd**  | [SalWindowHandle](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [VisListBoxExtension](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/69uzLyEV3ANF4GK6pznb)FromItemHandle(handle)

Returns the instance of VisListBoxExtension from the item handle.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **handle** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [VisListBoxExtension](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetChildNodeCount(hItem, bDirectChildrenOnly)

Gets the number of children for a specified item.

| Parameter               | Type                                                                              | Description |
| ----------------------- | --------------------------------------------------------------------------------- | ----------- |
| **hItem**               | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **bDirectChildrenOnly** | [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetColor(nIndex)

Returns the current color of the list item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetFlags(nIndex)

Returns the item's flags.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetFont(nIndex)

Returns the current font of the list control item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetIndexFromPoint(nXPos, nYPos)

Returns the index of the item at the indicated screen coordinates.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **nXPos** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nYPos** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemColor(hItem)

Retrieves the color associated with an outline item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemData(hItem, sText, nValue, nItemFlags)

| Parameter      | Type                                                                              | Description |
| -------------- | --------------------------------------------------------------------------------- | ----------- |
| **hItem**      | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **sText**      | [SalString&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue**     | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nItemFlags** | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemFlags(hItem)

Returns the items's flags.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemFont(hItem)

Retrieves the font associated with an outline item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemHandle(nIndex)

Retrieves the item handle based on an index specified.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemIndex(hItem)

Retrieves the index associated with an outline item based on an item handle.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemPicture(hItem, hPicNormal, hPicSelected)

| Parameter        | Type                                                                              | Description |
| ---------------- | --------------------------------------------------------------------------------- | ----------- |
| **hItem**        | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **hPicNormal**   | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemText(hItem)

Returns the text for the outline item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetItemValue(hItem)

Returns the value saved with the outline item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetLevel(hItem)

Returns the indentation level of the specified item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetNextSibling(hItem)

Retrieves the item handle for the next sibling of the specified item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetParent(hItem)

Retrieves the item handle for the parent of the specified item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetPicture(nIndex, hPicNormal, hPicSelected)

| Parameter        | Type                                                                              | Description |
| ---------------- | --------------------------------------------------------------------------------- | ----------- |
| **nIndex**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **hPicNormal**   | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetPrevSibling(hItem)

Retrieves the item handle for the previous sibling of the specified item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetRoot()

Returns the handle for the root node.

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetStyle()

Returns the style flags for the control.

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)GetTextRectangle(nIndex, nTop, nLeft, nBottom, nRight)

| Parameter   | Type                                                                              | Description |
| ----------- | --------------------------------------------------------------------------------- | ----------- |
| **nIndex**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **nTop**    | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nLeft**   | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nBottom** | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nRight**  | [SalNumber&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)InsertColor(nIndex, sText, nColor)

Inserts an item to the list control at the specified position and displays it in the specified color.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)InsertColorValue(nIndex, sText, nColor, nValue)

Inserts an item to the list control at the specified position, displays it in the specified color and associates the specified value to the item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)InsertFont(nIndex, sText, hFont)

Adds an item to a list control at the specified index and displays it in the specified font.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hFont**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)InsertFontValue(nIndex, sText, hFont, nValue)

Adds an item to the list control, displays it in the specified font, and associates the specified value with the item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**  | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hFont**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)InsertPicture(nIndex, sText, hPicNormal, hPicSelected)

Inserts an item at the specified position and specifies an image for the normal and selected state.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)InsertPictureValue(nIndex, sText, hPicNormal, hPicSelected, nValue)

Inserts an item at the specified position and specifies an image for the normal and selected state, and associates a value to the item.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)LoadChild(hItem, hPicNormal, hPicSelected, sText, nValue, nItemFlags)

Inserts an item as the last child of the specified parent.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem**        | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nItemFlags**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)LoadChildren(hItem, hPicNormal, hPicSelect, sTexts, nValues, nItemFlags)

Inserts multiple items as the last children of the specified parent item.

| Parameter      | Type                                                                                        | Description |
| -------------- | ------------------------------------------------------------------------------------------- | ----------- |
| **hItem**      | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)            |             |
| **hPicNormal** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)            |             |
| **hPicSelect** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)            |             |
| **sTexts**     | [SalArray\<SalString>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValues**    | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nItemFlags** | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)LoadChildren(hItem, hPicNormal, hPicSelect, sTexts, nValues, nItemFlags)

Inserts multiple items as the last children of the specified parent item.

| Parameter      | Type                                                                                        | Description |
| -------------- | ------------------------------------------------------------------------------------------- | ----------- |
| **hItem**      | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)            |             |
| **hPicNormal** | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelect** | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sTexts**     | [SalArray\<SalString>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValues**    | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nItemFlags** | [SalArray\<SalNumber>](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)LoadOutline(xml)

Deserializes the entire outline tree from the specified XML string.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **xml**   | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)LoadOutlineFile(sFileName, hPicParentNormal, hPicParentSelect, hPicChildNormal, hPicChildSelect)

Loads the serialized outline structure from the file and creates the new items as children of the specified node.

| Parameter            | Type                                                                             | Description |
| -------------------- | -------------------------------------------------------------------------------- | ----------- |
| **sFileName**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicParentNormal** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicParentSelect** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicChildNormal**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicChildSelect**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)LoadSibling(hItemBefore, hPicNormal, hPicSelected, sText, nValue, nItemFlags)

Loads a new tree node as a sibling of the specified item.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **hItemBefore**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**        | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nItemFlags**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)MoveDown(nIndex)

Moves the specified item down one position in the tree.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)MoveUp(nIndex)

Moves an item and its descendants up in the list.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)Promote(nIndex, hPicNormal, hPicSelected)

Moves an item and its descendants left in the outline by making it the last sibling of the parent item. If the node was the only child, the images of the previous parent node are also updated, otherwise the images are ignored.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SaveOutline(xml)

| Parameter | Type                                                                              | Description |
| --------- | --------------------------------------------------------------------------------- | ----------- |
| **xml**   | [SalString&](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetColor(nIndex, nColor)

Sets the color of a list item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetFlags(nIndex, nFlags, bState)

Sets the item's flags.

| Parameter  | Type                                                                              | Description |
| ---------- | --------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **nFlags** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **bState** | [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetFont(nIndex, hFont)

Sets the font of the list control item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hFont**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetIndent(nWidth)

Gets or sets the distance to indent each of the child tree node levels.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nWidth** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemColor(hItem, nColor)

Sets the color of the outline item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nColor** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemData(hItem, sText, nValue, nItemFlags)

Updates the specified item.

| Parameter      | Type                                                                             | Description |
| -------------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem**      | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText**      | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue**     | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nItemFlags** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemFlags(hItem, nFlags, bState)

Sets the item's flags.

| Parameter  | Type                                                                              | Description |
| ---------- | --------------------------------------------------------------------------------- | ----------- |
| **hItem**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **nFlags** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md)  |             |
| **bState** | [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemFont(hItem, hFont)

Sets the font of the outline item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hFont** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemPicture(hItem, hPicNormal, hPicSelected)

Assigns new bitmaps to the specified item.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem**        | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemText(hItem, sText)

Sets the text of the outline item.

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **sText** | [SalString](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetItemValue(hItem, nValue)

Sets the value associated to the outline item.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **hItem**  | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **nValue** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetOutlineRedraw(bRedraw)

Enables or disables drawing.

| Parameter   | Type                                                                              | Description |
| ----------- | --------------------------------------------------------------------------------- | ----------- |
| **bRedraw** | [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetPicture(nIndex, hPicNormal, hPicSelected)

Changes the normal and selected images for the specified item.

| Parameter        | Type                                                                             | Description |
| ---------------- | -------------------------------------------------------------------------------- | ----------- |
| **nIndex**       | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicNormal**   | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |
| **hPicSelected** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)SetStyle(nStyle)

Sets the style flags for the control.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nStyle** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

### ![](/files/dBIrS7XBDGmrzmTRbSI6)ShowOutline(nLevel)

Expands list items up to the specified level.

| Parameter  | Type                                                                             | Description |
| ---------- | -------------------------------------------------------------------------------- | ----------- |
| **nLevel** | [SalNumber](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |

**Returns:** [SalBoolean](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md).

## Implements

| Name                                                                              | Description |
| --------------------------------------------------------------------------------- | ----------- |
| [ISalWindow](/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md) |             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://desktop-api.iceteagroup.com/ppj.runtime.vis.49/controls/ppj.runtime.vis.vislistboxextension.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.