Sdílet prostřednictvím


Atributy podle použití

Toto téma uvádí atributy podle elementů jazyka C++, na které se vztahují.

Pokud atribut předchází prvku, který není v oboru atributu, je blok atributu považován za komentář.

Atribut Popis
Atributy modulu Platí pro atribut modulu .
Atributy rozhraní Platí pro klíčové slovo __interface C++.
Atributy třídy Platí pro klíčové slovo C++.
Atributy metody Platí pro metody ve třídě, coclass nebo rozhraní.
Atributy parametru Platí pro parametry metody ve třídě nebo rozhraní.
Atributy datového členu Platí pro datové členy třídy, třídy coclass nebo rozhraní.
Atributy klíčových slov typedef, enum, union a struct Platí pro klíčová slova jazyka C++.
Atributy pole Platí pro pole nebo SAFEARRAYs.
Samostatné atributy Funguje spíše jako řádek kódu, ale nepracuje s klíčovým slovem jazyka C++. Samostatné příkazy atributů vyžadují středník na konci řádku.
Vlastní atributy Umožňuje uživateli rozšířit metadata.

Atributy modulu

Následující atribut lze použít pouze pro atribut modulu .

Atribut Popis
helpstringdll Určuje název knihovny DLL, který se má použít k provedení vyhledávání řetězců dokumentu (lokalizace).

Atributy rozhraní

Následující atributy platí pro klíčové slovo jazyka C++ rozhraní (nebo __interface).

Atribut Popis
async_uuid Určuje UUID, který směruje kompilátor MIDL tak, aby definoval synchronní i asynchronní verze rozhraní MODELU COM.
custom Umožňuje definovat vlastní atributy.
dispinterface Umístí rozhraní do souboru .idl jako rozhraní pro odeslání.
dual Umístí rozhraní do souboru .idl jako duální rozhraní.
export Způsobí umístění datové struktury do souboru .idl.
helpcontext Určuje ID kontextu, které umožňuje uživateli zobrazit informace o tomto prvku v souboru nápovědy.
helpfile Nastaví název souboru nápovědy pro knihovnu typů.
helpstring Určuje řetězec znaků, který se používá k popisu prvku, na který se vztahuje.
helpstringcontext Určuje ID tématu nápovědy v souboru .hlp nebo .chm.
helpstringdll Určuje název knihovny DLL, který se má použít k provedení vyhledávání řetězců dokumentu (lokalizace).
hidden Označuje, že položka existuje, ale neměla by být zobrazena v prohlížeči orientovaném na uživatele.
library_block Umístí konstruktor uvnitř bloku knihovny souboru .idl.
local Umožňuje použít kompilátor MIDL jako generátor hlaviček při použití v hlavičce rozhraní. Při použití v jednotlivých funkcích určuje místní proceduru, pro kterou nejsou generovány žádné zástupné procedury.
nonextensible Určuje, že IDispatch implementace zahrnuje pouze vlastnosti a metody uvedené v popisu rozhraní a nelze ji rozšířit o další členy za běhu. Tento atribut je platný pouze na duálním rozhraní.
odl Identifikuje rozhraní jako rozhraní ODL (Object Description Language).
object Identifikuje vlastní rozhraní.
oleautomation Označuje, že rozhraní je kompatibilní se službou Automation.
pointer_default Určuje výchozí atribut ukazatele pro všechny ukazatele kromě ukazatelů nejvyšší úrovně, které se zobrazují v seznamech parametrů.
ptr Určuje ukazatel jako úplný ukazatel.
restricted Určuje, které členy knihovny nelze libovolně volat.
uuid Poskytuje jedinečné ID knihovny.

Musíte dodržovat tato pravidla pro definování rozhraní:

  • Výchozí konvence volání je __stdcall.

  • Pokud ho nezadáte, zadáte pro vás identifikátor GUID.

  • Nejsou povoleny žádné přetížené metody.

Pokud nezadáte atribut uuid a použijete stejný název rozhraní v různých projektech atributů, vygeneruje se stejný identifikátor GUID.

Viz také

Atributy C++ pro COM a .NET
Atributy podle skupin
Abecedně řazená referenční dokumentace k atributům