AccessibilityNodeInfo 類別

定義

命名空間:

Android.Views.Accessibility

組件:

Mono.Android.dll

此類別代表視窗內容的節點，以及可從其來源請求的動作。

[Android.Runtime.Register("android/view/accessibility/AccessibilityNodeInfo", DoNotGenerateAcw=true)]
public class AccessibilityNodeInfo : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/view/accessibility/AccessibilityNodeInfo", DoNotGenerateAcw=true)>]
type AccessibilityNodeInfo = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

AccessibilityNodeInfo

屬性

RegisterAttribute

實作

IParcelable IJavaObject IJavaPeerable IDisposable

備註

此類別代表視窗內容的節點，以及可從其來源請求的動作。 從視窗的角度 android.accessibilityservice.AccessibilityService 看，內容呈現為一棵可及性節點資訊樹狀結構，這些資訊可能與視圖階層一一對應，也可能不一定。 換句話說，自訂視圖可以自由地以無障礙節點資訊的樹狀結構來回報自己。 </p>

一旦無障礙節點資訊傳送到無障礙服務，該節點資訊即為不可變，呼叫狀態變異方法會產生錯誤。 看看 #setQueryFromAppProcessEnabled 你是否想檢查應用程式流程中的節點樹，作為測試或除錯工具。

請參閱 android.accessibilityservice.AccessibilityService 有關如何取得視窗內容的句柄作為可存取節點資訊樹狀結構的詳細資訊，以及安全性模型的詳細資訊。

<div class=“特殊參考”><h3>開發者指南</h3>

欲了解更多關於讓應用程式無障礙的資訊，請閱讀 無障礙 開發者指南。

</div> “note”b><> 注意：</b> 請使用 <androidx.core.view.accessibility.AccessibilityNodeInfoCompat></c> 包裝器來取代此類別以提升向下相容性。 </旁白>

