TextBlock 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供輕量化控制，以顯示少量流量。
public ref class TextBlock : System::Windows::FrameworkElement, IServiceProvider, System::Windows::IContentHost[System.Windows.Localizability(System.Windows.LocalizationCategory.Text)]
[System.Windows.Markup.ContentProperty("Inlines")]
public class TextBlock : System.Windows.FrameworkElement, IServiceProvider, System.Windows.IContentHost[<System.Windows.Localizability(System.Windows.LocalizationCategory.Text)>]
[<System.Windows.Markup.ContentProperty("Inlines")>]
type TextBlock = class
inherit FrameworkElement
interface IContentHost
interface IAddChild
interface IServiceProvider[<System.Windows.Localizability(System.Windows.LocalizationCategory.Text)>]
[<System.Windows.Markup.ContentProperty("Inlines")>]
type TextBlock = class
inherit FrameworkElement
interface IServiceProvider
interface IContentHost
interface IAddChildPublic Class TextBlock
Inherits FrameworkElement
Implements IContentHost, IServiceProvider- 繼承
- 屬性
- 實作
範例
以下範例展示了如何使用該 TextBlock 元素。
<TextBlock Name="textBlock1" TextWrapping="Wrap">
<Bold>TextBlock</Bold> is designed to be <Italic>lightweight</Italic>,
and is geared specifically at integrating <Italic>small</Italic> portions
of flow content into a UI.
</TextBlock>
<Button Width="100" Margin="10">Click Me</Button>
<TextBlock Name="textBlock2"
TextWrapping="Wrap" Background="AntiqueWhite" TextAlignment="Center"
>
By default, a TextBlock provides no UI beyond simply displaying its contents.
</TextBlock>
<Button Width="100" Margin="10">Click Me</Button>
下圖顯示此範例的轉譯方式。
截
以下範例展示了如何在程式化方式達成類似的結果。
TextBlock textBlock1 = new TextBlock();
TextBlock textBlock2 = new TextBlock();
textBlock1.TextWrapping = textBlock2.TextWrapping = TextWrapping.Wrap;
textBlock2.Background = Brushes.AntiqueWhite;
textBlock2.TextAlignment = TextAlignment.Center;
textBlock1.Inlines.Add(new Bold(new Run("TextBlock")));
textBlock1.Inlines.Add(new Run(" is designed to be "));
textBlock1.Inlines.Add(new Italic(new Run("lightweight")));
textBlock1.Inlines.Add(new Run(", and is geared specifically at integrating "));
textBlock1.Inlines.Add(new Italic(new Run("small")));
textBlock1.Inlines.Add(new Run(" portions of flow content into a UI."));
textBlock2.Text =
"By default, a TextBlock provides no UI beyond simply displaying its contents.";
Dim textBlock1 As New TextBlock()
Dim textBlock2 As New TextBlock()
textBlock2.TextWrapping = TextWrapping.Wrap
textBlock1.TextWrapping = textBlock2.TextWrapping
textBlock2.Background = Brushes.AntiqueWhite
textBlock2.TextAlignment = TextAlignment.Center
textBlock1.Inlines.Add(New Bold(New Run("TextBlock")))
textBlock1.Inlines.Add(New Run(" is designed to be "))
textBlock1.Inlines.Add(New Italic(New Run("lightweight")))
textBlock1.Inlines.Add(New Run(", and is geared specifically at integrating "))
textBlock1.Inlines.Add(New Italic(New Run("small")))
textBlock1.Inlines.Add(New Run(" portions of flow content into a UI."))
textBlock2.Text = "By default, a TextBlock provides no UI beyond simply displaying its contents."
備註
A TextBlock 可以包含其屬性中的Text字串，或Inline包含流內容元素，例如 Bold、 Hyperlink和 InlineUIContainer。Inlines
TextBlock 設計上具有輕量性，專門用於將流程內容的少量整合到使用者介面（UI）中。 TextBlock 針對單行顯示進行優化，並能提供良好效能，最多可顯示數行內容。
TextBlock 未優化於需要顯示超過幾行內容的情境;在這種情況下， FlowDocument 結合適當的觀看控制，在效能上比 更佳 TextBlock。 之後 TextBlock是 FlowDocumentScrollViewer 下一個最輕量級的控制項，用於顯示流程內容，僅提供一個可捲動的內容區域，介面簡潔。 FlowDocumentPageViewer 並以「逐頁」瀏覽方式優化流程內容。 最後， FlowDocumentReader 支援最豐富的集合功能以檢視流程內容，但相應地權重較高。
在 a TextBlock 內水平對齊文字就是用這個 TextAlignment 屬性來完成的。 在頁面版面中對齊 是 TextBlock 透過 HorizontalAlignment 和 VerticalAlignment 屬性來完成。
建構函式
| 名稱 | Description |
|---|---|
| TextBlock() |
初始化 TextBlock 類別的新執行個體。 |
| TextBlock(Inline) |
欄位
| 名稱 | Description |
|---|---|
| BackgroundProperty |
識別 Background 依賴性質。 |
| BaselineOffsetProperty |
識別 BaselineOffset 依賴性質。 |
| FontFamilyProperty |
識別 FontFamily 依賴性質。 |
| FontSizeProperty |
識別 FontSize 依賴性質。 |
| FontStretchProperty |
識別 FontStretch 依賴性質。 |
| FontStyleProperty |
識別 FontStyle 依賴性質。 |
| FontWeightProperty |
識別 FontWeight 依賴性質。 |
| ForegroundProperty |
識別 Foreground 依賴性質。 |
| IsHyphenationEnabledProperty |
識別 IsHyphenationEnabled 依賴性質。 |
| LineHeightProperty |
識別 LineHeight 依賴性質。 |
| LineStackingStrategyProperty |
識別 LineStackingStrategy 依賴性質。 |
| PaddingProperty |
識別 Padding 依賴性質。 |
| TextAlignmentProperty |
識別 TextAlignment 依賴性質。 |
| TextDecorationsProperty |
識別 TextDecorations 依賴性質。 |
| TextEffectsProperty |
識別 TextEffects 依賴性質。 |
| TextProperty |
識別 Text 依賴性質。 |
| TextTrimmingProperty |
識別 TextTrimming 依賴性質。 |
| TextWrappingProperty |
識別 TextWrapping 依賴性質。 |
屬性
| 名稱 | Description |
|---|---|
| ActualHeight |
取得此元素的渲染高度。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得這個元素的渲染寬度。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定一個值，指示該元素是否能作為拖放操作的目標。 這是相依性屬性。 (繼承來源 UIElement) |
| AreAnyTouchesCaptured |
會得到一個值，表示是否至少捕捉到一個觸碰到這個元素。 (繼承來源 UIElement) |
| AreAnyTouchesCapturedWithin |
會獲得一個值，表示是否至少捕捉到一個觸碰到該元素或其視覺樹中的任意子元素。 (繼承來源 UIElement) |
| AreAnyTouchesDirectlyOver |
會得到一個值，表示是否至少有一個觸碰點壓在這個元素上。 (繼承來源 UIElement) |
| AreAnyTouchesOver |
會得到一個值，表示是否至少有一個觸控點壓在這個元素或其視覺樹中的任何子元素上。 (繼承來源 UIElement) |
| Background |
取得或設定 Brush 用來填充內容區域的背景。 |
| BaselineOffset |
取得或設定每行文字與基準線偏移的程度。 |
| BindingGroup |
取得或設定 BindingGroup ，該元素所用的。 (繼承來源 FrameworkElement) |
| BitmapEffect |
已淘汰.
已淘汰.
會取得或設定一個位圖效果，直接套用到該元素的渲染內容。 這是相依性屬性。 (繼承來源 UIElement) |
| BitmapEffectInput |
已淘汰.
已淘汰.
取得或設定一個直接套用到該元素渲染內容的點陣圖效果輸入來源。 這是相依性屬性。 (繼承來源 UIElement) |
| BreakAfter |
會得到 LineBreakCondition 一個指示當前元素後內容應該如何中斷的指標。 |
| BreakBefore |
會得到 LineBreakCondition 一個指示內容應該在當前元素之前如何斷裂的選項。 |
| CacheMode |
取得或設定 的快取表示 UIElement。 (繼承來源 UIElement) |
| Clip |
取得或設定用來定義元素內容輪廓的幾何形狀。 這是相依性屬性。 (繼承來源 UIElement) |
| ClipToBounds |
取得或設定一個值，指示是否要裁剪該元素（或該元素子元素的內容）以符合包含元素的大小。 這是相依性屬性。 (繼承來源 UIElement) |
| CommandBindings |
會得到與此元素相關的物件集合 CommandBinding 。 A CommandBinding 啟用此元素的指令處理，並宣告指令、其事件與該元素所附加的處理器之間的連結。 (繼承來源 UIElement) |
| ContentEnd | |
| ContentStart |
在 內容的開頭TextBlock取得 TextPointer 。 |
| ContextMenu |
取得或設定當透過使用者介面（UI）從該元素中請求右鍵選單時，該元素應會出現。 (繼承來源 FrameworkElement) |
| Cursor |
當滑鼠指標位於此元素上方時，會顯示游標。 (繼承來源 FrameworkElement) |
| DataContext |
當元素參與資料綁定時，取得或設定其資料上下文。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
當主題風格被使用或定義時，取得或設定用於此控制的風格鍵。 (繼承來源 FrameworkElement) |
| DependencyObjectType |
會取得 DependencyObjectType 包裹此實例 CLR 類型的 。 (繼承來源 DependencyObject) |
| DesiredSize |
取得這個項目在版面配置處理序的測量傳遞期間所計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
了解 Dispatcher 這與此 DispatcherObject 有關。 (繼承來源 DispatcherObject) |
| Effect |
取得或設定點陣效應套用到 UIElement。 這是相依性屬性。 (繼承來源 UIElement) |
| FlowDirection |
設定文字及其他使用者介面（UI）元素在控制其版面配置的父元素內的流動方向。 (繼承來源 FrameworkElement) |
| Focusable |
取得或設定一個值，指示該元素是否能接收焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| FocusVisualStyle |
取得或設定一個屬性，允許自訂外觀、效果或其他風格特性，當該元素捕捉鍵盤焦點時會套用。 (繼承來源 FrameworkElement) |
| FontFamily |
取得或設定 的首選頂層字型家族。TextBlock |
| FontSize |
取得或設定 . 的頂層字型大小。TextBlock |
| FontStretch |
取得或設定 TextBlock. |
| FontStyle |
取得或設定 的頂層字型樣式。TextBlock |
| FontWeight |
取得或設定 TextBlock. |
| ForceCursor |
取得或設定一個值，指示是否 FrameworkElement 應該強制使用者介面（UI）依照屬性宣告 Cursor 的方式渲染游標。 (繼承來源 FrameworkElement) |
| Foreground | |
| HasAnimatedProperties |
會得到一個值，表示該元素是否有任何動畫屬性。 (繼承來源 UIElement) |
| HasEffectiveKeyboardFocus |
會得到一個表示你 UIElement 是否有焦點的值。 (繼承來源 UIElement) |
| Height |
取得或設定元素的建議高度。 (繼承來源 FrameworkElement) |
| HorizontalAlignment |
當該元素被組合在父元素（如面板或項目控制項）中時，取得或設定該元素所套用的水平對齊特性。 (繼承來源 FrameworkElement) |
| HostedElementsCore |
會有一個枚舉器，可以用來迭代由這個 TextBlock。 |
| InheritanceBehavior |
取得或設定財產價值繼承、資源金鑰查詢及 RelativeSource FindAncestor 查詢的範圍限制。 (繼承來源 FrameworkElement) |
| Inlines |
得到包含InlineCollection構成 TextBlock內容的頂層Inline元素的 。 |
| InputBindings |
取得與此元素相關的輸入綁定集合。 (繼承來源 UIElement) |
| InputScope |
取得或設定此輸入的 FrameworkElement上下文。 (繼承來源 FrameworkElement) |
| IsArrangeValid |
會獲得一個值，表示該元素配置中子元素的計算大小與位置是否有效。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定一個值，指示該元素是否在使用者介面（UI）中啟用。 這是相依性屬性。 (繼承來源 UIElement) |
| IsEnabledCore |
得到一個值，該值在衍生類別中成為的 IsEnabled 回傳值。 (繼承來源 UIElement) |
| IsFocused |
獲得一個決定該元素是否具有邏輯焦點的值。 這是相依性屬性。 (繼承來源 UIElement) |
| IsHitTestVisible |
取得或設定一個值，宣告該元素是否可能從其渲染內容的某部分回傳為命中測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| IsHyphenationEnabled |
取得或設定一個值，指示字詞的自動連字是否啟用或停用。 |
| IsInitialized |
會獲得一個值，表示該元素是否已被初始化，無論是在 XAML 處理器處理過程中，或是明確呼叫其 EndInit() 方法時。 (繼承來源 FrameworkElement) |
| IsInputMethodEnabled |
會取得一個值，表示輸入法系統（如輸入法編輯器（IME））是否啟用以處理該元素的輸入。 (繼承來源 UIElement) |
| IsKeyboardFocused |
會獲得一個值，表示該元素是否具有鍵盤焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| IsKeyboardFocusWithin |
會取得一個值，表示鍵盤焦點是否位於元素或其視覺樹子元素中的任何位置。 這是相依性屬性。 (繼承來源 UIElement) |
| IsLoaded |
會得到一個值，表示該元素是否已被載入以進行呈現。 (繼承來源 FrameworkElement) |
| IsManipulationEnabled |
取得或設定一個值，指示操作事件是否在此啟用 UIElement。 (繼承來源 UIElement) |
| IsMeasureValid |
會得到一個值，表示目前版面測量回傳的大小是否有效。 (繼承來源 UIElement) |
| IsMouseCaptured |
會得到一個值，表示滑鼠是否被捕捉到這個元素。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseCaptureWithin |
會獲得一個值，決定滑鼠捕捉是由這個元素還是其視覺樹中的子元素所持有。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseDirectlyOver |
會得到一個值，表示滑鼠指標的位置是否對應於包含元素合成的命中測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseOver |
會取得一個值，表示滑鼠指標是否位於此元素上方（包括視覺樹中的子元素）。 這是相依性屬性。 (繼承來源 UIElement) |
| IsSealed |
會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject) |
| IsStylusCaptured |
會獲得一個值，表示觸控筆是否被此元素捕捉。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusCaptureWithin |
會得到一個值，決定觸控筆擷取是由此元素持有，還是元素界限及其視覺樹內的元素。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusDirectlyOver |
會得到一個值，表示觸控筆位置是否對應於包含元素合成的命中測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusOver |
會獲得一個值，表示觸控筆游標是否位於此元素（包括視覺子元素）上方。 這是相依性屬性。 (繼承來源 UIElement) |
| IsVisible |
會取得一個值，表示該元素是否在使用者介面（UI）中可見。 這是相依性屬性。 (繼承來源 UIElement) |
| Language |
取得或設定適用於元素的在地化/全球化語言資訊。 (繼承來源 FrameworkElement) |
| LayoutTransform |
取得或設定一個圖形轉換，當執行版面配置時，該轉換應該套用到這個元素。 (繼承來源 FrameworkElement) |
| LineHeight |
取得或設定每行內容的高度。 |
| LineStackingStrategy |
取得或設定為每行文字決定 TextBlock行框的機制。 |
| LogicalChildren |
會得到一個能夠迭代 的 TextBlock邏輯子節點的列舉子。 |
| Margin |
取得或設定元素的外緣。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定元素的最大高度限制。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定元素的最大寬度限制。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定元素的最小高度限制。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定元素的最小寬度限制。 (繼承來源 FrameworkElement) |
| Name |
取得或設定元素的識別名稱。 這個名稱提供了一個參考，讓程式碼後方（code-hind，例如事件處理程式程式碼）能在 XAML 處理器在處理過程中建構標記元素後，參考該元素。 (繼承來源 FrameworkElement) |
| Opacity |
在使用者介面（UI）渲染時，取得或設定對整體 UIElement 套用的不透明度因子。 這是相依性屬性。 (繼承來源 UIElement) |
| OpacityMask |
取得或設定不透明度遮罩，作為 Brush 一套實作，適用於該元素渲染內容的任意 alpha 通道遮罩。 這是相依性屬性。 (繼承來源 UIElement) |
| OverridesDefaultStyle |
取得或設定一個值，指示此元素是否包含主題樣式的樣式屬性。 (繼承來源 FrameworkElement) |
| Padding |
取得或設定一個值，表示內容區域邊界與內容之間 TextBlock填充空間的厚度，而 則顯示的內容。 |
| Parent |
取得該元素的邏輯父元素。 (繼承來源 FrameworkElement) |
| PersistId |
已淘汰.
會得到一個唯一識別此元素的值。 (繼承來源 UIElement) |
| RenderSize |
取得（或設定）這個元素的最終渲染大小。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定影響此元素渲染位置的轉換資訊。 這是相依性屬性。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定任何可能渲染轉換的中心點，該轉換由 宣 RenderTransform告 ，相對於元素的邊界。 這是相依性屬性。 (繼承來源 UIElement) |
| Resources |
取得或設定本地定義的資源字典。 (繼承來源 FrameworkElement) |
| SnapsToDevicePixels |
會取得或設定一個值，決定該元素在渲染時是否應該使用裝置特定的像素設定。 這是相依性屬性。 (繼承來源 UIElement) |
| Style |
在渲染時，取得或設定該元素所使用的樣式。 (繼承來源 FrameworkElement) |
| StylusPlugIns |
會取得與此元素相關的所有觸控筆外掛（自訂）物件集合。 (繼承來源 UIElement) |
| Tag |
取得或設定一個任意物件值，可用來儲存該元素的自訂資訊。 (繼承來源 FrameworkElement) |
| TemplatedParent |
會取得該元素範本父碼的參考。 若元素非透過範本建立，此屬性不適用。 (繼承來源 FrameworkElement) |
| Text |
取得或設定 的文字內容 TextBlock。 |
| TextAlignment |
取得或設定一個值，表示文字內容的水平對齊。 |
| TextDecorations |
取得或設定 a TextDecorationCollection ，包含可應用於 文本 TextBlock的效果。 |
| TextEffects |
取得或設定效果套用到這個元素的文字內容。 |
| TextTrimming |
當內容溢出時，會執行或設定文字修剪行為。 |
| TextWrapping |
能設定文字應該如何 TextBlock 包裝。 |
| ToolTip |
取得或設定該元素在使用者介面（UI）中顯示的工具提示物件。 (繼承來源 FrameworkElement) |
| TouchesCaptured |
將所有被捕捉的觸控裝置都傳送到這個元素。 (繼承來源 UIElement) |
| TouchesCapturedWithin |
會將所有被捕捉的觸控裝置轉移到此元素或其視覺樹中的任何子元素。 (繼承來源 UIElement) |
| TouchesDirectlyOver |
所有觸控裝置都安裝在這個元件上。 (繼承來源 UIElement) |
| TouchesOver |
取得所有位於此元素或其視覺樹中子元素上的觸控裝置。 (繼承來源 UIElement) |
| Triggers |
取得直接在此元素或子元素中建立的觸發器集合。 (繼承來源 FrameworkElement) |
| Typography |
取得目前有效排版變化的本元素內容。 |
| Uid |
取得或設定此元素的唯一識別碼（用於本地化）。 這是相依性屬性。 (繼承來源 UIElement) |
| UseLayoutRounding |
取得或設定一個值，指示是否應對該元素在佈局中對其大小與位置進行四捨五入。 (繼承來源 FrameworkElement) |
| VerticalAlignment |
當該元素組合於父元素（如面板或項目控制項）時，取得或設定該元素所套用的垂直對齊特性。 (繼承來源 FrameworkElement) |
| Visibility |
取得或設定此元素的使用者介面（UI）可見性。 這是相依性屬性。 (繼承來源 UIElement) |
| VisualBitmapEffect |
已淘汰.
已淘汰.
取得或設定 BitmapEffect 的值。Visual (繼承來源 Visual) |
| VisualBitmapEffectInput |
已淘汰.
已淘汰.
取得或設定 BitmapEffectInput 的值。Visual (繼承來源 Visual) |
| VisualBitmapScalingMode |
取得或設定 BitmapScalingMode 。Visual (繼承來源 Visual) |
| VisualCacheMode |
取得或設定 的快取表示 Visual。 (繼承來源 Visual) |
| VisualChildrenCount | |
| VisualClearTypeHint |
取得或設定 ，ClearTypeHint決定 ClearType 在 中如何被渲染。Visual (繼承來源 Visual) |
| VisualClip |
會取得或設定 的 Visual 剪輯區域作為 Geometry 一個值。 (繼承來源 Visual) |
| VisualEdgeMode |
取得或設定 的 Visual 邊模態作為 EdgeMode 一個值。 (繼承來源 Visual) |
| VisualEffect |
取得或設定點陣效應套用到 Visual。 (繼承來源 Visual) |
| VisualOffset |
取得或設定視覺物件的偏移值。 (繼承來源 Visual) |
| VisualOpacity |
取得或設定 的不透明度 Visual。 (繼承來源 Visual) |
| VisualOpacityMask |
取得或設定 Brush 代表不 Visual透明度遮罩的值。 (繼承來源 Visual) |
| VisualParent |
取得視覺物件的視覺樹父。 (繼承來源 Visual) |
| VisualScrollableAreaClip |
為 取得或設定一個可切換的可捲動區域。Visual (繼承來源 Visual) |
| VisualTextHintingMode |
取得或設定 TextHintingMode 的 Visual。 (繼承來源 Visual) |
| VisualTextRenderingMode |
取得或設定 TextRenderingMode 的 Visual。 (繼承來源 Visual) |
| VisualTransform | (繼承來源 Visual) |
| VisualXSnappingGuidelines |
取得或設定 x 座標（垂直）指引集合。 (繼承來源 Visual) |
| VisualYSnappingGuidelines |
取得或設定 y 座標（水平）指引集合。 (繼承來源 Visual) |
| Width |
取得或設定元素的寬度。 (繼承來源 FrameworkElement) |
方法
事件
| 名稱 | Description |
|---|---|
| ContextMenuClosing |
發生在元素上任何上下文選單關閉之前。 (繼承來源 FrameworkElement) |
| ContextMenuOpening |
當打開元素上的任何右鍵選單時都會發生。 (繼承來源 FrameworkElement) |
| DataContextChanged |
當該元素的資料上下文改變時會發生。 (繼承來源 FrameworkElement) |
| DragEnter |
當輸入系統回報一個底層拖曳事件，並將此元素作為拖曳目標時發生。 (繼承來源 UIElement) |
| DragLeave |
當輸入系統回報一個底層拖曳事件，並將此元素作為拖原點時發生。 (繼承來源 UIElement) |
| DragOver |
當輸入系統回報一個底層拖曳事件，該元素為潛在的投放目標時發生。 (繼承來源 UIElement) |
| Drop |
當輸入系統回報一個底層丟棄事件，並將此元素作為丟棄目標時發生。 (繼承來源 UIElement) |
| FocusableChanged |
發生於 Focusable 屬性的值變更時。 (繼承來源 UIElement) |
| GiveFeedback |
當輸入系統回報涉及此元素的底層拖放事件時，會發生這種情況。 (繼承來源 UIElement) |
| GotFocus |
當這個元素獲得邏輯焦點時就會發生。 (繼承來源 UIElement) |
| GotKeyboardFocus |
當鍵盤聚焦於此元素時會發生。 (繼承來源 UIElement) |
| GotMouseCapture |
當這個元素捕捉滑鼠時會發生。 (繼承來源 UIElement) |
| GotStylusCapture |
當這個元素捕捉觸控筆時會發生。 (繼承來源 UIElement) |
| GotTouchCapture |
當觸碰到這個元素時會發生。 (繼承來源 UIElement) |
| Initialized |
當初始化時 FrameworkElement 會發生。 此事件與財產價值 IsInitialized 從 |
| IsEnabledChanged |
當該元素屬性的值 IsEnabled 改變時，會發生這種情況。 (繼承來源 UIElement) |
| IsHitTestVisibleChanged |
當依賴性質對該元素的值 IsHitTestVisible 改變時，會發生這種情況。 (繼承來源 UIElement) |
| IsKeyboardFocusedChanged |
當該屬性在此元素上的價值 IsKeyboardFocused 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsKeyboardFocusWithinChanged |
當該屬性在此元素上的價值 IsKeyboardFocusWithin 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsMouseCapturedChanged |
當該屬性在此元素上的價值 IsMouseCaptured 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsMouseCaptureWithinChanged |
當該元素的值 IsMouseCaptureWithinProperty 改變時，會發生這種情況。 (繼承來源 UIElement) |
| IsMouseDirectlyOverChanged |
當該屬性在此元素上的價值 IsMouseDirectlyOver 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsStylusCapturedChanged |
當該屬性在此元素上的價值 IsStylusCaptured 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsStylusCaptureWithinChanged |
當該屬性在此元素上的價值 IsStylusCaptureWithin 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsStylusDirectlyOverChanged |
當該屬性在此元素上的價值 IsStylusDirectlyOver 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| IsVisibleChanged |
當該屬性在此元素上的價值 IsVisible 改變時，就會發生這種情況。 (繼承來源 UIElement) |
| KeyDown |
當按鍵時，當焦點放在該元素時會發生。 (繼承來源 UIElement) |
| KeyUp |
當鑰匙釋放時，焦點放在該元素時會發生。 (繼承來源 UIElement) |
| LayoutUpdated |
當與當前 Dispatcher 相關的各種視覺元素的佈局改變時，會發生這種情況。 (繼承來源 UIElement) |
| Loaded |
當元素已擺放、渲染並準備互動時，會發生這種情況。 (繼承來源 FrameworkElement) |
| LostFocus |
當這個元素失去邏輯焦點時就會發生。 (繼承來源 UIElement) |
| LostKeyboardFocus |
當鍵盤不再專注於該元素時，會發生這種情況。 (繼承來源 UIElement) |
| LostMouseCapture |
當該元素失去滑鼠捕捉時會發生。 (繼承來源 UIElement) |
| LostStylusCapture |
當該元素失去觸控筆捕捉時會發生。 (繼承來源 UIElement) |
| LostTouchCapture |
當此元素失去觸碰捕捉時發生。 (繼承來源 UIElement) |
| ManipulationBoundaryFeedback |
當操控遇到邊界時，就會發生。 (繼承來源 UIElement) |
| ManipulationCompleted |
當對物體完成操作與慣性 UIElement 時，會發生這種情況。 (繼承來源 UIElement) |
| ManipulationDelta |
當輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
| ManipulationInertiaStarting |
當輸入裝置在操作過程中失去與物體 UIElement 接觸，慣性開始時，就會發生這種情況。 (繼承來源 UIElement) |
| ManipulationStarted |
當輸入裝置開始對 UIElement 物件進行操作時，會發生這種情況。 (繼承來源 UIElement) |
| ManipulationStarting |
第一次建立操作處理器時發生。 (繼承來源 UIElement) |
| MouseDown |
當任何滑鼠按鍵且指標位於此元素上時，會發生這種情況。 (繼承來源 UIElement) |
| MouseEnter |
當滑鼠指標進入該元素的範圍時，會發生這種情況。 (繼承來源 UIElement) |
| MouseLeave |
當滑鼠指標離開該元素的邊界時，會發生這種情況。 (繼承來源 UIElement) |
| MouseLeftButtonDown |
當滑鼠左鍵按下時，滑鼠指標正好位於此元素上方。 (繼承來源 UIElement) |
| MouseLeftButtonUp |
當滑鼠左鍵放開時，滑鼠指標正放在該元素上方。 (繼承來源 UIElement) |
| MouseMove |
當滑鼠指標移動到該元素時會發生。 (繼承來源 UIElement) |
| MouseRightButtonDown |
當滑鼠右鍵按下時，滑鼠指標正放在此元素上時會發生。 (繼承來源 UIElement) |
| MouseRightButtonUp |
當滑鼠右鍵放開時，滑鼠指標正放在該元素上方，會發生這種情況。 (繼承來源 UIElement) |
| MouseUp |
當任何滑鼠按鍵放到該元素上時，會發生這種情況。 (繼承來源 UIElement) |
| MouseWheel |
當使用者旋轉滑鼠滾輪，而滑鼠指標位於此元素上時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewDragEnter |
當輸入系統回報一個底層拖曳事件，並將此元素作為拖曳目標時發生。 (繼承來源 UIElement) |
| PreviewDragLeave |
當輸入系統回報一個底層拖曳事件，並將此元素作為拖原點時發生。 (繼承來源 UIElement) |
| PreviewDragOver |
當輸入系統回報一個底層拖曳事件，該元素為潛在的投放目標時發生。 (繼承來源 UIElement) |
| PreviewDrop |
當輸入系統回報一個底層丟棄事件，並將此元素作為丟棄目標時發生。 (繼承來源 UIElement) |
| PreviewGiveFeedback |
當拖放操作啟動時會發生。 (繼承來源 UIElement) |
| PreviewGotKeyboardFocus |
當鍵盤聚焦於此元素時會發生。 (繼承來源 UIElement) |
| PreviewKeyDown |
當按鍵時，當焦點放在該元素時會發生。 (繼承來源 UIElement) |
| PreviewKeyUp |
當鑰匙釋放時，焦點放在該元素時會發生。 (繼承來源 UIElement) |
| PreviewLostKeyboardFocus |
當鍵盤不再專注於該元素時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewMouseDown |
當任何滑鼠按鍵且指標位於此元素上時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewMouseLeftButtonDown |
當滑鼠左鍵按下時，滑鼠指標正好位於此元素上方。 (繼承來源 UIElement) |
| PreviewMouseLeftButtonUp |
當滑鼠左鍵放開時，滑鼠指標正放在該元素上方。 (繼承來源 UIElement) |
| PreviewMouseMove |
當滑鼠指標移動時，當滑鼠指標位於該元素上方時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewMouseRightButtonDown |
當滑鼠右鍵按下時，滑鼠指標正放在此元素上時會發生。 (繼承來源 UIElement) |
| PreviewMouseRightButtonUp |
當滑鼠右鍵放開時，滑鼠指標正放在該元素上方，會發生這種情況。 (繼承來源 UIElement) |
| PreviewMouseUp |
當滑鼠指標位於該元素上方時，放開任何滑鼠按鈕時會發生。 (繼承來源 UIElement) |
| PreviewMouseWheel |
當使用者旋轉滑鼠滾輪，而滑鼠指標位於此元素上時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewQueryContinueDrag |
當拖放操作時鍵盤或滑鼠按鈕狀態發生變化。 (繼承來源 UIElement) |
| PreviewStylusButtonDown |
當觸控筆按鈕在指標正覆蓋此元素時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewStylusButtonUp |
當觸控筆按鈕放開時，指標正放在該元素上方，會發生這種情況。 (繼承來源 UIElement) |
| PreviewStylusDown |
當觸控筆觸碰數位化器時，觸控筆正覆蓋在此元件上方，就會發生這種情況。 (繼承來源 UIElement) |
| PreviewStylusInAirMove |
當觸控筆在未觸碰數位化器的情況下移動元素時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewStylusInRange |
當觸控筆靠近觸控板，且位於該元件上方時，會發生此現象。 (繼承來源 UIElement) |
| PreviewStylusMove |
當觸控筆在元素上方移動時會發生。 觸控筆必須在數位化器偵測到時移動才能提升此事件，否則會 PreviewStylusInAirMove 被提升。 (繼承來源 UIElement) |
| PreviewStylusOutOfRange |
當觸控筆離數位化器太遠無法被偵測時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewStylusSystemGesture |
當使用者執行多種觸控筆手勢之一時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewStylusUp |
當使用者將觸控筆從數位化器上方抬起時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewTextInput |
當這個元素以與裝置無關的方式接收文字時，就會發生。 (繼承來源 UIElement) |
| PreviewTouchDown |
當手指觸碰螢幕時，手指正覆蓋著這個元素。 (繼承來源 UIElement) |
| PreviewTouchMove |
當手指在螢幕上移動時，手指正覆蓋著該元素。 (繼承來源 UIElement) |
| PreviewTouchUp |
當手指在螢幕上方時，手指被抬離螢幕，就會發生。 (繼承來源 UIElement) |
| QueryContinueDrag |
當拖放操作時鍵盤或滑鼠按鈕狀態發生變化。 (繼承來源 UIElement) |
| QueryCursor |
當游標被請求顯示時會發生。 每當滑鼠指標移動到新位置時，這個事件會在元素上觸發，這意味著游標物件可能需要根據新位置進行調整。 (繼承來源 UIElement) |
| RequestBringIntoView |
當 對此元素被調用時 BringIntoView(Rect) ，會發生。 (繼承來源 FrameworkElement) |
| SizeChanged |
當ActualHeightActualWidth該元素的屬性值改變時，會發生這種情況。 (繼承來源 FrameworkElement) |
| SourceUpdated |
當該元素綁定任何現有屬性的來源值改變時，會發生這種情況。 (繼承來源 FrameworkElement) |
| StylusButtonDown |
當觸控筆按鈕在指標正覆蓋此元素時，會發生這種情況。 (繼承來源 UIElement) |
| StylusButtonUp |
當觸控筆按鈕放開時，指標正放在該元素上方，會發生這種情況。 (繼承來源 UIElement) |
| StylusDown |
當觸控筆觸碰數位化器時，觸控筆正覆蓋此元件。 (繼承來源 UIElement) |
| StylusEnter |
當唱針進入該元素的範圍時，會發生這種情況。 (繼承來源 UIElement) |
| StylusInAirMove |
當觸控筆在未觸碰數位化器的情況下移動元素時，會發生這種情況。 (繼承來源 UIElement) |
| StylusInRange |
當觸控筆靠近觸控板，且位於該元件上方時，會發生此現象。 (繼承來源 UIElement) |
| StylusLeave |
當唱針離開元素範圍時發生。 (繼承來源 UIElement) |
| StylusMove |
當觸控筆移動到這個元素上時會發生。 觸控筆必須在數位化器上移動以提升此事件。 否則， StylusInAirMove 則是升高。 (繼承來源 UIElement) |
| StylusOutOfRange |
當觸控筆距離數位化器太遠無法偵測時，會發生在該元件上方。 (繼承來源 UIElement) |
| StylusSystemGesture |
當使用者執行多種觸控筆手勢之一時，會發生這種情況。 (繼承來源 UIElement) |
| StylusUp |
當使用者將觸控筆從觸控板上方抬起時，會發生在觸控板上方。 (繼承來源 UIElement) |
| TargetUpdated |
當該元素綁定任何屬性的目標值改變時，會發生這種情況。 (繼承來源 FrameworkElement) |
| TextInput |
當這個元素以與裝置無關的方式接收文字時，就會發生。 (繼承來源 UIElement) |
| ToolTipClosing |
發生在元件上任何提示關閉前。 (繼承來源 FrameworkElement) |
| ToolTipOpening |
當打開元素的任何提示時，都會發生。 (繼承來源 FrameworkElement) |
| TouchDown |
當手指觸碰螢幕時，手指正覆蓋著這個元素。 (繼承來源 UIElement) |
| TouchEnter |
當觸碰從該元素範圍外移動到該元素範圍內時，就會發生。 (繼承來源 UIElement) |
| TouchLeave |
當觸碰從該元素的範圍內移動到外部時，就會發生這種情況。 (繼承來源 UIElement) |
| TouchMove |
當手指在螢幕上移動時，手指正覆蓋著該元素。 (繼承來源 UIElement) |
| TouchUp |
當手指在螢幕上方時，手指被抬離螢幕，就會發生。 (繼承來源 UIElement) |
| Unloaded |
當元素從載入元素樹中移除時，會發生這種情況。 (繼承來源 FrameworkElement) |
明確介面實作
| 名稱 | Description |
|---|---|
| IAddChild.AddChild(Object) |
此成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 |
| IAddChild.AddText(String) |
此成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 |
| IContentHost.GetRectangles(ContentElement) |
此方法支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 建議改用型別安全 GetRectanglesCore(ContentElement) 方法。 |
| IContentHost.HostedElements |
此類型或成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 建議改用型別安全 HostedElementsCore 屬性。 |
| IContentHost.InputHitTest(Point) |
此方法支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 建議改用型別安全 InputHitTestCore(Point) 方法。 |
| IContentHost.OnChildDesiredSizeChanged(UIElement) |
此方法支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 建議改用型別安全 OnChildDesiredSizeChangedCore(UIElement) 方法。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
關於此成員的描述，請參見方法。IsAmbientPropertyAvailable(String) (繼承來源 FrameworkElement) |
| IServiceProvider.GetService(Type) |
此方法支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 |
