Přidání vlastnosti IDL

Průvodce přidáním vlastnosti IDL přidá vlastnost do rozhraní definovaného v knihovně IDL (Interface Definition Library), například v projektu ATL, který obsahuje .idl soubor. Tento průvodce není k dispozici v projektech, které podporují MFC.

Tento průvodce se liší od průvodce přidáním vlastnosti a průvodcem Přidat vlastnost knihovny MFC IDL následujícími způsoby:

• Průvodce přidat vlastnost přidá vlastnost do rozhraní v projektu.
• Průvodce přidáním vlastnosti mfc IDL je specifický pro projekty MFC, ActiveX nebo ATL, které podporují MFC.

Přidání vlastnosti IDL

1. V nabídce View (Zobrazení) vyberte Class View (Zobrazení třídy).

2. V zobrazení třídy klikněte pravým tlačítkem myši na název rozhraní, do kterého chcete přidat vlastnost.

   Poznámka

   Můžete také přidat vlastnosti dispinterfaces, které jsou vnořené v uzlu knihovny, pokud není projekt přiřazen.

3. Klikněte pravým tlačítkem myši na název rozhraní.

4. V místní nabídce vyberte Přidat>vlastnost.

5. V průvodci Přidat vlastnost IDL zadejte informace k vytvoření vlastnosti.

6. Vyberte OK a přidejte vlastnost.

Metody Get a Put vlastnosti jsou zobrazeny jako dvě ikony v zobrazení třídy pod rozhraním, kde je definována. Poklikáním na některou z ikon zobrazíte deklaraci vlastnosti v .idl souboru.

U rozhraní ATL se Get do souborů a přidají funkce a Put.h..cpp

Průvodce přidáním vlastnosti IDL

Následující část popisuje uživatelské rozhraní, které použijete k přidání vlastnosti IDL:

• Název vlastnosti

  Nastaví název vlastnosti.

• Typ vlastnosti

  Datový typ vlastnosti.

• Návratový typ

  Pro rozhraní ATL nastaví návratový typ vlastnosti. U duálních HRESULT rozhraní je vždy návratový typ a výběr možnosti není k dispozici. Pro vlastní rozhraní můžete vybrat návratový typ ze seznamu. HRESULT se stále doporučuje, protože poskytuje standardní způsob, jak vrátit chyby.

• Funkce Get

  Pro rozhraní ATL vytvoří metodu Get pro načtení hodnoty vlastnosti. Vyberte Získat, Vložit nebo obojí.

• Funkce Put

  Pro rozhraní ATL vytvoří metodu Put pro nastavení hodnoty vlastnosti. Vyberte Získat, Vložit nebo obojí. Pokud vyberete Funkci Put, můžete si vybrat z následujících dvou způsobů implementace metody:

  Možnost	Popis
  propput	Funkce PropPut vrátí kopii objektu. propput je výchozí a nejběžnější způsob, jak vlastnost zapisovat.
  propputref	Funkce PropPutRef vrátí odkaz na objekt místo vrácení kopie samotného objektu. Zvažte použití propputref možnosti pro objekty, jako jsou velké struktury nebo pole, které můžou mít režii inicializace.

• Parametry

  Zobrazí seznam parametrů přidaných do vlastnosti. Každá položka v seznamu se skládá z názvu parametru, typu parametru a atributů.

  in označuje, že parametr je předán z volající procedury do volané procedury. out označuje, že parametr ukazatele je vrácen z volané procedury volající proceduře (ze serveru do klienta).

• +

  Přidejte parametr. Do pole Parametry zadejte typ a název parametru. Například int xa vyberte OK.

• x

  Odebere vybraný parametr z parametru Parameters.

• Ikona tužky

  Upravte vybraný parametr.

• Atributy

1. helpcontext

   Určuje ID kontextu, které uživateli umožňuje zobrazit informace o této vlastnosti v souboru nápovědy. Další informace naleznete v tématu helpcontext.

2. helpstring

   Určuje řetězec znaku, který se používá k popisu elementu, na který se vztahuje. Ve výchozím nastavení je nastavená na propertyNázev vlastnosti. Další informace naleznete v tématu helpstring.

3. id

   Nastaví číselný identifikátor, který identifikuje vlastnost. Tato možnost není k dispozici pro vlastnosti vlastních rozhraní. Další informace naleznete v tématu id.

• Další atributy

Klíčová slova v jazyce MIDL (Microsoft Interface Definition Language) jsou podrobně popsána v referenčních informacích k jazyku MIDL.

Možnost	Popis
bindable	Označuje, že vlastnost podporuje datové vazby. Další informace naleznete v tématu bindable.
defaultbind	Označuje, že tato jednoduchá vázatelná vlastnost nejlépe představuje objekt. Další informace najdete v tématu defaultbind.
defaultcollelem	Označuje, že vlastnost je přistupnou funkcí pro prvek výchozí kolekce. Další informace naleznete v tématu defaultcollelem.
displaybind	Označuje, že tato vlastnost by měla být uživateli zobrazena jako svázání. Další informace naleznete v tématu displaybind.
hidden	Označuje, že vlastnost existuje, ale neměla by se zobrazovat v prohlížeči orientovaném na uživatele. Další informace naleznete v tématu hidden.
immediatebind	Označuje, že databáze bude okamžitě informována o všech změnách této vlastnosti objektu vázaného na data. Další informace naleznete v tématu immediatebind.
local	Určuje pro kompilátor MIDL, že vlastnost není vzdálená. Další informace naleznete v tématu local.
nonbrowsable	Označí rozhraní nebo člen dispinterface, který by se neměl zobrazovat v prohlížeči vlastností. Další informace naleznete v tématu nonbrowsable.
requestedit	Označuje, že vlastnost podporuje OnRequestEdit oznámení. Další informace naleznete v tématu requestedit.
restricted	Určuje, že vlastnost nelze volat libovolně. Další informace naleznete v tématu restricted.
source	Označuje, že člen vlastnosti je zdrojem událostí. Další informace naleznete v tématu source.

Viz také

Přidat vlastnost
Přidání vlastnosti IDL MFC