DDX_FieldRadio

The DDX_FieldRadio function associates a zero-based int member variable of a record view's recordset with the currently selected radio button in a group of radio buttons in the record view.

void AFXAPI DDX_FieldRadio(
   CDataExchange* pDX,
   int nIDC,
   int& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldRadio(
   CDataExchange* pDX,
   int nIDC,
   int& value,
   CDaoRecordset* pRecordset 
);

Parameters

  • pDX
    A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.

  • nIDC
    The ID of the first in a group (with style WS_GROUP) of adjacent radio button controls in the CRecordView or CDaoRecordView object.

  • value
    A reference to a field data member in the associated CRecordset or CDaoRecordset object.

  • pRecordset
    A pointer to the CRecordset or CDaoRecordset object with which data is exchanged.

Remarks

When transferring from the recordset field to the view, this function turns on the nth radio button (zero-based) and turns off the other buttons. In the reverse direction, this function sets the recordset field to the ordinal number of the radio button that is currently on (checked). On a transfer from the recordset to the control, if the recordset field is Null, no button is selected. On a transfer from control to recordset, if no control is selected, the recordset field is set to Null if the field permits that.

Use the first version if you are working with the ODBC-based classes. Use the second version if you are working with the DAO-based classes.

For more information about DDX, see Dialog Data Exchange and Validation. For examples and more information about DDX for CRecordView and CDaoRecordView fields, see the article Record Views.

Example

See DDX_FieldText for a general DDX_Field example. Calls to DDX_FieldRadio would be similar.

Requirements

Header: afxdao.h

See Also

Reference

DDX_FieldText

DDX_FieldLBString

DDX_FieldLBStringExact

DDX_FieldCBString

DDX_FieldCBStringExact

DDX_FieldCBIndex

DDX_FieldLBIndex

DDX_FieldScroll

Concepts

MFC Macros and Globals