> For the complete documentation index, see [llms.txt](https://web-api.iceteagroup.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://web-api.iceteagroup.com/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md).

# VisListViewDropDown

Namespace: **PPJ.Runtime.Vis**

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

Combobox with dropdown cListView

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

```csharp
public class VisListViewDropDown : VisDropDownBase
```

{% endtab %}

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

```visual-basic
Public Class VisListViewDropDown
    Inherits VisDropDownBase
```

{% endtab %}
{% endtabs %}

## Constructors

### ![](/files/qoQXnPICsjBVNBSqpOj9)VisListViewDropDown()

## Methods

### ![](/files/qoQXnPICsjBVNBSqpOj9)AddImage(hpicLarge, hpicSmall)

Adds an image to control's internal ImageLists at the index specified.

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **hpicLarge** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicSmall** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)Arrange(nCode)

Aligns items on a grid.

| Parameter | Type                                                                                     | Description |
| --------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nCode** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)AssignColumns(saTitles, naAlignments, naWidths, nNumColumns)

Assigns columns to be used for 'details' view. TIP: You can reassign columns on the fly without having to repopulate the control. For instance, you can use SetItemText() to add four subitems to an item, but only assign four columns (remember: 1 item + 4 subitems = 5 columns,) thus giving you a hidden column that you can display later by assigning five columns.

| Parameter        | Type                                                                                     | Description |
| ---------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **saTitles**     | [SalArray\<SalString>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **naAlignments** | [SalArray\<SalNumber>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **naWidths**     | [SalArray\<SalNumber>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **nNumColumns**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)DeleteAllItems()

Removes all items from the control.

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)DeleteItem(nItem)

Removes an item from control and returns count of remaining items.

| Parameter | Type                                                                                     | Description |
| --------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)EnsureVisible(nItem, fPartialOK)

Ensures that an item is visible

| Parameter      | Type                                                                                       | Description |
| -------------- | ------------------------------------------------------------------------------------------ | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md)   |             |
| **fPartialOK** | [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)FindItem(nFlags, sItemText, nItemStart)

Searches for an item by text or position.

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nFlags**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sItemText**  | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **nItemStart** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/jDiecrwjcc5yZsrGcmX2)FromHandle(hWnd)

Returns the control associated with the handle.

| Parameter | Type                                                                                                 | Description |
| --------- | ---------------------------------------------------------------------------------------------------- | ----------- |
| **hWnd**  | [SalWindowHandle](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salwindowhandle.md) |             |

