_variant_t CBCGPRibbonBar::GetControlValue	(	UINT	nID,
		VARTYPE	vtPreferredType = VT_UNKNOWN,
		UINT	nFlags = 0
	)

Retrieves the ribbon bar control value (e.g., text of the edit box).

Parameters

nID	Control command ID.
vtPreferredType	The preferred result type.
nFlags	The combination of the following flags: BCGP_CONTROL_VALUE_VISIBLE, BCGP_CONTROL_VALUE_FOCUSED and BCGP_CONTROL_VALUE_RECENT_ACTION.

Call this method to obtain a value of the control bar control. The method returns a value for the first matched control. The parameter "nFlags" specifies the search condition:

• BCGP_CONTROL_VALUE_VISIBLE: the control should be visible.
• BCGP_CONTROL_VALUE_FOCUSED: the control should be focused.
• BCGP_CONTROL_VALUE_RECENT_ACTION: the recent action (e.g., Enter on the edit box) should be performed on the control.