IAxWinAmbientDispatchEx – rozhraní
Toto rozhraní implementuje doplňkové okolí vlastnosti hostovaného ovládacího prvku.
Důležité
Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.
Syntaxe
MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch
Členové
Metody
| Název | Popis |
|---|---|
| SetAmbientDispatch | Tato metoda je volána k doplnění výchozí okolí vlastnosti rozhraní uživatelem definované rozhraní. |
Poznámky
Toto rozhraní zahrňte do aplikací ATL, které jsou staticky propojeny s ovládacími prvky ATL a hostují ovládací prvky ActiveX, zejména ovládací prvky ActiveX, které mají vlastnosti okolí. Nezařazení tohoto rozhraní vygeneruje toto kontrolní výraz: "Zapomněli jste předat LIBID CComModule::Init"
Toto rozhraní je vystaveno ovládacím prvkům ActiveX atL, které hostují objekty. Odvozen z IAxWinAmbientDispatch, přidává metodu, IAxWinAmbientDispatchEx která umožňuje doplnit okolí rozhraní vlastnosti poskytované ATL jedním z vašich vlastních.
AxHost se pokusí načíst informace o typu a IAxWinAmbientDispatch IAxWinAmbientDispatchEx z knihovny typů, která obsahuje kód.
Pokud odkazujete na ATL90.dll, aplikace AXHost načte informace o typu z knihovny typů v knihovně DLL.
Další podrobnosti najdete v tématu Hostování ovládacích prvků ActiveX pomocí TŘÍDY ATL AXHost .
Požadavky
Definice tohoto rozhraní je k dispozici v řadě formulářů, jak je znázorněno v následující tabulce.
| Typ definice | Soubor |
|---|---|
| IDL | atliface.idl |
| Knihovna typů | ATL.dll |
| C++ | atliface.h (zahrnutý také v ATLBase.h) |
IAxWinAmbientDispatchEx::SetAmbientDispatch
Tato metoda je volána k doplnění výchozí okolí vlastnosti rozhraní uživatelem definované rozhraní.
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
Parametry
pDispatch
Ukazatel na nové rozhraní.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Pokud SetAmbientDispatch je volána s ukazatelem na nové rozhraní, toto nové rozhraní bude použito k vyvolání všech vlastností nebo metod, které požaduje hostovaný ovládací prvek, pokud tyto vlastnosti ještě nejsou poskytovány IAxWinAmbientDispatch.