Rutinas de intercambio de datos de cuadros de diálogo estándarStandard Dialog Data Exchange Routines

En este tema se enumeran las rutinas de intercambio de datos de cuadros de diálogo (DDX) estándar utilizadas para los controles de cuadro de diálogo comunes de MFC.This topic lists the standard dialog data exchange (DDX) routines used for common MFC dialog controls.

Nota

Las rutinas de intercambio de datos de cuadros de diálogo estándar se definen en el archivo de encabezado afxdd_. h.The standard dialog data exchange routines are defined in the header file afxdd_.h. Sin embargo, las aplicaciones deben incluir AFXWIN. h.However, applications should include afxwin.h.

Funciones DDXDDX Functions

NombreName DescripciónDescription
DDX_CBIndexDDX_CBIndex Inicializa o recupera el índice de la selección actual de un control de cuadro combinado.Initializes or retrieves the index of the current selection of a combo box control.
DDX_CBStringDDX_CBString Inicializa o recupera el contenido actual del campo de edición de un control de cuadro combinado.Initializes or retrieves the current contents of the edit field of a combo box control.
DDX_CBStringExactDDX_CBStringExact Inicializa o recupera el contenido actual del campo de edición de un control de cuadro combinado.Initializes or retrieves the current contents of the edit field of a combo box control.
DDX_CheckDDX_Check Inicializa o recupera el estado actual de un control de casilla.Initializes or retrieves the current state of a check box control.
DDX_ControlDDX_Control Subclasse un control determinado dentro de un cuadro de diálogo.Subclasses a given control within a dialog box.
DDX_DateTimeCtrlDDX_DateTimeCtrl Inicializa o recupera datos de fecha y hora de un control selector de fecha y hora.Initializes or retrieves date and/or time data of a date and time picker control.
DDX_IPAddressDDX_IPAddress Inicializa o recupera el valor actual de un control de dirección IP.Initializes or retrieves the current value of an IP address control.
DDX_LBIndexDDX_LBIndex Inicializa o recupera el índice de la selección actual de un control de cuadro de lista.Initializes or retrieves the index of the current selection of a list box control.
DDX_LBStringDDX_LBString Inicializa o recupera la selección actual dentro de un control de cuadro de lista.Initializes or retrieves the current selection within a list box control.
DDX_LBStringExactDDX_LBStringExact Inicializa o recupera la selección actual dentro de un control de cuadro de lista.Initializes or retrieves the current selection within a list box control.
DDX_ManagedControlDDX_ManagedControl Crea un control .NET que coincide con el identificador de recurso del control.Creates a .NET control matching the control's resource ID.
DDX_MonthCalCtrlDDX_MonthCalCtrl Inicializa o recupera el valor actual de un control de calendario mensual.Initializes or retrieves the current value of a month calendar control.
DDX_RadioDDX_Radio Inicializa o recupera el índice de base cero del control de radio que está activado actualmente dentro de un grupo de control de radio.Initializes or retrieves the 0-based index of the radio control that is currently checked within a radio control group.
DDX_ScrollDDX_Scroll Inicializa o recupera la posición actual del control de desplazamiento.Initializes or retrieves the current position of a scroll control's thumb.
DDX_SliderDDX_Slider Inicializa o recupera la posición actual del control de un control deslizante.Initializes or retrieves the current position of a slider control's thumb.
DDX_TextDDX_Text Inicializa o recupera el valor actual de un control de edición.Initializes or retrieves the current value of an edit control.

DDX_CBIndexDDX_CBIndex

La DDX_CBIndex función administra la transferencia de int datos entre un control de cuadro combinado en un objeto de cuadro de diálogo, vista de formulario o vista de control y un int miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_CBIndex function manages the transfer of int data between a combo box control in a dialog box, form view, or control view object and a int data member of the dialog box, form view, or control view object.

void AFXAPI DDX_CBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de cuadro combinado asociado a la propiedad de control.The resource ID of the combo box control associated with the control property.

