IUIX_Dialog::CheckItem Method
From PDF XChange PDF SDK
m (Automatic page editing by robot) |
|||
(11 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | __NOTOC__ | ||
[[Category:Editor]] | [[Category:Editor]] | ||
{{#customTitle:IUIX_Dialog::CheckItem Method}} | {{#customTitle:IUIX_Dialog::CheckItem Method}} | ||
− | {{#parentPage:PXV:IUIX_Dialog|CheckItem | + | {{#parentPage:PXV:IUIX_Dialog#Methods|CheckItem|method}} |
− | + | ||
− | + | ||
− | + | ||
+ | Changes state of an item in a dialog to '''checked''' or '''unchecked''' by item's text ID. | ||
+ | |||
+ | This method can be applied only to objects of [[PXV:IUIX_Label|IUIX_Label]] interface with [[PXV:UIX_LabelStyleFlags|''radio box'']] or [[PXV:UIX_LabelStyleFlags|''check box'']] flags specified. | ||
== Syntax == | == Syntax == | ||
− | <pre class="brush:cpp;gutter:false">HRESULT CheckItem([in] BSTR | + | <pre class="brush:cpp;gutter:false">HRESULT CheckItem([in] BSTR sItemID, |
[in] LONG nNewCheckState, | [in] LONG nNewCheckState, | ||
[in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);</pre> | [in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);</pre> | ||
== Parameters == | == Parameters == | ||
− | ; | + | ;sItemID |
− | :[in] | + | :[in] Text ID of an item that is to be checked/unchecked. |
;nNewCheckState | ;nNewCheckState | ||
− | :[in] | + | :[in] Checks an item if set to TRUE, unchecks if set to FALSE. |
;bUpdateRadioGroup | ;bUpdateRadioGroup | ||
− | :[in, defaultvalue(-1)] | + | :[in, defaultvalue(-1)] if set to VARIANT_TRUE, updates state of all ''radio boxes'' of the same group unchecking items that were in a '''checked''' state. |
== Return Value == | == Return Value == | ||
Line 24: | Line 26: | ||
== See Also == | == See Also == | ||
− | + | [[PXV:IUIX_Dialog|IUIX_Dialog]] |
Latest revision as of 14:07, 15 June 2015
Changes state of an item in a dialog to checked or unchecked by item's text ID.
This method can be applied only to objects of IUIX_Label interface with radio box or check box flags specified.
Syntax
HRESULT CheckItem([in] BSTR sItemID, [in] LONG nNewCheckState, [in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);
Parameters
- sItemID
- [in] Text ID of an item that is to be checked/unchecked.
- nNewCheckState
- [in] Checks an item if set to TRUE, unchecks if set to FALSE.
- bUpdateRadioGroup
- [in, defaultvalue(-1)] if set to VARIANT_TRUE, updates state of all radio boxes of the same group unchecking items that were in a checked state.
Return Value
Returns S_OK if operation was successful or error code in other cases.