標準對話方塊資料交換常式

發行項
10/12/2023

本主題列出用於一般 MFC 對話控制項的標準對話資料交換（DDX）常式。

注意

標準對話資料交換常式定義于標頭檔中 afxdd_.h 。不過，應用程式應該包含 afxwin.h 。

DDX 函式

名稱	描述
`DDX_CBIndex`	初始化或擷取下拉式方塊控制項目前選取範圍的索引。
`DDX_CBString`	初始化或擷取下拉式方塊控制項編輯欄位的目前內容。
`DDX_CBStringExact`	初始化或擷取下拉式方塊控制項編輯欄位的目前內容。
`DDX_Check`	初始化或擷取核取方塊控制項的目前狀態。
`DDX_Control`	子類別化對話方塊中的指定控制項。
`DDX_DateTimeCtrl`	初始化或擷取日期和時間選擇器控制項的日期和時間和/或時間資料。
`DDX_IPAddress`	初始化或擷取 IP 位址控制項的目前值。
`DDX_LBIndex`	初始化或擷取清單方塊控制項目前選取範圍的索引。
`DDX_LBString`	初始化或擷取清單方塊控制項內的目前選取範圍。
`DDX_LBStringExact`	初始化或擷取清單方塊控制項內的目前選取範圍。
`DDX_ManagedControl`	建立符合控制項資源識別碼的 .NET 控制項。
`DDX_MonthCalCtrl`	初始化或擷取月曆控制項的目前值。
`DDX_Radio`	初始化或擷取目前在無線電控制群組內檢查之無線電控制項的 0 型索引。
`DDX_Scroll`	初始化或擷取滾動控制項拇指的目前位置。
`DDX_Slider`	初始化或擷取滑杆控制項拇指的目前位置。
`DDX_Text`	初始化或擷取編輯控制項的目前值。

`DDX_CBIndex`

函 DDX_CBIndex 式會 int 管理對話方塊、表單檢視或控制項檢視物件中下拉式方塊控制項之間的資料傳輸，以及 int 對話方塊、表單檢視或控制項檢視物件的資料成員。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的下拉式方塊控制項資源識別碼。

index
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫時 DDX_CBIndex ， index 會設定為目前下拉式方塊選取的索引。如果未選取任何專案， index 則會設定為 0。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_CBString`

函 DDX_CBString 式會 CString 管理對話方塊、表單檢視或控制項檢視物件中下拉式方塊控制項的編輯控制項與對話方塊、表單檢視或控制項檢視物件 CString 的資料成員之間的資料傳輸。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的下拉式方塊控制項資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫時 DDX_CBString ， value 會設定為目前的下拉式方塊選取專案。如果未選取任何專案， value 則會設定為長度為零的字串。

注意

如果下拉式方塊是下拉式清單方塊，交換的值限制為 255 個字元。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_CBStringExact`

函 DDX_CBStringExact 式會 CString 管理對話方塊、表單檢視或控制項檢視物件中下拉式方塊控制項的編輯控制項與對話方塊、表單檢視或控制項檢視物件 CString 的資料成員之間的資料傳輸。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的下拉式方塊控制項資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫時 DDX_CBStringExact ， value 會設定為目前的下拉式方塊選取專案。如果未選取任何專案， value 則會設定為長度為零的字串。

注意

如果下拉式方塊是下拉式清單方塊，交換的值限制為 255 個字元。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_Check`

函 DDX_Check 式會 int 管理對話方塊、表單檢視或控制項檢視物件中核取方塊控制項之間的資料傳輸，以及 int 對話方塊、表單檢視或控制項檢視物件的資料成員。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的核取方塊控制項資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫時 DDX_Check ， value 會設定為核取方塊控制項的目前狀態。如需可能的狀態值清單，請參閱 BM_GETCHECK Windows SDK 中的。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_Control`

函 DDX_Control 式會子類別化對話方塊、表單檢視或控制項檢視物件所 nIDC 指定的控制項。

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

參數

pDX
CDataExchange 物件的指標。

nIDC
要子類別化之控制項的資源識別碼。

rControl
與指定控制項相關的對話方塊、表單檢視或控制項檢視物件之成員變數的參考。

備註