índiceindex
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_CBIndex se llama a, index se establece en el índice de la selección del cuadro combinado actual.When DDX_CBIndex is called, index is set to the index of the current combo box selection. Si no hay ningún elemento seleccionado, el Índice se establece en 0.If no item is selected, index is set to 0.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_CBStringDDX_CBString

La DDX_CBString función administra la transferencia de CString datos entre el control de edición de un control de cuadro combinado en un objeto de cuadro de diálogo, vista de formulario o vista de control y un CString miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_CBString function manages the transfer of CString data between the edit control of a combo box control in a dialog box, form view, or control view object and a CString data member of the dialog box, form view, or control view object.

void AFXAPI DDX_CBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de cuadro combinado asociado a la propiedad de control.The resource ID of the combo box control associated with the control property.

valuevalue
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_CBString se llama a, el valor se establece en la selección del cuadro combinado actual.When DDX_CBString is called, value is set to the current combo box selection. Si no hay ningún elemento seleccionado, el valor se establece en una cadena de longitud cero.If no item is selected, value is set to a string of zero length.

Nota

Si el cuadro combinado es un cuadro de lista desplegable, el valor intercambiado se limita a 255 caracteres.If the combo box is a drop-down list box, the value exchanged is limited to 255 characters.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_CBStringExactDDX_CBStringExact

La DDX_CBStringExact función administra la transferencia de CString datos entre el control de edición de un control de cuadro combinado en un objeto de cuadro de diálogo, vista de formulario o vista de control y un CString miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_CBStringExact function manages the transfer of CString data between the edit control of a combo box control in a dialog box, form view, or control view object and a CString data member of the dialog box, form view, or control view object.

void AFXAPI DDX_CBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de cuadro combinado asociado a la propiedad de control.The resource ID of the combo box control associated with the control property.

valuevalue
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_CBStringExact se llama a, el valor se establece en la selección del cuadro combinado actual.When DDX_CBStringExact is called, value is set to the current combo box selection. Si no hay ningún elemento seleccionado, el valor se establece en una cadena de longitud cero.If no item is selected, value is set to a string of zero length.

Nota

Si el cuadro combinado es un cuadro de lista desplegable, el valor intercambiado se limita a 255 caracteres.If the combo box is a drop-down list box, the value exchanged is limited to 255 characters.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_CheckDDX_Check

La DDX_Check función administra la transferencia de int datos entre un control de casilla en un objeto de cuadro de diálogo, vista de formulario o vista de control y un int miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_Check function manages the transfer of int data between a check box control in a dialog box, form view, or control view object and a int data member of the dialog box, form view, or control view object.

void AFXAPI DDX_Check(
    CDataExchange* pDX,
    int nIDC,
    int& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de casilla asociado a la propiedad de control.The resource ID of the check box control associated with the control property.

valuevalue
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_Check se llama a, el valor se establece en el estado actual del control de casilla.When DDX_Check is called, value is set to the current state of the check box control. Para obtener una lista de los valores de estado posibles, vea BM_GETCHECK en el Windows SDK.For a list of the possible state values, see BM_GETCHECK in the Windows SDK.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_ControlDDX_Control

La DDX_Control función subclase el control, especificado por nIDC, del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_Control function subclasses the control, specified by nIDC, of the dialog box, form view, or control view object.

void AFXAPI DDX_Control(
    CDataExchange* pDX,
    int nIDC,
    CWnd& rControl);

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

nIDCnIDC
IDENTIFICADOR de recurso del control del que se van a crear subclases.The resource ID of the control to be subclassed.

rControlrControl
Referencia a una variable de miembro del objeto de cuadro de diálogo, vista de formulario o vista de control relacionada con el control especificado.A reference to a member variable of the dialog box, form view, or control view object related to the specified control.

ObservacionesRemarks

El marco de trabajo suministra el objeto pDX cuando DoDataExchange se llama a la función.The pDX object is supplied by the framework when the DoDataExchange function is called. Por lo tanto, DDX_Control solo se debe llamar dentro de la invalidación de DoDataExchange .Therefore, DDX_Control should only be called within your override of DoDataExchange.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_DateTimeCtrlDDX_DateTimeCtrl

La DDX_DateTimeCtrl función administra la transferencia de datos de fecha y hora entre un control de selector de fecha y hora ( CDateTimeCtrl) de un cuadro de diálogo o un objeto de vista de formulario y un miembro de datos ctime o COleDateTime del cuadro de diálogo o el objeto de vista de formulario.The DDX_DateTimeCtrl function manages the transfer of date and/or time data between a date and time picker control ( CDateTimeCtrl) in a dialog box or form view object and either a CTime or a COleDateTime data member of the dialog box or form view object.

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    CTime& value);

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction. No es necesario eliminar este objeto.You don't need to delete this object.

