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


Атрибуты библиотеки типов

Следующие ключевые слова указывают сведения о библиотеке типов в контексте инструкциибиблиотекив файле IDL.

Атрибут Употребление
агрегируемые Определяет coclass как вспомогательные объекты, которые могут напрямую предоставлять указатель интерфейса другого объекта.
appobject Определяет coclass как объект приложения, связанный с полным приложением EXE.
привязываемые Указывает, что свойство поддерживает привязку данных. Это позволяет клиенту получать уведомления при изменении значения свойства.
сокласс Содержит список поддерживаемых интерфейсов для объекта компонента.
элемента управления Определяет сокласс или библиотеку в качестве com-элемента управления, из которого сайт контейнера будет получать дополнительные библиотеки типов или классы объектов компонентов.
настраиваемые Определяет пользовательский атрибут (не определенный в MIDL).
по умолчанию Указывает, что интерфейс или dispinterface, определенный в coclass, представляет интерфейс по умолчанию.
по умолчанию Указывает одно привязываемое свойство, которое лучше всего представляет объект.
defaultcollelem Помечает свойство как функцию доступа для элемента коллекции по умолчанию. Используется для оптимизации кода Microsoft Visual Basic.
значение по умолчанию Разрешает спецификацию значения по умолчанию для типизированного необязательного параметра.
defaultvtable Позволяет объекту иметь два разных исходных интерфейса.
dispinterface Определяет набор свойств и методов, в которых можно вызывать IDispatch::Invoke.
displaybind Указывает свойство, которое должно отображаться пользователю как привязываемое.
dllname(str) Определяет имя библиотеки DLL, содержащей точки входа для модуля.
двойной Определяет интерфейс, предоставляющий свойства и методы как через IDispatch, так и непосредственно через Vtable.
запись Указывает экспортированную функцию или константу в модуле, определив точку входа в библиотеке DLL.
helpcontext Указывает идентификатор контекста, позволяющий пользователю просматривать сведения об этом элементе в файле справки.
helpfile Задает имя файла справки для библиотеки типов.
вспомогательной Указывает символьную строку, используемую для описания элемента, к которому он применяется.
helpstringdll Задает имя библиотеки DLL для выполнения поиска строки документа.
скрытые Указывает, что элемент существует, но не должен отображаться в пользовательском браузере.
идентификатор Указывает DISPID для функции-члена (свойство или метод, в интерфейсе или dispinterface).
интерпретации Указывает, что база данных будет немедленно уведомлена обо всех изменениях свойства объекта, привязанного к данным.
При применении к инструкциибиблиотекивместе с аргументом localeID определяет языковой стандарт для библиотеки типов или для аргумента функции и позволяет использовать международные символы внутри блока библиотеки. В инструкции библиотеки с точки, в которой используется атрибут lcid, MIDL будет принимать входные данные, локализованные в соответствии с указанным языковым стандартом.
библиотеки Указывает компилятору MIDL создавать сведения о библиотеке типов для интерфейсов и классов, на которые ссылается инструкция.
лицензированных Указывает, что coclass, к которой она применяется, лицензируется, и экземпляры должны создаваться с помощью IClassFactory2.
неизменяемые Указывает, что свойство отображается в браузере объектов (который не отображает значения свойств), но не отображается в браузере свойств (который отображает значения свойств).
неизменяемые Запрещает клиенту использовать фабрику классов по умолчанию для создания экземпляров интерфейса объекта.
неэкстенсивные Указывает, что реализация IDispatch включает только свойства и методы, перечисленные в описании интерфейса, и не может быть расширена с дополнительными элементами во время выполнения.
oleautomation Указывает, что интерфейс совместим с автоматизацией.
необязательные Указывает необязательный параметр для функции-члена.
propget Указывает функцию доступа к свойствам.
propput Задает функцию параметра свойства.
propputref Задает функцию параметра свойства, которая использует ссылку вместо значения.
общедоступных Гарантирует, что псевдоним, объявленный с typedef, становится частью библиотеки типов.
Запрещает назначение нового значения переменной.
запрошенный Указывает, что свойство поддерживает уведомление OnRequestEdit.
ограниченные Указывает, что библиотеку или член модуля, интерфейса или dispinterface нельзя вызывать произвольно.
retval Указывает параметр, который получает возвращаемое значение элемента.
источника Указывает, что элемент сокласса, свойства или метода является источником событий.
строковые Указывает, что одномерный массив char, wchar_t, байтов (или эквивалентный) массив или указатель на такой массив должен рассматриваться как строка.
uidefault Указывает, что элемент сведений о типе является элементом по умолчанию для отображения в пользовательском интерфейсе.
используется getlasterror Указывает, что точка входа модуля использует SetLastError для возврата кодов ошибок и что вызывающий объект может вызывать GetLastError, чтобы получить код ошибки при вводе функции.
uuid Задает уникальный идентификатор библиотеки типов, coclassили интерфейс.
vararg Указывает, что функция принимает переменное число аргументов.
версии Определяет определенную версию библиотеки типов.

 

синтаксис файла ODL

Пример файла ODL

создание библиотеки типов с помощью MIDL