표준 대화 상자 데이터 교환 루틴Standard Dialog Data Exchange Routines

이 항목에서는 일반적인 MFC 대화 상자 컨트롤에 사용 되는 표준 DDX (대화 상자 데이터 교환) 루틴을 나열 합니다.This topic lists the standard dialog data exchange (DDX) routines used for common MFC dialog controls.

참고

표준 대화 상자 데이터 교환 루틴은 헤더 파일 afxdd_에 정의 되어 있습니다.The standard dialog data exchange routines are defined in the header file afxdd_.h. 그러나 응용 프로그램은 afxwin.h를 포함 해야 합니다.However, applications should include afxwin.h.

DDX 함수DDX Functions

NameName 설명Description
DDX_CBIndexDDX_CBIndex 현재 선택 된 콤보 상자 컨트롤의 인덱스를 초기화 하거나 검색 합니다.Initializes or retrieves the index of the current selection of a combo box control.
DDX_CBStringDDX_CBString 콤보 상자 컨트롤의 편집 필드 현재 내용을 초기화 하거나 검색 합니다.Initializes or retrieves the current contents of the edit field of a combo box control.
DDX_CBStringExactDDX_CBStringExact 콤보 상자 컨트롤의 편집 필드 현재 내용을 초기화 하거나 검색 합니다.Initializes or retrieves the current contents of the edit field of a combo box control.
DDX_CheckDDX_Check 확인란 컨트롤의 현재 상태를 초기화 하거나 검색 합니다.Initializes or retrieves the current state of a check box control.
DDX_ControlDDX_Control 대화 상자 내에서 지정 된 컨트롤을 서브 클래스 합니다.Subclasses a given control within a dialog box.
DDX_DateTimeCtrlDDX_DateTimeCtrl 날짜 및 시간 선택 컨트롤의 날짜 및/또는 시간 데이터를 초기화 하거나 검색 합니다.Initializes or retrieves date and/or time data of a date and time picker control.
DDX_IPAddressDDX_IPAddress IP 주소 컨트롤의 현재 값을 초기화 하거나 검색 합니다.Initializes or retrieves the current value of an IP address control.
DDX_LBIndexDDX_LBIndex 목록 상자 컨트롤의 현재 선택 영역에 대 한 인덱스를 초기화 하거나 검색 합니다.Initializes or retrieves the index of the current selection of a list box control.
DDX_LBStringDDX_LBString 목록 상자 컨트롤에서 현재 선택 영역을 초기화 하거나 검색 합니다.Initializes or retrieves the current selection within a list box control.
DDX_LBStringExactDDX_LBStringExact 목록 상자 컨트롤에서 현재 선택 영역을 초기화 하거나 검색 합니다.Initializes or retrieves the current selection within a list box control.
DDX_ManagedControlDDX_ManagedControl 컨트롤의 리소스 ID와 일치 하는 .NET 컨트롤을 만듭니다.Creates a .NET control matching the control's resource ID.
DDX_MonthCalCtrlDDX_MonthCalCtrl Month calendar 컨트롤의 현재 값을 초기화 하거나 검색 합니다.Initializes or retrieves the current value of a month calendar control.
DDX_RadioDDX_Radio 라디오 컨트롤 그룹 내에서 현재 확인 된 라디오 컨트롤의 인덱스 (0부터 사용)를 초기화 하거나 검색 합니다.Initializes or retrieves the 0-based index of the radio control that is currently checked within a radio control group.
DDX_ScrollDDX_Scroll Scroll 컨트롤의 thumb의 현재 위치를 초기화 하거나 검색 합니다.Initializes or retrieves the current position of a scroll control's thumb.
DDX_SliderDDX_Slider 슬라이더 컨트롤 엄지 단추의 현재 위치를 초기화 하거나 검색 합니다.Initializes or retrieves the current position of a slider control's thumb.
DDX_TextDDX_Text 편집 컨트롤의 현재 값을 초기화 하거나 검색 합니다.Initializes or retrieves the current value of an edit control.

DDX_CBIndexDDX_CBIndex

함수는 대화 DDX_CBIndex int 상자, 폼 뷰 또는 컨트롤 뷰 개체의 콤보 상자 컨트롤과 int 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 콤보 상자 컨트롤의 리소스 ID입니다.The resource ID of the combo box control associated with the control property.