nIDCnIDC
IDENTIFICADOR de recurso del control selector de fecha y hora asociado a la variable miembro.The resource ID of the date and time picker control associated with the member variable.

valuevalue
En las dos primeras versiones, una referencia a una CTime COleDateTime variable miembro de o, un cuadro de diálogo, una vista de formulario o un objeto de vista de control con el que se intercambian los datos.In the first two versions, a reference to a CTime or COleDateTime member variable, dialog box, form view, or control view object with which data is exchanged. En la tercera versión, referencia a un CString objeto de vista de control de miembro de datos.In the third version, a reference to a CString data member control view object.

ObservacionesRemarks

Cuando DDX_DateTimeCtrl se llama a, el valor se establece en el estado actual del control selector de fecha y hora, o el control se establece en Value, dependiendo de la dirección del intercambio.When DDX_DateTimeCtrl is called, value is set to the current state of the date and time picker control, or the control is set to value, depending on the direction of the exchange.

En la tercera versión anterior, DDX_DateTimeCtrl administra la transferencia de CString datos entre un control de fecha y hora y un miembro de datos CString del objeto de vista de control.In the third version above, DDX_DateTimeCtrl manages the transfer of CString data between a date time control and a CString data member of the control view object. Se aplica formato a la cadena mediante las reglas de la configuración regional actual para dar formato a las fechas y horas.The string is formatted using the current locale's rules for formatting dates and times.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_ManagedControlDDX_ManagedControl

Crea un control .NET que coincide con el identificador de recurso del control.Creates a .NET control matching the control's resource ID.

SintaxisSyntax

template <typename T>
void DDX_ManagedControl(
   CDataExchange* pDX,
   int nIDC,
   CWinFormsControl<T>& control );

ParámetrosParameters