呼叫函 pDX 式時 DoDataExchange ，架構會提供物件。因此， DDX_Control 應該只在覆 DoDataExchange 寫內呼叫。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_DateTimeCtrl`

函 DDX_DateTimeCtrl 式會管理對話方塊或表單檢視物件中日期和時間選擇器控制項（ CDateTimeCtrl ）之間的日期和時間資料傳輸，以及 CTime 對話方塊或表單檢視物件的或 COleDateTime 資料成員。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。您不需要刪除此物件。

nIDC
與成員變數相關聯的日期和時間選擇器控制項資源識別碼。

value
在前兩個版本中，或 COleDateTime 成員變數、對話方塊、表單檢視或控制項檢視物件的參考 CTime ，用來交換資料。第三個版本中，資料成員控制項檢視物件的參考 CString 。

備註

呼叫時 DDX_DateTimeCtrl ， value 會設定為日期和時間選擇器控制項的目前狀態，或控制項設定 value 為，視交換的方向而定。

在上述第三個版本中， DDX_DateTimeCtrl 管理 CString 日期時間控制項與 CString 控制項檢視物件之資料成員之間的資料傳輸。字串會使用目前地區設定的規則來格式化日期和時間。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_ManagedControl`

建立符合控制項資源識別碼的 .NET 控制項。

語法

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

參數

pDX
Class 物件的指標。 CDataExchange 架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的控制項資源識別碼。

control
Class 物件的參考。 CWinFormsControl

備註

DDX_ManagedControl 呼叫 CWinFormsControl::CreateManagedControl 以建立符合資源控制項識別碼的控制項。使用 DDX_ManagedControl 從中的 CDialog::OnInitDialog 資源識別碼建立控制項。針對資料交換，您不需要搭配 Windows Forms 控制項使用 DDX/DDV 函式。

如需詳細資訊，請參閱如何：使用 Windows Forms 執行 DDX/DDV 資料系結。

需求

標頭：afxwinforms.h

`DDX_IPAddress`

函 DDX_IPAddress 式會管理 IP 位址控制項與控制項檢視物件之資料成員之間的資料傳輸。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的 IP 位址控制項資源識別碼。

value
的參考， DWORD 包含 IP 位址控制項的四個域值。欄位會填入或讀取，如下所示。

欄位	包含域值的位
3	0 到 7
2	8 到 15
1	16 到 23
0	24 到 31

使用 Win32 IPM_GETADDRESS 讀取值，或使用 IPM_SETADDRESS 來填滿值。這些訊息會在 Windows SDK 中描述。

備註

呼叫時 DDX_IPAddress ， value 會從 IP 位址控制項讀取或 value 寫入控制項，視交換的方向而定。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_LBIndex`

函 DDX_LBIndex 式會 int 管理對話方塊、表單檢視或控制項檢視物件中清單方塊控制項之間的資料傳輸，以及 int 對話方塊、表單檢視或控制項檢視物件的資料成員。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的清單方塊控制項資源識別碼。

index
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫時 DDX_LBIndex ， index 會設定為目前清單方塊選取範圍的索引。如果未選取任何專案， index 則會設定為 -1。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_LBString`

函 DDX_LBString 式會 CString 管理對話方塊、表單檢視或控制項檢視物件中清單方塊控制項之間的資料傳輸，以及 CString 對話方塊、表單檢視或控制項檢視物件的資料成員。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的清單方塊控制項資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫以將資料傳送至清單方塊控制項時 DDX_LBString ，控制項中的第一個專案會選取其開頭相符專案 value 。（若要比對整個專案，而不只是前置詞，請使用 DDX_LBStringExact 。如果沒有相符專案，則不會選取任何專案。比對不區分大小寫。

當呼叫以從清單方塊控制項傳輸資料時 DDX_LBString ， value 會設定為目前的清單方塊選取專案。如果未選取任何專案， value 則會設定為長度為零的字串。

注意

如果清單方塊是下拉式清單方塊，交換的值限制為 255 個字元。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_LBStringExact`

函 DDX_CBStringExact 式會 CString 管理對話方塊、表單檢視或控制項檢視物件中清單方塊控制項的編輯控制項與對話方塊、表單檢視或控制項檢視物件 CString 的資料成員之間的資料傳輸。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的清單方塊控制項資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫以將資料傳送至清單方塊控制項時 DDX_LBStringExact ，會選取符合 value 的控制項中的第一個專案。（若只要比對前置詞而非整個專案，請使用 DDX_LBString 。）如果沒有相符專案，則不會選取任何專案。比對不區分大小寫。

當呼叫以從清單方塊控制項傳輸資料時 DDX_CBStringExact ， value 會設定為目前的清單方塊選取專案。如果未選取任何專案， value 則會設定為長度為零的字串。

注意

如果清單方塊是下拉式清單方塊，交換的值限制為 255 個字元。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_MonthCalCtrl`

函 DDX_MonthCalCtrl 式會管理對話方塊、表單檢視或控制項檢視物件中月曆控制項（ CMonthCalCtrl ）之間的日期資料傳輸，以及 CTime 對話方塊、表單檢視或控制項檢視物件的或 COleDateTime 資料成員。

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

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。您不需要刪除此物件。

