Control 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示使用 ControlTemplate 定義其外觀之 UI 元素的基類。 ContentControl、UserControl、ItemsControl和數個實際控制項的父類別。
public ref class Control : FrameworkElement/// [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 Control : FrameworkElement[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 Control : FrameworkElementPublic Class Control
Inherits FrameworkElement- 繼承
- 衍生
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
備註
Control 類別是您新增至應用程式及其 UI 之許多控制項的基類。 Control 類別定義非常少的行為;您可以將實際 Control 元素新增至 UI 的 XAML，但通常會新增繼承自 Control 的專案，例如 Button 或 ListBox。 如需您可以使用的控制項清單，請參閱 依函式的控制項。
使用ControlTemplate類型的Template屬性會指定控制項的視覺外觀。 如果您想要變更控制項的外觀，但保留其功能，您應該考慮建立新的 ControlTemplate ，而不是定義新的 Control 型類別。 如需詳細資訊，請參閱 控制項範本。
控制項是 UserControl的父代。 UserControl 是不需要視覺狀態之輕量型控制項的預定基類。 雖然 UserControl 技術上繼承 Template 屬性，但您無法將範本套用至 UserControl。
控制項的隱含樣式
針對 XAML 定義的每個實際控制項都有一個預設樣式，其中包含其預設控制項範本。 控制項可以有隱含樣式，這表示未明確設定 FrameworkElement.Style 屬性。 一旦該隱含樣式可供使用，幾乎所有控制項的其他屬性都可以在該Style中使用Setter元素來設定。 Style可以與控制項邏輯的其餘部分分開初始化控制項，而且可以設定不是每個屬性之程式碼型預設值的值。
隱含樣式會以索引鍵資源的形式存在，屬於Windows 執行階段的一部分，儲存在內部做為 XAML 的二進位標記法。 您可以取得特定控制項的樣式或完整樣式集的複本，以查看如何定義樣式和控制項範本。
預設所使用之隱含樣式的特定控制項類型與索引鍵/名稱之間的關聯是由 DefaultStyleKey 屬性的值所建立。 DefaultStyleKey屬性受到保護，因此只有子類別控制項類別的人可以變更值。 如果您只是建立控制項實例，例如在 XAML UI 中宣告控制項，則預設樣式是以控制項的類型為基礎的隱含樣式。 如需詳細資訊，請參閱 DefaultStyleKey中的。 您不需要將 DefaultStyleKey 值變更為使用不同的樣式，只需要定義自己的 XAML Style ，該樣式具有相同的 TargetType 符合隱含樣式查閱，而且會以 XAML 資源的形式存在。 如需詳細資訊，請參閱 控制項範本。
視覺狀態模型
視覺狀態模型是一種技術，您可以只修改控制項範本中定義的幾個屬性。 您可以變更屬性值，以提供視覺回饋給使用者，指出控制項正在執行什麼動作，並在可能進一步的 UI 互動提示。 控制項會藉由將零持續時間或短期分鏡腳本動畫套用至範本中的部分屬性來修改。 您也可以定義短期動畫，這些動畫適用于狀態之間的轉換。
視覺狀態本身會定義為控制項範本的一部分。 每個視覺狀態都有名稱，因此控制項邏輯可以叫用 GoToState 方法，以在特定邏輯狀態需要時載入每個視覺狀態。 視覺狀態會在視覺狀態群組內宣告，讓彼此專屬的視覺狀態可確保一次只有一個這類狀態處於作用中狀態。 一旦載入相同群組的另一個視覺狀態，就會停止套用先前狀態的動畫，但另一個群組中的動畫可能仍在執行中，並套用其變更和視覺行為。 例如，控制項可能有鍵盤焦點的視覺指標，以及指標的視覺指標。 因為這些是可以彼此獨立調整的 UI 模式，而且可以同時發生，所以它們分別定義在不同的視覺狀態群組中。
因為它是在 XAML 中定義為控制項範本的一部分，所以您可以變更您在 UI 中使用的任何 XAML 控制項的視覺狀態行為。 不過，邏輯仍以預期在 內尋找特定視覺狀態群組和具名視覺狀態的控制項為基礎。 因此，您必須非常小心地提供正確的具名和結構化視覺狀態，以向使用者顯示控制項行為的所有層面。 如需詳細資訊，請參閱視覺狀態的腳本動畫。 控制項 範本中也會簡短介紹視覺狀態。
控制項的預設視覺狀態有時會使用程式庫動畫。 當您取代控制項範本或視覺狀態時，您應該嘗試保留程式庫動畫，因為這些動畫是控制項在 UI 中外觀和風格的重要部分。 如需詳細資訊，請參閱 動畫概觀。
控制項和焦點
Control 類別會定義數個 API 來影響 UI 的鍵盤焦點行為：Focus 方法、FocusState屬性，以及IsEnabled和IsTabStop屬性。 啟用鍵盤焦點是確保 UI 可存取的重要部分，因為每個可焦點元素都會成為 UI 定位順序的一部分。 通常只會啟用互動式 UI 元素來接收鍵盤焦點。 例如， TextBox 是互動式的，因為使用者可以輸入文字，而 TextBlock 不是互動式的，因為文字是唯讀的。 衍生自 Control 的大部分類別都是合法互動的，因此可以聚焦在索引標籤順序中。這很合理。
若要成為焦點，每個都必須是 true：
- 可見度 為 可見
- IsEnabled 為 true
- IsTabStop 為 true
- 控制項必須以已載入的 範本 (引發 時具現化、連線至應用程式根視覺效果的控制項) 如果您想要讓控制項無法聚焦，您可以將 IsTabStop 設定為 false。 不過，如果您不想讓控制項有焦點的原因是它不是 UI 中的互動式，您可能會想要將 IsEnabled 設定為 false ，讓每個人沒有明顯的互動。 許多控制項都有針對IsEnabled =false叫用的預先定義視覺狀態，例如標籤中的「灰色」文字。
焦點變更可能會引發 GotFocus 或 LostFocus 事件。 雖然透過GetFocusedElement方法公開的 「FocusedElement」 值 (會立即更新) ，但 GotFocus 或 LostFocus的變更通知會以非同步方式發生。 這個非同步焦點設計旨在避免在控制項邏輯回應焦點變更太快時，對視覺狀態轉換產生閃爍。
Focus方法可讓您以程式設計方式將鍵盤焦點帶入控制項。 呼叫此方法時，可能會干擾使用者不預期鍵盤焦點時移動鍵盤焦點。 焦點的主要案例是在載入整個 UI 頁面時設定第一個鍵盤焦點，或在父控制項容器收到最上層焦點 (時將焦點設定為控制項的特定部分，例如將下拉式方塊中的文字方塊設為焦點) 。 如需詳細資訊，請參閱 焦點。 FocusState 會追蹤焦點是否為程式設計或使用者導向，這會對視覺狀態造成差異，特別是所有控制項都應該擁有的鍵盤焦點視覺焦點指標。
在事件處理常式 上覆寫
每個 OnEvent 方法都代表對應 UIElement 事件的預先連接事件處理常式。 衍生自 Control 的實際控制項可以覆寫 OnEvent 方法，並使用此方法提供該輸入事件的控制項特定處理和行為。 最常見的案例是使用事件處理常式，將事件標示為事件資料中 已處理 的事件。 在叫用控制項實例上有線的任何事件處理常式之前，控制項程式碼第一次有機會處理此事件。 當事件資料標示為 [已處理] 時，將不會呼叫控制項實例上的其他處理常式，例如這些處理常式。 此外，事件不會泡泡。
當它直接在 Control 上實作時， OnEvent 方法會有空的實作。 但控制項階層中的每個上階可能都已提供實作。 您無法看到此實作，因為它是內部機器碼。 在某些情況下，控制項已經有標示已處理事件的現有On事件覆寫。 一旦您為控制項提供初始 OnEvent 覆寫之後，您進一步衍生自自己的控制項類別的任何控制項也會繼承您定義的 OnEvent 覆寫。 您使用的任何實例也有該行為。
注意
應用程式程式碼仍然可以處理可能已由控制項的OnEvent方法邏輯標示為 [處理] 的事件，但必須針對UIElement.AddHandler方法使用handledEventsToo參數。 如需詳細資訊，請參閱 UIElement.AddHandler 或 事件和路由事件概觀。
Control 類別會定義數個與架構層級輸入事件相關聯的受保護虛擬方法。 這些方法旨在提供輸入事件的預先有線事件處理常式，讓控制項可以強制執行該控制項及其所有實例所使用的特定輸入行為。 例如，UIElement定義了PointerPressed事件。 控制項會使用空的定義來定義 OnPointerPressed 方法。 在基底 Control 建構函式中，所有相關輸入事件的事件連接包含 OnEvent 方法作為接聽程式/處理常式，一開始不會執行任何動作。 但您現在只需要做為控制項作者變更輸入事件的行為，就是為 OnEvent 方法提供新的覆寫定義 (，也請確定您的建構函式會呼叫基底) 。 除非另一個子類別器再次覆寫該行為，否則該行為會繼承至所有實例或子類別。 由於 OnEvent 事件會先依序排列，所以在任何 UI 定義 XAML 之前，他們可以調整事件資料，並可能會變更其他接聽程式有關事件的條件。
特定控制項類別中的現有 On事件 定義可能會影響您做為控制項的取用者，即使您尚未自行覆寫任何 OnEvent 方法也一樣。 這是因為現有的 On事件 定義可能已針對事件提供處理，而該事件會將 Handled 屬性值設定為 true 的事件資料。 這會防止實例型事件處理甚至看到事件，並防止叫用處理程式。 此處發生的情況是，有一個刻意的控制項設計會強制特定事件對控制項無關，可能是因為它們是與控制項邏輯衝突的低階事件，或因為控制項具有取代邏輯。 這有一個明顯的範例是 ButtonBase 類別。 ButtonBase類別有兩種行為，它會透過OnPointerPressed和OnKeyDown的原生覆寫強制執行。 這樣做是因為其會結合低階的各種輸入模式，並改為報告為控制項特定的 Click 事件。 在 PointerPressed 事件處理常式的情況下，如果您嘗試在 Button 實例上處理此問題，則不會叫用處理程式。 這是因為原生 OnPointerPressed 將 Handled 設定為 true ，並防止 PointerPressed 傳播至您的實例和應用程式程式碼。 針對 OnKeyDown，邏輯只是尋找特定索引鍵， (Ctrl 和 Enter) ，因此只要實例處理常式不也會尋找這些索引鍵，仍然可以叫用。
注意
對於某些輸入事件，實際上有一種方式可以解決 輸入的 OnEvent 方法原生處理。 若要這樣做，您必須使用 AddHandler 方法與 handledEventsToo連接處理常式。 如需詳細資訊，請參閱 AddHandler 或 事件和路由事件概觀。
繼承至文字專案元件的文字屬性
控制項會定義數個與文字呈現相關的屬性。 這些工具為：
很明顯地，並非所有控制項都是用來顯示其中的文字。 例如，在AppBarSeparator上設定FontFamily是合法的，但絕對沒有作用。 Control 在基類層級定義這些屬性的原因是讓控制項範本能夠輕鬆地使用 {TemplateBinding} 標記延伸 ，將最上層文字屬性套用至範本記憶體在的一或多個文字元素元件。 例如，如果您查看 DatePicker的控制項範本，您會看到根是容器，而該容器內更深入的元件是實際採用文字輸入的數個 ComboBox 元件。 上述每一個都使用 語句，例如 FontWeight="{TemplateBinding FontWeight}" ，在DatePicker上設定最上層FontWeight，供各種元件使用。
控制項上的文字屬性也會隱含繼承，而控制項內有 ContentPresenter ，而該控制項內會顯示文字。 例如，如果您在Button上設定FontSize，其範本或ContentPresenter元件中沒有明確的{TemplateBinding} 標記延伸，可控制範本使用最上層FontSize值所執行的動作。 但是，ContentPresenter.FontSize會根據範本定義內的內容隱含繼承Control.FontSize值，因此按鈕內的文字將會使用您設定的Control.FontSize來呈現。
XAML 附加屬性
控制項是數個 XAML 附加屬性的主機服務類別。
為了支援 XAML 處理器存取附加屬性，以及公開對等 的 get 和 set 作業給程式碼，每個 XAML 附加屬性都有一對 Get 和 Set 存取子方法。 在程式碼中取得或設定值的另一種方式是使用相依性屬性系統，呼叫 GetValue 或 SetValue ，並將識別碼欄位傳遞為相依性屬性識別碼。
| 附加屬性 | Description |
|---|---|
| IsTemplateFocusTarget | 取得或設定值，這個值表示這個專案是否為具有焦點視覺效果之控制項範本的一部分。 |
| IsTemplateKeyTipTarget | 取得或設定值，這個值表示這個專案是否為放置 之控制項範本 KeyTip 的一部分。 |
版本歷程記錄
| Windows 版本 | SDK 版本 | 已新增值 |
|---|---|---|
| 1607 | 14393 | ElementSoundMode |
| 1607 | 14393 | FocusDisengaged |
| 1607 | 14393 | FocusEngaged |
| 1607 | 14393 | IsFocusEngaged |
| 1607 | 14393 | IsFocusEngagementEnabled |
| 1607 | 14393 | RemoveFocusEngagement |
| 1607 | 14393 | RequiresPointer |
| 1607 | 14393 | XYFocusDown |
| 1607 | 14393 | XYFocusLeft |
| 1607 | 14393 | XYFocusRight |
| 1607 | 14393 | XYFocusUp |
| 1703 | 15063 | DefaultStyleResourceUri |
| 1703 | 15063 | GetIsTemplateKeyTipTarget |
| 1703 | 15063 | SetIsTemplateKeyTipTarget |
| 1709 | 16299 | OnCharacterReceived |
| 1709 | 16299 | OnPreviewKeyDown |
| 1709 | 16299 | OnPreviewKeyUp |
| 1809 | 17763 | BackgroundSizing |
| 1809 | 17763 | CornerRadius |
建構函式
| Control() |
提供 控制項 衍生類別的基類初始化行為。 |
屬性
| AccessKey |
取得或設定這個專案的便捷鍵 (助憶鍵) 。 (繼承來源 UIElement) |
| AccessKeyScopeOwner |
取得或設定來源專案，這個元素會提供這個專案的存取索引鍵範圍，即使它不在來源專案的視覺化樹狀結構中也一樣。 (繼承來源 UIElement) |
| ActualHeight |
取得 FrameworkElement的呈現高度。 請參閱＜備註＞。 (繼承來源 FrameworkElement) |
| ActualOffset |
取得這個 UIElement 的位置，相對於其父系，在配置程式的排列階段期間計算。 (繼承來源 UIElement) |
| ActualSize |
取得這個 UIElement 在配置程式的排列階段期間計算的大小。 (繼承來源 UIElement) |
| ActualTheme |
取得專案目前使用的 UI 主題，可能與 RequestedTheme不同。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得 FrameworkElement的呈現寬度。 請參閱＜備註＞。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定值，這個值會判斷這個 UIElement 是否可以是拖放作業的置放目標。 (繼承來源 UIElement) |
| AllowFocusOnInteraction |
取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。 (繼承來源 FrameworkElement) |
| AllowFocusWhenDisabled |
取得或設定停用的控制項是否可以接收焦點。 (繼承來源 FrameworkElement) |
| Background |
取得或設定提供控制項背景的筆刷。 |
| BackgroundProperty |
識別 Background 相依性屬性。 |
| BackgroundSizing |
取得或設定值，這個值表示背景相對於這個專案框線的延伸距離。 |
| BackgroundSizingProperty |
識別 BackgroundSizing 相依性屬性。 |
| BaseUri |
取得統一資源識別元 (URI) ，代表 XAML 載入時間 XAML 建構物件的基底統一資源識別元 (URI) 。 此屬性適用于執行時間的統一資源識別項 (URI) 解析。 (繼承來源 FrameworkElement) |
| BorderBrush |
取得或設定描述控制項框線填滿的筆刷。 |
| BorderBrushProperty |
識別 BorderBrush 相依性屬性。 |
| BorderThickness |
取得或設定控制項的框線粗細。 |
| BorderThicknessProperty |
識別 BorderThickness 相依性屬性。 |
| CacheMode |
取得或設定值，這個值表示轉譯的內容應該盡可能快取為複合點陣圖。 (繼承來源 UIElement) |
| CanBeScrollAnchor |
取得或設定值，這個值表示 UIElement 是否可以是捲動錨定候選項目。 (繼承來源 UIElement) |
| CanDrag |
取得或設定值，這個值表示是否可以將專案拖曳為拖放作業中的資料。 (繼承來源 UIElement) |
| CenterPoint |
取得或設定專案的中心點，這是發生旋轉或縮放的點。 影響專案的轉譯位置。 (繼承來源 UIElement) |
| CharacterSpacing |
取得或設定字元之間的統一間距，單位為 em 的 1/1000。 |
| CharacterSpacingProperty |
識別 CharacterSpacing 相依性屬性。 |
| Clip |
取得或設定用來定義UIElement內容的大綱的RectangleGeometry。 (繼承來源 UIElement) |
| CompositeMode |
取得或設定屬性，這個屬性會宣告其父版面配置和視窗中專案的替代組合和混合模式。 這與混合 XAML/Microsoft DirectX UI 相關的元素相關。 (繼承來源 UIElement) |
| ContextFlyout |
取得或設定與這個專案相關聯的飛出視窗。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定控制項框線角落的半徑。 |
| CornerRadiusProperty |
識別 CornerRadius 相依性屬性。 |
| DataContext |
取得或設定 FrameworkElement的資料內容。 資料內容的常見用法是 當 FrameworkElement 使用 {Binding} 標記延伸並參與資料系結時。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
取得或設定參考控制項預設樣式的索引鍵。 自訂控制項的作者會使用此屬性來變更其控制項所使用的樣式預設值。 |
| DefaultStyleKeyProperty |
識別 DefaultStyleKey 相依性屬性。 |
| DefaultStyleResourceUri |
取得或設定資源檔的路徑，其中包含控制項的預設樣式。 |
| DefaultStyleResourceUriProperty |
識別 DefaultStyleResourceUri 相依性屬性。 |
| DesiredSize |
取得這個 UIElement 在版面配置程式的量值階段期間計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
取得這個 物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可在 UI 執行緒上存取DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject) |
| ElementSoundMode |
取得或設定值，指定是否播放音效的控制項喜好設定。 |
| ElementSoundModeProperty |
識別 ElementSoundMode 相依性屬性。 |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定值，指定叫用存取金鑰時是否關閉存取金鑰顯示。 (繼承來源 UIElement) |
| FlowDirection |
取得或設定文字和其他 UI 元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 LeftToRight 或 RightToLeft。 在任何元素上將 FlowDirection 設定為 RightToLeft ，會將對齊方式設定為右側、從右至左的讀取順序，以及控制項從右至左流動的版面配置。 (繼承來源 FrameworkElement) |
| FocusState |
取得值，指定這個控制項是否有焦點，以及取得焦點的模式。 |
| FocusStateProperty |
識別 FocusState 相依性屬性。 |
| FocusVisualMargin |
取得或設定 FrameworkElement焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定筆刷，用來繪製FrameworkElement之或 |
| FocusVisualPrimaryThickness |
取得或設定FrameworkElement之外部 |
| FocusVisualSecondaryBrush |
取得或設定筆刷，用來繪製FrameworkElement之或 |
| FocusVisualSecondaryThickness |
取得或設定FrameworkElement之 |
| FontFamily |
取得或設定顯示控制項的文字所用的字型。 |
| FontFamilyProperty |
識別 FontFamily 相 依性屬性。 |
| FontSize |
取得或設定這個控制項中的文字大小。 |
| FontSizeProperty |
識別 FontSize 相依性屬性。 |
| FontStretch |
取得或設定螢幕上字型緊縮或加寬的程度。 |
| FontStretchProperty |
識別 FontStretch 相依性屬性。 |
| FontStyle |
取得或設定呈現文字的樣式。 |
| FontStyleProperty |
識別 FontStyle 相依性屬性。 |
| FontWeight |
取得或設定指定字型的粗細。 |
| FontWeightProperty |
識別 FontWeight 相依性屬性。 |
| Foreground |
取得或設定描述前景色彩的筆刷。 |
| ForegroundProperty |
識別 前景 相依性屬性。 |
| Height |
取得或設定 FrameworkElement的建議高度。 (繼承來源 FrameworkElement) |
| HighContrastAdjustment |
取得或設定值，這個值表示當啟用高對比主題時，架構是否會自動調整專案的視覺屬性。 (繼承來源 UIElement) |
| HorizontalAlignment |
取得或設定在版面配置父系中撰寫時套用至 FrameworkElement 的水準對齊特性，例如面板或專案控制項。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控制項內容的水平對齊。 |
| HorizontalContentAlignmentProperty |
識別 HorizontalContentAlignment 相依性屬性。 |
| IsAccessKeyScope |
取得或設定值，這個值表示專案是否定義自己的存取金鑰範圍。 (繼承來源 UIElement) |
| IsDoubleTapEnabled |
取得或設定值，這個值會判斷 DoubleTapped 事件是否可以來自該專案。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定值，指出使用者是否可以與控制項互動。 |
| IsEnabledProperty |
識別 IsEnabled 相依性屬性。 |
| IsFocusEngaged |
取得或設定值，這個值表示焦點是否受限於遊戲台/遠端互動 (控制項界限) 。 |
| IsFocusEngagedProperty |
識別 IsFocusEngaged 相依性屬性。 |
| IsFocusEngagementEnabled |
取得或設定值，指出焦點是否可以限制在控制界限內， (遊戲台/遠端互動) 。 |
| IsFocusEngagementEnabledProperty |
識別 IsFocusEngagementEnabled 相依性屬性。 |
| IsHitTestVisible |
取得或設定這個 UIElement 的自主區域是否可以傳回真正的值來進行點擊測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定值，這個值會決定 Holding 事件是否可以來自該專案。 (繼承來源 UIElement) |
| IsLoaded |
取得值，這個值表示專案是否已加入至專案樹狀結構，且已準備好進行互動。 (繼承來源 FrameworkElement) |
| IsRightTapEnabled |
取得或設定值，這個值會判斷 RightTapped 事件是否可以來自該專案。 (繼承來源 UIElement) |
| IsTabStop |
取得或設定值，這個值表示控制項是否包含於索引標籤巡覽。 |
| IsTabStopProperty |
識別 IsTabStop 相依性屬性。 |
| IsTapEnabled |
取得或設定值，這個值會決定 Tapped 事件是否可以來自該專案。 (繼承來源 UIElement) |
| IsTemplateFocusTargetProperty |
識別 Control.IsTemplateFocusTarget XAML 附加屬性。 |
| IsTemplateKeyTipTargetProperty |
識別 Control.IsTemplateKeyTipTarget XAML 附加屬性。 |
| IsTextScaleFactorEnabled |
取得或設定是否啟用自動放大文字，以反映系統文字大小設定。 |
| IsTextScaleFactorEnabledProperty |
識別 IsTextScaleFactorEnabled 相依性屬性。 |
| KeyboardAcceleratorPlacementMode |
取得或設定值，這個值表示控制項 工具提示 是否顯示其相關聯鍵盤快速鍵的按鍵組合。 (繼承來源 UIElement) |
| KeyboardAcceleratorPlacementTarget |
取得或設定值，這個值表示顯示快速鍵組合的控制項 工具提示 。 (繼承來源 UIElement) |
| KeyboardAccelerators |
取得使用鍵盤叫用動作的按鍵組合集合。 快速鍵通常會指派給按鈕或功能表項目。
|
| KeyTipHorizontalOffset |
取得或設定值，指出索引鍵提示相對於 UIElement 的左邊或右邊。 (繼承來源 UIElement) |
| KeyTipPlacementMode |
取得或設定值，這個值表示存取索引鍵提示相對於 UIElement 界限的位置。 (繼承來源 UIElement) |
| KeyTipTarget |
取得或設定值，這個值表示存取索引鍵提示的目標專案。 (繼承來源 UIElement) |
| KeyTipVerticalOffset |
取得或設定值，這個值表示相對於 UI 元素放置索引鍵提示的上下距離。 (繼承來源 UIElement) |
| Language |
取得或設定套用至 FrameworkElement的當地語系化/全球化語言資訊，以及套用至物件標記法和 UI 中目前 FrameworkElement 的所有子項目。 (繼承來源 FrameworkElement) |
| Lights |
取得附加至這個專案的 XamlLight 物件集合。 (繼承來源 UIElement) |
| ManipulationMode |
取得或設定用於UIElement行為與手勢互動的ManipulationModes值。 設定此值可讓您處理來自應用程式程式碼中這個專案的操作事件。 (繼承來源 UIElement) |
| Margin |
取得或設定 FrameworkElement的外部邊界。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定 FrameworkElement的最大高度條件約束。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定 FrameworkElement的最大寬度條件約束。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定 FrameworkElement的最小高度條件約束。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定 FrameworkElement的最小寬度條件約束。 (繼承來源 FrameworkElement) |
| Name |
取得或設定 物件的識別名稱。 當 XAML 處理器從 XAML 標記建立物件樹狀結構時，執行時間程式碼可以透過這個名稱參考 XAML 宣告的物件。 (繼承來源 FrameworkElement) |
| Opacity |
取得或設定物件的不透明度程度。 (繼承來源 UIElement) |
| OpacityTransition |
取得或設定 ScalarTransition，以動畫顯示 Opacity 屬性的變更。 (繼承來源 UIElement) |
| Padding |
取得或設定控制項內部的邊框間距。 |
| PaddingProperty |
識別 Padding 相依性屬性。 |
| Parent |
取得物件樹狀結構中這個 FrameworkElement 的父物件。 (繼承來源 FrameworkElement) |
| PointerCaptures |
取得所有擷取指標的集合，表示為 指標 值。 (繼承來源 UIElement) |
| Projection |
取得或設定轉譯這個專案時要套用的 3D 效果) (3D 效果。 (繼承來源 UIElement) |
| RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用，請參閱。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform所宣告之任何可能轉譯轉換的原點，相對於 UIElement的界限。 (繼承來源 UIElement) |
| RequestedTheme |
取得或設定 UIElement (及其子項目) 用於資源判斷的 UI 主題。 您使用 RequestedTheme 指定的 UI 主題可以覆寫應用層級 RequestedTheme。 (繼承來源 FrameworkElement) |
| RequiresPointer |
取得或設定 UI 元素是否支援滑鼠模式，以模擬非指標輸入裝置的指標互動體驗，例如遊戲台或遙控器。 |
| RequiresPointerProperty |
識別 RequiresPointer 相依性屬性。 |
| Resources |
取得本機定義的資源字典。 在 XAML 中，您可以透過 XAML 隱含集合語法，將資源專案建立為屬性專案的子物件專案 |
| Rotation |
取得或設定順時針旋轉的角度，以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響專案的轉譯位置。 (繼承來源 UIElement) |
| RotationAxis |
取得或設定座標軸，以繞著旋轉專案。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition，以動畫顯示 Rotation 屬性的變更。 (繼承來源 UIElement) |
| Scale |
取得或設定專案的刻度。 相對於專案的 CenterPoint 進行調整。 影響專案的轉譯位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition，以動畫顯示 Scale 屬性的變更。 (繼承來源 UIElement) |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| Style |
取得或設定配置和轉譯期間針對這個物件套用的實例 Style 。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定值，這個值會修改 Tabbing 和 TabIndex 對此控制項的運作方式。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，指出當使用者使用 Tab 鍵流覽應用程式 UI 時，元素接收焦點的順序。 |
| TabIndexProperty |
識別 TabIndex 相依性屬性。 |
| TabNavigation |
取得或設定值，這個值會修改 Tabbing 和 TabIndex 對此控制項的運作方式。 注意 針對Windows 10 Creators Update (組建 10.0.15063) 和更新版本，TABFocusNavigation屬性可在UIElement基類上使用，以在不使用ControlTemplate的索引標籤序列中包含物件。 |
| TabNavigationProperty |
識別 TabNavigation 相依性屬性。 |
| Tag |
取得或設定任意物件值，可用來儲存這個物件的自訂資訊。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控制項範本。 控制項範本會定義 UI 中控制項的視覺外觀，並在 XAML 標記中定義。 |
| TemplateProperty |
識別 範本 相依性屬性。 |
| Transform3D |
取得或設定轉譯這個專案時要套用的 3D 轉換效果。 (繼承來源 UIElement) |
| TransformMatrix |
取得或設定要套用至專案的轉換矩陣。 (繼承來源 UIElement) |
| Transitions |
取得或設定套用至UIElement的Transition樣式專案集合。 (繼承來源 UIElement) |
| Translation |
取得或設定專案的 x、y 和 z 轉譯位置。 (繼承來源 UIElement) |
| TranslationTransition |
取得或設定 Vector3Transition，以動畫顯示 Translation 屬性的變更。 (繼承來源 UIElement) |
| Triggers |
取得針對 FrameworkElement定義的動畫觸發程式集合。 不常使用。 請參閱＜備註＞。 (繼承來源 FrameworkElement) |
| UIContext |
取得專案的內容識別碼。 (繼承來源 UIElement) |
| UseLayoutRounding |
取得或設定值，這個值會決定物件及其視覺子樹的轉譯是否應該使用四捨五入行為，將轉譯對齊整個圖元。 (繼承來源 UIElement) |
| UseSystemFocusVisuals |
取得或設定值，這個值表示控制項是否使用由系統或控制項範本中定義的焦點視覺效果。 |
| UseSystemFocusVisualsProperty |
識別 UseSystemFocusVisuals 相依性屬性。 |
| VerticalAlignment |
取得或設定在面板或專案控制項等父物件中撰寫時套用至 FrameworkElement 的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 |
| VerticalContentAlignmentProperty |
識別 VerticalContentAlignment 相依性屬性。 |
| Visibility |
取得或設定 UIElement的可見度。 不可見的 UIElement 不會轉譯，而且不會將其所需的大小傳達給版面配置。 (繼承來源 UIElement) |
| Width |
取得或設定 FrameworkElement的寬度。 (繼承來源 FrameworkElement) |
| XamlRoot |
取得或設定 |
| XYFocusDown |
取得或設定當使用者按下 Directional Pad (D-pad) 向下時取得焦點的物件。 |
| XYFocusDownNavigationStrategy |
取得或設定值，指定用來判斷向下導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusDownProperty |
識別 XYFocusDown 相依性屬性。 |
| XYFocusKeyboardNavigation |
取得或設定值，這個值會啟用或停用使用鍵盤方向箭號的流覽。 (繼承來源 UIElement) |
| XYFocusLeft |
取得或設定當使用者按下 Directional Pad (D-pad) 左邊時取得焦點的物件。 |
| XYFocusLeftNavigationStrategy |
取得或設定值，指定用來判斷左側導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusLeftProperty |
識別 XYFocusLeft 相依性屬性。 |
| XYFocusRight |
取得或設定當使用者按下方向鍵 (D 鍵) 右鍵時取得焦點的物件。 |
| XYFocusRightNavigationStrategy |
取得或設定值，指定用來判斷右導覽之目標元素的策略。 (繼承來源 UIElement) |
| XYFocusRightProperty |
識別 XYFocusRight 相依性屬性。 |
| XYFocusUp |
取得或設定當使用者按下 Directional Pad (D 鍵) 時取得焦點的物件。 |
| XYFocusUpNavigationStrategy |
取得或設定值，指定用來判斷向上流覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusUpProperty |
識別 XYFocusUp 相依性屬性。 |
附加屬性
| IsTemplateFocusTarget |
取得或設定值，這個值表示這個專案是否為具有焦點視覺效果之控制項範本的一部分。 |
| IsTemplateKeyTipTarget |
取得或設定值，這個值表示這個專案是否為放置 KeyTip 之控制項範本的一部分。 |
方法
事件
| AccessKeyDisplayDismissed |
發生于不應再顯示存取金鑰時。 (繼承來源 UIElement) |
| AccessKeyDisplayRequested |
發生于使用者要求顯示存取金鑰時。 (繼承來源 UIElement) |
| AccessKeyInvoked |
發生于使用者完成存取金鑰序列時。 (繼承來源 UIElement) |
| ActualThemeChanged |
發生于 ActualTheme 屬性值已變更時。 (繼承來源 FrameworkElement) |
| BringIntoViewRequested |
在這個專案或其中一個子代上呼叫 StartBringIntoView 時發生。 (繼承來源 UIElement) |
| CharacterReceived |
發生于輸入佇列收到單一、撰寫的字元時。 (繼承來源 UIElement) |
| ContextCanceled |
發生于內容輸入手勢繼續進入操作手勢時，通知專案不應開啟內容飛出視窗。 (繼承來源 UIElement) |
| ContextRequested |
發生于使用者已完成內容輸入手勢時，例如按一下滑鼠右鍵。 (繼承來源 UIElement) |
| DataContextChanged |
發生于 FrameworkElement.DataCoNtext 屬性的值變更時。 (繼承來源 FrameworkElement) |
| DoubleTapped |
發生于在此元素的點擊測試區域上發生未處理的 DoubleTap 互動時。 (繼承來源 UIElement) |
| DragEnter |
當輸入系統報告基礎拖曳事件，並將這個專案當做目標時發生。 (繼承來源 UIElement) |
| DragLeave |
當輸入系統報告基礎拖曳事件，並將這個專案當做原點時發生。 (繼承來源 UIElement) |
| DragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| DragStarting |
發生于起始拖曳作業時。 (繼承來源 UIElement) |
| Drop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement) |
| DropCompleted |
發生于以這個專案做為結束來源的拖放作業時。 (繼承來源 UIElement) |
| EffectiveViewportChanged |
發生于 FrameworkElement的有效檢視區 變更時。 (繼承來源 FrameworkElement) |
| FocusDisengaged |
當焦點從遊戲台/遠端互動 () 的控制項界限釋放時發生。 |
| FocusEngaged |
發生于控制項界限內限制焦點時， (遊戲台/遠端互動) 。 |
| GettingFocus |
發生于 UIElement 收到焦點之前。 此事件會同步引發，以確保事件反升時不會移動焦點。 (繼承來源 UIElement) |
| GotFocus |
發生于 UIElement 收到焦點時。 此事件會以非同步方式引發，因此焦點可以在反升完成之前再次移動。 (繼承來源 UIElement) |
| Holding |
發生于在此元素的點擊測試區域上發生未處理的 保留 互動時。 (繼承來源 UIElement) |
| IsEnabledChanged |
發生于 IsEnabled 屬性變更時。 |
| KeyDown |
在 UIElement 有焦點時按下鍵盤按鍵時發生。 (繼承來源 UIElement) |
| KeyUp |
發生于 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
| LayoutUpdated |
發生于視覺化樹狀結構的版面配置變更時，因為配置相關屬性變更值或重新整理版面配置的其他動作。 (繼承來源 FrameworkElement) |
| Loaded |
發生于 架構Element 已建構並新增至物件樹狀結構，並準備好進行互動時。 (繼承來源 FrameworkElement) |
| Loading |
當 FrameworkElement 開始載入時發生。 (繼承來源 FrameworkElement) |
| LosingFocus |
發生于 UIElement 失去焦點之前。 此事件會同步引發，以確保事件反升時不會移動焦點。 (繼承來源 UIElement) |
| LostFocus |
發生于 UIElement 失去焦點時。 此事件會以非同步方式引發，因此焦點可以在反升完成之前再次移動。 (繼承來源 UIElement) |
| ManipulationCompleted |
發生于 UIElement 上的操作完成時。 (繼承來源 UIElement) |
| ManipulationDelta |
輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
| ManipulationInertiaStarting |
在操作和慣性開始的時候，只要輸入裝置不與 UIElement 物件接觸便發生。 (繼承來源 UIElement) |
| ManipulationStarted |
當輸入裝置開始在 UIElement 進行操作時發生。 (繼承來源 UIElement) |
| ManipulationStarting |
發生於第一次建立操作處理器時。 (繼承來源 UIElement) |
| NoFocusCandidateFound |
發生于使用者嘗試透過索引標籤或方向箭號移動焦點 () ，但焦點不會移動，因為不會在移動方向找到任何焦點候選項目。 (繼承來源 UIElement) |
| PointerCanceled |
發生于讓連絡人異常失去連絡人的指標時。 (繼承來源 UIElement) |
| PointerCaptureLost |
發生于這個專案先前保留的指標擷取移至另一個專案或其他地方時。 (繼承來源 UIElement) |
| PointerEntered |
發生于指標進入這個專案的點擊測試區域時。 (繼承來源 UIElement) |
| PointerExited |
發生于指標離開這個專案的點擊測試區域時。 (繼承來源 UIElement) |
| PointerMoved |
當指標在指標保留在這個專案的點擊測試區域中時移動時發生。 (繼承來源 UIElement) |
| PointerPressed |
發生于指標裝置在這個專案內起始 Press 動作時。 (繼承來源 UIElement) |
| PointerReleased |
發生于先前起始 按下 動作的指標裝置放開時，同時在此元素內。 請注意， 按下動作的 結尾不保證會引發 PointerReleased 事件;其他事件可能會改為引發。 如需詳細資訊，請參閱。 (繼承來源 UIElement) |
| PointerWheelChanged |
發生于指標滾輪的差異值變更時。 (繼承來源 UIElement) |
| PreviewKeyDown |
在 UIElement 有焦點時按下鍵盤按鍵時發生。 (繼承來源 UIElement) |
| PreviewKeyUp |
發生于 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
| ProcessKeyboardAccelerators |
發生于按下 鍵盤快速鍵 (或快速鍵) 時。 (繼承來源 UIElement) |
| RightTapped |
發生于在指標位於 元素上方時發生右鍵輸入回應時。 (繼承來源 UIElement) |
| SizeChanged |
發生于 ActualHeight 或 ActualWidth 屬性變更 FrameworkElement上的值時。 (繼承來源 FrameworkElement) |
| Tapped |
發生于未處理的 點 選互動發生于這個專案的點擊測試區域。 (繼承來源 UIElement) |
| Unloaded |
當這個物件不再連接到主物件樹狀結構時發生。 (繼承來源 FrameworkElement) |