IUIX_Combo::SelItemByText Method

UI Layer > Interfaces > IUIX_Combo > IUIX_Combo::SelItemByText Method

Selects an item with a required text.

Syntax

HRESULT SelItemByText([in]                               BSTR   pText,
                      [in, defaultvalue(0)]              LONG   nFlags,
                      [out, retval, defaultvalue(NULL)]  LONG*  pIndex);

Parameters

pText

[in] text of an item that is to be selected.

nFlags

[in, defaultvalue(0)] Specifies parameters of text search. See UIX_FindItemByTextFlags for a full list of available search flags.

pIndex

[out, retval, defaultvalue(NULL)] returns value of selected item index. Returns -1 if no items with given text search parameters were found. If there is more than one item that matches given text search parameters, an item which is the first of them in a list will be selected.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IUIX_Combo, UIX_FindItemByTextFlags.