物件狀態常數

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

物件隨時都與一或多個這些狀態值相關聯。 不使用下列物件狀態常數:狀態 _ 系統 _ 警示 _ 高、狀態 _ 系統 _ 警示 _ 媒體、狀態 _ 系統 _ 警示 _ 低和狀態 _ 系統 _ 浮動。

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

當物件的狀態變更時,伺服器應該使用 事件 _ 物件 _ STATECHANGE事件常數來呼叫 NotifyWinEvent 。 不過,具有狀態系統的 _ 物件 _ 不可見、以狀態 _ 系統為 _ 焦點,以及狀態 _ 系統 _ 選取的物件狀態常數都有自己的事件常數。 若為這些物件,請勿使用 事件 _ 物件 _ STATECHANGE。 相反地,請使用個別的事件常數。

以下是物件狀態常數:

常數 描述
狀態 _ 系統 _ 警示 _ 高
(不支援此物件狀態常數。 )
表示要立即傳達給使用者的重要資訊。 例如,當電池達到極低等級時,層級指標會產生高階警示。 如此一來,盲人存取工具會立即將此資訊公佈給使用者,螢幕放大程式會滾動螢幕,讓電池指示器處於視野中。 這個狀態也適用於必須先完成,使用者才能夠繼續的任何提示或作業。
狀態 _ 系統 _ 警示 _ 媒體
(不支援此物件狀態常數。 )
表示不會立即傳達給使用者的重要資訊。 例如,當電池開始達到低層級時,層級指標會產生中等層級的警示。 接著會產生音效,讓使用者知道有重要的資訊可供使用,而不會實際中斷使用者的工作。 然後使用者可以在方便時查詢警示資訊。
狀態 _ 系統 _ 警示 _ 低
(不支援此物件狀態常數。 )
指出對使用者而言不重要的低優先順序資訊。 例如,當 Word 變更工具列上的 [自動完成] 按鈕的外觀,表示它有使用者的提示時,就會使用此狀態。
狀態 _ 系統 _ 動畫
物件的外觀會快速或不斷地變更。 偶爾動畫的圖形會描述為 角色 _ 系統 _ 圖形 ,並將 [狀態] 屬性設定為 [狀態 _ 系統動畫] _ 。 此狀態是用來表示物件的位置正在變更。
狀態 _ 系統 _ 忙碌中
此控制項目前無法接受輸入。
狀態 _ 系統 _ 已核取
已選取物件的核取方塊。
狀態系統已折迭 _ _
物件具有 角色 _ 系統 _ OUTLINEITEM 角色的子系會隱藏。
狀態 _ 系統 _ 預設值
此狀態代表視窗中的預設按鈕。
狀態 _ 系統已 _ 展開
顯示具有 角色 _ 系統 _ OUTLINEITEM 角色之物件的子系。
狀態 _ 系統 _ EXTSELECTABLE
表示物件會在 IAccessible:: accSelect 方法中使用 SELFLAG _ EXTENDSELECTION 來擴充其選取專案。
狀態 _ 系統 _ 浮動
(不支援此物件狀態常數。 )
物件不會裁剪至其父物件的界限,且不會在父代移動時自動移動。
狀態 _ 系統可 _ 設定焦點
物件位於使用中視窗上,並已準備好接收鍵盤焦點。
以狀態 _ 系統為 _ 焦點
物件具有鍵盤焦點。 請勿將物件焦點與物件選取專案混淆。 如需詳細資訊,請參閱 選取專案和焦點屬性和方法。 針對具有此物件狀態的物件,傳送 事件 _ 物件 _ 顯示事件 _ 物件 _ 隱藏 WinEvents,以通知用戶端應用程式有關狀態變更。 請勿使用 事件 _ 物件 _ STATECHANGE
狀態 _ 系統 _ HASPOPUP
叫用時,物件會顯示快顯功能表或視窗。
狀態 _ 系統 _ HOTTRACKED
此物件是由滑鼠熱追蹤,這表示物件的外觀已變更,表示滑鼠指標位於其上方。
狀態 _ 系統 _ 隱藏
以程式設計方式隱藏物件。 例如,在使用者啟動功能表之前,會以程式設計的方式隱藏功能表 itmes。 由於使用者無法使用具有此狀態的物件,因此用戶端應用程式不能將物件的相關資訊傳達給使用者。 但是,如果用戶端應用程式找到具有此狀態的物件,則應該檢查是否也設定了 [狀態 _ 系統] _ 。 如果已定義第二個狀態,用戶端可以將物件的相關資訊傳達給使用者。 例如,清單方塊可以同時設定 [狀態 _ 系統] _ 和 [狀態 _ 系統] _ 。 在此情況下,用戶端應用程式可以將清單中的所有專案傳達給使用者。
如果用戶端應用程式是在 IAccessible 樹狀結構中流覽,而且遇到不可見的父物件,Microsoft Active Accessibility 將不會公開父系的任何可能子系的相關資訊,只要父系為不可見。
狀態 _ 系統 _ 連結
指出物件已格式化為超連結。 物件的角色通常會是 角色 _ 系統 _ 文字
狀態 _ 系統 _ MARQUEED
表示滾動或移動文字或圖形。
狀態 _ 系統 _ 混合
指出未判斷出三個狀態核取方塊或工具列按鈕的狀態。 此核取方塊未選取或清除,因此在第三個或 混合 狀態。
狀態 _ 系統 _ 可移動
指出物件可以移動。 例如,使用者可以按一下物件的標題列,並將物件拖曳至新的位置。
狀態 _ 系統 _ MULTISELECTABLE
表示物件接受多個選取的專案;也就是說, IAccessible:: accSelect方法的 SELFLAG _ ADDSELECTION是有效的。
狀態 _ 系統 _ 正常
指出物件沒有指派給它的另一個狀態。
狀態 _ 系統 _ 外
物件已裁剪或已向外滾動,但不是以程式設計方式隱藏。 如果使用者讓視口更大,則會在電腦螢幕上看到更多物件。
已 _ _ 按下狀態系統
已按下物件。
狀態 _ 系統 _ 受保護
物件是受密碼保護的編輯控制項。
狀態 _ 系統 _ READONLY
物件已指定為唯讀。
狀態 _ 系統可 _ 選取
物件接受選取專案。
選取的狀態 _ 系統 _
已選取物件。
狀態 _ 系統 _ SELFVOICING
物件或子系使用文字轉換語音 (TTS) 技術做為描述之用。 當具有此狀態的物件具有焦點時,以語音為基礎的協助工具協助工具將不會宣告資訊,因為物件會自動宣佈資訊。
狀態 _ 系統 _ 相當大
可以調整大小的物件。 例如,使用者可以藉由拖曳框線來變更視窗的大小。
已進行狀態 _ 系統 _
物件是已造訪 (使用者先前按一下) 的超連結。
狀態 _ 系統 _ 無法使用
無法使用物件。

規格需求

需求
標頭
Oleacc。h