IASPowerListBox::Add

This method adds a new item to a power list box.

Syntax

HRESULT Add( long lItemId, long lType, IDispatch **ppdispItem );

Parameters

lItemId

Long integer that contains the identifier of the item.

lType

Long integer that contains the item type. It is one of the following values:

ASFC_PWRLB_TYPE_COMMAND

Specifies a command.

ASFC_PWRLB_TYPE_EDIT

Specifies an edit box.

ASFC_PWRLB_TYPE_STRINGSPINNER

Specifies a string spinner.

ASFC_PWRLB_TYPE_INTSPINNER

Specifies an integer spinner.

ppdispItem

Pointer to the pointer to item’s IDispatch interface.

Return Values

NOERROR indicates success. E_OUTOFMEMORY indicates that the system is out of memory.

Remarks

The item is added to the end of the list. To interact with the item, call QueryInterface on the IDispatch interface.

It is possible to use duplicate identifiers. However, if you do so, you can no longer identify items by their identifier.

See Also

IASPowerListBox::CreateItem