Sdílet prostřednictvím

Model ovládacího prvku hodnoty

  • Článek

Popisuje pokyny a konvence pro implementaci IValueProvider, včetně informací o vlastnostech a metodách. Vzor ovládacího prvku Hodnota slouží k podpoře ovládacích prvků, které mají vnitřní hodnotu, která nepřebírají rozsah a mohou být reprezentována jako řetězec.

Řetězec hodnoty lze upravit v závislosti na ovládacím prvku a jeho nastavení. Příklady ovládacích prvků, které tento vzor ovládacích prvků implementují, najdete v tématu typy ovládacích prvků a jejich podporované vzory ovládacích prvků.

Toto téma obsahuje následující části.

Pokyny a konvence implementace

Při implementaci vzoru kontroly hodnota si všimněte následujících pokynů a konvencí:

  • Ovládací prvky, jako je položka seznamu nebo položka stromu, musí podporovat hodnotu vzor ovládacího prvku, pokud je možné upravit hodnotu některé položky bez ohledu na aktuální režim úprav ovládacího prvku. Nadřazený ovládací prvek musí také podporovat Hodnotu vzor ovládacího prvku, pokud jsou podřízené položky upravitelné. Následující obrázek ukazuje příklad upravitelné položky seznamu.

    obrázek znázorňující upravitelnou položku seznamu

  • Ovládací prvky pro úpravy s jedním a více řádky musí implementovat ITextProvider, aby se zpřístupnil jejich obsah jen pro čtení.

  • Víceřádkové ovládací prvky úprav musí implementovat IValueProvider, pokud je možné jejich obsah změnit.

  • IValueProvider nepodporuje načítání informací o formátování ani hodnot podřetětěc. V těchto scénářích implementujte ITextProvider.

  • IValueProvider musí být implementovány ovládacími prvky, jako je například ovládací prvek pro výběr barvy z Microsoft Wordu (viz následující obrázek), který podporuje mapování řetězců mezi hodnotou barvy (například "žlutá") a ekvivalentní interní RGB hodnotu.

    obrázek znázorňující mapování řetězců vzorníků barev

  • Ovládací prvek by měl mít vlastnost IsEnabled nastavena na TRUE a jeho ITextProvider::IsReadOn ly vlastnost nastavena na FALSE předtím, než povolí volání ITextProvider::SetValue.

Požadované členy pro IValueProvider

Pro implementaci rozhraní IValueProvider jsou vyžadovány následující vlastnosti a metody.

Požadované členy Typ členu Poznámky
IsReadOnly Vlastnost Žádný
hodnoty Vlastnost Žádný
SetValue Metoda Žádný

 

Tento vzor ovládacího prvku nemá žádné přidružené události.

typy ovládacích prvků a jejich podporované vzory ovládacích prvků

Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní

Přehled stromu automatizace uživatelského rozhraní

vzory ovládacích prvků Text a TextRange