indexindex
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_CBIndex가 호출 되 면 인덱스 는 현재 콤보 상자 선택 항목의 인덱스로 설정 됩니다.When DDX_CBIndex is called, index is set to the index of the current combo box selection. 항목을 선택 하지 않으면 인덱스 는 0으로 설정 됩니다.If no item is selected, index is set to 0.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_CBStringDDX_CBString

함수는 대화 상자, DDX_CBString CString 폼 뷰 또는 컨트롤 뷰 개체의 콤보 상자 컨트롤의 편집 컨트롤과 CString 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 콤보 상자 컨트롤의 리소스 ID입니다.The resource ID of the combo box control associated with the control property.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_CBString가 호출 되 면 이 현재 콤보 상자 선택 항목으로 설정 됩니다.When DDX_CBString is called, value is set to the current combo box selection. 항목을 선택 하지 않으면 이 길이가 0 인 문자열로 설정 됩니다.If no item is selected, value is set to a string of zero length.

참고

콤보 상자가 드롭다운 목록 상자 이면 교환 되는 값은 255 자로 제한 됩니다.If the combo box is a drop-down list box, the value exchanged is limited to 255 characters.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_CBStringExactDDX_CBStringExact

함수는 대화 상자, DDX_CBStringExact CString 폼 뷰 또는 컨트롤 뷰 개체의 콤보 상자 컨트롤의 편집 컨트롤과 CString 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 콤보 상자 컨트롤의 리소스 ID입니다.The resource ID of the combo box control associated with the control property.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_CBStringExact가 호출 되 면 이 현재 콤보 상자 선택 항목으로 설정 됩니다.When DDX_CBStringExact is called, value is set to the current combo box selection. 항목을 선택 하지 않으면 이 길이가 0 인 문자열로 설정 됩니다.If no item is selected, value is set to a string of zero length.

참고

콤보 상자가 드롭다운 목록 상자 이면 교환 되는 값은 255 자로 제한 됩니다.If the combo box is a drop-down list box, the value exchanged is limited to 255 characters.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_CheckDDX_Check

함수는 대화 DDX_Check int 상자, 폼 뷰 또는 컨트롤 뷰 개체의 확인란 컨트롤과 int 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 확인란 컨트롤의 리소스 ID입니다.The resource ID of the check box control associated with the control property.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_Check가 호출 되 면 이 확인란 컨트롤의 현재 상태로 설정 됩니다.When DDX_Check is called, value is set to the current state of the check box control. 가능한 상태 값 목록은 Windows SDK에서 BM_GETCHECK 을 참조 하세요.For a list of the possible state values, see BM_GETCHECK in the Windows SDK.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_ControlDDX_Control

DDX_Control함수는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 nidc에 의해 지정 된 컨트롤을 하위 클래스로 지정 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

nIDCnIDC
서브클래싱된 컨트롤의 리소스 ID입니다.The resource ID of the control to be subclassed.

rControlrControl
지정 된 컨트롤과 관련 된 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object related to the specified control.

설명Remarks

PDX 개체는 함수가 호출 될 때 프레임 워크에서 제공 됩니다 DoDataExchange .The pDX object is supplied by the framework when the DoDataExchange function is called. 따라서는 DDX_Control 재정의 내에서 호출 해야 합니다 DoDataExchange .Therefore, DDX_Control should only be called within your override of DoDataExchange.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_DateTimeCtrlDDX_DateTimeCtrl

DDX_DateTimeCtrl함수는 대화 상자 또는 폼 뷰 개체의 날짜 및 시간 선택 컨트롤 ( CDateTimeCtrl)과 대화 상자 또는 폼 뷰 개체의 CTime 또는 COleDateTime 데이터 멤버 간에 날짜 및/또는 시간 데이터의 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction. 이 개체를 삭제할 필요는 없습니다.You don't need to delete this object.

nIDCnIDC
멤버 변수와 연결 된 날짜 및 시간 선택 컨트롤의 리소스 ID입니다.The resource ID of the date and time picker control associated with the member variable.