Java 文件 android.view.accessibility.AccessibilityNodeInfo。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
AccessibilityNodeInfo()	會產生一個新的 AccessibilityNodeInfo。
AccessibilityNodeInfo(AccessibilityNodeInfo)	複製建構函式。
AccessibilityNodeInfo(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
AccessibilityNodeInfo(View, Int32)	以給定AccessibilityNodeInfo的 創造一個新的 source 。
AccessibilityNodeInfo(View)	以給定AccessibilityNodeInfo的 創造一個新的 source 。

欄位

名稱	Description
ActionAccessibilityFocus	已淘汰. 讓節點聚焦於無障礙的行動。
ActionArgumentColumnInt	關於指定集合欄位以顯示在螢幕上的論點。
ActionArgumentDirectionInt	用 AccessibilityAction#ACTION_SCROLL_IN_DIRECTION來表示方向的參數。
ActionArgumentExtendSelectionBoolean	論點在以細緻層次移動時，是否應該擴展選取範圍，或是要以其他方式移動。
ActionArgumentHtmlElementString	關於哪個 HTML 元素該移到下一個或上一個 HTML 元素的論點。
ActionArgumentMovementGranularityInt	關於遍歷節點文本時應使用哪種移動細度的論點。
ActionArgumentMoveWindowX	指定將視窗移動到的 x 座標的論證。
ActionArgumentMoveWindowY	指定將視窗移動到的 y 座標的論證。
ActionArgumentPressAndHoldDurationMillisInt	參數用來表示按住節點所需的毫秒持續時間。
ActionArgumentProgressValue	指定要設定的進度值的論點。
ActionArgumentRowInt	關於指定集合列以在螢幕上顯示的論點。
ActionArgumentScrollAmountFloat	將捲動量表示為節點可見面積的百分比，為 1。
ActionArgumentSelectionEndInt	指定選擇的論點結束。
ActionArgumentSelectionStartInt	關於指定選擇起始的論點。
ActionArgumentSetTextCharsequence	指定要設定的文字內容的論點。
ActionClearAccessibilityFocus	已淘汰. 清除節點無障礙焦點的行動。
ActionClearFocus	已淘汰. 清除節點輸入焦點的動作。
ActionClearSelection	已淘汰. 移除該節點的動作。
ActionClick	已淘汰. 點擊節點資訊的動作。
ActionCollapse	已淘汰. 用來收縮可擴展節點的動作。
ActionCopy	已淘汰. 動作將目前的選取複製到剪貼簿。
ActionCut	已淘汰. 動作是剪斷目前的選取並放到剪貼板上。
ActionDismiss	已淘汰. 移除可駁回節點的動作。
ActionExpand	已淘汰. 擴展可擴展節點的動作。
ActionFocus	已淘汰. 將輸入聚焦於節點的動作。
ActionLongClick	已淘汰. 節點上長時間點擊的動作。
ActionNextAtMovementGranularity	已淘汰. 請求在特定移動細節度下，前往該節點文本中下一個實體的動作。
ActionNextHtmlElement	已淘汰. 動作移動到指定型別的下一個 HTML 元素。
ActionPaste	已淘汰. 動作是將目前的剪貼簿內容貼上。
ActionPreviousAtMovementGranularity	已淘汰. 請求在特定移動細節時，前往該節點文本中前一個實體的動作。
ActionPreviousHtmlElement	已淘汰. 動作移動到指定類型的前一個 HTML 元素。
ActionScrollBackward	已淘汰. 動作將節點內容往後捲動。
ActionScrollForward	已淘汰. 動作將節點內容向前捲動。
ActionSelect	已淘汰. 選擇節點的動作。
ActionSetSelection	已淘汰. 動作來設定選擇。
ActionSetText	已淘汰. 設定節點文字的動作。
ExtraDataRenderingInfoKey	鍵用於請求額外資料以取得渲染資訊。
ExtraDataTextCharacterLocationArgLength	整數參數指定所請求文字位置資料的末尾索引。
ExtraDataTextCharacterLocationArgMaxLength	請求文字位置資料的最大允許長度。
ExtraDataTextCharacterLocationArgStartIndex	整數參數指定所請求文字位置資料的起始索引。
ExtraDataTextCharacterLocationKey	鍵用於請求及定位文字字元位置的額外資料。
FlagPrefetchAncestors	已淘汰. 預取策略，預取請求節點的祖先。
FlagPrefetchDescendantsBreadthFirst	已淘汰. 預取策略，預先取出所請求節點的後代，先寬度優先。
FlagPrefetchDescendantsDepthFirst	已淘汰. 預取策略，預先取出所請求節點的後代深度優先。
FlagPrefetchDescendantsHybrid	已淘汰. 預取策略，以深度優先與廣度優先的混合方法預取後代。
FlagPrefetchSiblings	已淘汰. 預取策略，預取請求節點的兄弟節點。
FlagPrefetchUninterruptible	已淘汰. 指定預取的預取標誌不應被請求取回節點或執行節點動作的請求中斷。
FocusAccessibility	已淘汰. 重點在於無障礙。
FocusInput	已淘汰. 輸入焦點。
MaxNumberOfPrefetchedNodes	請求時預取節點的最大批次大小。
MovementGranularityCharacter	已淘汰. 移動粒度位元，用於依字元遍歷節點文字。
MovementGranularityLine	已淘汰. 移動粒度位元用於以行遍歷節點文字。
MovementGranularityPage	已淘汰. 移動粒度位元，用於逐頁遍歷節點文字。
MovementGranularityParagraph	已淘汰. 移動粒度位元，用於依段落遍歷節點的文字。
MovementGranularityWord	已淘汰. 移動粒度位元用於以字遍歷節點文字。

屬性

名稱	Description
AccessibilityDataSensitive	判斷節點的可及性資料是否被視為敏感。 -或- 設定該節點的無障礙資料是否被視為敏感。
AccessibilityFocused	判斷這個節點是否專注於無障礙。 -或- 設定此節點是否以無障礙為重點。
ActionList	取得節點上可執行的動作。
Actions	已淘汰. 取得節點上可執行的動作。
AvailableExtraData	取得該節點的額外資料。 -或- 設定該節點可用的額外資料。
Checkable	判斷該節點是否可檢查。 -或- 設定該節點是否可檢查。
Checked	判斷該節點是否被檢查。 -或- 設定該節點是否被檢查。
ChildCount	他會知道孩子數量。
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
ClassName	此類別代表視窗內容的節點，以及可從其來源請求的動作。
ClassNameFormatted	取得該節點所屬的類別。 -或- 設定該節點所屬的類別。
Clickable	判斷這個節點是否可點擊。 -或- 設定此節點是否可點擊。
ContainerTitle	此類別代表視窗內容的節點，以及可從其來源請求的動作。
ContainerTitleFormatted	還原貨櫃所有權證。 -或- 設定應用程式開發者定義容器的容器標題，該容器可以是任何類型的 ViewGroup 或版面配置。
ContentDescription	此類別代表視窗內容的節點，以及可從其來源請求的動作。
ContentDescriptionFormatted	取得該節點的內容描述。 -或- 設定該節點的內容描述。
ContentInvalid	如果該節點的內容無效，則會取得。 -或- 如果該節點的內容無效，則 設定。
ContextClickable	判斷這個節點是否可透過上下文點擊。 -或- 設定此節點是否可透過上下文點擊。
Creator
Dismissable	如果節點可以被駁回，則會得到。 -或- 如果節點可以被解散，則集合。
DrawingOrder	取得該節點對應視圖的繪圖順序。 -或- 設定該節點對應視圖的繪圖順序。
Editable	判斷節點是否可編輯。 -或- 設定該節點是否可編輯。
Enabled	會判斷這個節點是否啟用。 -或- 設定該節點是否啟用。
Error	此類別代表視窗內容的節點，以及可從其來源請求的動作。
ErrorFormatted	會取得該節點的錯誤文字。 -或- 設定此節點的錯誤文字。
Extras	會獲得一個包含額外資料的選購組合。
Focusable	判斷這個節點是否可聚焦。 -或- 設定此節點是否可聚焦。
Focused	判斷這個節點是否被聚焦。 -或- 設定該節點是否被聚焦。
GranularScrollingSupported	想知道節點是否支援顆粒捲動。 -或- 若節點支援顆粒捲動，則為 設定。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasRequestInitialAccessibilityFocus	取得節點是否擁有 #setRequestInitialAccessibilityFocus。
Heading	回傳節點是否代表標題。 -或- 設定節點是否代表標題。
HintText	此類別代表視窗內容的節點，以及可從其來源請求的動作。
HintTextFormatted	取得該節點的提示文字。 -或- 設定此節點的提示文字。
ImportantForAccessibility	回傳該節點是否來自被視為對無障礙重要的視圖。 -或- 設定該節點是否被視為對可及性的重要性。
InputType	取得來源的輸入型態，定義為 InputType。 -或- 設定來源的輸入型別，定義為 InputType。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
JniPeerMembers	此類別代表視窗內容的節點，以及可從其來源請求的動作。
LabeledBy	取得節點資訊，作為該資訊所代表視圖的標籤，方便無障礙使用。
LabelFor	取得節點資訊，該資訊所代表的視圖作為無障礙標籤。
LiveRegion	取得節點的即時區域模式。 -或- 設定節點的即時區域模式。
LongClickable	判斷該節點是否可長點。 -或- 設定此節點是否可長點。
MaxTextLength	回傳該節點的最大文字長度。 -或- 設定最大文字長度，或 -1，表示無限制。
MinDurationBetweenContentChanges	獲得兩次內容變更事件之間的最短時間。 -或- 設定兩個內容變更事件之間的最短時間，該時間用於限制無障礙服務中的內容變更事件。
MovementGranularities	取得遍歷該節點文字的移動細節。 -或- 設定遍歷該節點文字的移動粒度。
MultiLine	如果節點是多行可編輯的文字，則會取得。 -或- 如果節點是多行可編輯的文字，則 設定。
PackageName	此類別代表視窗內容的節點，以及可從其來源請求的動作。
PackageNameFormatted	取得該節點所屬的封包。 -或- 設定該節點所來自的封裝。
PaneTitle	此類別代表視窗內容的節點，以及可從其來源請求的動作。
PaneTitleFormatted	取得這個節點所代表的面板標題。 -或- 如果這個節點代表螢幕上一個視覺上明顯不同的區域，且可能與視窗其他部分分開更新，則稱為窗格。
Parent	抓到家長。
Password	判斷這個節點是否是密碼。 -或- 設定此節點是否為密碼。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ScreenReaderFocusable	回傳該節點是否被螢幕閱讀器明確標記為可聚焦單元。 -或- 設定該節點是否應被螢幕閱讀器視為可聚焦單元。
Scrollable	如果節點是可捲動的，就會有問題。 -或- 如果節點可捲動，則為 設定。
Selected	讀取是否選擇了這個節點。 -或- 設定是否選擇此節點。
ShowingHintText	回傳節點的文字是否代表使用者輸入文字的提示。 -或- 設定節點的文字是否代表使用者輸入文字的提示。
StateDescription	此類別代表視窗內容的節點，以及可從其來源請求的動作。
StateDescriptionFormatted	取得這個節點的狀態描述。 -或- 設定此節點的狀態描述。
Text	此類別代表視窗內容的節點，以及可從其來源請求的動作。
TextEntryKey	回傳節點是否代表鍵盤或鍵盤的文字輸入鍵。 -或- 設定節點是否代表鍵盤或鍵盤中的文字輸入鍵。
TextFormatted	取得這個節點的文字。 -或- 設定此節點的文字。
TextSelectable	讀取節點是否有可選擇的文字。 -或- 如果節點有可選的文字，則為 Set。
TextSelectionEnd	如果選取文字，則會結束文字選擇。
TextSelectionStart	會顯示文字選取開始或游標位置。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
TooltipText	此類別代表視窗內容的節點，以及可從其來源請求的動作。
TooltipTextFormatted	取得此節點的工具提示文字。 -或- 設定此節點的工具提示文字。
TraversalAfter	取得節點，之後在可達性遍歷中造訪此節點。
TraversalBefore	在穿越過程中取得該節點之前的節點。
UniqueId	取得節點的唯一 ID。 -或- 將唯一 ID 設定為識別節點的鍵。
ViewIdResourceName	取得來源視圖 ID 的完整限定資源名稱。-或- 設定來源視圖 ID 的完全限定資源名稱。
VisibleToUser	判斷該節點是否對使用者可見。 -或- 設定此節點是否對使用者可見。
Window	取得該節點所屬的視窗。
WindowId	它會取得資訊來源的視窗 ID。

方法

名稱	Description
AddAction(AccessibilityNodeInfo+AccessibilityAction)	新增一個可以在節點上執行的動作。
AddAction(Action)	已淘汰. 新增一個可以在節點上執行的動作。
AddChild(View, Int32)	新增一個虛擬子節點，該子節點是給定 root的後代。
AddChild(View)	新增了一個孩子。
CanOpenPopup()	如果這個節點會開啟彈出視窗或對話框。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
DescribeContents()	要新增
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
Equals(Object)	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FindAccessibilityNodeInfosByText(String)	透過簡訊找到 AccessibilityNodeInfos。
FindAccessibilityNodeInfosByViewId(String)	透過完全限定的視圖 ID 資源名稱找到 AccessibilityNodeInfos，其中完全限定的 id 來自「package：id/id_resource_name」。
FindFocus(NodeFocus)	找到擁有指定焦點類型的視角。
FocusSearch(FocusSearchDirection)	搜尋指定方向上最近的視角，該視角可取得輸入焦點。
GetBoundsInParent(Rect)	取得 viewParent 座標中的節點邊界。
GetBoundsInScreen(Rect)	取得螢幕座標中的節點邊界。
GetBoundsInWindow(Rect)	取得節點邊界的視窗座標。
GetChild(Int32, Int32)	讓孩子以指定索引取得。
GetChild(Int32)	讓孩子以指定索引取得。
GetCollectionInfo()	如果節點是集合，它會取得集合資訊。
GetCollectionItemInfo()	如果節點是收藏品，則會取得收藏品的資訊。
GetExtraRenderingInfo()	如果節點是要用額外資料刷新以檢視渲染相關的無障礙問題，會得到 ExtraRenderingInfo extra rendering info 這個問題。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetParent(Int32)	抓到家長。
GetRangeInfo()	如果這個節點是範圍，它會取得距離資訊。
GetTouchDelegateInfo()	取得 TouchDelegateInfo for touch 代表行為，並以代表視角呈現。
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Obtain()	實例化一個新的 AccessibilityNodeInfo。
Obtain(AccessibilityNodeInfo)	實例化一個新的 AccessibilityNodeInfo，初始化為給定 info的 。
Obtain(View, Int32)	如果有快取實例，則回傳此實例，否則會回傳新的實例並設定來源。
Obtain(View)	如果有快取實例，則回傳此實例，否則會回傳新的實例並設定來源。
PerformAction(Action, Bundle)	會對節點執行一個動作。
PerformAction(Action)	會對節點執行一個動作。
Recycle()	之前會回傳實例以便重複使用。
Refresh()	更新這些資訊時，會更新它所代表的最新視角狀態。
RefreshWithExtraData(String, Bundle)	會以該檢視中的最新狀態刷新這些資訊，並請求檢視新增資料。
RemoveAction(AccessibilityNodeInfo+AccessibilityAction)	移除節點上可執行的動作。
RemoveAction(Int32)	已淘汰. 移除節點上可執行的動作。
RemoveChild(View, Int32)	移除一個虛擬子節點，該子節點是給定 root的後代。
RemoveChild(View)	帶走一個孩子。
SetBoundsInParent(Rect)	設定節點邊界為 viewParent 的座標。
SetBoundsInScreen(Rect)	設定螢幕座標中的節點邊界。
SetBoundsInWindow(Rect)	設定節點邊界為視窗座標。
SetCanOpenPopup(Boolean)	如果這個節點會開啟彈出視窗或對話框，就會被設定。
SetCollectionInfo(AccessibilityNodeInfo+CollectionInfo)	如果節點是集合，則設定集合資訊。
SetCollectionItemInfo(AccessibilityNodeInfo+CollectionItemInfo)	如果節點是收藏品，則設定收藏項目資訊。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetLabeledBy(View, Int32)	設定視圖，作為該資訊所代表視圖的標籤，方便無障礙使用。
SetLabeledBy(View)	設定視圖，作為該資訊所代表視圖的標籤，方便無障礙使用。
SetLabelFor(View, Int32)	設定該觀點，該觀點作為無障礙標籤。
SetLabelFor(View)	設定該觀點，該觀點作為無障礙標籤。
SetParent(View, Int32)	將父節點設為給定 root的虛擬後代。
SetParent(View)	設定父本。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
SetQueryFromAppProcessEnabled(View, Boolean)	將此節點連接到 View 的根節點，使該節點的操作能查詢整 AccessibilityNodeInfo 棵樹並執行存取性操作。
SetRangeInfo(AccessibilityNodeInfo+RangeInfo)	如果這個節點是範圍，它會設定距離資訊。
SetRequestInitialAccessibilityFocus(Boolean)	設定節點是否已請求初始可及性焦點。
SetSource(View, Int32)	將來源設定為給定 root的虛擬後代。
SetSource(View)	設定源頭。
SetTextSelection(Int32, Int32)	設定文字選取的開始與結束。
SetTouchDelegateInfo(AccessibilityNodeInfo+TouchDelegateInfo)	如果表示的視圖有 TouchDelegate.
SetTraversalAfter(View, Int32)	設定節點，之後在可達性遍歷中造訪該節點。
SetTraversalAfter(View)	設定在可及性遍歷中，該節點之後被造訪的視圖。
SetTraversalBefore(View, Int32)	設定該節點在遍歷時所先訪的節點。
SetTraversalBefore(View)	設定該節點在遍歷時應造訪的視圖。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	要新增

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	此類別代表視窗內容的節點，以及可從其來源請求的動作。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此類別代表視窗內容的節點，以及可從其來源請求的動作。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。