멤버 변수 추가Add a member variable

클래스 뷰를 사용하여 클래스에 멤버 변수를 추가할 수 있습니다.You may add a member variable to a class using Class View. 멤버 변수는 데이터 교환 및 유효성 검사용일 수도 있고 일반적일 수도 있습니다.Member variables can be either for data exchange and data validation, or they can be generic. 데이터 멤버 변수 마법사는 관련 정보를 가져와 적절한 위치에 있는 원본 파일에 요소를 삽입하는 데 사용하도록 설계되었습니다.The data member variable wizard is designed to take the relevant information and use it to insert elements in your source files at the appropriate locations. 대화 상자 편집기리소스 뷰 또는 클래스 뷰에서 멤버 변수를 추가할 수 있습니다.You may add a member variable from the Dialog editor in Resource View, or from Class View.

참고

대화 상자를 디자인하고 구현할 때 대화 상자 편집기를 사용하여 대화 상자 컨트롤을 추가한 다음, 컨트롤의 멤버 변수를 구현하는 것이 더 효율적일 수 있습니다.When you're designing and implementing a dialog box, you might find it more efficient to use the Dialog editor to add the dialog box controls, and then to implement the controls' member variables.

멤버 변수 추가 마법사를 사용하여 리소스 뷰에서 대화 상자 컨트롤의 멤버 변수를 추가하려면:To add a member variable for a dialog control in Resource View using the Add Member Variable Wizard:

  1. 리소스 뷰에서 프로젝트 노드와 대화 상자 노드를 확장하여 프로젝트의 대화 상자 목록을 표시합니다.In Resource View, expand the project node and the Dialog node to display the list of the project's dialog boxes.

  2. 멤버 변수를 추가할 대화 상자를 두 번 클릭하여 대화 상자 편집기에서 엽니다.Double-click the dialog box to which you want to add the member variable to open it in the Dialog editor.

  3. 대화 상자 편집기에 표시된 대화 상자에서 멤버 변수를 추가할 컨트롤을 마우스 오른쪽 단추로 클릭합니다.In the dialog box displayed in the Dialog editor, right-click the control to which you want to add the member variable.

  4. 바로 가기 메뉴에서 변수 추가를 선택하여 멤버 변수 추가 마법사를 표시합니다.On the shortcut menu, choose Add Variable to display the Add member variable wizard.

    참고

    기본값은 컨트롤 ID에 이미 제공되어 있습니다.A default value is already provided in Control ID.

  5. 적절한 마법사 상자에 정보를 입력합니다.Provide the information in the appropriate wizard boxes. 자세한 내용은 대화 상자 컨트롤 및 변수 형식을 참조하세요.For more information, see dialog box controls and variable types.

  6. 마침을 선택하여 정의 및 구현 코드를 프로젝트에 추가하고 마법사를 닫습니다.Select Finish to add the definition and implementation code to the project and close the wizard.

멤버 변수 추가 마법사를 사용하여 클래스 뷰에서 멤버 변수를 추가하려면:To add a member variable from Class View using the Add Member Variable Wizard:

  1. 클래스 뷰에서 프로젝트 노드를 확장하여 프로젝트의 클래스를 표시합니다.In Class View, expand the project node to display the classes in the project.

  2. 변수를 추가할 클래스를 마우스 오른쪽 단추로 클릭합니다.Right-click the class to which you want to add a variable.

  3. 바로 가기 메뉴에서 추가를 선택한 다음, 변수 추가를 선택하여 멤버 변수 추가 마법사를 표시합니다.On the shortcut menu, choose Add, and then choose Add Variable to display the Add Member Variable Wizard.

  4. 적절한 마법사 상자에 정보를 입력합니다.Provide the information in the appropriate wizard boxes. 자세한 내용은 멤버 변수 추가 마법사를 참조하세요.For more information, see Add member variable wizard.

  5. 마침을 선택하여 정의 및 구현 코드를 프로젝트에 추가하고 마법사를 닫습니다.Select Finish to add the definition and implementation code to the project and close the wizard.

