Standaarddialoogvenster: routines voor gegevensuitwisseling

In dit onderwerp vindt u de standaarddialoogvenstergegevensuitwisseling (DDX) routines die worden gebruikt voor algemene MFC-dialoogvensterbesturingselementen.

DDX-functies

DDX_CBIndex

De DDX_CBIndex functie beheert de overdracht van int gegevens tussen een besturingselement met invoervak in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een int gegevenslid van het dialoogvenster, formulierweergave of besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het besturingselement keuzelijst met invoervak dat is gekoppeld aan de besturingselementeigenschap.

index
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_CBIndex wordt aangeroepen, index wordt ingesteld op de index van de huidige keuzelijst met invoervak. Als er geen item is geselecteerd, index is ingesteld op 0.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_CBString

De DDX_CBString functie beheert de overdracht van CString gegevens tussen het besturingselement bewerken van een besturingselement met invoervak in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een CString gegevenslid van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het besturingselement keuzelijst met invoervak dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_CBString wordt aangeroepen, value wordt deze ingesteld op de huidige keuzelijst met invoervak. Als er geen item is geselecteerd, value wordt dit ingesteld op een tekenreeks van nullengte.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_CBStringExact

De DDX_CBStringExact functie beheert de overdracht van CString gegevens tussen het besturingselement bewerken van een besturingselement met invoervak in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een CString gegevenslid van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het besturingselement keuzelijst met invoervak dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_CBStringExact wordt aangeroepen, value wordt deze ingesteld op de huidige keuzelijst met invoervak. Als er geen item is geselecteerd, value wordt dit ingesteld op een tekenreeks van nullengte.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_Check

De DDX_Check functie beheert de overdracht van int gegevens tussen een selectievakjebesturingselement in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een int gegevenslid van het dialoogvenster, formulierweergave of besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het selectievakjebesturingselement dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_Check wordt aangeroepen, value wordt ingesteld op de huidige status van het besturingselement voor selectievakjes. Zie de Windows SDK voor een lijst met mogelijke statuswaarden BM_GETCHECK .

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_Control

De DDX_Control functie subklassen van het besturingselement, opgegeven door nIDC, van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

nIDC
De resource-id van het besturingselement dat moet worden subklassen.

rControl
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject dat is gerelateerd aan het opgegeven besturingselement.

Opmerkingen

Het pDX object wordt geleverd door het framework wanneer de DoDataExchange functie wordt aangeroepen. DDX_Control Daarom mag alleen worden aangeroepen binnen uw onderdrukking van DoDataExchange.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_DateTimeCtrl

De DDX_DateTimeCtrl functie beheert de overdracht van datum- en/of tijdgegevens tussen een besturingselement voor datum- en tijdkiezer ( CDateTimeCtrl) in een dialoogvenster of formulierweergaveobject en een CTime of een COleDateTime gegevenslid van het dialoogvenster of formulierweergaveobject.

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);

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting. U hoeft dit object niet te verwijderen.

nIDC
De resource-id van het besturingselement voor datum- en tijdkiezer dat is gekoppeld aan de lidvariabele.

value
In de eerste twee versies, een verwijzing naar een CTime of COleDateTime lidvariabele, dialoogvenster, formulierweergave of besturingselementweergaveobject waarmee gegevens worden uitgewisseld. In de derde versie verwijst u naar een CString weergaveobject voor gegevenslidbeheer.

Opmerkingen

Wanneer DDX_DateTimeCtrl wordt aangeroepen, value wordt ingesteld op de huidige status van het besturingselement voor datum- en tijdkiezer, of het besturingselement is ingesteld valueop , afhankelijk van de richting van de uitwisseling.

In de derde versie hierboven beheert DDX_DateTimeCtrl u de overdracht van CString gegevens tussen een datum/tijd-besturingselement en een CString gegevenslid van het besturingselementweergaveobject. De tekenreeks wordt opgemaakt met behulp van de regels van de huidige landinstelling voor het opmaken van datums en tijden.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_ManagedControl