**Returns:** [VisListViewDropDown](https://docs.wisej.com/extensions/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetAllSelectedItems(naSelections)

Retrieves array of all selected items and returns count.

| Parameter        | Type                                                                                    | Description |
| ---------------- | --------------------------------------------------------------------------------------- | ----------- |
| **naSelections** | [SalArray\<SalNumber>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetBkColor()

Retrieves the color used for the control's overall background.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetColumn(nColumn, sTitle, nAlignment, nWidth)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn**    | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sTitle**     | [SalString&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)            |             |
| **nAlignment** | [SalNumber&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)            |             |
| **nWidth**     | [SalNumber&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)            |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetColumnAlignment(nColumn)

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetColumnTitle(nColumn)

Retrieves a column's text.

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetColumnWidth(nColumn)

Retrieves a column's width.

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetCountPerPage()

Calculates the number of items that can fit vertically in control.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetEditable()

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetFocusItem()

Retrieves index of item with input focus.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetImageCount()

Retrieves the number of images in control. TIP: Remember that a listview defaults to one image (Windows logo) unless you remove/replace it.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItem(nItem, nSubItem, sItemText, nItemValue, nImage)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nSubItem**   | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sItemText**  | [SalString&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)            |             |
| **nItemValue** | [SalNumber&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)            |             |
| **nImage**     | [SalNumber&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)            |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItemCount()

Retrieves the number of items in control.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItemPosition(nItem, ptPosition)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **ptPosition** | [VisPoint&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)             |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItemRect(nItem, rcItem)

| Parameter  | Type                                                                                     | Description |
| ---------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **rcItem** | [VisRect&](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)              |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItemState(nItem, nMask)

Retrieves an item's state.

| Parameter | Type                                                                                     | Description |
| --------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nMask** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItemText(nItem, nSubItem)

Retrieves an item's text.

| Parameter    | Type                                                                                     | Description |
| ------------ | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**    | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nSubItem** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetItemValue(nItem)

Retrieves an item's user data.

| Parameter | Type                                                                                     | Description |
| --------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetNextItem(nItem, nFlags)

Searches for an item by sequence, relation or state.

| Parameter  | Type                                                                                     | Description |
| ---------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nFlags** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetSelectedCount()

Retrieves the number of selected items in control.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetSelectedItem()

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetSortColumn()

Retrieves default sort column (subitem.)

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetSortOrder()

Retrieves default sort order (ascending/descending)

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetStringWidth(sCompare)

Determines the minimum column width necessary to display all of a given string.

| Parameter    | Type                                                                                     | Description |
| ------------ | ---------------------------------------------------------------------------------------- | ----------- |
| **sCompare** | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetTextBkColor()

Retrieves the color used for item and subitem text background.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetTextColor()

Retrieves the color used for item and subitem text.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)GetTopIndex()

Retrieves the index of the topmost visible item.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertDetails(nItem, saText, nImage)

Inserts a new item into control and supplies subitem text for item. TIP: Use this instead of the InsertItem\*() functions to specify items with multiple columns in one function call when you already have your data populated in an array.

| Parameter  | Type                                                                                     | Description |
| ---------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **saText** | [SalArray\<SalString>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **nImage** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertDetailsPic(nItem, saText, hpicLarge, hpicSmall)

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **saText**    | [SalArray\<SalString>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **hpicLarge** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicSmall** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertDetailsValue(nItem, saText, nItemValue, nImage)

Inserts a new item into control and supplies subitem text for item; also assigns user data for item.

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **saText**     | [SalArray\<SalString>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **nItemValue** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nImage**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertDetailsValuePic(nItem, saText, nItemValue, hpicLarge, hpicSmall)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **saText**     | [SalArray\<SalString>](/ppj.web.vis.49/controls/ppj.runtime.vis.vislistviewdropdown.md)  |             |
| **nItemValue** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicLarge**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicSmall**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertItem(nItem, sText, nImage)

Inserts an item in control and returns index of new item or -1 if unsuccessful. TIP: Do not assume that the item you add with InsertItem() is given the index you requested; InsertItem() returns the actual index of the item added. If you insert past the upper bound of the control, your item is added to the end.

| Parameter  | Type                                                                                     | Description |
| ---------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sText**  | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **nImage** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertItemPic(nItem, sText, hpicLarge, hpicSmall)

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sText**     | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **hpicLarge** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicSmall** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertItemValue(nItem, sText, nItemValue, nImage)

Inserts a new item in control and assigns user data for item. Returns index of new item or -1 if unsuccessful.

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sText**      | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **nItemValue** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nImage**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)InsertItemValuePic(nItem, sText, nItemValue, hpicLarge, hpicSmall)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sText**      | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **nItemValue** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicLarge**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicSmall**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)RemoveAllImages()

Removes all images from control.

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)RemoveImage(nIndex)

Removes an image from control's internal ImageLists. TIP: All other images will shift downward when you remove an image from the control. Bear in mind that this will affect the images each item displays, since images are references by position.

| Parameter  | Type                                                                                     | Description |
| ---------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nIndex** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)ReplaceImage(nIndex, hpicLarge, hpicSmall)

Replaces an image in control's internal ImageLists.

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nIndex**    | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicLarge** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **hpicSmall** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetBkColor(nNewColor)

Assigns the color used for the control's overall background.

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nNewColor** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetColumn(nColumn, nMask, sTitle, nAlignment, nWidth)

Sets the attributes of a column.

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn**    | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nMask**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sTitle**     | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **nAlignment** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nWidth**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetColumnAlignment(nColumn, nAlignment)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn**    | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nAlignment** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetColumnTitle(nColumn, sTitle)

