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 控制項的初始文字內容。
注意
雖然此範例的 Extensible Application Markup Language (XAML) 版本可以使用 < TextBox.Text > 標籤來括住每個按鈕 TextBox 內容的文字，但並非必要，因為 TextBox 會將 ContentPropertyAttribute 屬性套用至 Text 屬性。
<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 的範例
TextBox 是由數個封裝元件組成的複合控制項。 因此，某些事件不會反升至包含控制項，因為它們是由封裝的子項目處理。 因此，應用程式開發人員應該接聽前置詞 「Preview」) 表示的事件通道版本 (。
TextBox 僅支援未格式化的文字。 如需需要支援更豐富內容的應用程式，請參閱 RichTextBox 。 如需需要接受密碼或其他敏感性輸入的應用程式，請參閱 PasswordBox 。
水準和垂直對齊 中的 TextBox 文字是使用 HorizontalContentAlignment 和 VerticalContentAlignment 屬性來完成。 使用 TextBox 和 VerticalAlignment 屬性來 HorizontalAlignment 對齊頁面的版面配置內。
在 周圍 TextBox 隱藏框線的最佳方式是將 BorderThickness 的 TextBox 屬性設定為 0 。
重要
TextBox 具有反升 MouseUp 和 MouseDown 事件的內建處理。 因此，將不會呼叫接聽 MouseUp 或 來自 TextBox 的 MouseDown 自訂事件處理常式。 如果您需要回應這些事件，請改為接聽信道 PreviewMouseUp 和 PreviewMouseDown 事件，或向引數註冊處理常式 HandledEventsToo ， (後者選項只能透過程式碼) 使用。 除非您刻意停用 TextBox 這些事件的原生處理，否則請勿標記事件，並注意這對控制項的 UI 有顯著的影響。
預設不會顯示 TextBox 捲軸。 若要讓捲軸可見，請將 和 HorizontalScrollBarVisibility 屬性設定 VerticalScrollBarVisibility 為 Visible 或 Auto 。
通常 TextChanged 應該使用 事件來偵測每當 中的 TextBox 文字或 RichTextBox 變更，而不是 KeyDown 如您所預期般。 如需範例 ，請參閱如何：偵測 TextBox 中的文字何時變更 。
自訂 TextBox 控制項
若要將相同的屬性設定套用至多個 TextBox 控制項，請使用 Style 屬性。 您可以修改預設值 ControlTemplate ，讓控制項具有唯一的外觀。 如需建立 ControlTemplate 的詳細資訊，請參閱 建立 ControlTemplate 來自訂現有控制項的外觀。 若要查看 的特定 TextBox 元件和狀態，請參閱 TextBox 樣式和範本。
此控制項的相依性屬性可能是由控制項的預設樣式所設定。 如果屬性是以預設樣式設定，當控制項出現在應用程式中時，屬性可能會從其預設值變更。 預設樣式取決於應用程式執行時所使用的桌面主題。
注意
如果該屬性同時顯示於控制項的預設範本，並使用 TemplateBinding 來設定，則設定視覺效果屬性僅具效果作用。 您可以在通過建立 ControlTemplate 自訂現有控制項的外觀文章的變更控制項的視覺效果結構一節中找到視覺效果屬性清單。
建構函式
| TextBox() |
初始化 TextBox 類別的新執行個體。 |
欄位
| CharacterCasingProperty |
識別 CharacterCasing 相依性屬性。 |
| MaxLengthProperty |
識別 MaxLength 相依性屬性。 |
| MaxLinesProperty |
識別 MaxLines 相依性屬性。 |
| MinLinesProperty |
識別 MinLines 相依性屬性。 |
| TextAlignmentProperty |
識別 TextAlignment 相依性屬性。 |
| TextDecorationsProperty |
識別 TextDecorations 相依性屬性。 |
| TextProperty |
識別 Text 相依性屬性。 |
| TextWrappingProperty |
識別 TextWrapping 相依性屬性。 |
屬性
| 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 物件集合。 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 |
取得值，指出是否啟用輸入法編輯器 (輸入法) 等輸入法系統，以處理這個專案的輸入。 (繼承來源 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 |
取得或設定項目的識別名稱。 此名稱提供參考，讓事件處理常式程式碼等程式碼後置可以在 XAML 處理器在處理期間建構標記專案之後參考。 (繼承來源 FrameworkElement) |
| Opacity |
取得或設定在使用者介面 (UI) 轉譯時套用至整個 UIElement 的不透明度因數。 這是相依性屬性。 (繼承來源 UIElement) |
| OpacityMask |
取得或設定套用至任何 Alpha 色板遮罩 (用來遮住此項目的呈現內容) 時實作 Brush 的不透明度遮罩。 這是相依性屬性。 (繼承來源 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 物件，該物件可存取 TextBoxBase 或 RichTextBox 之文字內容中的拼字錯誤。 (繼承來源 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，以決定 Visual 中的 ClearType 呈現方式。 (繼承來源 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 |
取得或設定 Visual 的 TextHintingMode。 (繼承來源 Visual) |
| VisualTextRenderingMode |
取得或設定 Visual 的 TextRenderingMode。 (繼承來源 Visual) |
| VisualTransform | (繼承來源 Visual) |
| VisualXSnappingGuidelines |
取得或設定 X 座標 (垂直) 導線集合。 (繼承來源 Visual) |
| VisualYSnappingGuidelines |
取得或設定 Y 座標 (水平) 導線集合。 (繼承來源 Visual) |
| Width |
取得或設定元素的寬度。 (繼承來源 FrameworkElement) |
方法
事件
| 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 |
當這個項目的 ActualHeight 或 ActualWidth 屬性變更值時發生。 (繼承來源 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) |
明確介面實作
| IAddChild.AddChild(Object) |
在所有情況下都擲回例外狀況 (Exception)。 |
| IAddChild.AddText(String) |
將節點的文字內容加入物件中。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
如需這個成員的描述，請參閱 IsAmbientPropertyAvailable(String) 方法。 (繼承來源 FrameworkElement) |
