Sdílet prostřednictvím


Názvy, Průvodce přidáním vlastnosti

Tento průvodce slouží pro přidání vlastnosti k rozhraní.

  • Typ vlastnosti
    Nastaví typ přidávané vlastnosti.Pro odesílající rozhraní knihovny MFC zadejte vlastní typ, nebo jej vyberte z předdefinovaného seznamu.Pokud zadáte uloženou implementaci vlastnosti, je Typ vlastnosti nastaven na uložený typ a není možné jej změnit.

  • Název vlastnosti
    Nastaví název vlastnosti.Pro odesílající rozhraní knihovny MFC přidružené k ovládacímu prvku ActiveX lze zadat vlastní název, nebo můžete zvolit uložený název vlastnosti z předdefinovaného seznamu.Pokud zadáte vlastní název vlastnosti, není Uložený typ implementace k dispozici.Popis vlastností v seznamu naleznete v tématu Uložené vlastnosti.

    Typ rozhraní

    Description

    Duální rozhraní ATL, vlastní rozhraní a vlastní místní rozhraní

    Zadejte název vlastnosti.

    Odesílající rozhraní MFC, odesílající rozhraní ovládacího prvku MFC ActiveX

    Zadejte název vlastnosti nebo vyberte uloženou vlastnost ze seznamu.Pokud vyberete vlastnost ze seznamu, objeví se odpovídající hodnota v políčku Typ vlastnosti.Tento typ je možné změnit v závislosti na vašem výběru v položce Typ implementace.

  • Návratový typ;
    Pouze rozhraní knihovny ATL.Nastaví návratový typ pro vlastnost.Pro duální rozhraní je vždy návratovým typem HRESULT a toto políčko není k dispozici. Pro vlastní rozhraní můžete vybrat návratový typ ze seznamu.Je však doporučován HRESULT, protože poskytuje standardní způsob vrácení chyb.

  • Název proměnné
    Pouze odesílající rozhraní knihovny MFC.K dispozici pouze v případě, že zadáte Členská proměnná pod Typ implementace.Nastaví název členské proměnné související s vlastnosti.Ve výchozím nastavení je název proměnné nastaven na m_PropertyName.Tento název lze změnit.

  • Funkce oznámení
    Pouze odesílající rozhraní knihovny MFC.K dispozici pouze v případě, že zadáte Členská proměnná pod Typ implementace.Nastaví název funkce oznámení volané v případě změny vlastnosti.Ve výchozím nastavení je název funkce oznámení nastaven na OnPropertyNameChanged.Tento název lze změnit.

  • Funkce Get
    Pouze pro odesílající rozhraní knihovny MFC.K dispozici pouze v případě, že zadáte metody Get/Set pod Typ implementace.Nastaví název funkce pro získání vlastnosti.Ve výchozím nastavení je název funkce Get nastaven na GetPropertyName.Tento název lze změnit.Pokud toto jméno odstraníte, je funkce GetNotSupported vložena do mapy odesílaní rozhraní.Funkce GetPropertyName určuje vlastnost jako čitelnou.

  • Funkce Set
    Pouze odesílající rozhraní knihovny MFC.K dispozici pouze v případě, že zadáte metody Get/Set pod Typ implementace.Nastaví název funkce pro nastavení vlastnosti.Ve výchozím nastavení je název funkce Set nastaven na SetPropertyName.Tento název lze změnit.Pokud toto jméno odstraníte, je funkce SetNotSupported vložena do mapy odesílaní rozhraní.Funkce SetPropertyName určuje vlastnost jako zapisovatelnou.

  • Typ implementace
    Pouze odesílající rozhraní knihovny MFC.Určuje, jak implementovat vlastnost, kterou přidáváte.

    Typ implementace

    Description

    Uložená

    Určuje uloženou implementaci pro vlastnost vybranou v Název vlastnosti.Výchozí nastavení.Další informace naleznete v tématu Uložené vlastnosti.

    Pokud zadáte Uložená, pak je Typ vlastnosti, Typ parametru a Název parametru neaktivní.

    Členská proměnná

    Určuje, že vlastnost je přidána jako členská proměnná.Většinu vlastních a uložených vlastností lze přidat jako členskou proměnnou.Členskou proměnnou nelze zadat pro Titulek, hWnd, a textové vlastností.

    Obsahuje výchozí názvy v rámci Název proměnné a Funkce oznámení.Tento název lze změnit.

    Metody Get/Set

    Určuje, že vlastnost je přidána jako funkce GetPropertyName a SetPropertyName.Tyto názvy se zobrazí pod funkce Get a funkce Set.

    Výchozí Typ vlastnosti lze změnit na takový, který splňuje hodnotu funkce Get.Můžete určit parametry pro funkce Get a Set.

  • Funkce Get
    Pouze pro rozhraní ATL.Nastaví vlastnost jako čitelnou; to znamená, že vytvoří metodu Get pro získání této vlastnosti z objektu.Je třeba zvolit Get, Put, nebo obojí.

  • Funkce Put
    Pouze rozhraní knihovny ATL.Nastaví vlastnost jako zapisovatelnou; to znamená, že vytvoří metodu Put pro nastavení nebo „vložení” této vlastnosti objektu. Je třeba zvolit Get, Put, nebo obojí. Při výběru této možnosti lze zvolit z následujících dvou způsobu implementace metody:

    Možnost

    Description

    PropPut

    Funkce PropPut vrátí kopii objektu.Toto je výchozí a nejběžnější způsob vytvoření zapisovatelné vlastnosti.

    PropPutRef

    Funkce PropPutRef vrátí odkaz na objekt, namísto vrácení kopie objektu.Tuto možnost zvažte pro objekty, jako jsou například velké struktury nebo pole, které mohou mít velkou režii inicializace.

  • Atributy parametru
    Pouze rozhraní knihovny ATL.Nastaví, zda je parametr určený Názvem parametruin, out, obojí, nebo žádný z těchto.

    Možnost

    Description

    in

    Označuje, že parametr je předán z volající procedury do volané procedury.

    out

    Označuje, že ukazatel parametru je vrácen z volané procedury do volající procedury (ze serveru klientovi).

  • Typ parametru
    Nastaví datový typ parametru.Vyberte typ ze seznamu.

  • Název parametru
    Pokud má vlastnost parametry, nastaví název parametru přidávaného k vlastnosti.Po kliknutí na tlačítko Přidat se název parametru zobrazí v Seznam parametrů.

  • Seznam parametrů
    Zobrazuje seznam atributů, které mají být přidány k vlastnosti.Každá položka seznamu se skládá z názvu parametru, typu parametru a atributů.K aktualizaci seznamu použijte Přidat a Odstranit.

  • Přidejte
    Přidá parametr určený v Název parametru a Typ parametru do Seznam parametrů.Pro přidání parametru do seznamu je třeba kliknout na Přidat.

  • Remove
    Odebere parametr vybraný v Seznam parametrů.

  • Výchozí vlastnost
    Pouze odesílající rozhraní knihovny MFC.Nastaví tuto vlastnost jako výchozí pro rozhraní.Rozhraní může mít pouze jednu výchozí vlastnost; po zadání výchozí vlastnosti je toto políčko pro další přidávané vlastnosti nedostupné.

Viz také

Úkoly

Přidání vlastnosti

Implementace rozhraní

Referenční dokumentace

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