TextBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表一個可用來顯示或編輯未格式文字的控制項。
public ref class TextBox : System::Windows::Controls::Primitives::TextBoxBase, System::Windows::Markup::IAddChild[System.Windows.Localizability(System.Windows.LocalizationCategory.Text)]
[System.Windows.Markup.ContentProperty("Text")]
public class TextBox : System.Windows.Controls.Primitives.TextBoxBase, System.Windows.Markup.IAddChild[<System.Windows.Localizability(System.Windows.LocalizationCategory.Text)>]
[<System.Windows.Markup.ContentProperty("Text")>]
type TextBox = class
inherit TextBoxBase
interface IAddChildPublic Class TextBox
Inherits TextBoxBase
Implements IAddChild- 繼承
- 衍生
- 屬性
- 實作
範例
這個範例展示了如何使用 Text 屬性來設定 TextBox 控制項的初始文字內容。
備註
雖然範例的可擴充應用程式標記語言（XAML）版本可以在每個按鈕的 TextBox 內容文字周圍使用 <TextBox.Text> 標籤，但這並非必要，因為 TextBox 會將 ContentPropertyAttribute 屬性套用到文字屬性上。
<TextBox Name="tbSettingText">
Initial text contents of the TextBox.
</TextBox>
tbSettingText.Text = "Initial text contents of the TextBox.";
tbSettingText.Text = "Initial text contents of the TextBox."
備註
TextBox控制項的屬性中只能包含未格式化的文字Text。 以下圖表展示了一個範例 TextBox。
文字框範例
TextBox 是一種由多個封裝元件組成的複合控制系統。 因此，有些事件不會冒泡到包含控制項，因為它們是由封裝的子元素處理。 因此，應用程式開發者應聆聽事件的隧道版本（以前綴「Preview」表示）。
TextBox 僅支援未格式文字。 如需支援更豐富內容的應用，請參見 RichTextBox。 如需接受密碼或其他敏感輸入的應用程式，請參見 PasswordBox。
在 a TextBox 內進行橫向和縱向對齊文字，是用 HorizontalContentAlignment 和 VerticalContentAlignment 屬性來完成的。 在頁面版面中對齊 是 TextBox 透過 HorizontalAlignment 和 VerticalAlignment 屬性來完成。
隱藏 a TextBox 周圍邊界的最佳方法是將 的屬性TextBox設BorderThickness為 0。
這很重要
TextBox 內建氣泡 MouseUp 和 MouseDown 事件操控。 因此，監聽MouseUpMouseDown或從 事件TextBox中接收的自訂事件處理程式將不會被呼叫。 如果你需要回應這些事件，請聆聽隧道和PreviewMouseUpPreviewMouseDown事件，或用參數註冊處理器HandledEventsToo（後者只能透過程式碼使用）。 除非你刻意關閉 TextBox 這些事件的原生處理，否則不要標記事件已處理，且這會對控制項的介面產生顯著影響。
預設情況下，捲軸條是看不到 TextBox 的。 要讓滾動條可見，請將 and HorizontalScrollBarVisibility 屬性設VerticalScrollBarVisibility為 Visible 或 Auto。
通常應使用 TextChanged 事件來偵測 TextBox 或 RichTextBox 中的文字變化，而非如你預期的使用 KeyDown。 請參考 「如何偵測文字框中的文字何時變更 」作為範例。
自訂文字框控制
要將相同的屬性設定套用到多個TextBox控制項，請使用Style屬性。 你可以修改預設的 ControlTemplate，讓控制項呈現獨特的外觀。 欲了解更多關於建立 ControlTemplate控制範本的資訊，請參閱 「如何建立控制範本」。 欲了解特定於 TextBox的部分與狀態，請參閱 TextBox 樣式與範本。
此控制項的相依屬性可能由控制項的預設樣式設定。 如果屬性是由預設樣式設定，當控制項出現在應用程式中時，該屬性可能會從預設值改變。 預設樣式由應用程式執行時使用的桌面主題決定。
備註
設定視覺屬性只有在該屬性同時存在於控制項的預設範本中，且透過 TemplateBinding 設定時才會有影響。
建構函式
| 名稱 | Description |
|---|---|
| TextBox() |
初始化 TextBox 類別的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| CharacterCasingProperty |
識別 CharacterCasing 依賴性質。 |
| MaxLengthProperty |
識別 MaxLength 依賴性質。 |
| MaxLinesProperty |
識別 MaxLines 依賴性質。 |
| MinLinesProperty |
識別 MinLines 依賴性質。 |
| TextAlignmentProperty |
識別 TextAlignment 依賴性質。 |
| TextDecorationsProperty |
識別 TextDecorations 依賴性質。 |
| TextProperty |
識別 Text 依賴性質。 |
| TextWrappingProperty |
識別 TextWrapping 依賴性質。 |
屬性
| 名稱 | Description |
|---|---|
| AcceptsReturn |
會取得或設定一個值，指示使用者按下 ENTER 鍵時文字編輯控制項的反應。 (繼承來源 TextBoxBase) |
| AcceptsTab |
會取得或設定一個值，指示使用者按下 TAB 鍵時文字編輯控制鍵的反應。 (繼承來源 TextBoxBase) |
| ActualHeight |
取得此元素的渲染高度。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得這個元素的渲染寬度。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定一個值，指示該元素是否能作為拖放操作的目標。 這是相依性屬性。 (繼承來源 UIElement) |
| AreAnyTouchesCaptured |
會得到一個值，表示是否至少捕捉到一個觸碰到這個元素。 (繼承來源 UIElement) |
| AreAnyTouchesCapturedWithin |
會獲得一個值，表示是否至少捕捉到一個觸碰到該元素或其視覺樹中的任意子元素。 (繼承來源 UIElement) |
| AreAnyTouchesDirectlyOver |
會得到一個值，表示是否至少有一個觸碰點壓在這個元素上。 (繼承來源 UIElement) |
| AreAnyTouchesOver |
會得到一個值，表示是否至少有一個觸控點壓在這個元素或其視覺樹中的任何子元素上。 (繼承來源 UIElement) |
| AutoWordSelection |
會取得或設定一個值，決定當使用者用滑鼠拖曳選取單字部分時，是否會選取該單字的其餘部分。 (繼承來源 TextBoxBase) |
| Background |
取得或設定一個筆刷，描述控制組的背景。 (繼承來源 Control) |
| BindingGroup |
取得或設定 BindingGroup ，該元素所用的。 (繼承來源 FrameworkElement) |
| BitmapEffect |
已淘汰.
已淘汰.
會取得或設定一個位圖效果，直接套用到該元素的渲染內容。 這是相依性屬性。 (繼承來源 UIElement) |
| BitmapEffectInput |
已淘汰.
已淘汰.
取得或設定一個直接套用到該元素渲染內容的點陣圖效果輸入來源。 這是相依性屬性。 (繼承來源 UIElement) |
| BorderBrush |
取得或設定一個筆刷，描述控制組的邊界背景。 (繼承來源 Control) |
| BorderThickness |
取得或設定控制區的邊框厚度。 (繼承來源 Control) |
| CacheMode |
取得或設定 的快取表示 UIElement。 (繼承來源 UIElement) |
| CanRedo |
會有一個值，表示最近一次復原動作是否可以重新執行。 (繼承來源 TextBoxBase) |
| CanUndo |
會得到一個值，表示最近一次行動是否可以被撤銷。 (繼承來源 TextBoxBase) |
| CaretBrush |
取得或設定用來繪製文字框中綴的畫筆。 (繼承來源 TextBoxBase) |
| CaretIndex |
取得或設定滑槽的插入位置指數。 |
| CharacterCasing |
它能設定字元在手動輸入文字框時的大小寫方式。 |
| Clip |
取得或設定用來定義元素內容輪廓的幾何形狀。 這是相依性屬性。 (繼承來源 UIElement) |
| ClipToBounds |
取得或設定一個值，指示是否要裁剪該元素（或該元素子元素的內容）以符合包含元素的大小。 這是相依性屬性。 (繼承來源 UIElement) |
| CommandBindings |
會得到與此元素相關的物件集合 CommandBinding 。 A CommandBinding 啟用此元素的指令處理，並宣告指令、其事件與該元素所附加的處理器之間的連結。 (繼承來源 UIElement) |
| ContextMenu |
取得或設定當透過使用者介面（UI）從該元素中請求右鍵選單時，該元素應會出現。 (繼承來源 FrameworkElement) |
| Cursor |
當滑鼠指標位於此元素上方時，會顯示游標。 (繼承來源 FrameworkElement) |
| DataContext |
當元素參與資料綁定時，取得或設定其資料上下文。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
當主題風格被使用或定義時，取得或設定用於此控制的風格鍵。 (繼承來源 FrameworkElement) |
| DependencyObjectType |
會取得 DependencyObjectType 包裹此實例 CLR 類型的 。 (繼承來源 DependencyObject) |
| DesiredSize |
取得這個項目在版面配置處理序的測量傳遞期間所計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
了解 Dispatcher 這與此 DispatcherObject 有關。 (繼承來源 DispatcherObject) |
| Effect |
取得或設定點陣效應套用到 UIElement。 這是相依性屬性。 (繼承來源 UIElement) |
| ExtentHeight |
取得可見內容區的垂直大小。 (繼承來源 TextBoxBase) |
| ExtentWidth |
取得可見內容區域的水平大小。 (繼承來源 TextBoxBase) |
| FlowDirection |
設定文字及其他使用者介面（UI）元素在控制其版面配置的父元素內的流動方向。 (繼承來源 FrameworkElement) |
| Focusable |
取得或設定一個值，指示該元素是否能接收焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| FocusVisualStyle |
取得或設定一個屬性，允許自訂外觀、效果或其他風格特性，當該元素捕捉鍵盤焦點時會套用。 (繼承來源 FrameworkElement) |
| FontFamily |
取得或設定控制項的字型家族。 (繼承來源 Control) |
| FontSize |
它負責取得或設定字型大小。 (繼承來源 Control) |
| FontStretch |
決定字體在螢幕上的濃縮或擴展程度。 (繼承來源 Control) |
| FontStyle |
取得或設定字型樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細或粗細。 (繼承來源 Control) |
| ForceCursor |
取得或設定一個值，指示是否 FrameworkElement 應該強制使用者介面（UI）依照屬性宣告 Cursor 的方式渲染游標。 (繼承來源 FrameworkElement) |
| Foreground |
取得或設定一筆筆來描述前景色。 (繼承來源 Control) |
| HandlesScrolling |
會得到一個值，表示某個控制項是否支援捲動。 (繼承來源 Control) |
| HasAnimatedProperties |
會得到一個值，表示該元素是否有任何動畫屬性。 (繼承來源 UIElement) |
| HasEffectiveKeyboardFocus |
會得到一個表示你 UIElement 是否有焦點的值。 (繼承來源 UIElement) |
| Height |
取得或設定元素的建議高度。 (繼承來源 FrameworkElement) |
| HorizontalAlignment |
當該元素被組合在父元素（如面板或項目控制項）中時，取得或設定該元素所套用的水平對齊特性。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控制項內容的水平對齊。 (繼承來源 Control) |
| HorizontalOffset |
取得或設定水平捲軸的位置。 (繼承來源 TextBoxBase) |
| HorizontalScrollBarVisibility |
會取得或設定一個值，指示是否顯示水平捲動條。 (繼承來源 TextBoxBase) |
| InheritanceBehavior |
取得或設定財產價值繼承、資源金鑰查詢及 RelativeSource FindAncestor 查詢的範圍限制。 (繼承來源 FrameworkElement) |
| InputBindings |
取得與此元素相關的輸入綁定集合。 (繼承來源 UIElement) |
| InputScope |
取得或設定此輸入的 FrameworkElement上下文。 (繼承來源 FrameworkElement) |
| IsArrangeValid |
會獲得一個值，表示該元素配置中子元素的計算大小與位置是否有效。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定一個值，指示該元素是否在使用者介面（UI）中啟用。 這是相依性屬性。 (繼承來源 UIElement) |
| IsEnabledCore |
得到一個值，該值在衍生類別中成為的 IsEnabled 回傳值。 (繼承來源 UIElement) |
| IsFocused |
獲得一個決定該元素是否具有邏輯焦點的值。 這是相依性屬性。 (繼承來源 UIElement) |
| IsHitTestVisible |
取得或設定一個值，宣告該元素是否可能從其渲染內容的某部分回傳為命中測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| IsInactiveSelectionHighlightEnabled |
取得或設定一個值，指示當文字框未聚焦時，文字框是否顯示所選文字。 (繼承來源 TextBoxBase) |
| 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) |
| IsReadOnly |
取得或設定一個值，指示文字編輯控制項是否對使用者為唯讀。 (繼承來源 TextBoxBase) |
| IsReadOnlyCaretVisible |
取得或設定一個值，指示唯讀文字框是否顯示插入點。 (繼承來源 TextBoxBase) |
| IsSealed |
會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject) |
| IsSelectionActive |
會得到一個值，表示文字框是否有焦點和選取的文字。 (繼承來源 TextBoxBase) |
| IsStylusCaptured |
會獲得一個值，表示觸控筆是否被此元素捕捉。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusCaptureWithin |
會得到一個值，決定觸控筆擷取是由此元素持有，還是元素界限及其視覺樹內的元素。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusDirectlyOver |
會得到一個值，表示觸控筆位置是否對應於包含元素合成的命中測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusOver |
會獲得一個值，表示觸控筆游標是否位於此元素（包括視覺子元素）上方。 這是相依性屬性。 (繼承來源 UIElement) |
| IsTabStop |
取得或設定一個值，指示分頁導覽中是否包含某個控制項。 (繼承來源 Control) |
| IsUndoEnabled |
取得或設定一個值，指示文字編輯控制項是否啟用復原支援。 (繼承來源 TextBoxBase) |
| IsVisible |
會取得一個值，表示該元素是否在使用者介面（UI）中可見。 這是相依性屬性。 (繼承來源 UIElement) |
| Language |
取得或設定適用於元素的在地化/全球化語言資訊。 (繼承來源 FrameworkElement) |
| LayoutTransform |
取得或設定一個圖形轉換，當執行版面配置時，該轉換應該套用到這個元素。 (繼承來源 FrameworkElement) |
| LineCount |
會取得文字框中總行數。 |
| LogicalChildren |
取得一個列舉子，針對 的邏輯子元素 TextBox。 |
| Margin |
取得或設定元素的外緣。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定元素的最大高度限制。 (繼承來源 FrameworkElement) |
| MaxLength |
取得或設定可手動輸入文字框的最大字元數。 |
| MaxLines |
取得或設定最大可見線數。 |
| MaxWidth |
取得或設定元素的最大寬度限制。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定元素的最小高度限制。 (繼承來源 FrameworkElement) |
| MinLines |
取得或設定最少可見線數。 |
| MinWidth |
取得或設定元素的最小寬度限制。 (繼承來源 FrameworkElement) |
| Name |
取得或設定元素的識別名稱。 這個名稱提供了一個參考，讓程式碼後方（code-hind，例如事件處理程式程式碼）能在 XAML 處理器在處理過程中建構標記元素後，參考該元素。 (繼承來源 FrameworkElement) |
| Opacity |
在使用者介面（UI）渲染時，取得或設定對整體 UIElement 套用的不透明度因子。 這是相依性屬性。 (繼承來源 UIElement) |
| OpacityMask |
取得或設定不透明度遮罩，作為 Brush 一套實作，適用於該元素渲染內容的任意 alpha 通道遮罩。 這是相依性屬性。 (繼承來源 UIElement) |
| OverridesDefaultStyle |
取得或設定一個值，指示此元素是否包含主題樣式的樣式屬性。 (繼承來源 FrameworkElement) |
| Padding |
在控制區內取得或設定填充物。 (繼承來源 Control) |
| Parent |
取得該元素的邏輯父元素。 (繼承來源 FrameworkElement) |
| PersistId |
已淘汰.
會得到一個唯一識別此元素的值。 (繼承來源 UIElement) |
| RenderSize |
取得（或設定）這個元素的最終渲染大小。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定影響此元素渲染位置的轉換資訊。 這是相依性屬性。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定任何可能渲染轉換的中心點，該轉換由 宣 RenderTransform告 ，相對於元素的邊界。 這是相依性屬性。 (繼承來源 UIElement) |
| Resources |
取得或設定本地定義的資源字典。 (繼承來源 FrameworkElement) |
| SelectedText |
在文字框中取得或設定目前選擇的內容。 |
| SelectionBrush |
取得或設定用來高亮選取文字的筆刷。 (繼承來源 TextBoxBase) |
| SelectionLength |
取得或設定一個值，表示文字框中當前選取的字元數。 |
| SelectionOpacity |
取得或設定 的不透明度 SelectionBrush。 (繼承來源 TextBoxBase) |
| SelectionStart |
取得或設定字元索引，作為當前選擇的開頭。 |
| SelectionTextBrush |
取得或設定一個值，定義用於選取文字的筆刷。 (繼承來源 TextBoxBase) |
| SnapsToDevicePixels |
會取得或設定一個值，決定該元素在渲染時是否應該使用裝置特定的像素設定。 這是相依性屬性。 (繼承來源 UIElement) |
| SpellCheck |
取得SpellCheck一個物件，能存取TextBoxBaseRichTextBox或 (繼承來源 TextBoxBase) |
| Style |
在渲染時，取得或設定該元素所使用的樣式。 (繼承來源 FrameworkElement) |
| StylusPlugIns |
會取得與此元素相關的所有觸控筆外掛（自訂）物件集合。 (繼承來源 UIElement) |
| TabIndex |
取得或設定一個值，決定使用者使用 TAB 鍵在控制項中導航時，元素獲得焦點的順序。 (繼承來源 Control) |
| Tag |
取得或設定一個任意物件值，可用來儲存該元素的自訂資訊。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控制範本。 (繼承來源 Control) |
| TemplatedParent |
會取得該元素範本父碼的參考。 若元素非透過範本建立，此屬性不適用。 (繼承來源 FrameworkElement) |
| Text |
取得或設定文字框的文字內容。 |
| TextAlignment |
取得或設定文字框內容的水平對齊。 |
| TextDecorations |
讓文字裝飾套用到文字框上。 |
| TextWrapping |
它能設定文字框應該如何摺疊文字。 |
| ToolTip |
取得或設定該元素在使用者介面（UI）中顯示的工具提示物件。 (繼承來源 FrameworkElement) |
| TouchesCaptured |
將所有被捕捉的觸控裝置都傳送到這個元素。 (繼承來源 UIElement) |
| TouchesCapturedWithin |
會將所有被捕捉的觸控裝置轉移到此元素或其視覺樹中的任何子元素。 (繼承來源 UIElement) |
| TouchesDirectlyOver |
所有觸控裝置都安裝在這個元件上。 (繼承來源 UIElement) |
| TouchesOver |
取得所有位於此元素或其視覺樹中子元素上的觸控裝置。 (繼承來源 UIElement) |
| Triggers |
取得直接在此元素或子元素中建立的觸發器集合。 (繼承來源 FrameworkElement) |
| Typography |
取得目前有效字體版本的文字內容。 |
| Uid |
取得或設定此元素的唯一識別碼（用於本地化）。 這是相依性屬性。 (繼承來源 UIElement) |
| UndoLimit |
取得或設定還原佇列中儲存的動作數量。 (繼承來源 TextBoxBase) |
| UseLayoutRounding |
取得或設定一個值，指示是否應對該元素在佈局中對其大小與位置進行四捨五入。 (繼承來源 FrameworkElement) |
| VerticalAlignment |
當該元素組合於父元素（如面板或項目控制項）時，取得或設定該元素所套用的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 (繼承來源 Control) |
| VerticalOffset |
取得或設定垂直捲軸位置。 (繼承來源 TextBoxBase) |
| VerticalScrollBarVisibility |
取得或設定一個值，指示是否顯示垂直捲動條。 (繼承來源 TextBoxBase) |
| ViewportHeight |
取得可捲動內容區的垂直大小。 (繼承來源 TextBoxBase) |
| ViewportWidth |
會取得可捲動內容區域的橫向大小。 (繼承來源 TextBoxBase) |
| Visibility |
取得或設定此元素的使用者介面（UI）可見性。 這是相依性屬性。 (繼承來源 UIElement) |
| VisualBitmapEffect |
已淘汰.
已淘汰.
取得或設定 BitmapEffect 的值。Visual (繼承來源 Visual) |
| VisualBitmapEffectInput |
已淘汰.
已淘汰.
取得或設定 BitmapEffectInput 的值。Visual (繼承來源 Visual) |
| VisualBitmapScalingMode |
取得或設定 BitmapScalingMode 。Visual (繼承來源 Visual) |
| VisualCacheMode |
取得或設定 的快取表示 Visual。 (繼承來源 Visual) |
| VisualChildrenCount |
取得該元素中視覺子元素的數量。 (繼承來源 FrameworkElement) |
| 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) |
| MouseDoubleClick |
當滑鼠按鈕被點擊兩次或以上時會發生。 (繼承來源 Control) |
| 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) |
| PreviewMouseDoubleClick |
當使用者點擊滑鼠按鈕兩次或以上時會發生。 (繼承來源 Control) |
| 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) |
| SelectionChanged |
當文字選擇改變時會發生。 (繼承來源 TextBoxBase) |
| 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) |
| TextChanged |
當文字元素內容變更時，會發生這種情況。 (繼承來源 TextBoxBase) |
| TextInput |
當這個元素以與裝置無關的方式接收文字時，就會發生。 (繼承來源 UIElement) |
| ToolTipClosing |
發生在元件上任何提示關閉前。 (繼承來源 FrameworkElement) |
| ToolTipOpening |
當打開元素的任何提示時，都會發生。 (繼承來源 FrameworkElement) |
| TouchDown |
當手指觸碰螢幕時，手指正覆蓋著這個元素。 (繼承來源 UIElement) |
| TouchEnter |
當觸碰從該元素範圍外移動到該元素範圍內時，就會發生。 (繼承來源 UIElement) |
| TouchLeave |
當觸碰從該元素的範圍內移動到外部時，就會發生這種情況。 (繼承來源 UIElement) |
| TouchMove |
當手指在螢幕上移動時，手指正覆蓋著該元素。 (繼承來源 UIElement) |
| TouchUp |
當手指在螢幕上方時，手指被抬離螢幕，就會發生。 (繼承來源 UIElement) |
| Unloaded |
當元素從載入元素樹中移除時，會發生這種情況。 (繼承來源 FrameworkElement) |
明確介面實作
| 名稱 | Description |
|---|---|
| IAddChild.AddChild(Object) |
在所有情況下都會有例外。 |
| IAddChild.AddText(String) |
將節點的文字內容加入物件。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
關於此成員的描述，請參見方法。IsAmbientPropertyAvailable(String) (繼承來源 FrameworkElement) |
