IUIX_Dialog::CheckItem2 Method
From PDF XChange PDF SDK
m (Automatic page editing by robot) |
|||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | __NOTOC__ | ||
[[Category:Editor]] | [[Category:Editor]] | ||
{{#customTitle:IUIX_Dialog::CheckItem2 Method}} | {{#customTitle:IUIX_Dialog::CheckItem2 Method}} | ||
| − | {{#parentPage:PXV:IUIX_Dialog|method | + | {{#parentPage:PXV:IUIX_Dialog#Methods|CheckItem2|method}} |
| − | + | ||
| − | + | ||
| − | + | ||
| + | Changes state of an item in a dialog to '''checked''' or '''unchecked''' by item's numerical 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 CheckItem2([in] LONG nItemID, [in] LONG nNewCheckState, [in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);</pre> | + | <pre class="brush:cpp;gutter:false">HRESULT CheckItem2([in] LONG nItemID, |
| + | [in] LONG nNewCheckState, | ||
| + | [in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);</pre> | ||
== Parameters == | == Parameters == | ||
| − | ; | + | ;nItemID |
| − | :[in] | + | :[in] numerical ID of an item that is to be checked/unchecked. |
| − | ; | + | ;nNewCheckState |
| − | :[in] | + | :[in] Checks an item if set to TRUE, unchecks if set to FALSE. |
| − | ; | + | ;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 == | ||
| − | 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_Dialog|IUIX_Dialog]] | |
Latest revision as of 15:08, 15 June 2015
Changes state of an item in a dialog to checked or unchecked by item's numerical ID.
This method can be applied only to objects of IUIX_Label interface with radio box or check box flags specified.
Syntax
HRESULT CheckItem2([in] LONG nItemID,
[in] LONG nNewCheckState,
[in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);
Parameters
- nItemID
- [in] numerical 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 the operation was successful, or will return an error code if it fails.