단원 내용In this section

멤버 변수 추가 마법사Add member variable wizard

이 마법사는 멤버 변수 선언을 헤더 파일에 추가합니다.This wizard adds a member variable declaration to the header file. 옵션에 따라 .cpp 파일에 코드를 추가할 수 있습니다.Depending on the options, it can add code to the .cpp file. 마법사를 사용하여 멤버 변수를 추가하면 개발 환경에서 코드를 편집할 수 있습니다.Once you've added the member variable using the wizard, you can edit the code in the development environment.

  • AccessAccess

    멤버 변수에 대한 액세스를 설정합니다.Sets the access to the member variable. 액세스 한정자는 다른 클래스가 멤버 변수에 포함되는 액세스를 지정하는 키워드입니다.Access modifiers are keywords that specify the access other classes have to the member variable. 액세스 권한 지정에 대한 자세한 내용은 멤버 액세스 제어를 참조하세요.For more information about specifying access, see member-access control. 멤버 변수 액세스 수준은 기본적으로 public으로 설정됩니다.The member variable access level is set to public by default.

  • 변수 형식Variable type

    추가하는 멤버 변수의 반환 형식을 설정합니다.Sets the return type for the member variable you're adding.

    • 대화 상자 컨트롤이 아닌 멤버 변수를 추가하는 경우 사용 가능한 형식 목록에서 선택합니다.If you're adding a member variable that isn't a dialog box control, select from the list of available types.

      형식에 대한 자세한 내용은 기본 형식을 참조하세요.For information about the types, see fundamental types.

      char short
      double unsigned char
      float unsigned int
      int unsigned long
      long
    • 대화 상자 컨트롤에 멤버 변수를 추가하는 경우 이 상자는 컨트롤이나 값에 대해 반환된 개체의 형식으로 채워집니다.If you're adding a member variable for a dialog box control, this box is filled with the type of object that is returned for a control or value. 컨트롤을 선택하는 경우 변수 형식컨트롤 ID 상자에서 선택한 컨트롤의 기본 클래스를 지정합니다.If you select Control, then Variable type specifies the base class of the control you select in the Control ID box. 대화 상자 컨트롤에 값이 포함될 수 있는 경우 및 을 선택한 경우 변수 형식은 컨트롤이 포함할 수 있는 값에 적절한 형식을 지정합니다.If the dialog box control can hold a value, and if you select Value, then Variable type specifies the appropriate type for the value that control can hold. 자세한 내용은 대화 상자 컨트롤 및 변수 형식을 참조하세요.For more information, see dialog box controls and variable types.

      이 값은 컨트롤 ID의 선택 영역에 따라 다르며 변경할 수 없습니다.This value depends on the selection in Control ID and can't be changed.

  • 변수 이름Variable name

    추가하는 멤버 변수의 이름을 설정합니다.Sets the name of the member variable you're adding. 멤버 변수는 일반적으로 기본 제공되는 m_ 식별 문자열로 시작합니다.Member variables typically begin with the identifying string m_, which is provided for you by default.

  • 제어 변수Control variable

    멤버 변수가 데이터 교환 및 데이터 유효성 지원을 사용하여 대화 상자 내에서 컨트롤을 관리한다고 표시합니다.Indicates that the member variable manages a control within a dialog box with data exchange and data validation support. 자세한 정보는 DoDataExchange를 참조하세요.For more information, see DoDataExchange. 이 옵션은 CDialog에서 파생된 클래스에 추가된 멤버 변수에 사용할 수 있습니다.This option is available only for member variables added to classes derived from CDialog. 컨트롤 ID컨트롤 형식 옵션을 활성화하려면 이 상자를 선택합니다.Select this box to activate the Control ID and Control type options.

  • 컨트롤 IDControl ID

    추가하는 제어 변수의 ID를 설정합니다.Sets the ID for the control variable you're adding. 멤버 변수를 추가하는 컨트롤 형식의 ID를 목록에서 선택합니다.Select from the list the ID for the type of control for which you're adding the member variable. 제어 변수 상자를 선택한 경우에만 목록이 활성화되고, 대화 상자에 이미 추가된 컨트롤의 ID로 제한됩니다.The list is active only when the Control variable box is selected, and it's limited to IDs for the controls already added to the dialog box. 예를 들어 표준 확인 단추에서 컨트롤 ID는 IDOK입니다.For example, for the standard OK button, the Control ID is IDOK.

    옵션Option 설명Description
    컨트롤Control 이 옵션은 컨트롤 형식에 대해 기본적으로 설정되며,This option is set by default for the control type. 목록 상자, 콤보 상자 또는 편집 상자에서 관리하려고 할 수 있으므로 컨트롤의 상태나 콘텐츠가 아닌 컨트롤 자체를 관리합니다.It manages the control itself, not the state or contents of the control (as you might want to manage for a list box, combo box, or edit box).
    Value 이 옵션은 편집 상자나 확인란 등 값을 포함하거나 상태를 표시할 수 있는 컨트롤 형식에 사용할 수 있습니다.This option is available for control types that can hold a value or show a state, such as an edit box or a check box. 범위, 콘텐츠 또는 상태를 관리할 수 있는 컨트롤 형식에 사용할 수도 있습니다.It's also available for control types for which you might manage range, contents, or state. 자세한 내용은 대화 상자 컨트롤 및 변수 형식을 참조하세요.For more information, see dialog box controls and variable types.
  • 범주Category

    변수가 컨트롤 형식과 컨트롤 값 중 어느 것을 기반으로 하는지 지정합니다.Specifies whether the variable is based on a control type or the value of the control.

  • 컨트롤 형식Control type

    추가되는 컨트롤의 형식을 설정합니다.Sets the type of control being added. 이 상자는 변경할 수 없습니다.This box isn't available to change. 예를 들어 단추에 컨트롤 형식 BUTTON가 있고, 콤보 상자에 컨트롤 형식 COMBOBOX가 있습니다.For example, a button has the control type BUTTON, and a combo box has the control type COMBOBOX. 자세한 내용은 대화 상자 컨트롤 및 변수 형식을 참조하세요.For more information, see dialog box controls and variable types.

  • 최대 문자Max characters

    변수 형식CString으로 설정된 경우에만 사용할 수 있습니다.Available only when Variable type is set to CString. 컨트롤이 포함할 수 있는 문자의 최대 수를 나타냅니다.Indicates the most number of characters that the control can hold.

  • 최소값Min value

    변수 형식이 BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency 또는 CTime인 경우에만 사용할 수 있습니다.Available only when the variable type is BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency or CTime. 소수 자릿수 또는 날짜 범위에 허용되는 가장 낮은 값을 나타냅니다.Indicates the lowest value acceptable for a scale or date range.

  • 최대값Max value

    변수 형식이 BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency 또는 CTime인 경우에만 사용할 수 있습니다.Available only when the variable type is BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency, or CTime. 소수 자릿수 또는 날짜 범위에 허용되는 가장 높은 값을 나타냅니다.Indicates the highest value acceptable for a scale or date range.

  • .h 파일.h file

    ActiveX 컨트롤의 경우 해당 멤버 변수에는 래퍼 클래스가 필요합니다.For ActiveX controls, whose member variables require a wrapper class. 클래스 선언에 추가할 헤더 파일의 이름을 설정합니다.Sets the name of the header file to add the class declaration.

  • .cpp 파일.cpp file

    ActiveX 컨트롤의 경우 해당 멤버 변수에는 래퍼 클래스가 필요합니다.For ActiveX controls, whose member variables require a wrapper class. 클래스 정의에 추가할 구현 파일의 이름을 설정합니다.Sets the name of the implementation file to add the class definition.

  • 설명Comment

    멤버 변수에 대한 헤더 파일에 주석을 제공합니다.Provides a comment in the header file for the member variable.

