Aracılığıyla paylaş


Stiller Denetim Deseni

IStylesProvideruygulamak için özellikler ve yöntemler hakkında bilgiler de dahil olmak üzere yönergeleri ve kuralları açıklar. Stilleri denetim düzeni, belirli bir stile, dolgu rengine, dolgu desenine veya şekle sahip bir kullanıcı arabirimi öğesini tanımlamak için kullanılır.

Stilleri denetim deseni, belgedeki öğeleri tanımlamak için özellikle yararlıdır ve bu tür stiller sık sık bulunur. Stiller genellikle engelli müşteriler için yararlı olan bilgileri taşır; örneğin, stil belirli bir dizeyi belgenin başlığı olarak veya belirli bir akış çizelgesi nesnesini elmas veya daire olarak tanımlayabilir. Bu denetim desenini uygulayan denetim örnekleri için bkz. Denetim Türleri ve Desteklenen Denetim Desenleri.

Bu konu aşağıdaki bölümleri içerir.

Uygulama Yönergeleri ve Kuralları

Stilleri denetim desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:

  • UIAutomationClient.h üst bilgi dosyası, çeşitli ortak stilleri tanımlamak için kullanılan adlandırılmış sabit değerler kümesini tanımlar. Daha fazla bilgi için bkz. Stil Tanımlayıcıları.
  • StyleId_Customkullanıyorsanız, istemcilerin stilin adını bulmasını sağlamak için IStylesProvider::StyleNameözelliğini uygulamanız gerekir. Microsoft UI Otomasyonu varsayılan bir ad sağladığından standart stil için StyleName özelliğini uygulamanız gerekmez, ancak varsayılan adı geçersiz kılmanız gerekiyorsa bunu uygulayabilirsiniz.
  • Stilleri desenindeki diğer özellikler isteğe bağlıdır; sağlayıcı desteklenmeyen bir özellik için UIA_E_NOTSUPPORTED döndürebilir.
  • Metin aralığındaki stiller aşağıdaki metin öznitelikleriyle gösterilebilir:
    • StyleId metin özniteliği isteğine yanıt verirken, metin aralığı Stil Tanımlayıcıları'nde açıklanan stil tanımlayıcılarından birini döndürmelidir.
    • StyleId_Custom kullanılırsa, istemcilerin stil adını bulmasını sağlamak için metin aralığı StyleName metin özniteliği için bir dize değeri döndürmelidir.
    • Hem başlık hem de normal metin gibi birden çok stile sahip bir metin aralığı, hem StyleId hem de StyleName özellikleri için özel UI Otomasyonu ReservedMixedAttributeValue özelliğini döndürmelidir. Bu yanıtı alan bir istemci, stillerin nereden başlayıp biteceğini bulmak için metin aralığını alt bölümlere ayırabilir.
  • Uygulamalar nesneleri açıklamak için çok çeşitli stiller kullanabilir, ancak UI Otomasyonu yalnızca en yaygın stilleri temsil eder. Bir sağlayıcı, kenarlık rengi gibi ek stil özniteliklerini temsil etmek için ExtendedProperties özelliğinde ek özniteliklerin listesini döndürebilir. Bu temelde "BorderColor=0xFF0000; BorderStyle=dotted". Genişletilmiş özelliklerin değerleri uygulamaya özgü olabilir.

IStylesProvider için Gerekli Üyeler

IStylesProvider arabirimini uygulamak için aşağıdaki özellikler gereklidir.

Gerekli üyeler Üye türü Notlar
ExtendedProperties Mülk Hiç kimse
FillColor Mülk Hiç kimse
FillPatternColor Mülk Hiç kimse
FillPatternStyle Mülk Hiç kimse
Şekil Mülk Hiç kimse
StyleId Mülk Hiç kimse
StyleName Mülk Hiç kimse

 

Bu denetim deseninde ilişkili yöntem veya olay yok.

Denetim Türlerini ve Desteklenen Denetim Desenlerini

UI Otomasyonu Denetim Desenlerine Genel Bakış

UI Otomasyon Ağacına Genel Bakış