IUIX_Dialog::CheckItem2 Method

From PDF XChange PDF SDK
Jump to: navigation, search


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.

See Also

IUIX_Dialog