Поделиться через

Добавление свойства IDL MFC

  • Статья

Мастер добавления свойств IDL MFC добавляет свойство в интерфейс библиотеки определений интерфейса (IDL), определенный в проекте класса Microsoft Framework (MFC).

Чтобы использовать этот мастер, необходимо находиться в проекте MFC, проекте ActiveX или проекте ATL, поддерживающем MFC. Например, если у вас есть проект элемента управления Microsoft ActiveX, можно использовать следующую процедуру, чтобы добавить свойство в интерфейс IDL в решении.

Добавление свойства IDL MFC в интерфейс

  1. В меню Вид выберите Представление классов.

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

    Примечание.

    Вы также можете добавлять свойства в disp-интерфейсы, которые, если только проект не имеет атрибуты, вложены в узел библиотеки.

  3. В контекстном меню выберите "Добавить>свойство".

  4. В мастере добавления свойств IDL MFC укажите сведения для создания свойства.

  5. Нажмите кнопку ОК, чтобы добавить свойство.

Для mFC dispinterfaces:

  • При выборе переменной Member в качестве типа реализации метод и переменная добавляются в класс, реализующий его.
  • Если выбрать методы Get/Set в качестве типа реализации, два метода добавляются в класс, который его реализует.

Список элементов пользовательского интерфейса

В следующем разделе описывается мастер добавления свойств IDL MFC:

Снимок экрана: добавление свойства IDL MFC с двумя параметрами: int i и char c. Тип свойства — OLE_COLOR.

  • Имя свойства

    Задает имя свойства.

    Для disp-интерфейсов MFC, связанных с элементами управления ActiveX, можно указать собственное имя или выбрать стандартное имя свойства в предопределенном списке. Если вы указываете собственное имя свойства, тип реализации Биржевая недоступен.

    Дополнительные сведения об описании свойств акций в списке см. в разделе "Свойства акций".

    Тип интерфейса Параметры имени свойства
    Двойной интерфейс ATL, настраиваемый интерфейс и локальный настраиваемый интерфейс Укажите имя свойства.
    Disp-интерфейс MFC, disp-интерфейс элементов управления ActiveX MFC Укажите имя свойства или выберите стандартное свойство в списке.

    При выборе свойства в списке соответствующее значение отображается в поле Тип свойства. Этот тип можно изменить в зависимости от выбора типа реализации.

  • Тип свойства

    Задает тип добавляемого свойства.

    Для disp-интерфейсов MFC укажите свой собственный тип или выберите в предопределенном списке. Если вы предоставляете акции реализации свойства, тип свойства является типом акций и не может быть изменен.

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

    Задает имя переменной-члена, с которой сопоставлено свойство.

    По умолчанию имя переменной — m_PropertyName. Это имя можно изменить.

    Это поле отображается только для mFC dispinterfaces и если в типе реализации указана переменная-член.

  • Функция уведомления

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

    По умолчанию имя функции уведомления — OnPropertyNameChanged. Это имя можно изменить.

    Это поле отображается только для mFC dispinterfaces и если в типе реализации указана переменная-член.

  • Функция Get

    Задает имя функции для возвращения свойства.

    По умолчанию функции Get присвоено имя Getимя_свойства. Это имя можно изменить.

    Если удалить это имя, в схему диспетчеризации интерфейса вставляется функция GetNotSupported.

    Это поле отображается только для mFC dispinterfaces и если заданы методы Get/Set в типе реализации.

  • Задать функцию

    Задает имя функции для задания свойства.

    По умолчанию функции Set присвоено имя Setимя_свойства. Это имя можно изменить.

    Если удалить это имя, в схему диспетчеризации интерфейса вставляется функция SetNotSupported.

    Это поле отображается только для mFC dispinterfaces и если заданы методы Get/Set в типе реализации.

  • Тип реализации

    Указывает, как реализовать добавляемое свойство.

    Доступно только для mFC dispinterfaces.

    Тип реализации Description
    Биржевая Задает реализацию по умолчанию для свойства, выбранного в имени свойства. Дополнительные сведения см. в разделе Стандартные свойства.
    При указании значения Биржевая элементы Тип свойства, Тип параметра и Имя параметра становятся недоступны.
    Переменная-член Добавляет свойство в качестве переменной-члена.
    Настраиваемые свойства и большинство стандартных свойств можно добавить в качестве переменных-членов.
    Предоставляет имена по умолчанию в полях Имя переменной и Функция уведомления. Это имя можно изменить.
    Нельзя указать переменную-член для CaptionhWndсвойства или Text свойства.
    Методы Get и Set Указывает, что свойство добавляется как Getфункции PropertyName и SetPropertyName по умолчанию. Эти имена отображаются в полях Функция Get и Функция Set.
    Вы можете изменить значение по умолчанию Тип свойства, которое передает значение для функции Get.
    Вы можете указать параметры для функций Get и Set.

  • Свойство по умолчанию

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

    Интерфейс может иметь только одно свойство по умолчанию.

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

  • Параметры

    Отображает параметры метода и его типы.

  • +

    Добавляет параметр. В параметрах введите тип параметра и имя и нажмите кнопку "ОК". Например: int x

  • x

    Удаляет выбранный параметр из списка Параметры.

  • Значок карандаша

    Изменяет выбранный параметр.

  • id

    Задает числовой идентификатор, который определяет это свойство.

    Этот параметр недоступен для свойств настраиваемых интерфейсов. Дополнительные сведения смid. в справочнике ПО MIDL.

  • helpcontext

    Задает идентификатор контекста, позволяющий пользователю просматривать в файле справки информацию об этом свойстве.

    Дополнительные сведения смhelpcontext. в справочнике ПО MIDL.

  • helpstring

    Определяет строку символов, используемую для описания элемента, к которому оно применяется. По умолчанию это propertyимя свойства.

    Дополнительные сведения смhelpstring. в справочнике ПО MIDL.

Свойства хранения

Если вы добавляете свойство в MFC dispinterface, в раскрывающемся списке "Имя свойства" можно выбрать одно из следующих свойств:

Имя свойства Description
Appearance Возвращает или задает значение, определяющее внешний вид элемента управления.
Свойство Appearance элемента управления может включать или исключить трехмерные эффекты отображения. Это свойство является окружающим свойством чтения и записи.
BackColor Возвращает или задает для окружающего свойства BackColor элемента управления цвет палитры (RGB) или предопределенный системный цвет.
По умолчанию его значение соответствует цвету переднего плана для контейнера элемента управления.
Это свойство является окружающим свойством чтения и записи.
BorderStyle Возвращает или задает стиль границы для элемента управления.
Это свойство является свойством чтения и записи.
Caption Возвращает или задает свойство Caption элемента управления.
Это значение является заголовком окна. У свойства Caption нет типа реализации Переменная-член.
Enabled Возвращает или задает свойство Enabled элемента управления.
Включенный элемент управления может отвечать на события, вызываемые пользователем.
Font Возвращает или задает окружающий шрифт элемента управления.
Null Если элемент управления не имеет шрифта.
ForeColor Возвращает или задает окружающее свойство ForeColor элемента управления.
hWnd Возвращает или задает свойство hWnd элемента управления.
Не имеет типа реализации переменной-члена.
ReadyState Возвращает или задает свойство ReadyState элемента управления.
Элемент управления может быть неинициализированным, инициализированным, загружаемым, интерактивным или завершенным.
Дополнительные сведения см. в разделе READYSTATE для пакета SDK Интернета.
Text Возвращает или задает текст, содержащийся в элементе управления.
Не имеет типа реализации переменной-члена.

См. также

Добавление свойства

Добавление свойства IDL