IUIX_Dialog::CheckItem Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
 
(13 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#Methods|CheckItem|method}}
  
The method of interface of PDF-XChange Editor SDK.
+
 
 +
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 pItemID, [in] LONG nNewCheckState, [in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);</pre>
+
<pre class="brush:cpp;gutter:false">HRESULT CheckItem([in]                   BSTR         sItemID,
 +
                  [in]                   LONG         nNewCheckState,
 +
                  [in, defaultvalue(-1)] VARIANT_BOOL bUpdateRadioGroup);</pre>
  
 
== Parameters ==
 
== Parameters ==
;''pItemID''
+
;sItemID
:[in]  Value of BSTR.
+
:[in]  Text ID of an item that is to be checked/unchecked.
;''nNewCheckState''
+
;nNewCheckState
:[in]  Value of LONG.
+
:[in]  Checks an item if set to TRUE, unchecks if set to FALSE.
;''bUpdateRadioGroup''
+
;bUpdateRadioGroup
:[in, defaultvalue(-1)]  Value of VARIANT_BOOL.
+
:[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 19: Line 26:
  
 
== See Also ==
 
== See Also ==
See also [[PXV:IUIX_Dialog|IUIX_Dialog]].
+
[[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.

See Also

IUIX_Dialog