ContentPresenter 類別

定義

命名空間:: Microsoft.UI.Xaml.Controls

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

顯示 ContentControl 的內容。也能為非控制系統提供內容呈現。提供一個專門呈現器的基底類別，例如 ScrollContentPresenter。

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ContentPresenter : FrameworkElement

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ContentPresenter : FrameworkElement

Public Class ContentPresenter
Inherits FrameworkElement

<ContentPresenter .../>

繼承: Object IInspectable DependencyObject UIElement FrameworkElement ContentPresenter

衍生: Microsoft.UI.Xaml.Controls.Primitives.GridViewItemPresenter

Microsoft.UI.Xaml.Controls.Primitives.ListViewItemPresenter

Microsoft.UI.Xaml.Controls.ScrollContentPresenter

屬性: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

此範例展示了 ContentPresenter 物件元素作為 ContentCtrl 控制模板一部分的典型擺放方式。此範例是 Windows Runtime XAML 預設風格的簡化，適用於 HyperlinkButton。其中有一個 VisualState 範例，用以展示 ContentPresenter 屬性如何根據狀態改變。內容呈現者位於作文的邊界內;內容控制項通常會將 ContentPresenter 巢狀嵌入另一個父元素中，而該父元素經常會用模板綁定 ContentPresenter 沒有的控制項屬性。同時也請注意 ContentPresenter 使用 {TemplateBinding} 標記擴充功能，將 HorizontalAlignment / 垂直對齊值綁定到模板套用處的控制屬性。

    <!-- Default style for Windows.UI.Xaml.Controls.Primitives.HyperlinkButton -->
    <Style TargetType="HyperlinkButton">
...
        <Setter Property="HorizontalAlignment" Value="Left"/>
        <Setter Property="VerticalAlignment" Value="Center"/>
...
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="HyperlinkButton">
                    <Grid>
                        <VisualStateManager.VisualStateGroups>
                            <VisualStateGroup x:Name="CommonStates">
...
                                <VisualState x:Name="Disabled">
                                    <Storyboard>
                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter"
                                                                       Storyboard.TargetProperty="Foreground">
                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource HyperlinkDisabledThemeBrush}"/>
                                        </ObjectAnimationUsingKeyFrames>
                                    </Storyboard>
                                </VisualState>
                            </VisualStateGroup>
                        </VisualStateManager.VisualStateGroups>
                        <Border x:Name="Border"
                                Background="{TemplateBinding Background}"
                                BorderBrush="{TemplateBinding BorderBrush}"
                                BorderThickness="{TemplateBinding BorderThickness}"
                                Margin="3">
                            <ContentPresenter x:Name="ContentPresenter"
                                              Content="{TemplateBinding Content}"
                                              ContentTransitions="{TemplateBinding ContentTransitions}"
                                              ContentTemplate="{TemplateBinding ContentTemplate}"
                                              HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                                              VerticalAlignment="{TemplateBinding VerticalContentAlignment}" 
                    />
                        </Border>
                        <!--focus visuals omitted-->
                    </Grid>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>

備註

通常，你會直接在 ContentControl 的 ControlTemplate 中使用 ContentPresenter，標記要呈現的內容出現的位置。

ContentPresenter 常用於將特性套用於文字內容中，這些特徵僅以字串作為文字（或某種間接等價物如 Binding 或 RESX 資源）設定在內容屬性中。因此，ContentPresenter 的特性與 TextElement 類別的性質相似。（ TextElement 類別是用於幾個非控制項元素的基底類別，這些元素用於格式化可能出現在控制項或版面容器中的文字。）

ContentPresenter 可以使用邏輯類別，在執行時影響用於模板資料內容的範本。欲了解更多資訊，請參閱 ContentTemplateSelector 屬性。

如果 ContentPresenter 位於 ContentControl 的 ControlTemplate 中，ContentPresenter 的行為會隱含綁定到該模板化 ContentControl 的內容範本及其內容屬性。

邊界性質

ContentPresenter 定義邊界屬性，讓你可以在不使用額外邊框元素的情況下，在 ContentPresenter 周圍繪製邊界。這些屬性分別是 ContentPresenter.BorderBrush、 ContentPresenter.BorderThickness、 ContentPresenter.CornerRadius 以及 ContentPresenter.Padding。

