物件狀態常數

本主題描述用來描述應用程式 UI 中物件狀態的常數值。 狀態常數定義于 oleacc.h 中。

物件隨時會與一或多個這些狀態值相關聯。 未使用下列物件狀態常數:STATE_SYSTEM_ALERT_HIGH、STATE_SYSTEM_ALERT_MEDIUM、STATE_SYSTEM_ALERT_LOW和STATE_SYSTEM_FLOATING。

用戶端會呼叫 IAccessible::get_accState來擷取物件的狀態,它會傳回整數,這是下列位旗標的組合。 用戶端會使用狀態值呼叫 GetStateText ,以擷取描述物件狀態的當地語系化字串。

當物件的狀態變更時,伺服器應該使用EVENT_OBJECT_STATECHANGE事件常數呼叫NotifyWinEvent。 不過,具有STATE_SYSTEM_INVISIBLE、STATE_SYSTEM_FOCUSED和STATE_SYSTEM_ SELECTED 物件狀態常數的物件都有自己的事件常數。 對於這些物件,請勿使用 EVENT_OBJECT_STATECHANGE。 請改用個別的事件常數。

以下是物件狀態常數:

常數 描述
STATE_SYSTEM_ALERT_HIGH
(不支援此物件狀態常數。)
指出要立即傳達給使用者的重要資訊。 例如,當電池達到嚴重低等級時,層級指標會產生高階警示。 因此,盲目存取工具會立即向使用者宣佈這項資訊,而螢幕放大程式會捲動螢幕,讓電池指示器處於檢視狀態。 這個狀態也適用於必須先完成,使用者才能夠繼續的任何提示或作業。
STATE_SYSTEM_ALERT_MEDIUM
(不支援此物件狀態常數。)
指出未立即傳達給使用者的重要資訊。 例如,當電池開始達到低階時,層級指標會產生中階警示。 然後,盲目存取工具會產生音效,讓使用者知道有重要資訊可供使用,而不會實際中斷使用者的工作。 使用者接著可以在方便時查詢警示資訊。
STATE_SYSTEM_ALERT_LOW
(不支援此物件狀態常數。)
指出對使用者而言不重要的低優先順序資訊。 例如,Word 變更工具列上 TipWizard 按鈕的外觀,以指出其具有使用者的提示時,會使用此狀態。
STATE_SYSTEM_ANIMATED
物件的外觀會快速或不斷變更。 有時候以動畫顯示圖形會描述為 ROLE_SYSTEM_GRAPHIC ,並將 State 屬性設定為 STATE_SYSTEM_ANIMATED。 這個狀態是用來指出物件的位置正在變更。
STATE_SYSTEM_BUSY
控制項目前無法接受輸入。
STATE_SYSTEM_CHECKED
已選取物件的核取方塊。
STATE_SYSTEM_COLLAPSED
隱藏具有 ROLE_SYSTEM_OUTLINEITEM角色的物件 子系。
STATE_SYSTEM_DEFAULT
此狀態代表視窗中的預設按鈕。
STATE_SYSTEM_EXPANDED
顯示具有 ROLE_SYSTEM_OUTLINEITEM 角色的物件子系。
STATE_SYSTEM_EXTSELECTABLE
表示物件在 IAccessible::accSelect 方法中使用 SELFLAG_EXTENDSELECTION 來擴充其選取範圍。
STATE_SYSTEM_FLOATING
(不支援此物件狀態常數。)
物件不會裁剪到其父物件的界限,而且不會在父物件移動時自動移動。
STATE_SYSTEM_FOCUSABLE
物件位於使用中視窗上,並準備好接收鍵盤焦點。
STATE_SYSTEM_FOCUSED
物件具有鍵盤焦點。 請勿將物件焦點與物件選取混淆。 如需詳細資訊,請參閱 選取範圍和焦點屬性和方法。 對於具有此物件狀態的物件,請傳送 EVENT_OBJECT_SHOWEVENT_OBJECT_HIDE WinEvents,以通知用戶端應用程式狀態變更。 請勿使用 EVENT_OBJECT_STATECHANGE
STATE_SYSTEM_HASPOPUP
叫用時,物件會顯示快顯視窗或視窗。
STATE_SYSTEM_HOTTRACKED
物件是由滑鼠熱追蹤,這表示物件的外觀已變更,表示滑鼠指標位於該物件上方。
STATE_SYSTEM_INVISIBLE
物件是以程式設計方式隱藏的。 例如,功能表 itmes 會以程式設計方式隱藏,直到使用者啟動功能表為止。 由於具有此狀態的物件無法供使用者使用,因此用戶端應用程式不得將物件的相關資訊傳達給使用者。 不過,如果用戶端應用程式找到具有此狀態的物件,則應該檢查是否也會設定STATE_SYSTEM_OFFSCREEN。 如果已定義此第二個狀態,用戶端可以將物件的相關資訊傳達給使用者。 例如,清單方塊可以同時設定STATE_SYSTEM_INVISIBLE和STATE_SYSTEM_OFFSCREEN。 在此情況下,用戶端應用程式可以將清單中的所有專案傳達給使用者。
如果用戶端應用程式正在流覽 IAccessible 樹狀結構,並遇到不可見的父物件,只要父系不可見,Microsoft Active Accessibility 將不會公開父系任何可能子系的相關資訊。
STATE_SYSTEM_LINKED
表示物件格式化為超連結。 物件的角色通常會 ROLE_SYSTEM_TEXT
STATE_SYSTEM_MARQUEED
表示捲動或移動文字或圖形。
STATE_SYSTEM_MIXED
表示未判斷三狀態核取方塊或工具列按鈕的狀態。 核取方塊不會選取或清除,因此處于第三個或 混合 狀態。
STATE_SYSTEM_MOVEABLE
表示可以移動物件。 例如,使用者可以按一下物件的標題列,並將物件拖曳至新的位置。
STATE_SYSTEM_MULTISELECTABLE
表示物件接受多個選取的專案;也就是說,IAccessible::accSelect方法SELFLAG_ADDSELECTION有效。
STATE_SYSTEM_NORMAL
表示物件沒有指派另一個狀態。
STATE_SYSTEM_OFFSCREEN
物件已裁剪或已從檢視中捲動,但不會以程式設計方式隱藏。 如果使用者讓檢視區變大,則會在電腦畫面上看到更多物件。
STATE_SYSTEM_PRESSED
按下物件。
STATE_SYSTEM_PROTECTED
物件是受密碼保護的編輯控制項。
STATE_SYSTEM_READONLY
物件是指定為唯讀的。
STATE_SYSTEM_SELECTABLE
物件接受選取範圍。
STATE_SYSTEM_SELECTED
已選取物件。
STATE_SYSTEM_SELFVOICING
物件或子系會使用文字轉換語音 (TTS) 技術進行描述。 當具有此狀態的物件有焦點時,語音型協助工具協助工具不會宣告資訊,因為物件會自動宣告資訊。
STATE_SYSTEM_SIZEABLE
物件可以調整大小。 例如,使用者可以藉由拖曳框線來變更視窗的大小。
STATE_SYSTEM_TRAVERSED
物件是使用者先前按一下) (流覽過的超連結。
STATE_SYSTEM_UNAVAILABLE
物件無法使用。

規格需求

需求
標頭
Oleacc.h