Hiermee maakt u een .NET-besturingselement dat overeenkomt met de resource-id van het besturingselement.

Syntaxis

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange klasseobject . Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het besturingselement dat is gekoppeld aan de besturingselementeigenschap.

control
Een verwijzing naar een CWinFormsControl klasseobject .

Opmerkingen

DDX_ManagedControl aanroepen CWinFormsControl::CreateManagedControl om een besturingselement te maken dat overeenkomt met de resourcebeheer-id. Hiermee DDX_ManagedControl kunt u besturingselementen maken op basis van resource-id's in CDialog::OnInitDialog. Voor gegevensuitwisseling hoeft u de DDX/DDV-functies niet te gebruiken met Besturingselementen voor Windows Forms.

Zie Procedure: Do DDX/DDV Data Binding with Windows Forms(DDX/DDV-gegevensbinding met Windows Forms) voor meer informatie.

Requirements

Rubriek:afxwinforms.h

DDX_IPAddress

De DDX_IPAddress functie beheert de overdracht van gegevens tussen een IP-adresbeheer en een gegevenslid van het besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het IP-adresbesturingselement dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar de DWORD waarde met vier velden van het IP-adresbesturingselement. De velden worden als volgt ingevuld of gelezen.

Gebruik Win32 IPM_GETADDRESS om de waarde te lezen of om IPM_SETADDRESS de waarde te vullen. Deze berichten worden beschreven in de Windows SDK.

Opmerkingen

Wanneer DDX_IPAddress wordt aangeroepen, value wordt gelezen vanuit het IP-adresbeheer of value naar het besturingselement geschreven, afhankelijk van de richting van de uitwisseling.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_LBIndex

De DDX_LBIndex functie beheert de overdracht van int gegevens tussen een keuzelijstbesturingselement in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een int gegevenslid van het dialoogvenster, formulierweergave of besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het keuzelijstbesturingselement dat is gekoppeld aan de besturingselementeigenschap.

index
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_LBIndex wordt aangeroepen, index wordt ingesteld op de index van de huidige keuzelijstselectie. Als er geen item is geselecteerd, index is ingesteld op -1.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_LBString

De DDX_LBString functie beheert de overdracht van CString gegevens tussen een keuzelijstbesturingselement in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een CString gegevenslid van het dialoogvenster, formulierweergave of besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het keuzelijstbesturingselement dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_LBString wordt aangeroepen om gegevens over te dragen naar een keuzelijst, wordt het eerste item in het besturingselement waarvan de beginovereenkomsten value zijn geselecteerd. (Als u het hele item wilt vergelijken in plaats van alleen een voorvoegsel, gebruikt u DDX_LBStringExact.) Als er geen overeenkomsten zijn, worden er geen items geselecteerd. De overeenkomst is niet hoofdlettergevoelig.

Wanneer DDX_LBString wordt aangeroepen om gegevens over te dragen van een keuzelijst, value wordt deze ingesteld op de huidige keuzelijstselectie. Als er geen item is geselecteerd, value wordt dit ingesteld op een tekenreeks van nullengte.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_LBStringExact

De DDX_CBStringExact functie beheert de overdracht van CString gegevens tussen het besturingselement bewerken van een keuzelijstbesturingselement in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een CString gegevenslid van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het keuzelijstbesturingselement dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_LBStringExact wordt aangeroepen om gegevens over te dragen naar een keuzelijst, wordt het eerste item in het besturingselement geselecteerd.value (Als u alleen een voorvoegsel wilt vergelijken in plaats van het hele item, gebruikt DDX_LBStringu .) Als er geen overeenkomsten zijn, worden er geen items geselecteerd. De overeenkomst is niet hoofdlettergevoelig.

Wanneer DDX_CBStringExact wordt aangeroepen om gegevens over te dragen van een keuzelijst, value wordt deze ingesteld op de huidige keuzelijstselectie. Als er geen item is geselecteerd, value wordt dit ingesteld op een tekenreeks van nullengte.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_MonthCalCtrl

De DDX_MonthCalCtrl functie beheert de overdracht van datumgegevens tussen een maandkalenderbesturingselement ( CMonthCalCtrl) in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een CTime of een COleDateTime gegevenslid van het dialoogvenster, formulierweergave of besturingselementweergaveobject.

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

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting. U hoeft dit object niet te verwijderen.

nIDC
De resource-id van het maandkalenderbeheer dat is gekoppeld aan de lidvariabele.

value
Een verwijzing naar een CTime of COleDateTime lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_MonthCalCtrl wordt aangeroepen, value wordt ingesteld op de huidige status van het kalenderbeheer van de maand.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_Radio

De DDX_Radio functie beheert de overdracht van int gegevens tussen een radiobesturingselementgroep in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een int gegevenslid van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject. De waarde van het int gegevenslid wordt bepaald op basis van welk keuzerondje in de groep is geselecteerd.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het eerste keuzerondje in de groep.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_Radio wordt aangeroepen, value wordt ingesteld op de huidige status van de radiobesturingsgroep. De waarde wordt ingesteld als een index op basis van 0 van het radiobesturingselement dat momenteel is ingeschakeld of -1 als er geen keuzeronden zijn ingeschakeld.

Als het eerste keuzerondje in de groep bijvoorbeeld is ingeschakeld (de knop met WS_GROUP stijl) is de waarde van het int lid 0 enzovoort.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_Scroll

De DDX_Scroll functie beheert de overdracht van int gegevens tussen een schuifbalkbesturingselement in een dialoogvenster, formulierweergave of besturingselementweergaveobject en een int gegevenslid van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het besturingselement schuifbalk dat is gekoppeld aan de besturingselementeigenschap.

value
Een verwijzing naar een lidvariabele van het dialoogvenster, de formulierweergave of het besturingselementweergaveobject waarmee gegevens worden uitgewisseld.

Opmerkingen

Wanneer DDX_Scroll wordt aangeroepen, value wordt ingesteld op de huidige positie van de duim van het besturingselement. Zie de Windows SDK voor meer informatie over de waarden die zijn gekoppeld aan de huidige positie van de duim GetScrollPos van het besturingselement.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

DDX_Slider

De DDX_Slider functie beheert de overdracht van int gegevens tussen een schuifregelaar in een dialoogvenster of formulierweergave en een int gegevenslid van het dialoogvenster of formulierweergaveobject.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De resource-id van het schuifregelaar.

value
Een verwijzing naar de waarde die moet worden uitgewisseld. Deze parameter bevat of stelt de huidige positie van het schuifregelaar in.

Opmerkingen

Wanneer DDX_Slider wordt aangeroepen, value wordt ingesteld op de huidige positie van de duim van het besturingselement, of de waarde ontvangt de positie, afhankelijk van de richting van de uitwisseling.

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX. Zie Using CSliderCtrlvoor meer informatie over schuifregelaars.

Requirements

Headerafxdd_.h

DDX_Text

De DDX_Text functie beheert de overdracht van int, UINT, , long, DWORD, , CString, of doublefloatgegevens tussen een besturingselement bewerken in een dialoogvenster, formulierweergave of besturingselementweergave en een CString gegevenslid van het dialoogvenster, formulierweergave of besturingselementweergaveobject.

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);

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object. Het framework levert dit object om de context van de gegevensuitwisseling vast te stellen, met inbegrip van de richting.

nIDC
De id van een besturingselement bewerken in het dialoogvenster, de formulierweergave of het besturingselementweergaveobject.

value
Een verwijzing naar een gegevenslid in het dialoogvenster, de formulierweergave of het besturingselementweergaveobject. Het gegevenstype is value afhankelijk van welke van de overbelaste versies van DDX_Text u gebruikt.

Opmerkingen

Zie Dialoogvenster gegevensuitwisseling en validatie voor meer informatie over DDX.

Requirements

Headerafxdd_.h

Zie ook

Standaarddialoogvenstergegevensvalidatieroutines
macro's en globalen
CWinFormsControl::CreateManagedControl
CDialog::OnInitDialog