valuevalue
처음 두 버전에서는 데이터를 교환 하는 CTime 또는 COleDateTime 멤버 변수, 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체에 대 한 참조입니다.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. 세 번째 버전에서 CString 데이터 멤버 컨트롤 뷰 개체에 대 한 참조입니다.In the third version, a reference to a CString data member control view object.

설명Remarks

DDX_DateTimeCtrl가 호출 되 면 이 날짜 및 시간 선택 컨트롤의 현재 상태로 설정 되거나 exchange의 방향에 따라 컨트롤이 으로 설정 됩니다.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.

위의 세 번째 버전에서는 DDX_DateTimeCtrl CString 컨트롤 뷰 개체의 날짜/시간 컨트롤과 CString 데이터 멤버 간의 데이터 전송을 관리 합니다.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. 문자열은 날짜 및 시간 형식을 지정 하기 위해 현재 로캘의 규칙을 사용 하 여 형식이 지정 됩니다.The string is formatted using the current locale's rules for formatting dates and times.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_ManagedControlDDX_ManagedControl

컨트롤의 리소스 ID와 일치 하는 .NET 컨트롤을 만듭니다.Creates a .NET control matching the control's resource ID.

구문Syntax

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

매개 변수Parameters

pDXpDX
CDataExchange 클래스 개체에 대 한 포인터입니다.A pointer to a CDataExchange Class object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 컨트롤의 리소스 ID입니다.The resource ID of the control associated with the control property.

controlcontrol
CWinFormsControl 클래스 개체에 대 한 참조입니다.A reference to a CWinFormsControl Class object.

설명Remarks

DDX_ManagedControlCWinFormsControl:: CreateManagedControl 를 호출 하 여 리소스 컨트롤 ID와 일치 하는 컨트롤을 만듭니다.DDX_ManagedControl calls CWinFormsControl::CreateManagedControl to create a control matching the resource control ID. DDX_ManagedControl을 사용 하 여 CDialog:: OnInitDialog의 리소스 id에서 컨트롤을 만듭니다.Use DDX_ManagedControl to create controls from resource IDs in CDialog::OnInitDialog. 데이터 교환의 경우 Windows Forms 컨트롤에서 DDX/DDV 함수를 사용할 필요가 없습니다.For data exchange, you do not need to use the DDX/DDV functions with Windows Forms controls.

자세한 내용은 방법: Windows Forms를 사용 하 여 DDX/DDV 데이터 바인딩 수행을 참조 하세요.For more information, see How to: Do DDX/DDV Data Binding with Windows Forms.

요구 사항Requirements

헤더: afxwinformsHeader: afxwinforms.h

DDX_IPAddressDDX_IPAddress

DDX_IPAddress함수는 IP 주소 컨트롤과 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성에 연결 된 IP 주소 컨트롤의 리소스 ID입니다.The resource ID of the IP Address control associated with the control property.

valuevalue
IP 주소 컨트롤의 네 필드 값을 포함 하는 DWORD에 대 한 참조입니다.A reference to the DWORD containing the four-field value of the IP Address control. 필드는 다음과 같이 채우거 나 읽습니다.The fields are filled or read as follows.

필드Field 필드 값을 포함 하는 비트Bits containing the field value
33 0-70 through 7
22 8-158 through 15
11 16-2316 through 23
00 24 ~ 3124 through 31

Win32 IPM_GETADDRESS 를 사용 하 여 값을 읽거나 IPM_SETADDRESS 를 사용 하 여 값을 채웁니다.Use the Win32 IPM_GETADDRESS to read the value, or use IPM_SETADDRESS to fill the value. 이러한 메시지는 Windows SDK에 설명 되어 있습니다.These messages are described in the Windows SDK.

설명Remarks

DDX_IPAddress가 호출 되 면 IP 주소 컨트롤에서 을 읽거나 exchange의 방향에 따라 을 컨트롤에 씁니다.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.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_LBIndexDDX_LBIndex

함수는 대화 DDX_LBIndex int 상자, 폼 뷰 또는 컨트롤 뷰 개체의 목록 상자 컨트롤과 int 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 목록 상자 컨트롤의 리소스 ID입니다.The resource ID of the list box control associated with the control property.

indexindex
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_LBIndex가 호출 되 면 인덱스 는 현재 목록 상자 선택 항목의 인덱스로 설정 됩니다.When DDX_LBIndex is called, index is set to the index of the current list box selection. 항목을 선택 하지 않으면 인덱스 는-1로 설정 됩니다.If no item is selected, index is set to -1.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_LBStringDDX_LBString