nIDC
與成員變數相關聯的月曆控制項資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件的或 COleDateTime 成員變數參考 CTime ，其中會交換資料。

備註

注意

控制項只會管理日期值。時間物件中的時間欄位會設定為反映控制項視窗的建立時間，或控制項中設定了呼叫 CMonthCalCtrl::SetCurSel 的任何時間。

呼叫時 DDX_MonthCalCtrl ， value 會設定為月曆控制項的目前狀態。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_Radio`

函 DDX_Radio 式會 int 管理對話方塊、表單檢視或控制項檢視物件中的單選控制項群組與對話方塊、表單檢視或控制項檢視物件 int 的資料成員之間的資料傳輸。資料成員的值 int 取決於選取群組內的選項按鈕。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
群組中第一個無線電控制項的資源識別碼。

value
對話方塊、表單檢視或控制項檢視物件之成員變數的參考，用來交換資料。

備註

呼叫時 DDX_Radio ， value 會設定為無線電控制群組的目前狀態。值會設定為目前已檢查之無線電控制項的 0 型索引，如果未檢查任何無線電控制項，則為 -1。

例如，如果已核取群組中的第一個選項按鈕（具有WS_GROUP樣式的 int 按鈕），則成員的值是 0 等等。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_Scroll`

函 DDX_Scroll 式會 int 管理對話方塊、表單檢視或控制項檢視物件中捲軸控制項之間的資料傳輸，以及 int 對話方塊、表單檢視或控制項檢視物件的資料成員。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
與控制項屬性相關聯的捲軸控制項資源識別碼。

value
用來交換資料之對話方塊、表單檢視或控制項檢視物件的成員變數參考。

備註

呼叫時 DDX_Scroll ， value 會設定為控制項拇指的目前位置。如需與控制項拇指目前位置相關聯之值的詳細資訊，請參閱 GetScrollPos Windows SDK。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

`DDX_Slider`

函 DDX_Slider 式會 int 管理對話方塊或表單檢視中滑杆控制項與對話方塊或表單檢視 int 物件之資料成員之間的資料傳輸。

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
滑杆控制項的資源識別碼。

value
要交換之值的參考。此參數會保留或設定滑杆控制項的目前位置。

備註

呼叫時 DDX_Slider ， value 會設定為控制項拇指的目前位置，或值會根據交換的方向接收位置。

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。如需滑杆控制項的相關資訊，請參閱使用 CSliderCtrl 。

需求

頁首afxdd_.h

`DDX_Text`

函 DDX_Text 式會管理對話方塊、 doublefloatCStringlongDWORD 表單檢視或控制項檢視中編輯控制項與對話方塊、表單檢視或控制項檢視 CString 物件之資料成員之間的、 UINT 或資料之間的傳輸。 int

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

參數

pDX
CDataExchange 物件的指標。架構會提供此物件來建立資料交換的內容，包括其方向。

nIDC
對話方塊、表單檢視或控制項檢視物件中編輯控制項的識別碼。

value
對話方塊、表單檢視或控制項檢視物件中資料成員的參考。的 value 資料類型取決於您所使用的多載版本 DDX_Text 。

備註

如需有關 DDX 的詳細資訊，請參閱對話方塊資料交換和驗證。

需求

頁首afxdd_.h

另請參閱

標準對話方塊資料驗證常式
 宏和全域
 CWinFormsControl::CreateManagedControl
CDialog::OnInitDialog

共用方式為

標準對話方塊資料交換常式

DDX 函式

DDX_CBIndex

參數

備註

需求

DDX_CBString

參數

備註

需求

DDX_CBStringExact

參數

備註

需求

DDX_Check

參數

備註

需求

DDX_Control

參數

備註

需求

DDX_DateTimeCtrl

參數

備註

需求

DDX_ManagedControl

語法

參數

備註

需求

DDX_IPAddress

參數

備註

需求

DDX_LBIndex

參數

備註

需求

DDX_LBString

參數

備註

需求

DDX_LBStringExact

參數

備註

需求

DDX_MonthCalCtrl

參數

備註

需求

DDX_Radio

參數

備註

需求

DDX_Scroll

參數

備註

需求

DDX_Slider

參數

備註

需求

DDX_Text

參數

備註

需求

另請參閱

意見反應

意見反應

其他資源

`DDX_CBIndex`

`DDX_CBString`

`DDX_CBStringExact`

`DDX_Check`

`DDX_Control`

`DDX_DateTimeCtrl`

`DDX_ManagedControl`

`DDX_IPAddress`

`DDX_LBIndex`

`DDX_LBString`

`DDX_LBStringExact`

`DDX_MonthCalCtrl`

`DDX_Radio`

`DDX_Scroll`

`DDX_Slider`

`DDX_Text`