Nesne Durumu Sabitleri
Bu konuda, uygulama kullanıcı arabirimindeki nesnelerin durumunu açıklamak için kullanılan sabit değerler açıklanmaktadır. Durum sabitleri oleacc.h dosyasında tanımlanır.
Bir nesne, bu durum değerlerinden herhangi bir anda bir veya daha fazlasıyla ilişkilendirilir. Aşağıdaki nesne durumu sabitleri kullanılmaz: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW ve STATE_SYSTEM_FLOATING.
İstemciler, aşağıdaki bit bayraklarının birleşimi olan bir tamsayı döndüren IAccessible::get_accStateçağrısı yaparak bir nesnenin durumunu alır. İstemciler, nesnenin durumunu açıklayan yerelleştirilmiş bir dizeyi almak için durum değeriyle GetStateText çağırır.
Bir nesnenin durumu değiştiğinde, sunucular EVENT_OBJECT_STATECHANGE olay sabitiyle NotifyWinEvent çağırmalıdır. Ancak, STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED ve STATE_SYSTEM_ SELECTED nesne durumu sabitlerine sahip nesnelerin kendi olay sabitleri vardır. Bu nesneler için EVENT_OBJECT_STATECHANGEkullanmayın. Bunun yerine tek tek olay sabitini kullanın.
Nesne durumu sabitleri şunlardır:
| Sabit | Açıklama |
|---|---|
|
STATE_SYSTEM_ALERT_HIGH 0x10000000 |
(Bu nesne durumu sabiti desteklenmiyor.) Kullanıcıya hemen iletilmesi gereken önemli bilgileri gösterir. Örneğin, bir pil kritik düzeyde düşük bir düzeye ulaştığında, düzey göstergesi üst düzey bir uyarı oluşturur. Sonuç olarak, bir kör erişim aracı bu bilgileri kullanıcıya hemen duyurur ve bir ekran büyütme programı ekranı kaydırarak pil göstergesinin görünür durumda olmasını sağlar. Bu durum, kullanıcının devam etmesi için tamamlanması gereken tüm istemler veya işlemler için de uygundur. |
|
STATE_SYSTEM_ALERT_MEDIUM 0x8000000 |
(Bu nesne durumu sabiti desteklenmiyor.) Kullanıcıya hemen aktarılmayan önemli bilgileri gösterir. Örneğin, bir pil düşük bir düzeye ulaşmaya başladığında, düzey göstergesi orta düzey bir uyarı oluşturur. Ardından bir kör erişim aracı, kullanıcının çalışmasını kesintiye uğratmadan önemli bilgilerin kullanılabilir olduğunu kullanıcıya bildirmek için bir ses oluşturur. Kullanıcı daha sonra uygun olduğunda uyarı bilgilerini sorgulayabilir. |
|
STATE_SYSTEM_ALERT_LOW 0x4000000 |
(Bu nesne durumu sabiti desteklenmiyor.) Kullanıcı için önemli olmayan düşük öncelikli bilgileri gösterir. Bu durum, örneğin Word kullanıcı için bir ipucu olduğunu belirtmek üzere araç çubuğundaki İpucuWizard düğmesinin görünümünü değiştirdiğinde kullanılır. |
|
STATE_SYSTEM_ANIMATED 0x4000 |
Nesnenin görünümü hızla veya sürekli olarak değişir. Zaman zaman animasyonlu grafikler, State özelliği STATE_SYSTEM_ANIMATED olarak ayarlanmış ROLE_SYSTEM_GRAPHIC olarak tanımlanır. Bu durum, nesnenin konumunun değiştiğini belirtmek için kullanılır. |
|
STATE_SYSTEM_BUSY 0x800 |
Denetim şu anda girişi kabul edemiyor. |
|
STATE_SYSTEM_CHECKED 0x10 |
Nesnenin onay kutusu seçilidir. |
|
STATE_SYSTEM_COLLAPSED 0x400 |
nesnenin ROLE_SYSTEM_OUTLINEITEM rolüne sahip alt öğeleri gizlenir. |
|
STATE_SYSTEM_DEFAULT 0x100 |
Bu durum, bir penceredeki varsayılan düğmeyi temsil eder. |
|
STATE_SYSTEM_EXPANDED 0x200 |
nesnenin ROLE_SYSTEM_OUTLINEITEM rolüne sahip alt öğeleri görüntülenir. |
|
STATE_SYSTEM_EXTSELECTABLE 0x2000000 |
Bir nesnenin IAccessible::accSelect yönteminde SELFLAG_EXTENDSELECTION kullanarak seçimini genişletdiğini gösterir. |
|
STATE_SYSTEM_FLOATING 0x1000 |
(Bu nesne durumu sabiti desteklenmiyor.) Nesne üst nesnesinin sınırına kırpılmaz ve üst nesne taşındığında otomatik olarak taşınmaz. |
|
STATE_SYSTEM_FOCUSABLE 0x100000 |
Nesne etkin pencerededir ve klavye odağını almaya hazırdır. |
|
STATE_SYSTEM_FOCUSED 0x4 |
Nesne, klavye odağına sahiptir. Nesne odağını nesne seçimiyle karıştırmayın. Daha fazla bilgi için bkz. Seçim ve Odak Özellikleri ve Yöntemleri. Bu nesne durumuna sahip nesneler için EVENT_OBJECT_SHOW veya EVENT_OBJECT_HIDE WinEvents'i göndererek istemci uygulamalarına durum değişikliklerini bildirin.
EVENT_OBJECT_STATECHANGEkullanmayın. |
|
STATE_SYSTEM_HASPOPUP 0x40000000 |
Çağrıldığında nesne bir açılır menü veya pencere görüntüler. |
|
STATE_SYSTEM_HOTTRACKED 0x80 |
Nesne fare tarafından çalışırken izlenir, yani nesnenin görünümü fare işaretçisinin üzerinde bulunduğunu gösterecek şekilde değişmiştir. |
|
STATE_SYSTEM_INVISIBLE 0x8000 |
Nesne program aracılığıyla gizlenir. Örneğin, kullanıcı menüyü etkinleştirene kadar menü itme'leri program aracılığıyla gizlenir. Bu duruma sahip nesneler kullanıcılar tarafından kullanılamadığından, istemci uygulamaları nesne hakkındaki bilgileri kullanıcılara iletmemelidir. Ancak, istemci uygulamaları bu duruma sahip bir nesne bulursa, STATE_SYSTEM_OFFSCREEN de ayarlanıp ayarlanmadığını denetlemelidir. Bu ikinci durum tanımlanmışsa, istemciler nesne hakkındaki bilgileri kullanıcılara iletebilir. Örneğin, liste kutusunda hem STATE_SYSTEM_INVISIBLE hem de STATE_SYSTEM_OFFSCREEN ayarlanmış olabilir. Bu durumda, istemci uygulaması listedeki tüm öğeleri kullanıcılara iletebilir. İstemci uygulaması IAccessible ağacında geziniyorsa ve görünmez bir üst nesneyle karşılaşırsa, Üst öğe görünmez olduğu sürece Microsoft Etkin Erişilebilirlik üst öğedeki olası alt öğeler hakkındaki bilgileri kullanıma sunmaz. |
|
STATE_SYSTEM_LINKED 0x400000 |
Nesnenin köprü olarak biçimlendirildiğini gösterir. Nesnenin rolü genellikle ROLE_SYSTEM_TEXTolur. |
|
STATE_SYSTEM_MARQUEED 0x2000 |
Metni veya grafikleri kaydırmayı veya taşımayı gösterir. |
|
STATE_SYSTEM_MIXED 0x20 |
Üç durumlu onay kutusunun veya araç çubuğu düğmesinin durumunun belirlenmediğini gösterir. Onay kutusu seçili veya temizlenmemiştir ve bu nedenle üçüncü veya karma durumundadır. |
|
STATE_SYSTEM_MOVEABLE 0x40000 |
Nesnenin taşınabileceğini gösterir. Örneğin, kullanıcı nesnenin başlık çubuğuna tıklayıp nesneyi yeni bir konuma sürükleyebilir. |
|
STATE_SYSTEM_MULTISELECTABLE 0x1000000 |
Nesnenin birden çok seçili öğeyi kabul ettiğini gösterir; yani, IAccessible::accSelect yöntemi için SELFLAG_ADDSELECTION geçerlidir. |
|
STATE_SYSTEM_NORMAL 0 |
Nesneye atanmış başka bir durum olmadığını gösterir. |
|
STATE_SYSTEM_OFFSCREEN 0x10000 |
Nesne kırpılır veya görüntü dışına kaydırılır, ancak program aracılığıyla gizlenmemiştir. Kullanıcı görünüm penceresi büyütürse, nesnenin daha fazlası bilgisayar ekranında görünür. |
|
STATE_SYSTEM_PRESSED 0x8 |
Nesneye basılır. |
|
STATE_SYSTEM_PROTECTED 0x20000000 |
Nesnesi, parola korumalı bir düzenleme denetimidir. |
|
STATE_SYSTEM_READONLY 0x40 |
Nesne salt okunur olarak belirlenir. |
|
STATE_SYSTEM_SELECTABLE 0x200000 |
Nesnesi seçimi kabul eder. |
|
STATE_SYSTEM_SELECTED 0x2 |
Nesne seçilir. |
|
STATE_SYSTEM_SELFVOICING 0x80000 |
Nesne veya alt öğe, açıklama amacıyla metin okuma (TTS) teknolojisini kullanır. Bu duruma sahip bir nesne odaklandığında, nesne otomatik olarak duyurur çünkü konuşma tabanlı erişilebilirlik yardımı bilgileri duyurmaz. |
|
STATE_SYSTEM_SIZEABLE 0x20000 |
Nesne yeniden boyutlandırılabilir. Örneğin, bir kullanıcı pencerenin boyutunu kenarlıkla sürükleyerek değiştirebilir. |
|
STATE_SYSTEM_TRAVERSED 0x800000 |
Nesne, bir kullanıcı tarafından ziyaret edilen (daha önce tıklanan) bir köprüdür. |
|
STATE_SYSTEM_UNAVAILABLE 0x1 |
Nesne kullanılamıyor. |
Gereksinim -leri
| Gereksinim | Değer |
|---|---|
| Üstbilgi |
Oleacc.h |