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

發行項
07/05/2024

本主題列出用於一般 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式會管理對話框、doubleDWORDlongfloatCString窗體檢視或控件檢視中編輯控件與對話框、窗體檢視或控件檢視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`