<ContentPresenter BorderBrush="Red" BorderThickness="2" CornerRadius="10" Padding="12"/>

ContentPresenter 衍生類別

ContentPresenter 是以下類別的父類別：

建構函式

名稱	Description
ContentPresenter()	初始化 ContentPresenter 類別的新實例。

屬性

名稱	Description
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	取得或設定筆刷套用到由 ContentPresenter 處理的內容背景。
BackgroundProperty	識別背景依賴屬性。
BackgroundSizing	取得或設定一個值，表示背景相對於該元素邊界的延伸距離。
BackgroundSizingProperty	識別背景尺寸依賴性屬性。
BackgroundTransition	取得或設定 BrushTransition 實例自動為背景屬性做動畫變更。
BaseUri	取得一個統一資源識別碼（URI），代表 XAML 載入時所建構物件的基礎 URI。此特性對執行時的 URI 解析非常有用。 (繼承來源 FrameworkElement)
BorderBrush	會取得或設定一個筆刷，描述內容呈現器的邊框填充。
BorderBrushProperty	識別 BorderBrush 相依性屬性。
BorderThickness	取得或設定內容呈現器的邊界厚度。
BorderThicknessProperty	識別 BorderThickness 依賴性質。
CacheMode	取得或設定一個值，表示渲染內容應盡可能以合成點陣圖形式快取。 (繼承來源 UIElement)
CanBeScrollAnchor	取得或設定一個值，指示 UIElement 是否適合作為捲動錨定的候選對象。 (繼承來源 UIElement)
CanDrag	取得或設定一個值，指示該元素是否能以拖放操作的方式被拖曳為資料。 (繼承來源 UIElement)
CenterPoint	取得或設定元素的中心點，即旋轉或縮放發生的中心點。會影響元素的渲染位置。 (繼承來源 UIElement)
CharacterSpacing	取得或設定字元間的均勻間距，單位為 1/1000 的 em。
CharacterSpacingProperty	識別 CharacterSpacing 依賴屬性。
Clip	取得或設定用於定義 UIElement 內容輪廓的矩形幾何。 (繼承來源 UIElement)
CompositeMode	取得或設定一個屬性，宣告該元素在其父版面配置與視窗中的替代合成與混合模式。這對於涉及混合 XAML / Microsoft DirectX UI 的元素非常重要。 (繼承來源 UIElement)
Content	取得或設定用於產生 ContentPresenter 子元素的資料。
ContentProperty	識別內容相依屬性
ContentTemplate	取得或設定用來顯示控制內容的範本。
ContentTemplateProperty	識別 ContentTemplate 相依屬性。
ContentTemplateSelector	取得或設定一個選擇物件，根據執行時處理內容項目或其容器的資訊，將資料範本變更為 ContentPresenter 呈現的內容。
ContentTemplateSelectorProperty	識別 ContentTemplateSelector 相依屬性。
ContentTransitions	取得或設定適用於 ContentPresenter 呈現內容的 Transition 風格元素集合。
ContentTransitionsProperty	識別 ContentTransitions 相依屬性。
ContextFlyout	取得或設定與此元素相關的飛出。 (繼承來源 UIElement)
CornerRadius	取得或設定內容呈現者邊框角落的半徑。
CornerRadiusProperty	識別 CornerRadius 依賴性屬性。
DataContext	取得或設定 FrameworkElement 的資料上下文。資料上下文的常見用途是 a `FrameworkElement` 使用 {Binding} 標記擴充並參與資料綁定。 (繼承來源 FrameworkElement)
DesiredSize	取得該 UIElement 在佈局過程的測度通過時計算出的大小。 (繼承來源 UIElement)
Dispatcher	它總是在 Windows App SDK 應用程式中回傳 `null` 。改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	得到 `DispatcherQueue` 這個物件所關聯的那個。代表 `DispatcherQueue` 一個功能，即使程式碼是由非 UI 執行緒發起，也能存取 UI `DependencyObject` 執行緒。 (繼承來源 DependencyObject)
ExitDisplayModeOnAccessKeyInvoked	取得或設定一個值，指定在呼叫存取鍵時是否會關閉存取鍵顯示。 (繼承來源 UIElement)
FlowDirection	它設定文字及其他 UI 元素在任何控制其版面配置的父元素內流動的方向。此屬性可設定為或 `LeftToRightRightToLeft`。將設定 `FlowDirection` 為對 `RightToLeft` 任意元素，會將比對順序設定為右至左，控制鍵的配置則由右向左流動。 (繼承來源 FrameworkElement)
FocusState	會得到一個值，指定此控制是否具備對焦功能，以及取得對焦的方式。 (繼承來源 UIElement)
FocusVisualMargin	取得或設定 FrameworkElement 焦點視覺化的外圍。 (繼承來源 FrameworkElement)
FocusVisualPrimaryBrush	取得或設定用來繪製框架元素外邊界`HighVisibility`或`Reveal`聚焦視覺化的畫筆。 (繼承來源 FrameworkElement)
FocusVisualPrimaryThickness	取得或設定框架元素外層邊界`HighVisibility`的厚度，或`Reveal`聚焦視覺化。 (繼承來源 FrameworkElement)
FocusVisualSecondaryBrush	取得或設定用來繪製框架元素內邊界`HighVisibilityReveal`或聚焦視覺化的畫筆。 (繼承來源 FrameworkElement)
FocusVisualSecondaryThickness	取得或設定框架元素內邊界`HighVisibility`的厚度，或`Reveal`聚焦視覺化的視覺化。 (繼承來源 FrameworkElement)
FontFamily	取得或設定 ContentPresenter 所呈現文字內容的首選頂層字型家族。
FontFamilyProperty	識別 FontFamily 依賴屬性。
FontSize	取得或設定 ContentPresenter 所呈現文字內容的字體大小。
FontSizeProperty	識別 FontSize 依賴屬性。
FontStretch	取得或設定 ContentPresenter 所呈現文字內容的字型拉伸。
FontStretchProperty	識別 FontStretch 依賴性屬性。
FontStyle	取得或設定呈現內容的字體樣式。
FontStyleProperty	識別 FontStyle 依賴屬性。
FontWeight	取得或設定 ContentPresenter 所呈現文字內容的頂層字體粗細。
FontWeightProperty	識別 FontWeight 依賴屬性。
Foreground	取得或設定筆刷套用到 ContentPresenter 處理的文字內容。
ForegroundProperty	識別前景依賴性質。
Height	取得或設定 FrameworkElement 的建議高度。 (繼承來源 FrameworkElement)
HighContrastAdjustment	取得或設定一個值，指示框架在啟用高對比主題時是否自動調整元素的視覺屬性。 (繼承來源 UIElement)
HorizontalAlignment	取得或設定在 FrameworkElement 組合於版面父元件（如面板或項目控制項）時套用的水平對齊特性。 (繼承來源 FrameworkElement)
HorizontalContentAlignment	取得或設定內容的水平對齊。
HorizontalContentAlignmentProperty	識別 HorizontalContentAlignment 依賴屬性。
IsAccessKeyScope	取得或設定一個值，指示元素是否定義其存取鍵作用域。 (繼承來源 UIElement)
IsDoubleTapEnabled	取得或設定一個值，決定 DoubleTapped 事件是否能從該元素產生。 (繼承來源 UIElement)
IsHitTestVisible	取得或設定此 UIElement 所包含區域是否能回傳真實值以進行命中測試。 (繼承來源 UIElement)
IsHoldingEnabled	取得或設定一個值，決定持有事件是否能從該元素產生。 (繼承來源 UIElement)
IsLoaded	會得到一個值，表示該元素是否已被加入元素樹並準備好進行互動。 (繼承來源 FrameworkElement)
IsRightTapEnabled	取得或設定一個值，決定 RightTapped 事件是否能從該元素產生。 (繼承來源 UIElement)
IsTabStop	取得或設定一個值，指示分頁導覽中是否包含某個控制項。 (繼承來源 UIElement)
IsTapEnabled	取得或設定一個值，決定 Tapped 事件是否能從該元素產生。 (繼承來源 UIElement)
IsTextScaleFactorEnabled	取得或設定是否啟用自動文字放大（反映系統文字大小設定）。
IsTextScaleFactorEnabledProperty	識別 IsTextScaleFactorEnabled 相依性屬性。
KeyboardAcceleratorPlacementMode	取得或設定一個值，指示控制工具提示是否顯示其對應鍵盤加速器的按鍵組合。 (繼承來源 UIElement)
KeyboardAcceleratorPlacementTarget	取得或設定一個值，指示顯示加速器按鍵組合的控制工具提示。 (繼承來源 UIElement)
KeyboardAccelerators	取得一組按鍵組合，用鍵盤觸發動作。加速器通常分配給按鈕或選單項目。顯示各種選單項目鍵盤加速器的選單範例 (繼承來源 UIElement)
KeyTipHorizontalOffset	取得或設定一個值，表示鍵尖相對於 UIElement 的位置有多左或多右。 (繼承來源 UIElement)
KeyTipPlacementMode	取得或設定一個值，指示存取鍵提示相對於 UIElement 邊界的位置。 (繼承來源 UIElement)
KeyTipTarget	取得或設定一個值，指示存取鍵提示所鎖定的元素。 (繼承來源 UIElement)
KeyTipVerticalOffset	它會取得或設定一個值，表示鍵尖相對於 UI 元素的上下位置。 (繼承來源 UIElement)
Language	取得或設定適用於 FrameworkElement 的本地化/全球化語言資訊，同時也適用於物件表示法和 UI 中目前 FrameworkElement 的所有子元素。 (繼承來源 FrameworkElement)
Lights	會讓 XamlLight 物件集合附加到這個元素上。 (繼承來源 UIElement)
LineHeight	取得或設定 ContentPresenter 所呈現的每行文字內容的高度。
LineHeightProperty	識別 LineHeight 依賴屬性。
LineStackingStrategy	取得或設定一個值，指示每行文字如何決定行框。
LineStackingStrategyProperty	識別 LineStackingStrategy 依賴屬性。
ManipulationMode	取得或設定用於 UIElement 行為及手勢互動的 ManipulationModes 值。設定此值後，能在應用程式程式碼中處理該元素的操作事件。 (繼承來源 UIElement)
Margin	取得或設定 FrameworkElement 的外緣。 (繼承來源 FrameworkElement)
MaxHeight	取得或設定 FrameworkElement 的最大高度限制。 (繼承來源 FrameworkElement)
MaxLines	取得或設定顯示的最大文字行數。
MaxLinesProperty	識別 MaxLines 相依屬性。
MaxWidth	取得或設定 FrameworkElement 的最大寬度限制。 (繼承來源 FrameworkElement)
MinHeight	取得或設定 FrameworkElement 的最小高度限制。 (繼承來源 FrameworkElement)
MinWidth	取得或設定 FrameworkElement 的最小寬度限制。 (繼承來源 FrameworkElement)
Name	取得或設定物件的識別名稱。當 XAML 處理器從 XAML 標記建立物件樹時，執行時程式碼可以以此名稱來指稱 XAML 宣告的物件。 (繼承來源 FrameworkElement)
Opacity	取得或設定物件不透明度的度數。 (繼承來源 UIElement)
OpacityTransition	取得或設定 ScalarTransition，用來動畫化 Opacity 屬性的變更。 (繼承來源 UIElement)
OpticalMarginAlignment	取得或設定一個值，指示字型如何修改以符合不同大小的字型。
OpticalMarginAlignmentProperty	識別 OpticalMarginAlignment 依賴性屬性。
Padding	取得或設定邊界與其子物件之間的距離。
PaddingProperty	識別 Padding 依賴性質。
Parent	取得物件樹中 FrameworkElement 的父物件。 (繼承來源 FrameworkElement)
PointerCaptures	取得所有捕獲指標的集合，以指標值表示。 (繼承來源 UIElement)
Projection	在渲染這個元素時，會取得或設定投影（3D 效果）來套用。 (繼承來源 UIElement)
ProtectedCursor	取得或設定游標，當指標位於此元素上時會顯示。預設為 null，表示游標沒有變化。 (繼承來源 UIElement)
RasterizationScale	會獲得一個代表額外比例因子的值，用於渲染形狀、影像、文字或媒體，通常是為了渲染比一般解析度更高的解析度。 (繼承來源 UIElement)
RenderSize	會取得 UIElement 的最終渲染大小。不建議使用此，詳見備註。 (繼承來源 UIElement)
RenderTransform	取得或設定影響 UIElement 渲染位置的轉換資訊。 (繼承來源 UIElement)
RenderTransformOrigin	取得或設定 RenderTransform 宣告的任何可能渲染轉換的起點，相對於 UIElement 的界限。 (繼承來源 UIElement)
RequestedTheme	取得或設定 UI 主題，該主題由 UIElement （及其子元素）用於資源判定。你指定的 `RequestedTheme` UI 主題可以覆蓋應用程式層級的 RequestedTheme。 (繼承來源 FrameworkElement)
Resources	取得本地定義的資源字典。在 XAML 中，你可以透過 XAML 隱含的集合語法，將資源項目建立為屬性元素的 `frameworkElement.Resources` 子物件元素。 (繼承來源 FrameworkElement)
Rotation	設定順時針旋轉的角度，以度數為單位。相對於旋轉軸和中心點旋轉。會影響元素的渲染位置。 (繼承來源 UIElement)
RotationAxis	讓軸線旋轉元素。 (繼承來源 UIElement)
RotationTransition	取得或設定 ScalarTransition，讓 Rotation 屬性的變化動畫化。 (繼承來源 UIElement)
Scale	取得或設定元素的比例。相對於元素的中心點進行縮放。會影響元素的渲染位置。 (繼承來源 UIElement)
ScaleTransition	取得或設定 Vector3Transition，用來動畫化 Scale 屬性的變更。 (繼承來源 UIElement)
Shadow	取得或設定元素所轉換的陰影效果。 (繼承來源 UIElement)
Style	在版面設計和渲染過程中，會取得或設定一個實例樣式，應用於該物件。 (繼承來源 FrameworkElement)
TabFocusNavigation	取得或設定一個值，改變 tab 鍵和 TabIndex 對此控制項的運作方式。 (繼承來源 UIElement)
TabIndex	取得或設定一個值，決定使用者使用 Tab 鍵在控制項中移動時，元素獲得焦點的順序。 (繼承來源 UIElement)
Tag	取得或設定一個任意物件值，可用來儲存該物件的自訂資訊。 (繼承來源 FrameworkElement)
TextLineBounds	取得或設定一個值，指示 ContentPresenter 中顯示的每行文字如何決定行框高度。
TextLineBoundsProperty	識別 TextLineBounds 依賴屬性。
TextWrapping	設定元素如何摺疊文字。
TextWrappingProperty	識別 TextWrapping 依賴屬性。
Transform3D	在渲染這個元素時，會取得或設定 3D 轉換效果套用。 (繼承來源 UIElement)
TransformMatrix	取得或設定轉換矩陣以套用到元素。 (繼承來源 UIElement)
Transitions	取得或設定適用於 UIElement 的 Transition 風格元素集合。 (繼承來源 UIElement)
Translation	取得或設定元素的 x、y 和 z 渲染位置。 (繼承來源 UIElement)
TranslationTransition	取得或設定 Vector3Transition，用來動畫化 Translation 屬性的變更。 (繼承來源 UIElement)
Triggers	取得為 FrameworkElement 定義的動畫觸發器集合。不常用。請參閱備註。 (繼承來源 FrameworkElement)
UseLayoutRounding	取得或設定一個值，決定物件及其視覺子樹的渲染是否應該使用捨入行為，使渲染對齊到整像素。 (繼承來源 UIElement)
UseSystemFocusVisuals	取得或設定一個值，指示控制使用系統繪製的焦點視覺化，還是控制模板中定義的焦點視覺化。 (繼承來源 UIElement)
VerticalAlignment	取得或設定當 FrameworkElement 被組合在父物件（如面板或項目控制項）時，套用到的垂直對齊特性。 (繼承來源 FrameworkElement)
VerticalContentAlignment	取得或設定內容的垂直對齊。
VerticalContentAlignmentProperty	識別 VerticalContentAlignment 依賴屬性。
Visibility	取得或設定 UIElement 的可見性。不可見的 A `UIElement` 不會被渲染，也無法向佈局傳達其期望大小。 (繼承來源 UIElement)
Width	取得或設定 FrameworkElement 的寬度。 (繼承來源 FrameworkElement)
XamlRoot	取得或設定 `XamlRoot` 該元素正在被觀看的區域。 (繼承來源 UIElement)
XYFocusDown	當使用者按下遊戲控制器的方向鍵（方向鍵）時，會取得或設定該物件被聚焦的目標。 (繼承來源 UIElement)
XYFocusDownNavigationStrategy	取得或設定一個值，指定用以決定下行導覽目標元素的策略。 (繼承來源 UIElement)
XYFocusKeyboardNavigation	取得或設定一個值，使鍵盤方向鍵導覽啟用或停用。 (繼承來源 UIElement)
XYFocusLeft	當使用者按下遊戲控制器方向鍵（D-pad）左鍵時，會取得或設定該物件被聚焦。 (繼承來源 UIElement)
XYFocusLeftNavigationStrategy	取得或設定一個值，指定用來決定左邊導航目標元素的策略。 (繼承來源 UIElement)
XYFocusRight	當使用者按下遊戲控制器方向鍵（方向鍵）時，該物件會被聚焦。 (繼承來源 UIElement)
XYFocusRightNavigationStrategy	取得或設定一個值，指定用以決定右向導航目標元素的策略。 (繼承來源 UIElement)
XYFocusUp	當使用者按下遊戲控制器的方向鍵（D-pad）時，會取得或設定該物件會被聚焦。 (繼承來源 UIElement)
XYFocusUpNavigationStrategy	取得或設定一個值，指定用以決定上行導航目標元素的策略。 (繼承來源 UIElement)

