Sdílet prostřednictvím

Zobrazované názvy tříd a atributů

  • Článek

Specifikátor zobrazení pro třídu objektu obsahuje následující atributy, které lze použít k určení lokalizovaných zobrazovaných názvů používaných v uživatelském rozhraní pro objekty této třídy:

  • Atribut classDisplayName je řetězec Unicode s jednou hodnotou, který určuje zobrazovaný název třídy.
  • Atribut attributeDisplayNames atribut je vlastnost s více hodnotami, která určuje názvy, které se mají použít v uživatelském rozhraní pro atributy třídy objektu.

Hodnoty atributu DisplayNames jsou řetězce Unicode; každý prvek se skládá z dvojice názvů oddělených čárkami:

<attribute name>,<display text>

V tomto příkladu je "<název atributu>" je lDAPDisplayName atributu a "<zobrazovaný text>" je text, který se má zobrazit jako název tohoto atributu v uživatelském rozhraní.

Pokyny pro zobrazované názvy tříd a atributů

Vzhledem k tomu, že mnoho dodavatelů může rozšiřovat třídy o nové atributy nebo vytvářet zcela nové třídy, je důležité, aby zobrazované názvy tříd a atributů byly jednoznačné a neměly by vést ke konfliktům.

Každý dodavatel by měl předponu zobrazovaného názvu třídy s jedinečným popisným identifikátorem na základě názvu dodavatele. Pokud například fiktivní společnost Fabrikam Inc., vytvoří novou třídu odvozenou z třídy "kontakt", může mít jedinečný zobrazovaný název třídy "Fabrikam Contact".

Pokud dodavatel rozšiřuje existující třídu o nové atributy, měli by znovu jednoznačně identifikovat zobrazovaný název atributu, aby nedošlo ke konfliktům s jinými zobrazovanými názvy atributů. Opět platí, že předpona zobrazovaného názvu atributu s jedinečným popisným identifikátorem na základě názvu dodavatele je dobrým postupem. Pokud například společnost Fabrikam rozšiřuje třídu uživatelů o nový atribut personálního oddělení, může atribut jedinečně zobrazit jako "Informace o Fabrikam HR Information".

Kromě toho by každý dodavatel měl z hlediska lokalizace lokalizovat zobrazované názvy tříd a atributů do každého jazyka podporovaného systémem Windows 2000.

Přidání hodnoty do atributuDisplayNames

Přidání hodnoty mapování názvů do atributu attributeDisplayNames atributu

  1. Určete, jestli existuje hodnota mapování názvu pro atribut. Pokud má být hodnota mapování názvů nahrazena, odstraňte nejprve existující hodnotu pomocí metody ID::P utEx s parametrem lnControlCode nastaveným na ADS_PROPERTY_DELETE a parametr vProp nastaven na hodnotu, kterou chcete odebrat. Nepoužívejte ADS_PROPERTY_CLEAR ani ADS_PROPERTY_UPDATE pro lnControlCode .
  2. Vytvořte řetězec, který představuje zobrazovaný název atributu. Příklad najdete ve výše uvedeném formátu.
  3. K přidání nové hodnoty použijte metodu ID::P utEx s parametrem lnControl Code nastaveným na ADS_PROPERTY_APPEND.
  4. Volání ID::SetInfo potvrzení změn do adresáře.

Další informace o pojmenování nových tříd a atributů naleznete v tématu Pojmenování atributů a tříd.