대화 상자 컨트롤 및 변수 형식Dialog box controls and variable types

MFC를 사용하여 만든 대화 상자 컨트롤에 멤버 변수를 추가하는 데 멤버 변수 추가 마법사를 사용할 수 있습니다.You can use the add member variable wizard to add a member variable to a dialog box control created using MFC. 멤버 변수를 추가하는 컨트롤의 형식은 대화 상자에 표시되는 옵션을 결정합니다.The type of control for which you add the member variable determines the options that appear in the dialog box.

다음 표에서는 MFC에서 지원되는 모든 대화 상자 컨트롤 형식 및 대화 상자 편집기에 대해 설명합니다.The following table describes all the dialog box control types that are supported in MFC and the Dialog editor. 사용 가능한 형식 및 값도 표시합니다.It also displays their available types and values.

컨트롤Control 컨트롤 형식Control type 제어 변수 형식Control variable type 변수 값 형식Value variable type 최소값/최대값(값 형식에만 해당)Min/max values (value type only)
애니메이션 컨트롤Animation control SysAnimate32SysAnimate32 CAnimateCtrlCAnimateCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A
단추Button BUTTONBUTTON CButtonCButton 없음; 컨트롤에만 해당None; control only 해당 없음N/A
확인란Check box CHECKCHECK CButtonCButton BOOL 최소값/최대값Min value/Max value
콤보 상자Combo box COMBOBOXCOMBOBOX CComboBoxCComboBox CStringCString 최대 문자Max characters
날짜 시간 선택 컨트롤Date time picker control SysDateTimePick32SysDateTimePick32 CDateTimeCtrlCDateTimeCtrl CTimeCTime 최소값/최대값Min value/max value
편집 상자Edit box 편집EDIT CEditCEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime 또는 COleCurrencyCString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime, or COleCurrency 최소값/최대값; 일부 지원 최대 문자Min value/max value; some support max characters
바로 가기 키 컨트롤Hotkey control msctls_hotkey32msctls_hotkey32 CHotKeyCtrlCHotKeyCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A
목록 상자List box LISTBOXLISTBOX CListBoxCListBox CString 최대 문자Max characters
목록 컨트롤List control SysListView32SysListView32 CListCtrlCListCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A
MonthCalendar 컨트롤Month Calendar control SysMonthCal32SysMonthCal32 CMonthCalCtrlCMonthCalCtrl CTime 최소값/최대값Min value/max value
Progress 컨트롤Progress control msctls_progress32msctls_progress32 CProgressCtrlCProgressCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A
Rich Edit 2 컨트롤Rich Edit 2 control RichEdit20ARichEdit20A CRichEditCtrlCRichEditCtrl CString 최대 문자Max characters
Rich Edit 컨트롤Rich Edit control RICHEDITRICHEDIT CRichEditCtrl CString 최대 문자Max characters
스크롤 막대(가로 또는 세로)Scroll bar (vertical or horizontal SCROLLBARSCROLLBAR CScrollBarCScrollBar int 최소값/최대값Min value/max value
Slider 컨트롤Slider control msctls_trackbar32msctls_trackbar32 CSliderCtrlCSliderCtrl int 최소값/최대값Min value/max value
Spin 컨트롤Spin control msctls_updown32msctls_updown32 CSpinButtonCtrlCSpinButtonCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A
탭 컨트롤Tab control SysTabControl32SysTabControl32 CTabCtrlCTabCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A
트리 컨트롤Tree control SysTreeView32SysTreeView32 CTreeCtrlCTreeCtrl 없음; 컨트롤에만 해당None; control only 해당 없음N/A