方法

名稱	Description
AddHandler(RoutedEvent, Object, Boolean)	為指定的路由事件新增一個路由事件處理器，並將該處理器加入目前元素的處理器集合中。指定`handledEventsTootrue`即使事件在其他地方處理，也能呼叫所提供的處理器。 (繼承來源 UIElement)
Arrange(Rect)	定位子物件並決定 UIElement 的大小。為其子元素實作自訂版面配置的父物件，應從其版面覆寫實作中呼叫此方法，形成遞迴版面更新。 (繼承來源 UIElement)
ArrangeOverride(Size)	提供佈局「編排」路徑的行為。類別可以覆寫此方法，定義自己的「排列」傳遞行為。 (繼承來源 FrameworkElement)
CancelDirectManipulations()	取消任何包含當前 UIElement 的 ScrollViewer 父程式上的直接操作處理（系統定義的平移/縮放）。 (繼承來源 UIElement)
CapturePointer(Pointer)	將指標擷取設定到 UIElement。一旦被捕獲，只有被捕獲的元素會觸發與指標相關的事件。 (繼承來源 UIElement)
ClearValue(DependencyProperty)	清除依賴性財產的局部價值。 (繼承來源 DependencyObject)
FindName(String)	擷取具有指定識別碼名稱的物件。 (繼承來源 FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)	啟用 UIElement 子類別，以揭露有助於解決觸控目標的子元素。 (繼承來源 UIElement)
Focus(FocusState)	嘗試將焦點設定為這個專案。 (繼承來源 UIElement)
GetAnimationBaseValue(DependencyProperty)	回傳任何為相依屬性建立的基礎值，適用於動畫未啟用時。 (繼承來源 DependencyObject)
GetBindingExpression(DependencyProperty)	回傳代表指定屬性綁定的 BindingExpression 。 (繼承來源 FrameworkElement)
GetChildrenInTabFocusOrder()	啟用 UIElement 子類別，以暴露參與 Tab 焦點的子元素。 (繼承來源 UIElement)
GetValue(DependencyProperty)	回傳 DependencyObject 中相依屬性的當前有效值。 (繼承來源 DependencyObject)
GetVisualInternal()	取回該元素所解析的。`Visual` (繼承來源 UIElement)
GoToElementStateCore(String, Boolean)	當在衍生類別中實作時，能在程式碼中為控制範本逐狀態建構視覺化樹，而非在控制啟動時載入所有狀態的 XAML。 (繼承來源 FrameworkElement)
InvalidateArrange()	使 UIElement 的 arrange 狀態（layout）失效。失效後， UIElement 的版面會被非同步更新。 (繼承來源 UIElement)
InvalidateMeasure()	使 UIElement 的測量狀態（佈局）失效。 (繼承來源 UIElement)
InvalidateViewport()	會使用於計算有效視窗的 UIElement 的視窗狀態失效。 (繼承來源 FrameworkElement)
Measure(Size)	更新 UIElement 的 DesiredSize 。通常，實作自訂版面版面子版面的物件會從自己的 MeasureOverride 實作中呼叫此方法，形成遞迴版面更新。 (繼承來源 UIElement)
MeasureOverride(Size)	提供佈局週期中「測量」通道的行為。類別可以覆寫此方法，定義自己的「Measure」通過行為。 (繼承來源 FrameworkElement)
OnApplyTemplate()	每當應用程式碼或內部程序（如重建版面操作）呼叫 ApplyTemplate 時，都會被呼叫。簡單來說，這表示在應用程式中顯示 UI 元素之前，會呼叫這個方法。覆寫此方法以影響類別預設的模板後邏輯。 (繼承來源 FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	在 BringIntoViewRequested 事件發生前被呼叫。 (繼承來源 UIElement)
OnContentTemplateChanged(DataTemplate, DataTemplate)	當 ContentTemplate 屬性的值改變時會被呼叫。
OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)	當 ContentTemplateSelector 屬性的值改變時會被呼叫。
OnCreateAutomationPeer()	當在衍生類別中實作時，會回傳類別專屬的 AutomationPeer Microsoft UI Automation基礎架構的實作。 (繼承來源 UIElement)
OnDisconnectVisualChildren()	覆寫此方法，實作當類別特定內容或子屬性移除項目時，版面與邏輯應如何運作。 (繼承來源 UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)	當鍵盤快捷鍵（或加速器）在你的應用程式中處理時會被呼叫。覆寫此方法，以處理應用程式在啟動鍵盤加速器時的回應。 (繼承來源 UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	在你的應用程式處理鍵盤快捷鍵（或加速器）之前，這會被呼叫。每當應用程式程式碼或內部程序呼叫 ProcessKeyboardAccelators 時會被呼叫。覆寫此方法以影響預設加速器的處理方式。 (繼承來源 UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義了一個可以被動畫化的屬性。 (繼承來源 UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	當在派生類別中覆寫時，定義了一個可被動畫化的屬性。 (繼承來源 UIElement)
ReadLocalValue(DependencyProperty)	若設定了本地值，則回傳依賴性質的局部值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊一個通知函式，用於監聽此 DependencyObject 實例中特定 DependencyProperty 的變更。 (繼承來源 DependencyObject)
ReleasePointerCapture(Pointer)	此 UIElement 釋放指標擷取以捕捉特定指標。 (繼承來源 UIElement)
ReleasePointerCaptures()	釋放此元素所持有的所有指標捕獲。 (繼承來源 UIElement)
RemoveHandler(RoutedEvent, Object)	移除此 UIElement 中指定的路由事件處理程序。通常該處理器是由 AddHandler 新增的。 (繼承來源 UIElement)
SetBinding(DependencyProperty, BindingBase)	利用提供的綁定物件將綁定附加到 FrameworkElement。 (繼承來源 FrameworkElement)
SetValue(DependencyProperty, Object)	將相依屬性的局部值設定在 DependencyObject 上。 (繼承來源 DependencyObject)
StartAnimation(ICompositionAnimationBase)	開始該元素的指定動畫。 (繼承來源 UIElement)
StartBringIntoView()	向 XAML 框架發起請求，要求將元素在任何可捲動的區域內顯示。 (繼承來源 UIElement)
StartBringIntoView(BringIntoViewOptions)	會向 XAML 框架發起請求，使用指定的選項將元素帶入視野。 (繼承來源 UIElement)
StartDragAsync(ExpPointerPoint)	顯示 ContentControl 的內容。也能為非控制系統提供內容呈現。提供一個專門呈現器的基底類別，例如 ScrollContentPresenter。 (繼承來源 UIElement)
StartDragAsync(PointerPoint)	啟動拖放操作。 Important 若使用者以管理員身份以提升模式執行應用程式，則不支援。 (繼承來源 UIElement)
StopAnimation(ICompositionAnimationBase)	停止元素上指定的動畫。 (繼承來源 UIElement)
TransformToVisual(UIElement)	回傳一個轉換物件，可用於將座標從 UIElement 轉換到指定物件。 (繼承來源 UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	嘗試透過搜尋整個 UIElement 視覺樹來呼叫鍵盤捷徑（或加速器）。 (繼承來源 UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback 註冊的變更通知。 (繼承來源 DependencyObject)
UpdateLayout()	確保 UIElement 中所有子物件的位置都正確更新以進行版面配置。 (繼承來源 UIElement)

事件

名稱	Description
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)
GettingFocus	發生在 UIElement 獲得焦點之前。這個事件會同步提高，以確保活動在進行時焦點不會被轉移。 (繼承來源 UIElement)
GotFocus	當 UIElement 獲得焦點時會發生。此事件會非同步啟動，因此焦點能在沸騰完成前再次移動。 (繼承來源 UIElement)
Holding	當本元素的命中測試區域發生原本未處理的 Hold 互動時，會發生這種情況。 (繼承來源 UIElement)
KeyDown	當 UIElement 正在對焦時按下鍵盤鍵時，會發生這種情況。 (繼承來源 UIElement)
KeyUp	當 UIElement 正在對焦時放開鍵盤鍵時會發生。 (繼承來源 UIElement)
LayoutUpdated	當視覺樹的配置改變時，會發生在與佈局相關的屬性改變值或其他會刷新佈局的動作時。 (繼承來源 FrameworkElement)
Loaded	當 FrameworkElement 已被建構並加入物件樹，並準備進行互動時，會發生這種情況。 (繼承來源 FrameworkElement)
Loading	當 FrameworkElement 開始載入時會發生。 (繼承來源 FrameworkElement)
LosingFocus	發生在 UIElement 失去焦點之前。這個事件會同步提高，以確保活動在進行時焦點不會被轉移。 (繼承來源 UIElement)
LostFocus	當 UIElement 失去焦點時會發生。此事件會非同步啟動，因此焦點能在沸騰完成前再次移動。 (繼承來源 UIElement)
ManipulationCompleted	當對 UIElement 進行操作完成時，會發生。 (繼承來源 UIElement)
ManipulationDelta	當輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement)
ManipulationInertiaStarting	當輸入裝置在操作過程中失去與 UIElement 物件的接觸，導致慣性開始時，會發生這種情況。 (繼承來源 UIElement)
ManipulationStarted	當輸入裝置開始對 UIElement 進行操作時，會發生這種情況。 (繼承來源 UIElement)
ManipulationStarting	第一次建立操作處理器時發生。 (繼承來源 UIElement)
NoFocusCandidateFound	當使用者嘗試移動焦點（透過 Tab 鍵或方向箭頭）但焦點無法移動，因為該方向找不到焦點候選時，會發生這種情況。 (繼承來源 UIElement)
PointerCanceled	當一個曾經接觸到的指標異常失去接觸時，就會發生這種情況。 (繼承來源 UIElement)
PointerCaptureLost	當該元素先前持有的指標捕獲移至其他元素或其他位置時，會發生此現象。 (繼承來源 UIElement)
PointerEntered	當指標進入該元素的命中測試區域時發生。 (繼承來源 UIElement)
PointerExited	當指標離開該元素的命中測試區域時，會發生。 (繼承來源 UIElement)
PointerMoved	當指標移動時，指標仍停留在該元素的命中測試區域內。 (繼承來源 UIElement)
PointerPressed	當指標裝置在此元素內啟動按鍵動作時，會發生這種情況。 (繼承來源 UIElement)
PointerReleased	當先前發起新聞行動的指標裝置在此元素內被釋放時，會發生這種情況。請注意，新聞行動結束時不保證觸發 `PointerReleased` 事件;其他事件可能會觸發。更多資訊請參閱備註。 (繼承來源 UIElement)
PointerWheelChanged	當指標輪的 delta 值改變時，會發生這種情況。 (繼承來源 UIElement)
PreviewKeyDown	當 UIElement 正在對焦時按下鍵盤鍵時，會發生這種情況。 (繼承來源 UIElement)
PreviewKeyUp	當 UIElement 正在對焦時放開鍵盤鍵時會發生。 (繼承來源 UIElement)
ProcessKeyboardAccelerators	當按下鍵盤快捷鍵（或加速器）時會發生。 (繼承來源 UIElement)
RightTapped	當指標正好在元素上方時，右鍵輸入刺激發生。 (繼承來源 UIElement)
SizeChanged	當 ActualHeight 或 ActualWidth 屬性在 FrameworkElement 上的值改變時，會發生這種情況。 (繼承來源 FrameworkElement)
Tapped	當未處理的 Tap 互動發生在該元件的命中測試區域時。 (繼承來源 UIElement)
Unloaded	當該物件不再連接到主物件樹時，會發生這種情況。 (繼承來源 FrameworkElement)

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？