UserControl 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供建立控件的簡單方式。
public ref class UserControl : System::Windows::Controls::ContentControlpublic class UserControl : System.Windows.Controls.ContentControltype UserControl = class
inherit ContentControlPublic Class UserControl
Inherits ContentControl- 繼承
- 衍生
範例
下列範例示範如何建立簡單的 NumericUpDownUserControl。
<!--XAML for NumericUpDown that inherits from UserControl.-->
<UserControl x:Class="MyUserControl.NumericUpDown"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:MyUserControl">
<Grid Margin="3">
<Grid.RowDefinitions>
<RowDefinition/>
<RowDefinition/>
</Grid.RowDefinitions>
<Grid.ColumnDefinitions>
<ColumnDefinition/>
<ColumnDefinition/>
</Grid.ColumnDefinitions>
<Border BorderThickness="1" BorderBrush="Gray" Margin="2"
Grid.RowSpan="2" VerticalAlignment="Center" HorizontalAlignment="Stretch">
<!--Bind the TextBlock to the Value property-->
<TextBlock
Width="60" TextAlignment="Right" Padding="5"
Text="{Binding RelativeSource={RelativeSource FindAncestor,
AncestorType={x:Type local:NumericUpDown}},
Path=Value}"/>
</Border>
<RepeatButton Name="upButton" Click="upButton_Click"
Grid.Column="1" Grid.Row="0">Up</RepeatButton>
<RepeatButton Name="downButton" Click="downButton_Click"
Grid.Column="1" Grid.Row="1">Down</RepeatButton>
</Grid>
</UserControl>
下列顯示此 UserControl的邏輯：
using System;
using System.Windows;
using System.Windows.Controls;
namespace MyUserControl
{
public partial class NumericUpDown : System.Windows.Controls.UserControl
{
/// <summary>
/// Initializes a new instance of the NumericUpDownControl.
/// </summary>
public NumericUpDown()
{
InitializeComponent();
}
/// <summary>
/// Identifies the Value dependency property.
/// </summary>
public static readonly DependencyProperty ValueProperty =
DependencyProperty.Register(
"Value", typeof(decimal), typeof(NumericUpDown),
new FrameworkPropertyMetadata(MinValue, new PropertyChangedCallback(OnValueChanged),
new CoerceValueCallback(CoerceValue)));
/// <summary>
/// Gets or sets the value assigned to the control.
/// </summary>
public decimal Value
{
get { return (decimal)GetValue(ValueProperty); }
set { SetValue(ValueProperty, value); }
}
private static object CoerceValue(DependencyObject element, object value)
{
decimal newValue = (decimal)value;
NumericUpDown control = (NumericUpDown)element;
newValue = Math.Max(MinValue, Math.Min(MaxValue, newValue));
return newValue;
}
private static void OnValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
NumericUpDown control = (NumericUpDown)obj;
RoutedPropertyChangedEventArgs<decimal> e = new RoutedPropertyChangedEventArgs<decimal>(
(decimal)args.OldValue, (decimal)args.NewValue, ValueChangedEvent);
control.OnValueChanged(e);
}
/// <summary>
/// Identifies the ValueChanged routed event.
/// </summary>
public static readonly RoutedEvent ValueChangedEvent = EventManager.RegisterRoutedEvent(
"ValueChanged", RoutingStrategy.Bubble,
typeof(RoutedPropertyChangedEventHandler<decimal>), typeof(NumericUpDown));
/// <summary>
/// Occurs when the Value property changes.
/// </summary>
public event RoutedPropertyChangedEventHandler<decimal> ValueChanged
{
add { AddHandler(ValueChangedEvent, value); }
remove { RemoveHandler(ValueChangedEvent, value); }
}
/// <summary>
/// Raises the ValueChanged event.
/// </summary>
/// <param name="args">Arguments associated with the ValueChanged event.</param>
protected virtual void OnValueChanged(RoutedPropertyChangedEventArgs<decimal> args)
{
RaiseEvent(args);
}
private void upButton_Click(object sender, EventArgs e)
{
Value++;
}
private void downButton_Click(object sender, EventArgs e)
{
Value--;
}
private const decimal MinValue = 0, MaxValue = 100;
}
}
Imports System.Windows
Imports System.Windows.Controls
Namespace MyUserControl
Partial Public Class NumericUpDown
Inherits System.Windows.Controls.UserControl
''' <summary>
''' Initializes a new instance of the NumericUpDownControl.
''' </summary>
Public Sub New()
InitializeComponent()
End Sub
''' <summary>
''' Identifies the Value dependency property.
''' </summary>
Public Shared ReadOnly ValueProperty As DependencyProperty = DependencyProperty.Register("Value", GetType(Decimal), GetType(NumericUpDown), New FrameworkPropertyMetadata(MinValue, New PropertyChangedCallback(AddressOf OnValueChanged), New CoerceValueCallback(AddressOf CoerceValue)))
''' <summary>
''' Gets or sets the value assigned to the control.
''' </summary>
Public Property Value() As Decimal
Get
Return CDec(GetValue(ValueProperty))
End Get
Set(ByVal value As Decimal)
SetValue(ValueProperty, value)
End Set
End Property
Private Shared Overloads Function CoerceValue(ByVal element As DependencyObject, ByVal value As Object) As Object
Dim newValue As Decimal = CDec(value)
Dim control As NumericUpDown = CType(element, NumericUpDown)
newValue = Math.Max(MinValue, Math.Min(MaxValue, newValue))
Return newValue
End Function
Private Shared Sub OnValueChanged(ByVal obj As DependencyObject, ByVal args As DependencyPropertyChangedEventArgs)
Dim control As NumericUpDown = CType(obj, NumericUpDown)
Dim e As New RoutedPropertyChangedEventArgs(Of Decimal)(CDec(args.OldValue), CDec(args.NewValue), ValueChangedEvent)
control.OnValueChanged(e)
End Sub
''' <summary>
''' Identifies the ValueChanged routed event.
''' </summary>
Public Shared ReadOnly ValueChangedEvent As RoutedEvent = EventManager.RegisterRoutedEvent("ValueChanged", RoutingStrategy.Bubble, GetType(RoutedPropertyChangedEventHandler(Of Decimal)), GetType(NumericUpDown))
''' <summary>
''' Occurs when the Value property changes.
''' </summary>
Public Custom Event ValueChanged As RoutedPropertyChangedEventHandler(Of Decimal)
AddHandler(ByVal value As RoutedPropertyChangedEventHandler(Of Decimal))
MyBase.AddHandler(ValueChangedEvent, value)
End AddHandler
RemoveHandler(ByVal value As RoutedPropertyChangedEventHandler(Of Decimal))
MyBase.RemoveHandler(ValueChangedEvent, value)
End RemoveHandler
RaiseEvent(ByVal sender As System.Object, ByVal e As RoutedPropertyChangedEventArgs(Of Decimal))
End RaiseEvent
End Event
''' <summary>
''' Raises the ValueChanged event.
''' </summary>
''' <param name="args">Arguments associated with the ValueChanged event.</param>
Protected Overridable Sub OnValueChanged(ByVal args As RoutedPropertyChangedEventArgs(Of Decimal))
MyBase.RaiseEvent(args)
End Sub
Private Sub upButton_Click(ByVal sender As Object, ByVal e As EventArgs)
Value += 1
End Sub
Private Sub downButton_Click(ByVal sender As Object, ByVal e As EventArgs)
Value -= 1
End Sub
Private Const MinValue As Decimal = 0, MaxValue As Decimal = 100
End Class
End Namespace
如需詳細資訊，請參閱 控件撰寫概觀。
備註
Windows Presentation Foundation （WPF） 中的控件支援豐富的內容、樣式、觸發程式和範本。 在許多情況下，這些功能可讓您建立自定義且一致的體驗，而不需要建立新的控件。 如需詳細資訊，請參閱 樣式和範本化。
如果您需要建立新的控件，最簡單的方式是建立衍生自 UserControl的類別。 這麼做之前，請考慮控件不支援範本，因此不支援複雜的自定義。 不過，如果您想要藉由將現有的元素新增至控件，類似於建置應用程式的方式，以及您不需要支援複雜的自定義，則衍生自 UserControl 是適合的模型。 （如果您想要搭配控件使用範本，請改為衍生自 Control。如需撰寫控件之不同模型的詳細資訊，請參閱 控件撰寫概觀。
UserControl 是 ContentControl，這表示它可以包含任何類型的單一物件（例如字串、影像或面板）。 如需詳細資訊，請參閱 ContentControl 類別。
此控件的相依性屬性可能由控件的預設樣式設定。 如果屬性是以預設樣式設定，當控件出現在應用程式中時，屬性可能會從其預設值變更。 默認樣式取決於應用程式執行時所使用的桌面主題。
建構函式
| UserControl() |
初始化 UserControl 類別的新實例。 |
屬性
| ActualHeight |
取得這個項目的轉譯高度。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得這個元素的轉譯寬度。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定值，指出這個元素是否可以當做拖放作業的目標使用。 這是相依性屬性。 (繼承來源 UIElement) |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少擷取一個觸控到這個專案。 (繼承來源 UIElement) |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少擷取一個觸控至這個專案，或是擷取至其可視化樹狀結構中的任何子專案。 (繼承來源 UIElement) |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否在這個元素上按下至少一個觸控。 (繼承來源 UIElement) |
| AreAnyTouchesOver |
取得值，這個值表示是否至少在這個專案或其可視化樹狀結構中的任何子專案上按下一個觸控。 (繼承來源 UIElement) |
| Background |
取得或設定描述控制件背景的筆刷。 (繼承來源 Control) |
| BindingGroup |
取得或設定用於 專案的 BindingGroup。 (繼承來源 FrameworkElement) |
| BitmapEffect |
已淘汰.
已淘汰.
取得或設定直接套用至這個項目轉譯內容的點陣圖效果。 這是相依性屬性。 (繼承來源 UIElement) |
| BitmapEffectInput |
已淘汰.
已淘汰.
取得或設定位圖效果的輸入來源，該效果會直接套用至這個專案的轉譯內容。 這是相依性屬性。 (繼承來源 UIElement) |
| BorderBrush |
取得或設定描述控制件框線背景的筆刷。 (繼承來源 Control) |
| BorderThickness |
取得或設定控件的框線粗細。 (繼承來源 Control) |
| CacheMode |
取得或設定 UIElement的快取表示法。 (繼承來源 UIElement) |
| Clip |
取得或設定用來定義項目內容的外框的幾何。 這是相依性屬性。 (繼承來源 UIElement) |
| ClipToBounds |
取得或設定值，指出是否要裁剪這個元素的內容（或來自這個專案的子項目的內容），以符合包含專案的大小。 這是相依性屬性。 (繼承來源 UIElement) |
| CommandBindings |
取得與這個項目相關聯的 CommandBinding 物件集合。 CommandBinding 會啟用這個專案的命令處理，並宣告命令、其事件和這個專案所附加之處理程式之間的連結。 (繼承來源 UIElement) |
| Content |
取得或設定 ContentControl的內容。 (繼承來源 ContentControl) |
| ContentStringFormat |
取得或設定複合字串，指定當屬性顯示為字串時，如何格式化 Content 屬性。 (繼承來源 ContentControl) |
| ContentTemplate |
取得或設定用來顯示 ContentControl內容的數據範本。 (繼承來源 ContentControl) |
| ContentTemplateSelector |
取得或設定範本選取器，可讓應用程式寫入器提供自定義範本選取邏輯。 (繼承來源 ContentControl) |
| ContextMenu |
取得或設定每當透過使用者介面 （UI） 從這個專案內要求操作功能表時，應該出現的操作功能表元素。 (繼承來源 FrameworkElement) |
| Cursor |
取得或設定游標，這個游標會在滑鼠指標位於這個專案上方時顯示。 (繼承來源 FrameworkElement) |
| DataContext |
取得或設定專案參與數據系結時的數據內容。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
取得或設定索引鍵，當使用或定義主題樣式時，用來參考這個控件的樣式。 (繼承來源 FrameworkElement) |
| DependencyObjectType |
取得包裝這個實例 CLR 類型的 DependencyObjectType。 (繼承來源 DependencyObject) |
| DesiredSize |
取得此元素在版面配置程式量值階段期間計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
取得與這個 DispatcherObject 相關聯的 Dispatcher。 (繼承來源 DispatcherObject) |
| Effect |
取得或設定要套用至 UIElement的點陣圖效果。 這是相依性屬性。 (繼承來源 UIElement) |
| 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) |
| HasContent |
取得值，這個值表示 ContentControl 是否包含內容。 (繼承來源 ContentControl) |
| HasEffectiveKeyboardFocus |
取得值，指出 UIElement 是否有焦點。 (繼承來源 UIElement) |
| Height |
取得或設定項目的建議高度。 (繼承來源 FrameworkElement) |
| HorizontalAlignment |
取得或設定在父元素內撰寫時套用至這個專案的水準對齊特性，例如面板或專案控件。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控件內容的水準對齊方式。 (繼承來源 Control) |
| InheritanceBehavior |
取得或設定屬性值繼承、資源索引鍵查閱和 RelativeSource FindAncestor 查閱的範圍限制。 (繼承來源 FrameworkElement) |
| InputBindings |
取得與這個專案相關聯的輸入系結集合。 (繼承來源 UIElement) |
| InputScope |
取得或設定這個 FrameworkElement所使用的輸入內容。 (繼承來源 FrameworkElement) |
| IsArrangeValid |
取得值，指出這個元素配置中子元素的計算大小和位置是否有效。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定值，指出使用者介面 （UI） 中是否啟用這個專案。 這是相依性屬性。 (繼承來源 UIElement) |
| IsEnabledCore |
取得值，這個值會成為衍生類別中 IsEnabled 的傳回值。 (繼承來源 UIElement) |
| IsFocused |
取得值，這個值會判斷這個專案是否具有邏輯焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| IsHitTestVisible |
取得或設定值，這個值會宣告這個元素是否可以從其轉譯內容的某些部分傳回作為點擊測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| 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) |
| IsTabStop |
取得或設定值，指出控件是否包含在索引標籤導覽中。 (繼承來源 Control) |
| IsVisible |
取得值，指出這個元素是否顯示在使用者介面 （UI） 中。 這是相依性屬性。 (繼承來源 UIElement) |
| Language |
取得或設定套用至 專案的當地語系化/全球化語言資訊。 (繼承來源 FrameworkElement) |
| LayoutTransform |
取得或設定執行版面配置時，應該套用至這個項目的圖形轉換。 (繼承來源 FrameworkElement) |
| LogicalChildren |
取得內容控制項邏輯子專案的列舉值。 (繼承來源 ContentControl) |
| Margin |
取得或設定專案的外部邊界。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定專案的最大高度條件約束。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定專案的最大寬度條件約束。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定專案的最低高度條件約束。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定專案的最小寬度條件約束。 (繼承來源 FrameworkElement) |
| Name |
取得或設定項目的識別名稱。 此名稱會提供參考，讓程式代碼後置，例如事件處理程式程式代碼，可以在 XAML 處理器在處理期間建構標記專案之後參考它。 (繼承來源 FrameworkElement) |
| Opacity |
取得或設定在使用者介面中轉譯時套用至整個 UIElement 不透明度因數。 這是相依性屬性。 (繼承來源 UIElement) |
| OpacityMask |
取得或設定不透明度遮罩，做為套用至這個元素轉譯內容之任何 Alpha 色板遮罩的 Brush 實作。 這是相依性屬性。 (繼承來源 UIElement) |
| OverridesDefaultStyle |
取得或設定值，這個值表示這個專案是否包含主題樣式的樣式屬性。 (繼承來源 FrameworkElement) |
| Padding |
取得或設定 控件內的邊框間距。 (繼承來源 Control) |
| Parent |
取得這個項目的邏輯父元素。 (繼承來源 FrameworkElement) |
| PersistId |
已淘汰.
取得可唯一識別這個專案的值。 (繼承來源 UIElement) |
| RenderSize |
取得這個元素的最終轉譯大小（或設定）。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響這個項目轉譯位置的轉換資訊。 這是相依性屬性。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform所宣告之任何可能轉譯轉換的中心點，相對於專案界限。 這是相依性屬性。 (繼承來源 UIElement) |
| Resources |
取得或設定本機定義的資源字典。 (繼承來源 FrameworkElement) |
| SnapsToDevicePixels |
取得或設定值，這個值會決定這個元素的轉譯是否應該在轉譯期間使用裝置特定的像素設定。 這是相依性屬性。 (繼承來源 UIElement) |
| Style |
取得或設定這個元素在轉譯時所使用的樣式。 (繼承來源 FrameworkElement) |
| StylusPlugIns |
取得與這個項目相關聯的所有手寫筆外掛程式（自定義）物件的集合。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，這個值會決定當使用者使用 TAB 鍵巡覽控件時，專案接收焦點的順序。 (繼承來源 Control) |
| Tag |
取得或設定可用來儲存這個專案之自定義資訊的任意物件值。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控件範本。 (繼承來源 Control) |
| TemplatedParent |
取得這個專案之範本父系的參考。 如果元素不是透過範本建立，則此屬性不相關。 (繼承來源 FrameworkElement) |
| ToolTip |
取得或設定使用者介面 （UI） 中這個元素所顯示的工具提示物件。 (繼承來源 FrameworkElement) |
| TouchesCaptured |
取得擷取至這個專案的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesCapturedWithin |
取得擷取至這個專案的所有觸控裝置，或其可視化樹狀結構中的任何子專案。 (繼承來源 UIElement) |
| TouchesDirectlyOver |
取得位於這個專案上的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesOver |
取得位於這個元素上的所有觸控裝置或其可視化樹狀結構中的任何子專案。 (繼承來源 UIElement) |
| Triggers |
取得直接在此專案或子專案上建立的觸發程式集合。 (繼承來源 FrameworkElement) |
| Uid |
取得或設定這個專案的唯一標識碼（用於當地語系化）。 這是相依性屬性。 (繼承來源 UIElement) |
| UseLayoutRounding |
取得或設定值，這個值表示配置四捨五入是否應該套用至配置期間這個專案的大小和位置。 (繼承來源 FrameworkElement) |
| VerticalAlignment |
取得或設定在父元素內，例如面板或專案控件的父元素內時，套用至這個專案的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控件內容的垂直對齊方式。 (繼承來源 Control) |
| Visibility |
取得或設定這個項目的使用者介面 （UI） 可見性。 這是相依性屬性。 (繼承來源 UIElement) |
| VisualBitmapEffect |
已淘汰.
已淘汰.
取得或設定 Visual的 BitmapEffect 值。 (繼承來源 Visual) |
| VisualBitmapEffectInput |
已淘汰.
已淘汰.
取得或設定 Visual的 BitmapEffectInput 值。 (繼承來源 Visual) |
| VisualBitmapScalingMode |
取得或設定 Visual的 BitmapScalingMode。 (繼承來源 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) |
| 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) |
| TextInput |
發生於這個專案以與裝置無關的方式取得文字時。 (繼承來源 UIElement) |
| ToolTipClosing |
發生於專案上的任何工具提示關閉之前。 (繼承來源 FrameworkElement) |
| ToolTipOpening |
在開啟專案的任何工具提示時發生。 (繼承來源 FrameworkElement) |
| TouchDown |
當手指位於這個專案上方時，手指觸碰螢幕時發生。 (繼承來源 UIElement) |
| TouchEnter |
發生於觸控從外部移至這個專案界限內時。 (繼承來源 UIElement) |
| TouchLeave |
當觸控從內部移至這個專案界限外時發生。 (繼承來源 UIElement) |
| TouchMove |
當手指位於這個專案上方時，手指在螢幕上移動時發生。 (繼承來源 UIElement) |
| TouchUp |
當手指位於這個專案上方時，手指從螢幕上抬起時發生。 (繼承來源 UIElement) |
| Unloaded |
發生於從已載入專案的專案樹狀結構中移除專案時。 (繼承來源 FrameworkElement) |
明確介面實作
| IAddChild.AddChild(Object) |
此類型或成員支援 Windows Presentation Foundation （WPF） 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 ContentControl) |
| IAddChild.AddText(String) |
此類型或成員支援 Windows Presentation Foundation （WPF） 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 ContentControl) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
如需此成員的描述，請參閱 IsAmbientPropertyAvailable(String) 方法。 (繼承來源 FrameworkElement) |
