AppBarToggleButtonAutomationPeer 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將 AppBarToggleButton 類型公開至 Microsoft UI 自動化。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppBarToggleButtonAutomationPeer : ToggleButtonAutomationPeer[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AppBarToggleButtonAutomationPeer : ToggleButtonAutomationPeerPublic Class AppBarToggleButtonAutomationPeer
Inherits ToggleButtonAutomationPeer- 繼承
-
Object IInspectable DependencyObject AutomationPeer FrameworkElementAutomationPeer ButtonBaseAutomationPeer ToggleButtonAutomationPeer AppBarToggleButtonAutomationPeer
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
備註
Windows 執行階段AppBarToggleButton類別會建立新的 AppBarToggleButtonAutomationPeer 作為其OnCreateAutomationPeer定義。 如果您從 AppBarToggleButtonAutomationPeer 衍生自訂類別，並想要為自訂類別中啟用的其他功能新增自動化支援，請從 AppBarToggleButton 衍生自動化對等。 然後覆寫 OnCreateAutomationPeer ，使其傳回您的自訂對等。
AppBarToggleButtonAutomationPeer中的預設對等實作和覆寫
AppBarToggleButtonAutomationPeer 具有 Core 方法的覆寫，讓相關聯的 AutomationPeer 方法提供對等特定資訊給 Microsoft UI 自動化用戶端。
- GetClassName 會傳回 「AppBarToggleButton」。
- GetName不會使用根據Content傳回字串的ButtonBaseAutomationPeer行為。 相反地，它會尋找標籤 / LabeledBy 值。 否則，來自應用程式的值應該來自 XAML UI 定義 中的 AutomationProperties.Name 用法，而不是來自對等從控制項轉送的值。 此對等具有基類 ToggleButtonAutomationPeer ，並繼承其行為，而不是上述的覆寫。 這包括IToggleProvider的模式支援，以及要求時傳回該模式的GetPattern行為，而 GetAutomationControlType 會傳回 AutomationControlType.Button。 如需詳細資訊，請參閱 ToggleButtonAutomationPeer。
對等也有由基底 FrameworkElementAutomationPeer 類別提供的其他行為。 For more info, see "Base implementation in FrameworkElementAutomationPeer" section of Custom automation peers.
建構函式
| AppBarToggleButtonAutomationPeer(AppBarToggleButton) |
初始化 AppBarToggleButtonAutomationPeer 類別的新實例。 |
屬性
| Dispatcher |
取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject) |
| EventsSource |
取得或設定 AutomationPeer，這個 AutomationPeer 會回報給自動化用戶端作為來自這個 AutomationPeer的所有事件來源。 請參閱＜備註＞。 (繼承來源 AutomationPeer) |
| Owner |
取得與此FrameworkElementAutomationPeer相關聯的UIElement擁有者。 (繼承來源 FrameworkElementAutomationPeer) |
| ToggleState |
取得控制項的切換狀態。 (繼承來源 ToggleButtonAutomationPeer) |
方法
| ClearValue(DependencyProperty) |
清除相依性屬性的本機值。 (繼承來源 DependencyObject) |
| GetAcceleratorKey() |
取得與 UI 自動化對等相關聯之 物件的快速鍵組合。 (繼承來源 AutomationPeer) |
| GetAcceleratorKeyCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAcceleratorKey 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAccessKey() |
取得與自動化對等相關聯之項目的存取金鑰。 (繼承來源 AutomationPeer) |
| GetAccessKeyCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAccessKey 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAnimationBaseValue(DependencyProperty) |
傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject) |
| GetAnnotations() |
取得目前自動化對等之 UI 自動化注釋清單的參考。 (繼承來源 AutomationPeer) |
| GetAnnotationsCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAnnotations 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAutomationControlType() |
取得與 UI 自動化對等相關聯之專案的控制項類型。 (繼承來源 AutomationPeer) |
| GetAutomationControlTypeCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAutomationControlType 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAutomationId() |
取得與自動化對等相關聯之專案的 AutomationId 。 (繼承來源 AutomationPeer) |
| GetAutomationIdCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAutomationId 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetBoundingRectangle() |
取得 Rect 物件，表示與自動化對等相關聯之專案的螢幕座標。 (繼承來源 AutomationPeer) |
| GetBoundingRectangleCore() |
當 Microsoft UI 自動化用戶端呼叫 GetBoundingRectangle 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetChildren() |
取得在使用者介面自動化樹狀結構中表示為自動化對等之立即子項目的子項目集合。 (繼承來源 AutomationPeer) |
| GetChildrenCore() |
當 Microsoft UI 自動化用戶端呼叫 GetChildren 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetClassName() |
取得與 AutomationControlType搭配使用的名稱，以區分這個 AutomationPeer所代表的控制項。 (繼承來源 AutomationPeer) |
| GetClassNameCore() |
當 Microsoft UI 自動化用戶端呼叫 GetClassName 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetClickablePoint() |
取得專案上的點，該專案與回應滑鼠按一下的自動化對等相關聯。 (繼承來源 AutomationPeer) |
| GetClickablePointCore() |
當 Microsoft UI 自動化用戶端呼叫 GetClickablePoint 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetControlledPeers() |
當 Microsoft UI 自動化用戶端呼叫 GetControlledPeers 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為，例如取得 由 UIA_ControllerForPropertyId識別的屬性值。 (繼承來源 AutomationPeer) |
| GetControlledPeersCore() |
取得目前自動化對等的受控制對等清單。 (繼承來源 AutomationPeer) |
| GetCulture() |
呼叫 GetCultureCore 以取得與自動化對等相關聯之專案的文化特性值。 (繼承來源 AutomationPeer) |
| GetCultureCore() |
取得與自動化對等相關聯之專案的文化特性值。 (繼承來源 AutomationPeer) |
| GetDescribedByCore() |
取得專案集合，提供自動化專案的詳細資訊。 (繼承來源 AutomationPeer) |
| GetElementFromPoint(Point) |
從指定的點取得專案。 (繼承來源 AutomationPeer) |
| GetElementFromPointCore(Point) |
當 Microsoft UI 自動化用戶端呼叫 GetElementFromPoint 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetFlowsFromCore() |
當 Microsoft UI 自動化用戶端呼叫 GetFlowsFrom 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetFlowsToCore() |
當 Microsoft UI 自動化用戶端呼叫 GetFlowsTo 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetFocusedElement() |
取得目前具有焦點的專案。 (繼承來源 AutomationPeer) |
| GetFocusedElementCore() |
當 Microsoft UI 自動化用戶端呼叫 GetFocusedElement 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetFullDescription() |
取得當地語系化字串，描述影像或影像控制項等專案的實際視覺外觀或內容。 (繼承來源 AutomationPeer) |
| GetFullDescriptionCore() |
當 Microsoft UI 自動化用戶端呼叫 GetFullDescription 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetHeadingLevel() |
取得與這個自動化對等相關聯之 UI 自動化專案的標題層級。 (繼承來源 AutomationPeer) |
| GetHeadingLevelCore() |
當 Microsoft UI 自動化用戶端呼叫 GetHeadingLevel 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetHelpText() |
取得文字，這個文字描述與自動化對等個體關聯之控制項的功能。 (繼承來源 AutomationPeer) |
| GetHelpTextCore() |
當 Microsoft UI 自動化用戶端呼叫 GetHelpText 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetItemStatus() |
取得文字，這個文字表示與此自動化對等個體關聯之項目的視覺化狀態。 (繼承來源 AutomationPeer) |
| GetItemStatusCore() |
當 Microsoft UI 自動化用戶端呼叫 GetItemStatus 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetItemType() |
取得字串，描述專案所代表的專案類型。 (繼承來源 AutomationPeer) |
| GetItemTypeCore() |
當 Microsoft UI 自動化用戶端呼叫 GetItemType 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetLabeledBy() |
取得以 元素為目標之 UIElement的AutomationPeer。 (繼承來源 AutomationPeer) |
| GetLabeledByCore() |
當 Microsoft UI 自動化用戶端呼叫 GetLabeledBy 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetLandmarkType() |
取得這個自動化對等的地標類型。 (繼承來源 AutomationPeer) |
| GetLandmarkTypeCore() |
當 Microsoft UI 自動化用戶端呼叫 GetLandmarkType 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetLevel() |
傳回與自動化對等相關聯之元素之層級 (階層) 以 1 起始的整數。 (繼承來源 AutomationPeer) |
| GetLevelCore() |
當 Microsoft UI 自動化用戶端呼叫 GetLevel 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetLiveSetting() |
取得與 UI 自動化對等相關聯之物件的即時設定通知行為資訊。 (繼承來源 AutomationPeer) |
| GetLiveSettingCore() |
當 Microsoft UI 自動化用戶端呼叫 GetLiveSetting 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetLocalizedControlType() |
取得當地語系化字串，表示與這個自動化對等相關聯之控制項的 AutomationControlType 值。 (繼承來源 AutomationPeer) |
| GetLocalizedControlTypeCore() |
當 Microsoft UI 自動化用戶端呼叫 GetLocalizedControlType 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetLocalizedLandmarkType() |
取得當地語系化字串，表示與這個自動化對等相關聯之專案的 AutomationLandmarkType 值。 (繼承來源 AutomationPeer) |
| GetLocalizedLandmarkTypeCore() |
當 Microsoft UI 自動化用戶端呼叫 GetLocalizedLandmarkType 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetName() |
取得文字，這個文字描述與此自動化對等個體關聯的項目。 Microsoft UI 自動化 名稱 值是大部分輔助技術透過與 Microsoft UI 自動化架構互動來代表應用程式 UI 時所使用的主要識別碼。 (繼承來源 AutomationPeer) |
| GetNameCore() |
當 Microsoft UI 自動化用戶端呼叫 GetName 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetOrientation() |
取得值，這個值表示明確的控制項方向 (若有的話)。 (繼承來源 AutomationPeer) |
| GetOrientationCore() |
當 Microsoft UI 自動化用戶端呼叫 GetOrientation 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetParent() |
取得 AutomationPeer，這個 AutomationPeer 是這個 AutomationPeer的父代。 (繼承來源 AutomationPeer) |
| GetPattern(PatternInterface) |
取得與指定 PatternInterface相關聯的控制項模式。 (繼承來源 AutomationPeer) |
| GetPatternCore(PatternInterface) |
當 Microsoft UI 自動化用戶端呼叫 GetPattern 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetPeerFromPoint(Point) |
從指定的點取得 AutomationPeer 。 (繼承來源 AutomationPeer) |
| GetPeerFromPointCore(Point) |
當 Microsoft UI 自動化用戶端呼叫 GetPeerFromPoint 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetPositionInSet() |
傳回與自動化對等相關聯之元素集合中序數位置的 1 整數。 (繼承來源 AutomationPeer) |
| GetPositionInSetCore() |
當 Microsoft UI 自動化用戶端呼叫 GetPositionInSet 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetSizeOfSet() |
針對與自動化對等相關聯之元素所在的集合大小，傳回以 1 為起始的整數。 (繼承來源 AutomationPeer) |
| GetSizeOfSetCore() |
當 Microsoft UI 自動化用戶端呼叫 GetSizeOfSet 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetValue(DependencyProperty) |
從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject) |
| HasKeyboardFocus() |
取得值，這個值表示與這個自動化對等個體相關聯的項目目前是否有鍵盤焦點。 (繼承來源 AutomationPeer) |
| HasKeyboardFocusCore() |
當 Microsoft UI 自動化用戶端呼叫 HasKeyboardFocus 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| InvalidatePeer() |
觸發 AutomationPeer 主要屬性的重新計算，並在屬性變更時向自動化用戶端引發 PropertyChanged 通知。 (繼承來源 AutomationPeer) |
| IsContentElement() |
取得值，這個值表示與此 Automation Peer 相關聯的項目是否包含呈現給使用者的資料。 (繼承來源 AutomationPeer) |
| IsContentElementCore() |
當 Microsoft UI 自動化用戶端呼叫 IsContentElement 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsControlElement() |
取得值，這個值表示專案是由使用者視為互動式或參與 GUI 中控制項的邏輯結構。 (繼承來源 AutomationPeer) |
| IsControlElementCore() |
當 Microsoft UI 自動化用戶端呼叫 IsControlElement 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsDataValidForForm() |
取得布林值，指出輸入或選取的值是否對與自動化專案相關聯的表單規則有效。 (繼承來源 AutomationPeer) |
| IsDataValidForFormCore() |
當 Microsoft UI 自動化用戶端存取 IsDataValidForForm 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsDialog() |
取得值，這個值表示與此自動化對等相關聯的專案是否為對話方塊視窗。 (繼承來源 AutomationPeer) |
| IsDialogCore() |
當 Microsoft UI 自動化用戶端呼叫 IsDialog 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsEnabled() |
取得值，這個值表示與此自動化對等個體關聯的項目是否支援互動。 (繼承來源 AutomationPeer) |
| IsEnabledCore() |
當 Microsoft UI 自動化用戶端呼叫 IsEnabled 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsKeyboardFocusable() |
取得值，這個值表示項目是否可以接受鍵盤焦點。 (繼承來源 AutomationPeer) |
| IsKeyboardFocusableCore() |
當 Microsoft UI 自動化用戶端呼叫 IsKeyboardFocusable 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsOffscreen() |
取得值，這個值表示項目是否不在螢幕上。 (繼承來源 AutomationPeer) |
| IsOffscreenCore() |
當 Microsoft UI 自動化用戶端呼叫 IsOffscreen 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsPassword() |
取得值，這個值表示項目是否包含敏感性內容。 (繼承來源 AutomationPeer) |
| IsPasswordCore() |
當 Microsoft UI 自動化用戶端呼叫 IsPassword 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsPeripheral() |
取得布林值，指出自動化專案是否代表周邊 UI。 (繼承來源 AutomationPeer) |
| IsPeripheralCore() |
當 Microsoft UI 自動化用戶端存取 IsPeripheral 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| IsRequiredForForm() |
取得值，這個值表示與此對等個體關聯的項目在表單上是否為必填項。 (繼承來源 AutomationPeer) |
| IsRequiredForFormCore() |
當 Microsoft UI 自動化用戶端呼叫 IsRequiredForForm 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| Navigate(AutomationNavigationDirection) |
取得 UI 自動化樹狀結構中指定方向的專案。 (繼承來源 AutomationPeer) |
| NavigateCore(AutomationNavigationDirection) |
當 Microsoft UI 自動化用戶端呼叫 Navigate 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| PeerFromProvider(IRawElementProviderSimple) |
取得指定之 IRawElementProviderSimple Proxy 的AutomationPeer。 (繼承來源 AutomationPeer) |
| ProviderFromPeer(AutomationPeer) |
取得指定AutomationPeer的IRawElementProviderSimple Proxy。 (繼承來源 AutomationPeer) |
| RaiseAutomationEvent(AutomationEvents) |
引發自動化事件。 (繼承來源 AutomationPeer) |
| RaiseNotificationEvent(AutomationNotificationKind, AutomationNotificationProcessing, String, String) |
起始通知事件。 (繼承來源 AutomationPeer) |
| RaisePropertyChangedEvent(AutomationProperty, Object, Object) |
引發事件，通知自動化用戶端已變更屬性值。 (繼承來源 AutomationPeer) |
| RaiseStructureChangedEvent(AutomationStructureChangeType, AutomationPeer) |
引發事件，通知 Microsoft UI 自動化核心樹狀結構已變更。 (繼承來源 AutomationPeer) |
| RaiseTextEditTextChangedEvent(AutomationTextEditChangeType, IVectorView<String>) |
引發事件，通知 Microsoft UI 自動化核心文字控制項已以程式設計方式變更文字。 (繼承來源 AutomationPeer) |
| ReadLocalValue(DependencyProperty) |
如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject) |
| SetFocus() |
對與此自動化對等個體關聯的項目設定鍵盤焦點。 (繼承來源 AutomationPeer) |
| SetFocusCore() |
當 Microsoft UI 自動化用戶端呼叫 SetFocus 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| SetParent(AutomationPeer) |
設定 AutomationPeer ，這是這個 AutomationPeer的父代。 (繼承來源 AutomationPeer) |
| SetValue(DependencyProperty, Object) |
在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject) |
| ShowContextMenu() |
顯示擁有者元素的可用操作功能表。 (繼承來源 AutomationPeer) |
| ShowContextMenuCore() |
當 Microsoft UI 自動化用戶端呼叫 ShowCoNtextMenu 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| Toggle() |
透過控制項狀態的切換循環。 (繼承來源 ToggleButtonAutomationPeer) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject) |