Share this page

# ListViewItem

# WinForms. ListViewItem

## new ListViewItem()

A ListView item object

### Methods

## clickState() → {Promise.<void>}

Clicks the state image icon.

##### Returns:

a promise that is fulfilled when the operation is performed.

Type
  Promise.<void>

## doubleClickState() → {Promise.<void>}

Double-clicks state image icon.

##### Returns:

a promise that is fulfilled when the operation is performed.

Type
  Promise.<void>

## dragAndDropOn(target, dragOptionsopt) → {Promise.<void>}

Drags and drops a test object onto the specified target object according to the specified DragOptions behavior.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`target` | TestObject | Object |  | The target object on which this object is dropped.
`dragOptions` | Object | <optional> | The drag and drop behavior to apply. ###### Properties
Name | Type | Attributes | Default | Description
--- | --- | --- | --- | ---
`button` | MouseButton | <optional> | MouseButton.left | The mouse button used to drag the object.
`dragLocation` | Location | <optional> |  | The point on the source object where the drag operation begins.
`dropLocation` | Location | <optional> |  | The point on the target object where the drag and drop operation ends.

##### Returns:

a promise that is fulfilled when the drop operation ends.

Type
  Promise.<void>

## enableLabelEditing() → {Promise.<void>}

Activates the edit mode for the lists item label to enable renaming. Remarks: This method only enables the item for renaming. To actually rename the item, set its value using EditorTO or EditTO test object, together with an applicable method.

##### Returns:

a promise that is fulfilled when the operation is performed.

Type
  Promise.<void>

## getSubItemText(indexOrName) → {Promise.<string>}

Returns the text value of the specified report-style (LVS_REPORT) list-view subitem.

##### Parameters:

Name | Type | Description
--- | --- | ---
`indexOrName` | number | string | The 0-based numeric index or name of the list-view subitem you want to retrieve.

##### Returns:

a promise that is fulfilled with the text value of the subitem.

Type
  Promise.<string>

## isFocused() → {Promise.<boolean>}

Indicates whether the list item is in focus in a multiple selection list box.

##### Returns:

a promise that is fulfilled with indication whether the item is focused.

Type
  Promise.<boolean>

## isSelected() → {Promise.<boolean>}

Indicates whether the list item is selected.

##### Returns:

a promise that is fulfilled with indication whether the item is selected or not.

Type
  Promise.<boolean>

## setItemState(state) → {Promise.<void>}

Sets the state of the check box icon of the specified item in the list.

##### Parameters:

Name | Type | Description
--- | --- | ---
`state` | number | the 0-based state image index.

##### Returns:

a promise that is fulfilled when the operation is performed.

Type
  Promise.<void>

## state() → {Promise.<number>}

The list item's state image index.

##### Returns:

a promise that is fulfilled with the list item's state image index..

Type
  Promise.<number>

## text() → {Promise.<string>}

The text value of the list item, or "" when empty..

##### Returns:

a promise that is fulfilled with the text of the item.

Type
  Promise.<string>

Tips to improve your search results... UFT Developer JavaScript SDK Reference Version 15.0-15.0.2 UFT Developer SDK Reference All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: