Standard Dialog Data Exchange-rutiner

I det här avsnittet visas de standardrutiner för dialogdatautbyte (DDX) som används för vanliga MFC-dialogkontroller.

DDX-funktioner

DDX_CBIndex

Funktionen DDX_CBIndex hanterar överföringen av int data mellan en kombinationsrutekontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en int datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för kombinationsrutekontrollen som är associerad med kontrollegenskapen.

index
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_CBIndex anropas index anges till indexet för den aktuella kombinationsrutemarkeringen. Om inget objekt har markerats index anges det till 0.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_CBString

Funktionen DDX_CBString hanterar överföringen av CString data mellan redigeringskontrollen för en kombinationsrutekontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en CString datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för kombinationsrutekontrollen som är associerad med kontrollegenskapen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_CBString anropas value anges den aktuella kombinationsrutans val. Om inget objekt har valts value anges till en sträng med noll längd.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_CBStringExact

Funktionen DDX_CBStringExact hanterar överföringen av CString data mellan redigeringskontrollen för en kombinationsrutekontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en CString datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för kombinationsrutekontrollen som är associerad med kontrollegenskapen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_CBStringExact anropas value anges den aktuella kombinationsrutans val. Om inget objekt har valts value anges till en sträng med noll längd.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_Check

Funktionen DDX_Check hanterar överföringen av int data mellan en kryssruta i en dialogruta, formulärvy eller kontrollvyobjekt och en int datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för den kryssrutekontroll som är associerad med kontrollegenskapen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_Check anropas value anges den aktuella statusen för kryssrutan. En lista över möjliga tillståndsvärden BM_GETCHECK finns i Windows SDK.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_Control

Funktionen DDX_Control underklassar kontrollen, som anges av nIDC, i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt.

nIDC
Resurs-ID för kontrollen som ska underklasseras.

rControl
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som är relaterat till den angivna kontrollen.

Anmärkningar

Objektet pDX tillhandahålls av ramverket när DoDataExchange funktionen anropas. DDX_Control Därför bör endast anropas inom åsidosättningen av DoDataExchange.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_DateTimeCtrl

Funktionen DDX_DateTimeCtrl hanterar överföringen av datum- och/eller tidsdata mellan en datum- och tidskontroll ( CDateTimeCtrl) i en dialogruta eller formulärvyobjekt och antingen en CTime eller en COleDateTime datamedlem i dialogrutan eller formulärvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning. Du behöver inte ta bort det här objektet.

nIDC
Resurs-ID för den datum- och tidsväljare som är associerad med medlemsvariabeln.

value
I de två första versionerna, en referens till en CTime variabel eller COleDateTime medlemsvariabel, dialogruta, formulärvy eller kontrollvyobjekt som data utbyts med. I den tredje versionen, en referens till ett CString objekt för datamedlemskontrollvyn.

Anmärkningar

När DDX_DateTimeCtrl anropas value anges till aktuellt tillstånd för datum- och tidsväljarens kontroll, eller så är kontrollen inställd valuepå , beroende på bytets riktning.

I den tredje versionen ovan DDX_DateTimeCtrl hanterar du överföringen av CString data mellan en datumtidskontroll och en CString datamedlem i kontrollvyobjektet. Strängen formateras med hjälp av de aktuella språkens regler för formatering av datum och tider.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_ManagedControl

Skapar en .NET-kontroll som matchar kontrollens resurs-ID.

Syntax

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

Parameterar

pDX
En pekare till ett CDataExchange klassobjekt . Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID:t för kontrollen som är associerad med kontrollegenskapen.

control
En referens till ett CWinFormsControl klassobjekt .

Anmärkningar

DDX_ManagedControl anropar CWinFormsControl::CreateManagedControl för att skapa en kontroll som matchar resurskontroll-ID:t. Använd DDX_ManagedControl för att skapa kontroller från resurs-ID:t i CDialog::OnInitDialog. För datautbyte behöver du inte använda DDX/DDV-funktionerna med Windows Forms-kontroller.

Mer information finns i How to: Do DDX/DDV Data Binding with Windows Forms (Gör DDX/DDV-databindning med Windows-formulär).

Kravspecifikation

Rubrik:afxwinforms.h

DDX_IPAddress

Funktionen DDX_IPAddress hanterar överföringen av data mellan en IP-adresskontroll och en datamedlem i kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för DEN IP-adresskontroll som är associerad med kontrollegenskapen.

value
En referens till det DWORD som innehåller värdet med fyra fält för IP-adresskontrollen. Fälten fylls i eller läss på följande sätt.

Använd Win32 IPM_GETADDRESS för att läsa värdet eller använd IPM_SETADDRESS för att fylla i värdet. Dessa meddelanden beskrivs i Windows SDK.

Anmärkningar

När DDX_IPAddress anropas, value antingen läss från IP-adresskontrollen eller value skrivs till kontrollen, beroende på riktningen för utbytet.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_LBIndex

Funktionen DDX_LBIndex hanterar överföringen av int data mellan en listrutekontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en int datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för listrutekontrollen som är associerad med kontrollegenskapen.

index
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_LBIndex anropas index anges till indexet för den aktuella listrutemarkeringen. Om inget objekt har valts index anges det till -1.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_LBString

Funktionen DDX_LBString hanterar överföringen av CString data mellan en listrutekontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en CString datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för listrutekontrollen som är associerad med kontrollegenskapen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_LBString anropas för att överföra data till en listrutekontroll är det första objektet i kontrollen vars startmatchningar value har valts. (Om du vill matcha hela objektet i stället för bara ett prefix använder du DDX_LBStringExact.) Om det inte finns några matchningar markeras inga objekt. Matchningen är skiftlägeskänslig.

När DDX_LBString anropas för att överföra data från en listrutekontroll value anges till den aktuella listrutemarkeringen. Om inget objekt har valts value anges till en sträng med noll längd.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_LBStringExact

Funktionen DDX_CBStringExact hanterar överföringen av CString data mellan redigeringskontrollen för en listrutekontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en CString datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för listrutekontrollen som är associerad med kontrollegenskapen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_LBStringExact anropas för att överföra data till en listrutekontroll väljs det första objektet i kontrollen som matchar value . (Om du bara vill matcha ett prefix i stället för hela objektet använder du DDX_LBString.) Om det inte finns några matchningar markeras inga objekt. Matchningen är skiftlägeskänslig.

När DDX_CBStringExact anropas för att överföra data från en listrutekontroll value anges till den aktuella listrutemarkeringen. Om inget objekt har valts value anges till en sträng med noll längd.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_MonthCalCtrl

Funktionen DDX_MonthCalCtrl hanterar överföringen av datumdata mellan en månads kalenderkontroll ( CMonthCalCtrl) i en dialogruta, formulärvy eller kontrollvyobjekt och antingen en CTime eller en COleDateTime datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning. Du behöver inte ta bort det här objektet.

nIDC
Resurs-ID för månadskalenderkontrollen som är associerad med medlemsvariabeln.

value
En referens till en CTime eller COleDateTime en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_MonthCalCtrl anropas value anges till det aktuella tillståndet för månadskalenderkontrollen.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_Radio

Funktionen DDX_Radio hanterar överföringen av int data mellan en radiokontrollgrupp i en dialogruta, formulärvy eller kontrollvyobjekt och en int datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet. Värdet för int datamedlemmen bestäms enligt vilken alternativknapp i gruppen som väljs.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för den första radiokontrollen i gruppen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_Radio anropas value är inställt på radiokontrollgruppens aktuella tillstånd. Värdet anges som ett 0-baserat index för den radiokontroll som för närvarande är markerad, eller -1 om inga radiokontroller kontrolleras.

Om till exempel den första alternativknappen i gruppen är markerad (knappen med WS_GROUP formatmall) är värdet int för medlemmen 0 och så vidare.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_Scroll

Funktionen DDX_Scroll hanterar överföringen av int data mellan en rullningslistkontroll i en dialogruta, formulärvy eller kontrollvyobjekt och en int datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Resurs-ID för rullningslistkontrollen som är associerad med kontrollegenskapen.

value
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data utbyts med.

Anmärkningar

När DDX_Scroll anropas value anges den aktuella positionen för kontrollens tumme. Mer information om de värden som är associerade med den aktuella positionen för kontrollens tumme GetScrollPos finns i Windows SDK.

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

DDX_Slider

Funktionen DDX_Slider hanterar överföringen av int data mellan en skjutreglagekontroll i en dialogruta eller formulärvy och en int datamedlem i dialogrutan eller formulärvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
Skjutreglagets resurs-ID.

value
En referens till det värde som ska bytas ut. Den här parametern innehåller eller anger skjutreglagets aktuella position.

Anmärkningar

När DDX_Slider anropas value anges den aktuella positionen för kontrollens tumme, eller så tar värdet emot positionen, beroende på bytets riktning.

Mer information om DDX finns i Dialog datautbyte och validering. Information om skjutreglagekontroller finns i Använda CSliderCtrl.

Kravspecifikation

Huvudetafxdd_.h

DDX_Text

Funktionen DDX_Text hanterar överföringen av int, UINT, long, DWORD, CString, floateller double data mellan en redigeringskontroll i en dialogruta, formulärvy eller kontrollvy och en CString datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet.

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

Parameterar

pDX
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

nIDC
ID för en redigeringskontroll i dialogrutan, formulärvyn eller kontrollvyobjektet.

value
En referens till en datamedlem i dialogrutan, formulärvyn eller kontrollvyobjektet. Datatypen value beror på vilken av de överlagrade versionerna av DDX_Text du använder.

Anmärkningar

Mer information om DDX finns i Dialog datautbyte och validering.

Kravspecifikation

Huvudetafxdd_.h

Se även

Valideringsrutiner för standarddialogdata
Makro och globala variabler
CWinFormsControl::CreateManagedControl
CDialog::OnInitDialog