Добавление переменной-члена

Вы можете добавить переменную-член для класса с помощью представления классов. Переменные-члены могут использоваться для обмена данными и их проверки либо могут быть универсальными. Мастер переменных-членов данных предназначен для получения релевантной информации и ее использования для вставки элементов в исходные файлы в нужных расположениях. Вы можете добавить переменную-член из редактора диалоговых окон в представлении ресурсов или из представления классов.

Примечание

При проектировании и реализации диалогового окна может оказаться, что эффективнее использовать редактор диалоговых окон для добавления элементов управления диалоговых окон, а затем реализовать переменные-члены для элементов управления.

Добавление переменной-члена для элемента управления диалогового окна в представлении ресурсов с помощью мастера добавления переменной-члена

  1. В представлении ресурсов разверните узел проекта и узел диалогового окна, чтобы отобразить список диалоговых окон проекта.

  2. Дважды щелкните диалоговое окно, для которого хотите добавить переменную-член, чтобы открыть его в редакторе диалоговых окон.

  3. В диалоговом окне, отображаемом в редакторе диалоговых окон, щелкните правой кнопкой мыши элемент управления, к которому требуется добавить переменную-член.

  4. В контекстном меню выберите команду Добавить переменную, чтобы отобразить мастер добавления переменной-члена.

    Примечание

    Значение по умолчанию уже указано в поле Идентификатор элемента управления.

  5. Укажите сведения в соответствующих полях мастера. Дополнительные сведения см. в разделе Элементы управления "Диалоговое окно" и типы переменных.

  6. Нажмите кнопку Готово, чтобы добавить в проект код определения и реализации, и закройте мастер.

Добавление переменной-члена из представления классов с помощью мастера добавления переменной-члена

  1. В представлении классов разверните узел проекта, чтобы отобразить классы в проекте.

  2. Щелкните правой кнопкой мыши класс, куда нужно добавить переменную.

  3. В контекстном меню выберите Добавить и затем Добавить переменную, чтобы отобразить мастер добавления переменной-члена.

  4. Укажите сведения в соответствующих полях мастера. Дополнительные сведения см. в разделе Мастер добавления переменной-члена.

  5. Нажмите кнопку Готово, чтобы добавить в проект код определения и реализации, и закройте мастер.

В этом разделе

Мастер добавления переменной-члена

Этот мастер добавляет объявления переменной-члена в файл заголовка. В зависимости от параметров он может добавить код в CPP-файл. После добавления переменной-члена с помощью мастера вы можете редактировать код в среде разработки.

  • Доступ

    Задает уровень доступа к переменной-члену. Модификаторы доступа — это ключевые слова, которые определяют доступ других классов к переменной-члену. Дополнительные сведения о задании доступа см. в разделе Контроль доступа членов. Для переменной-члена по умолчанию задан уровень доступа public.

  • Тип переменной

    Задает тип возвращаемого значения для добавляемой переменной-члена.

    • При добавлении переменной-члена, не являющейся элементом управления диалогового окна, выберите один из доступных типов в списке.

      Сведения о типах см. в разделе Фундаментальные типы.

      • char
      • double
      • float
      • int
      • long
      • short
      • unsigned char
      • unsigned int
      • unsigned long
    • При добавлении переменной-члена для элемента управления диалогового окна это поле заполняется типом объекта, возвращаемого для элемента управления или значения. Если выбрать Элемент управления, то поле Тип переменной будет указывать базовый класс элемента управления, выбранного в поле Идентификатор элемента управления. Если элемент управления диалогового окна может содержать значение и вы выбрали Значение, то Тип переменной будет указывать соответствующий тип для значения, которое может содержать элемент управления. Дополнительные сведения см. в разделе Элементы управления "Диалоговое окно" и типы переменных.

      Это значение зависит от выбора в поле Идентификатор элемента управления и не может быть изменено.

  • Имя переменной

    Задает имя для добавляемой переменной-члена. Переменные-члены обычно начинаются с идентифицирующей строки m_, которая указывается по умолчанию.

  • Control variable (Переменная элемента управления)

    Указывает, что переменная-член управляет элементом управления в диалоговом окне с поддержкой обмена данными и проверки данных. Дополнительные сведения см. в разделе DoDataExchange. Этот параметр доступен только для переменных-членов, которые добавлены в классы, производные от CDialog. Установите этот флажок, чтобы активировать параметры Идентификатор элемента управления и Тип элемента управления.

  • Идентификатор элемента управления

    Задает идентификатор для добавляемой переменной элемента управления. Выберите в списке идентификатор для типа элемента управления, для которого вы добавляете переменную-член. Этот список активен только при выбранном поле Переменная элемента управления и ограничен идентификаторами для элементов управления, уже добавленных в диалоговое окно. Например, стандартная кнопка ОК имеет идентификатор элемента управления IDOK.

    Параметр Описание:
    Управление Этот параметр по умолчанию задан для типа элемента управления. Он управляет самим элементом управления, а не его состоянием или содержимым (как это может потребоваться для списка, поля со списком или поля ввода).
    Значение Этот параметр доступен для типов элементов управления, которые могут содержать значение или отображать состояние, например для поля ввода или флажка. Он также доступен для типов элементов управления, для которых можно управлять диапазоном, содержимым или состоянием. Дополнительные сведения см. в разделе Элементы управления "Диалоговое окно" и типы переменных.
  • Категория

    Указывает, основана ли переменная на типе или на значении элемента управления.

  • Тип элемента управления

    Задает тип добавляемого элемента управления. Это поле невозможно изменить. Например, кнопка имеет тип элемента управления BUTTON, а поле со списком — COMBOBOX. Дополнительные сведения см. в разделе Элементы управления "Диалоговое окно" и типы переменных.

  • Max characters (Максимальное число символов)

    Доступно, только если для параметра Тип переменной задано значение CString. Указывает наибольшее число символов, которое может содержать элемент управления.

  • Минимальное значение

    Доступно только для типов переменной BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency или CTime. Указывает наименьшее значение, допустимое для масштаба или диапазона дат.

  • Максимальное значение

    Доступно только для типов переменной BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency или CTime. Указывает наибольшее значение, допустимое для масштаба или диапазона дат.

  • H-файл

    Для элементов управления ActiveX, переменным-членам требуется класс-оболочка. Задает имя файла заголовка для добавления объявления класса.

  • CPP-файл

    Для элементов управления ActiveX, переменным-членам требуется класс-оболочка. Задает имя файла реализации для добавления определения класса.

  • Комментарий

    Предоставляет комментарий в файле заголовка для переменной-члена.