함수는 대화 DDX_LBString CString 상자, 폼 뷰 또는 컨트롤 뷰 개체의 목록 상자 컨트롤과 CString 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 목록 상자 컨트롤의 리소스 ID입니다.The resource ID of the list box control associated with the control property.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_LBString목록 상자 컨트롤에 데이터를 전송 하기 위해가 호출 되 면 컨트롤에서 시작 과 일치 하는 첫 번째 항목이 선택 됩니다.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. (접두사가 아니라 전체 항목을 일치 시키려면 DDX_LBStringExact를 사용 합니다.) 일치 하는 항목이 없으면 선택 된 항목이 없습니다.(To match the entire item rather than just a prefix, use DDX_LBStringExact.) If there are no matches, no items are selected. 일치는 대/소문자를 구분 하지 않습니다.The matching is case-insensitive.

DDX_LBString목록 상자 컨트롤에서 데이터를 전송 하기 위해가 호출 되 면 이 현재 목록 상자 선택 항목으로 설정 됩니다.When DDX_LBString is called to transfer data from a list box control, value is set to the current list box selection. 항목을 선택 하지 않으면 이 길이가 0 인 문자열로 설정 됩니다.If no item is selected, value is set to a string of zero length.

참고

목록 상자가 드롭다운 목록 상자 이면 교환 되는 값은 255 자로 제한 됩니다.If the list box is a drop-down list box, the value exchanged is limited to 255 characters.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_LBStringExactDDX_LBStringExact

함수는 대화 상자, DDX_CBStringExact CString 폼 뷰 또는 컨트롤 뷰 개체와 CString 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버에 있는 목록 상자 컨트롤의 편집 컨트롤 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 목록 상자 컨트롤의 리소스 ID입니다.The resource ID of the list box control associated with the control property.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_LBStringExact목록 상자 컨트롤에 데이터를 전송 하기 위해가 호출 되 면 컨트롤에서 과 일치 하는 첫 번째 항목이 선택 됩니다.When DDX_LBStringExact is called to transfer data to a list box control, the first item in the control that matches value is selected. (전체 항목이 아닌 접두사만 일치 시키려면 DDX_LBString를 사용 합니다.) 일치 하는 항목이 없으면 선택 된 항목이 없습니다.(To match just a prefix rather than the entire item, use DDX_LBString.) If there are no matches, no items are selected. 일치는 대/소문자를 구분 하지 않습니다.The matching is case-insensitive.

DDX_CBStringExact목록 상자 컨트롤에서 데이터를 전송 하기 위해가 호출 되 면 이 현재 목록 상자 선택 항목으로 설정 됩니다.When DDX_CBStringExact is called to transfer data from a list box control, value is set to the current list box selection. 항목을 선택 하지 않으면 이 길이가 0 인 문자열로 설정 됩니다.If no item is selected, value is set to a string of zero length.

참고

목록 상자가 드롭다운 목록 상자 이면 교환 되는 값은 255 자로 제한 됩니다.If the list box is a drop-down list box, the value exchanged is limited to 255 characters.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_MonthCalCtrlDDX_MonthCalCtrl

DDX_MonthCalCtrl함수는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 monthcalendar 컨트롤 ( Cmonthcalctrl)과 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 CTime 또는 COleDateTime 데이터 멤버 간에 날짜 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction. 이 개체를 삭제할 필요는 없습니다.You don't need to delete this object.

nIDCnIDC
멤버 변수와 연결 된 month calendar 컨트롤의 리소스 ID입니다.The resource ID of the month calendar control associated with the member variable.

valuevalue
CTime COleDateTime 데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 또는 멤버 변수에 대 한 참조입니다.A reference to a CTime or COleDateTime member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

참고

컨트롤은 날짜 값만 관리 합니다.The control manages a date value only. 시간 개체의 시간 필드는 컨트롤 창의 만든 시간을 반영 하거나를 호출 하 여 컨트롤에 설정 된 시간을 반영 하 여 설정 됩니다 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.