pDXpDX
Un puntero a un objeto de la clase CDataExchange ( .A pointer to a CDataExchange Class object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control asociado a la propiedad de control.The resource ID of the control associated with the control property.

controlcontrol
Referencia a un objeto de la clase CWinFormsControl .A reference to a CWinFormsControl Class object.

ObservacionesRemarks

DDX_ManagedControl llama a CWinFormsControl:: CreateManagedControl para crear un control que coincida con el identificador de control de recursos.DDX_ManagedControl calls CWinFormsControl::CreateManagedControl to create a control matching the resource control ID. Use DDX_ManagedControl para crear controles a partir de los identificadores de recursos en CDialog:: OnInitDialog.Use DDX_ManagedControl to create controls from resource IDs in CDialog::OnInitDialog. Para el intercambio de datos, no es necesario usar las funciones DDX/DDV con controles de Windows Forms.For data exchange, you do not need to use the DDX/DDV functions with Windows Forms controls.

Para obtener más información, vea Cómo: realizar el enlace de datos DDX/DDV con Windows Forms.For more information, see How to: Do DDX/DDV Data Binding with Windows Forms.

RequisitosRequirements

Encabezado: afxwinforms. hHeader: afxwinforms.h

DDX_IPAddressDDX_IPAddress

La DDX_IPAddress función administra la transferencia de datos entre un control de dirección IP y un miembro de datos del objeto de vista de control.The DDX_IPAddress function manages the transfer of data between an IP Address control and a data member of the control view object.

void AFXAPI DDX_IPAddress(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de dirección IP asociado a la propiedad de control.The resource ID of the IP Address control associated with the control property.

valuevalue
Referencia a la DWORD que contiene el valor de cuatro campos del control de dirección IP.A reference to the DWORD containing the four-field value of the IP Address control. Los campos se rellenan o se leen como se indica a continuación.The fields are filled or read as follows.

CampoField Bits que contiene el valor del campoBits containing the field value
33 de 0 a 70 through 7
22 de 8 a 158 through 15
11 de 16 a 2316 through 23
00 de 24 a 3124 through 31

Use el IPM_GETADDRESS Win32 para leer el valor o utilice IPM_SETADDRESS para rellenar el valor.Use the Win32 IPM_GETADDRESS to read the value, or use IPM_SETADDRESS to fill the value. Estos mensajes se describen en el Windows SDK.These messages are described in the Windows SDK.

ObservacionesRemarks

Cuando DDX_IPAddress se llama a, el valor se lee desde el control de dirección IP o el valor se escribe en el control, en función de la dirección del intercambio.When DDX_IPAddress is called, value is either read from the IP Address control, or value is written to the control, depending on the direction of the exchange.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_LBIndexDDX_LBIndex

La DDX_LBIndex función administra la transferencia de int datos entre un control de cuadro de lista en un objeto de cuadro de diálogo, vista de formulario o vista de control y un int miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_LBIndex function manages the transfer of int data between a list box control in a dialog box, form view, or control view object and an int data member of the dialog box, form view, or control view object.

void AFXAPI DDX_LBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de cuadro de lista asociado a la propiedad de control.The resource ID of the list box control associated with the control property.

índiceindex
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_LBIndex se llama a, index se establece en el índice de la selección del cuadro de lista actual.When DDX_LBIndex is called, index is set to the index of the current list box selection. Si no hay ningún elemento seleccionado, index se establece en-1.If no item is selected, index is set to -1.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_LBStringDDX_LBString

La DDX_LBString función administra la transferencia de CString datos entre un control de cuadro de lista en un objeto de cuadro de diálogo, vista de formulario o vista de control y un CString miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_LBString function manages the transfer of CString data between a list box control in a dialog box, form view, or control view object and a CString data member of the dialog box, form view, or control view object.

void AFXAPI DDX_LBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de cuadro de lista asociado a la propiedad de control.The resource ID of the list box control associated with the control property.

valuevalue
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_LBString se llama a para transferir datos a un control de cuadro de lista, se selecciona el primer elemento del control cuyo valor de inicio coincide.When DDX_LBString is called to transfer data to a list box control, the first item in the control whose beginning matches value is selected. (Para hacer coincidir todo el elemento en lugar de simplemente un prefijo, utilice DDX_LBStringExact). Si no hay ninguna coincidencia, no se selecciona ningún elemento.(To match the entire item rather than just a prefix, use DDX_LBStringExact.) If there are no matches, no items are selected. La coincidencia no distingue entre mayúsculas y minúsculas.The matching is case-insensitive.

Cuando DDX_LBString se llama a para transferir datos de un control de cuadro de lista, el valor se establece en la selección actual del cuadro de lista.When DDX_LBString is called to transfer data from a list box control, value is set to the current list box selection. Si no hay ningún elemento seleccionado, el valor se establece en una cadena de longitud cero.If no item is selected, value is set to a string of zero length.

Nota

Si el cuadro de lista es un cuadro de lista desplegable, el valor intercambiado se limita a 255 caracteres.If the list box is a drop-down list box, the value exchanged is limited to 255 characters.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_LBStringExactDDX_LBStringExact

La DDX_CBStringExact función administra la transferencia de CString datos entre el control de edición de un control de cuadro de lista en un objeto de cuadro de diálogo, vista de formulario o vista de control y un CString miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_CBStringExact function manages the transfer of CString data between the edit control of a list box control in a dialog box, form view, or control view object and a CString data member of the dialog box, form view, or control view object.

void AFXAPI DDX_LBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de cuadro de lista asociado a la propiedad de control.The resource ID of the list box control associated with the control property.

valuevalue
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_LBStringExact se llama a para transferir datos a un control de cuadro de lista, se selecciona el primer elemento del control que coincida con el valor .When DDX_LBStringExact is called to transfer data to a list box control, the first item in the control that matches value is selected. (Para que coincida solo con un prefijo en lugar de con todo el elemento, use DDX_LBString). Si no hay ninguna coincidencia, no se selecciona ningún elemento.(To match just a prefix rather than the entire item, use DDX_LBString.) If there are no matches, no items are selected. La coincidencia no distingue entre mayúsculas y minúsculas.The matching is case-insensitive.

Cuando DDX_CBStringExact se llama a para transferir datos de un control de cuadro de lista, el valor se establece en la selección actual del cuadro de lista.When DDX_CBStringExact is called to transfer data from a list box control, value is set to the current list box selection. Si no hay ningún elemento seleccionado, el valor se establece en una cadena de longitud cero.If no item is selected, value is set to a string of zero length.

Nota

Si el cuadro de lista es un cuadro de lista desplegable, el valor intercambiado se limita a 255 caracteres.If the list box is a drop-down list box, the value exchanged is limited to 255 characters.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_MonthCalCtrlDDX_MonthCalCtrl

La DDX_MonthCalCtrl función administra la transferencia de datos de fecha entre un control de calendario mensual ( CMonthCalCtrl) en un objeto de cuadro de diálogo, vista de formulario o vista de control y un miembro de datos ctime o COleDateTime del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_MonthCalCtrl function manages the transfer of date data between a month calendar control ( CMonthCalCtrl) in a dialog box, form view, or control view object and either a CTime or a COleDateTime data member of the dialog box, form view, or control view object.

void AFXAPI DDX_MonthCalCtrl(
    CDataExchange* pDX,
    int nIDC,
    CTime& value);

void AFXAPI DDX_MonthCalCtrl(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction. No es necesario eliminar este objeto.You don't need to delete this object.

nIDCnIDC
IDENTIFICADOR de recurso del control de calendario mensual asociado a la variable miembro.The resource ID of the month calendar control associated with the member variable.

valuevalue
Referencia a una CTime variable o COleDateTime miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a CTime or COleDateTime member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Nota

El control solo administra un valor de fecha.The control manages a date value only. Los campos de hora del objeto de hora se establecen para reflejar la hora de creación de la ventana de control, o cualquier hora establecida en el control con una llamada a CMonthCalCtrl::SetCurSel .The time fields in the time object are set to reflect the creation time of the control window, or whatever time was set in the control with a call to CMonthCalCtrl::SetCurSel.

Cuando DDX_MonthCalCtrl se llama a, el valor se establece en el estado actual del control de calendario mensual.When DDX_MonthCalCtrl is called, value is set to the current state of the month calendar control.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_RadioDDX_Radio

La DDX_Radio función administra la transferencia de int datos entre un grupo de control de radio en un objeto de cuadro de diálogo, vista de formulario o vista de control y un int miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_Radio function manages the transfer of int data between a radio control group in a dialog box, form view, or control view object and a int data member of the dialog box, form view, or control view object. El valor del int miembro de datos se determina según el botón de radio del grupo seleccionado.The value of the int data member is determined according to which radio button within the group is selected.

void AFXAPI DDX_Radio(
    CDataExchange* pDX,
    int nIDC,
    int& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del primer control de radio del grupo.The resource ID of the first radio control in the group.

valuevalue
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_Radio se llama a, el valor se establece en el estado actual del grupo de control de radio.When DDX_Radio is called, value is set to the current state of the radio control group. El valor se establece como un índice de base cero del control de radio que está activado actualmente, o-1 si no se comprueba ningún control de radio.The value is set as a 0-based index of the radio control that is currently checked, or -1 if no radio controls are checked.

Por ejemplo, en caso de que se compruebe el primer botón de radio del grupo (el botón con el estilo WS_GROUP), el valor del int miembro es 0 y así sucesivamente.For example, in case that the first radio button in the group is checked (the button with WS_GROUP style) the value of the int member is 0 and so on.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_ScrollDDX_Scroll

La DDX_Scroll función administra la transferencia de int datos entre un control de barra de desplazamiento en un objeto de cuadro de diálogo, vista de formulario o vista de control y un int miembro de datos del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_Scroll function manages the transfer of int data between a scroll-bar control in a dialog box, form view, or control view object and an int data member of the dialog box, form view, or control view object.

void AFXAPI DDX_Scroll(
    CDataExchange* pDX,
    int nIDC,
    int& value);

ParámetrosParameters

pDXpDX
Puntero a un objeto CDataExchange .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control de barra de desplazamiento asociado a la propiedad de control.The resource ID of the scroll-bar control associated with the control property.

valuevalue
Referencia a una variable de miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se intercambian los datos.A reference to a member variable of the dialog box, form view or control view object with which data is exchanged.

ObservacionesRemarks

Cuando DDX_Scroll se llama a, el valor se establece en la posición actual del control de posición del control.When DDX_Scroll is called, value is set to the current position of the control's thumb. Para obtener más información sobre los valores asociados a la posición actual del control Thumb del control, vea GetScrollPos en el Windows SDK.For more information on the values associated with the current position of the control's thumb, see GetScrollPos in the Windows SDK.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_SliderDDX_Slider

La DDX_Slider función administra la transferencia de int datos entre un control deslizante de un cuadro de diálogo o una vista de formulario y un int miembro de datos del cuadro de diálogo o el objeto de vista de formulario.The DDX_Slider function manages the transfer of int data between a slider control in a dialog box or form view and an int data member of the dialog box or form view object.

void AFXAPI DDX_Slider(
    CDataExchange* pDX,
    int nIDC,
    int& value);

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de recurso del control deslizante.The resource ID of the slider control.

valuevalue
Referencia al valor que se va a intercambiar.A reference to the value to be exchanged. Este parámetro contiene o establece la posición actual del control deslizante.This parameter holds or sets the slider control's current position.

ObservacionesRemarks

Cuando DDX_Slider se llama a, el valor se establece en la posición actual del control de posición del control o el valor recibe la posición, dependiendo de la dirección del intercambio.When DDX_Slider is called, value is set to the current position of the control's thumb, or the value receives the position, depending on the direction of the exchange.

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation. Para obtener información acerca de los controles deslizantes, vea usar CSliderCtrl.For information about slider controls, see Using CSliderCtrl.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

DDX_TextDDX_Text

La DDX_Text función administra la transferencia de int datos, uint, long , DWORD, CString , float o double entre un control de edición en un cuadro de diálogo, vista de formulario o vista de control y un miembro de datos CString del objeto de cuadro de diálogo, vista de formulario o vista de control.The DDX_Text function manages the transfer of int, UINT, long, DWORD, CString, float, or double data between an edit control in a dialog box, form view, or control view and a CString data member of the dialog box, form view, or control view object.

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    BYTE& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    short& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    int& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    UINT& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    long& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    float& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    double& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    COleCurrency& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
IDENTIFICADOR de un control de edición en el objeto de cuadro de diálogo, vista de formulario o vista de control.The ID of an edit control in the dialog box, form view, or control view object.

valuevalue
Referencia a un miembro de datos en el objeto de cuadro de diálogo, vista de formulario o vista de control.A reference to a data member in the dialog box, form view, or control view object. El tipo de datos del valor depende de las versiones sobrecargadas de DDX_Text que use.The data type of value depends on which of the overloaded versions of DDX_Text you use.

ObservacionesRemarks

Para obtener más información sobre DDX, consulte Intercambio y validación de datos de cuadro de diálogo.For more information about DDX, see Dialog Data Exchange and Validation.

RequisitosRequirements

Encabezado afxdd_. hHeader afxdd_.h

Consulte tambiénSee also

Rutinas de validación de datos de cuadros de diálogo estándarStandard Dialog Data Validation Routines
Macros y variables globalesMacros and Globals
CWinFormsControl::CreateManagedControlCWinFormsControl::CreateManagedControl
CDialog:: OnInitDialogCDialog::OnInitDialog