CheckBoxAutomationPeer 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
/// [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 CheckBoxAutomationPeer : 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 CheckBoxAutomationPeer : ToggleButtonAutomationPeerPublic Class CheckBoxAutomationPeer
Inherits ToggleButtonAutomationPeer- 繼承
-
Object IInspectable DependencyObject AutomationPeer FrameworkElementAutomationPeer ButtonBaseAutomationPeer ToggleButtonAutomationPeer CheckBoxAutomationPeer
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
備註
Windows 執行階段CheckBox類別會建立新的CheckBoxAutomationPeer 做為其 OnCreateAutomationPeer定義。 如果您要從 CheckBox 衍生自訂類別，並想要新增自訂支援，以取得您在自訂類別中啟用的其他功能，請從 CheckBoxAutomationPeer 衍生自動化對等。 然後覆寫 OnCreateAutomationPeer ，使其傳回您的自訂對等。
CheckBoxAutomationPeer中的預設對等實作和覆寫
CheckBoxAutomationPeer 具有 Core 方法的覆寫，讓相關聯的 AutomationPeer 方法提供對等特定資訊給 Microsoft UI 自動化用戶端。
- GetPattern 報告對等提供 PatternInterface.Toggle (IToggleProvider ) 的模式支援。 這實際上是來自 ToggleButtonAutomationPeer 基類;CheckBoxAutomationPeer 不會進一步覆寫 Core 方法。
- GetClassName 會傳回 「CheckBox」。
- GetAutomationControlType 會傳回 AutomationControlType.CheckBox。
- 當對等和擁有者控制項的ToggleState變更時，對等可以引發PropertyChanged自動化事件。 此對等具有基類 ButtonBaseAutomationPeer ，並繼承其行為，而不是上述覆寫。 值得注意的是， GetName 會根據檢查目前的 Content傳回字串值。 如需詳細資訊，請參閱 ButtonBaseAutomationPeer。
對等也有由基底 FrameworkElementAutomationPeer 類別提供的其他行為。 For more info, see "Base implementation in FrameworkElementAutomationPeer" section of Custom automation peers.
建構函式
| CheckBoxAutomationPeer(CheckBox) |
初始化 CheckBoxAutomationPeer 類別的新實例。 |
屬性
| Dispatcher |
取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject) |
| EventsSource |
取得或設定 向自動化用戶端報告的 AutomationPeer ，做為來自這個 AutomationPeer之所有事件的來源。 請參閱＜備註＞。 (繼承來源 AutomationPeer) |
| Owner |
取得與此FrameworkElementAutomationPeer相關聯的UIElement擁有者。 (繼承來源 FrameworkElementAutomationPeer) |
| ToggleState |
取得控制項的切換狀態。 (繼承來源 ToggleButtonAutomationPeer) |
方法
| ClearValue(DependencyProperty) |
清除相依性屬性的本機值。 (繼承來源 DependencyObject) |
| GetAcceleratorKey() |
取得與使用者介面自動化對等相關聯之物件的快速鍵組合。 (繼承來源 AutomationPeer) |
| GetAcceleratorKeyCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAcceleratorKey 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAccessKey() |
取得與自動化對等相關聯之項目的存取金鑰。 (繼承來源 AutomationPeer) |
| GetAccessKeyCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAccessKey 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAnimationBaseValue(DependencyProperty) |
傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject) |
| GetAnnotations() |
取得目前自動化對等使用者介面自動化注釋清單的參考。 (繼承來源 AutomationPeer) |
| GetAnnotationsCore() |
當 Microsoft UI 自動化用戶端呼叫 GetAnnotations 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。 (繼承來源 AutomationPeer) |
| GetAutomationControlType() |
取得與使用者介面自動化對等相關聯之專案的控制項類型。 (繼承來源 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() |
取得與這個自動化對等相關聯之使用者介面自動化專案的標題層級。 (繼承來源 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() |
取得與使用者介面自動化對等相關聯之 物件的即時設定通知行為資訊。 (繼承來源 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) |
| 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) |