IUIX_Combo::FindItemByText Method
From PDF XChange PDF SDK
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | __NOTOC__ | ||
[[Category:Editor]] | [[Category:Editor]] | ||
{{#customTitle:IUIX_Combo::FindItemByText Method}} | {{#customTitle:IUIX_Combo::FindItemByText Method}} | ||
| − | {{#parentPage:PXV:IUIX_Combo|FindItemByText | + | {{#parentPage:PXV:IUIX_Combo#Methods|FindItemByText|method}} |
| − | + | ||
Returns ''index'' of an item with a required ''text''. | Returns ''index'' of an item with a required ''text''. | ||
== Syntax == | == Syntax == | ||
| − | <pre class="brush:cpp;gutter:false">HRESULT FindItemByText([in] BSTR | + | <pre class="brush:cpp;gutter:false">HRESULT FindItemByText([in] BSTR sText, |
[in, defaultvalue(0)] LONG nFlags, | [in, defaultvalue(0)] LONG nFlags, | ||
| − | [out, retval] LONG* | + | [out, retval] LONG* nIndex);</pre> |
== Parameters == | == Parameters == | ||
| − | ; | + | ;sText |
:[in] BSTR value of '''text''' to search for. | :[in] BSTR value of '''text''' to search for. | ||
;nFlags | ;nFlags | ||
| − | :[in, defaultvalue(0)] | + | :[in, defaultvalue(0)] Specifies parameters of text search. See [[PXV:UIX_FindItemByTextFlags|UIX_FindItemByTextFlags]] for a full list of available search flags. |
| − | ; | + | ;nIndex |
| − | :[out, retval] Returned value of found item index. Returns -1 if no items with given parameters were found. If there | + | :[out, retval] Returned value of found item index. Returns -1 if no items with given parameters were found. If there is more than one item found, index of the first of them in combo box list will be returned. |
== Return Value == | == Return Value == | ||
| − | Returns S_OK if operation was successful or error code | + | Returns S_OK if the operation was successful, or will return an error code if it fails. |
== See Also == | == See Also == | ||
| − | + | [[PXV:IUIX_Combo|IUIX_Combo]] | |
Latest revision as of 13:05, 15 June 2015
Returns index of an item with a required text.
Syntax
HRESULT FindItemByText([in] BSTR sText,
[in, defaultvalue(0)] LONG nFlags,
[out, retval] LONG* nIndex);
Parameters
- sText
- [in] BSTR value of text to search for.
- nFlags
- [in, defaultvalue(0)] Specifies parameters of text search. See UIX_FindItemByTextFlags for a full list of available search flags.
- nIndex
- [out, retval] Returned value of found item index. Returns -1 if no items with given parameters were found. If there is more than one item found, index of the first of them in combo box list will be returned.
Return Value
Returns S_OK if the operation was successful, or will return an error code if it fails.
