IUIX_Dialog::CheckItem Method
From PDF XChange PDF SDK
| (8 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] Text ID of an item | + | :[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 25: | Line 26: | ||
== See Also == | == See Also == | ||
| − | + | [[PXV:IUIX_Dialog|IUIX_Dialog]] | |
Latest revision as of 15: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.