Sets a column's text.

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sTitle**  | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetColumnWidth(nColumn, nWidth)

Sets a column's width.

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nWidth**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetEditable(fEditable)

| Parameter     | Type                                                                                       | Description |
| ------------- | ------------------------------------------------------------------------------------------ | ----------- |
| **fEditable** | [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetFocusItem(nItem)

Assigns focus to the specified item.

| Parameter | Type                                                                                     | Description |
| --------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetItem(nItem, nSubItem, nMask, sItemText, nItemValue, nImage)

Sets an item's attributes.

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nSubItem**   | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nMask**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sItemText**  | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |
| **nItemValue** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nImage**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetItemState(nItem, nNewState, nStateMask)

Assigns an item's state (LVIS\_Focused, LVIS\_Selected, etc..)

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nNewState**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nStateMask** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetItemText(nItem, nSubItem, sItemText)

Sets an item's or subitem's text. TIP: When using this function to assign subitem text for new items, do not assume that the item you just added with InsertItem() was given the index you requested; InsertItem() returns the actual index of the item, use that value.

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**     | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nSubItem**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **sItemText** | [SalString](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salstring.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetItemValue(nItem, nItemValue)

Assigns an item's user data.

| Parameter      | Type                                                                                     | Description |
| -------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nItem**      | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nItemValue** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetListSize(nWidth, nHeight)

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nWidth**  | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |
| **nHeight** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetSortColumn(nColumn)

Assigns default column (subitem) to sort on.

| Parameter   | Type                                                                                     | Description |
| ----------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nColumn** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetSortOrder(nOrder)

Assigns default sort order (LVSORT\_Ascending/LVSORT\_Descending.)

| Parameter  | Type                                                                                     | Description |
| ---------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nOrder** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetStyle(nStyle, fOn)

Sets style bits for control.

| Parameter  | Type                                                                                       | Description |
| ---------- | ------------------------------------------------------------------------------------------ | ----------- |
| **nStyle** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md)   |             |
| **fOn**    | [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md) |             |

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetTextBkColor(nNewColor)

Assigns the color used for item and subitem text background.

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nNewColor** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SetTextColor(nNewColor)

Assigns the color used for item and subitem text.

| Parameter     | Type                                                                                     | Description |
| ------------- | ---------------------------------------------------------------------------------------- | ----------- |
| **nNewColor** | [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md) |             |

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)SortItems()

Sorts the items based on default column (subitem) and order settings.

**Returns:** [SalBoolean](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salboolean.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)ViewDetails()

Tells control to display 'details' view.' This view is similar to the 'small icon' view, with the exception that subitem text is also displayed in resizable, sortable columns to the right of the item text. NOTE: Clicking on subitem text does NOT change focus,

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)ViewLargeIcons()

Tells control to display 'large icons' view. This view is similar to Windows' program manager groups; a large icon is displayed with the item text underneath.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

### ![](/files/qoQXnPICsjBVNBSqpOj9)ViewSmallIcons()

Tells control to display 'small icons' view. This view is a vertical list of item text with a small icon to the left of each item.

**Returns:** [SalNumber](https://docs.wisej.com/extensions/ppj.web.49/types/ppj.runtime.salnumber.md).

## Implements

| Name                                                                                                              | Description |
| ----------------------------------------------------------------------------------------------------------------- | ----------- |
| [ISalControl](https://docs.wisej.com/extensions/ppj.web.49/interfaces/ppj.runtime.windows.isalcontrol.md)         |             |
| [ISalEditControl](https://docs.wisej.com/extensions/ppj.web.49/interfaces/ppj.runtime.windows.isaleditcontrol.md) |             |
| [ISalListControl](https://docs.wisej.com/extensions/ppj.web.49/interfaces/ppj.runtime.windows.isallistcontrol.md) |             |
| [ISalWindow](https://docs.wisej.com/extensions/ppj.web.49/interfaces/ppj.runtime.windows.isalwindow.md)           |             |