DDX_MonthCalCtrl가 호출 되 면 이 month calendar 컨트롤의 현재 상태로 설정 됩니다.When DDX_MonthCalCtrl is called, value is set to the current state of the month calendar control.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_RadioDDX_Radio

함수는 대화 DDX_Radio int 상자, 폼 뷰 또는 컨트롤 뷰 개체의 라디오 컨트롤 그룹과 int 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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. 데이터 멤버의 값은 int 선택 된 그룹 내의 라디오 단추에 따라 결정 됩니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
그룹에 있는 첫 번째 라디오 컨트롤의 리소스 ID입니다.The resource ID of the first radio control in the group.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대 한 참조입니다.A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

설명Remarks

DDX_Radio가 호출 되 면 이 라디오 컨트롤 그룹의 현재 상태로 설정 됩니다.When DDX_Radio is called, value is set to the current state of the radio control group. 이 값은 현재 선택 된 라디오 컨트롤의 0부터 기반 하는 인덱스로 설정 되며, 선택 된 라디오 컨트롤이 없으면-1입니다.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.

예를 들어 그룹의 첫 번째 라디오 단추를 선택 하는 경우 (WS_GROUP 스타일이 있는 단추) 멤버 값은 int 0이 됩니다.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.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_ScrollDDX_Scroll

DDX_Scroll함수는 int 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 스크롤 막대 컨트롤과 int 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
컨트롤 속성과 연결 된 스크롤 막대 컨트롤의 리소스 ID입니다.The resource ID of the scroll-bar control associated with the control property.

valuevalue
데이터를 교환할 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.A reference to a member variable of the dialog box, form view or control view object with which data is exchanged.

설명Remarks

DDX_Scroll가 호출 되 면 이 컨트롤의 현재 위치로 설정 됩니다.When DDX_Scroll is called, value is set to the current position of the control's thumb. 컨트롤의 현재 위치와 연결 된 값에 대 한 자세한 내용은 Windows SDK의 GetScrollPos 를 참조 하세요.For more information on the values associated with the current position of the control's thumb, see GetScrollPos in the Windows SDK.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_SliderDDX_Slider

DDX_Slider함수는 int 대화 상자 또는 폼 보기의 슬라이더 컨트롤과 int 대화 상자 또는 폼 뷰 개체의 데이터 멤버 간 데이터 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
슬라이더 컨트롤의 리소스 ID입니다.The resource ID of the slider control.

valuevalue
교환할 값에 대 한 참조입니다.A reference to the value to be exchanged. 이 매개 변수는 슬라이더 컨트롤의 현재 위치를 포함 하거나 설정 합니다.This parameter holds or sets the slider control's current position.

설명Remarks

DDX_Slider가 호출 되 면 이 컨트롤의 현재 위치에 대 한 값으로 설정 되거나, exchange의 방향에 따라 값이 위치를 수신 합니다.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.

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation. 슬라이더 컨트롤에 대 한 자세한 내용은 CSliderCtrl 사용을 참조 하세요.For information about slider controls, see Using CSliderCtrl.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

DDX_TextDDX_Text

함수는 대화 상자, DDX_Text int UINT long CString float double 폼 뷰 또는 컨트롤 뷰의 편집 컨트롤과 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 CString 데이터 멤버 사이에서, UINT,, DWORD,, 또는 데이터의 전송을 관리 합니다.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);

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.The framework supplies this object to establish the context of the data exchange, including its direction.

nIDCnIDC
대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 편집 컨트롤 ID입니다.The ID of an edit control in the dialog box, form view, or control view object.

valuevalue
대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 데이터 멤버에 대 한 참조입니다.A reference to a data member in the dialog box, form view, or control view object. 의 데이터 형식은 사용 하는 오버 로드 된 버전에 따라 다릅니다 DDX_Text .The data type of value depends on which of the overloaded versions of DDX_Text you use.

설명Remarks

DDX에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조하세요.For more information about DDX, see Dialog Data Exchange and Validation.

요구 사항Requirements

헤더 afxdd_ .hHeader afxdd_.h

참고 항목See also

표준 대화 상자 데이터 유효성 검사 루틴Standard Dialog Data Validation Routines
매크로 및 전역Macros and Globals
CWinFormsControl::CreateManagedControlCWinFormsControl::CreateManagedControl
CDialog::OnInitDialogCDialog::OnInitDialog