Sdílet prostřednictvím

Atribut event_receiver

  • Článek

Vytvoří přijímač událostí (jímku).

Poznámka:

Atributy událostí v nativním jazyce C++ nejsou kompatibilní se standardem C++. Při zadávání /permissive- režimu shody se nekompiluje.

Syntaxe

[ event_receiver(type
   [, layout_dependent=false]) ]

Parametry

type
Výčet jedné z následujících hodnot:

  • native pro nespravovaný kód C/C++ (výchozí nastavení pro nativní třídy).

  • com pro kód COM. Tato hodnota vyžaduje, abyste zahrnuli tyto soubory hlaviček:

    #define _ATL_ATTRIBUTES
#include <atlbase.h>
#include <atlcom.h>

layout_dependent
Zadejte layout_dependent pouze v případě, žetype= com. layout_dependent je logická hodnota:

  • true znamená, že podpis delegátů v příjemci události musí přesně odpovídat těm, ke kterým jsou připojení ve zdroji události. Názvy obslužných rutin příjemce události musí odpovídat názvům zadaným v příslušném rozhraní zdroje událostí. Použít coclass , pokud layout_dependent je true. Je o něco efektivnější určit true.

  • false (výchozí) znamená, že konvence volání a třída úložiště (virtual, statica další) nemusí odpovídat metodě události a obslužným rutinům. Názvy obslužných rutin také nemusí odpovídat názvům metod zdrojového rozhraní události.

Poznámky

Atribut event_receiver C++ určuje, že třída nebo struktura, na kterou se použije, bude příjemcem události pomocí modelu sjednocených událostí Microsoft C++.

event_receiver se používá s atributem event_source a __hook __unhook klíčovými slovy. Slouží event_source k vytváření zdrojů událostí. Pomocí __hook metod příjemce události přidružte metody příjemce události ("hook") k událostem zdroje událostí. Slouží __unhook k zrušení přidružení.

layout_dependent je určen pouze pro příjemce událostí modelu COM (type=com). Výchozí hodnota je layout_dependent false.

Poznámka:

Třída šablony nebo struktura nemohou obsahovat události.

Požadavky

Kontext atributu Hodnota
Platí pro class, struct
Opakovatelný No
Požadované atributy coclass Kdy layout_dependent=true
Neplatné atributy Nic

Další informace naleznete v tématu Kontexty atributů.

Viz také

Atributy kompilátoru
event_source
__event
__hook
__unhook
Atributy třídy