Элементы управления "Диалоговое окно" и типы переменных

Вы можете использовать мастер добавления переменной-члена для добавления переменной-члена в элемент управления диалогового окна, созданный с помощью MFC. Тип элемента управления, для которого вы добавляете переменную-член, определяет параметры, отображаемые в диалоговом окне.

В следующей таблице описаны все типы элементов управления диалогового окна, поддерживаемые в MFC и редакторе диалоговых окон. В таблице также содержатся доступные типы и значения для них.

Control Тип элемента управления Тип переменной элемента управления Тип переменной значения Минимальное и максимальное значения (только тип значения)
Элемент управления "Анимация" SysAnimate32 CAnimateCtrl Нет, только элемент управления Недоступно
Кнопка BUTTON CButton Нет, только элемент управления Недоступно
Флажок CHECK CButton BOOL Минимальное и максимальное значения
Поле со списком COMBOBOX CComboBox CString Максимальное число символов
Элемент управления "Выбор даты и времени" SysDateTimePick32 CDateTimeCtrl CTime Минимальное и максимальное значения
Поле ввода EDIT CEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime или COleCurrency Минимальное и максимальное значения; некоторые поддерживают максимальное количество символов
Элемент управления "Сочетание клавиш" msctls_hotkey32 CHotKeyCtrl Нет, только элемент управления Недоступно
Список LISTBOX CListBox CString Максимальное число символов
Элемент управления "Список" SysListView32 CListCtrl Нет, только элемент управления Недоступно
Элемент управления "Календарь месяца" SysMonthCal32 CMonthCalCtrl CTime Минимальное и максимальное значения
Progress control msctls_progress32 CProgressCtrl Нет, только элемент управления Недоступно
Элемент управления Rich Edit 2 RichEdit20A CRichEditCtrl CString Максимальное число символов
Элемент управления Rich Edit RICHEDIT CRichEditCtrl CString Максимальное число символов
Полоса прокрутки (вертикальная или горизонтальная) SCROLLBAR CScrollBar int Минимальное и максимальное значения
Ползунок - элемент управления msctls_trackbar32 CSliderCtrl int Минимальное и максимальное значения
Spin control msctls_updown32 CSpinButtonCtrl Нет, только элемент управления Недоступно
Элемент управления табуляции SysTabControl32 CTabCtrl Нет, только элемент управления Недоступно
Элемент управления "Дерево" SysTreeView32 CTreeCtrl Нет, только элемент управления Н/Д