Atrybuty w zależności od zastosowania

  • Artykuł

W tym temacie wymieniono atrybuty zgodnie z elementami języka C++, do których mają zastosowanie.

Jeśli atrybut poprzedza element, który nie znajduje się w zakresie atrybutu, blok atrybutu jest traktowany jako komentarz.

Atrybut opis
Atrybuty modułów Dotyczy atrybutu modułu.
Atrybuty interfejsu Dotyczy słowa kluczowego __interface C++.
Atrybuty klasy Dotyczy słowa kluczowego C++.
Atrybuty metody Dotyczy metod w klasie, coclass lub interfejsie.
Atrybuty parametru Dotyczy parametrów metody w klasie lub interfejsie.
Atrybuty składowych danych Dotyczy składowych danych w klasie, coclass lub interfejsie.
Atrybuty Typedef, Enum, Union oraz Struct Dotyczy słów kluczowych języka C++.
Atrybuty tablicy Dotyczy tablic lub SAFEARRAYs.
Oddzielne atrybuty Działa bardziej jak wiersz kodu, ale nie działa na słowie kluczowym C++. Instrukcje atrybutów autonomicznych wymagają średnika na końcu wiersza.
Atrybuty niestandardowe Umożliwia użytkownikowi rozszerzenie metadanych.

Atrybuty modułów

Do atrybutu modułu można zastosować tylko następujący atrybut.

Atrybut opis
helpstringdll Określa nazwę biblioteki DLL, która ma być używana do wykonywania wyszukiwania ciągów dokumentu (lokalizacja).

Atrybuty interfejsu

Następujące atrybuty dotyczą interfejsu (lub __interface) słowa kluczowego C++.

Atrybut opis
async_uuid Określa identyfikator UUID, który kieruje kompilator MIDL do definiowania zarówno synchronicznych, jak i asynchronicznych wersji interfejsu COM.
custom Umożliwia definiowanie własnych atrybutów.
dispinterface Umieszcza interfejs w pliku idl jako interfejs wysyłania.
dual Umieszcza interfejs w pliku idl jako podwójny interfejs.
export Powoduje umieszczenie struktury danych w pliku idl.
helpcontext Określa identyfikator kontekstu, który umożliwia użytkownikowi wyświetlanie informacji o tym elemecie w pliku Pomocy.
helpfile Ustawia nazwę pliku Pomocy dla biblioteki typów.
helpstring Określa ciąg znaków używany do opisywania elementu, do którego ma on zastosowanie.
helpstringcontext Określa identyfikator tematu pomocy w pliku hlp lub chm.
helpstringdll Określa nazwę biblioteki DLL, która ma być używana do wykonywania wyszukiwania ciągów dokumentu (lokalizacja).
hidden Wskazuje, że element istnieje, ale nie powinien być wyświetlany w przeglądarce zorientowanej na użytkownika.
library_block Umieszcza konstrukcję wewnątrz bloku biblioteki pliku idl.
local Umożliwia użycie kompilatora MIDL jako generatora nagłówków, gdy jest używany w nagłówku interfejsu. W przypadku użycia w pojedynczej funkcji wyznacza procedurę lokalną, dla której nie są generowane wycinki.
nonextensible Określa, że implementacja IDispatch zawiera tylko właściwości i metody wymienione w opisie interfejsu i nie można go rozszerzyć z dodatkowymi elementami członkowskimi w czasie wykonywania. Ten atrybut jest prawidłowy tylko w przypadku podwójnego interfejsu.
odl Identyfikuje interfejs jako interfejs ODL (Object Description Language).
object Identyfikuje interfejs niestandardowy.
oleautomation Wskazuje, że interfejs jest zgodny z usługą Automation.
pointer_default Określa domyślny atrybut wskaźnika dla wszystkich wskaźników z wyjątkiem wskaźników najwyższego poziomu, które są wyświetlane na listach parametrów.
ptr Wyznacza wskaźnik jako pełny wskaźnik.
restricted Wyznacza, których elementów członkowskich biblioteki nie można nazwać dowolnie.
uuid Udostępnia unikatowy identyfikator biblioteki

Należy przestrzegać tych reguł definiowania interfejsu:

  • Domyślna konwencja wywoływania jest __stdcall.

  • Jeśli go nie podasz, zostanie podany identyfikator GUID.

  • Metody przeciążone nie są dozwolone.

Jeśli nie określisz atrybutu uuid i użyjemy tej samej nazwy interfejsu w różnych projektach atrybutów, zostanie wygenerowany ten sam identyfikator GUID.

Zobacz też

Atrybuty języka C++ dla modelu COM i platformy .NET
Atrybuty według grup
Alfabetyczny spis atrybutów