Grid 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义由列和行组成的灵活网格区域。
public ref class Grid : System::Windows::Controls::Panel, System::Windows::Markup::IAddChildpublic class Grid : System.Windows.Controls.Panel, System.Windows.Markup.IAddChildtype Grid = class
inherit Panel
interface IAddChildPublic Class Grid
Inherits Panel
Implements IAddChild- 继承
- 派生
- 实现
示例
以下示例演示如何创建网格。 在这种情况下，网格定义托管子内容的三 ColumnDefinition 个元素和四 RowDefinition 个元素。
// Create the application's main window
mainWindow = new Window();
mainWindow.Title = "Grid Sample";
// Create the Grid
Grid myGrid = new Grid();
myGrid.Width = 250;
myGrid.Height = 100;
myGrid.HorizontalAlignment = HorizontalAlignment.Left;
myGrid.VerticalAlignment = VerticalAlignment.Top;
myGrid.ShowGridLines = true;
// Define the Columns
ColumnDefinition colDef1 = new ColumnDefinition();
ColumnDefinition colDef2 = new ColumnDefinition();
ColumnDefinition colDef3 = new ColumnDefinition();
myGrid.ColumnDefinitions.Add(colDef1);
myGrid.ColumnDefinitions.Add(colDef2);
myGrid.ColumnDefinitions.Add(colDef3);
// Define the Rows
RowDefinition rowDef1 = new RowDefinition();
RowDefinition rowDef2 = new RowDefinition();
RowDefinition rowDef3 = new RowDefinition();
RowDefinition rowDef4 = new RowDefinition();
myGrid.RowDefinitions.Add(rowDef1);
myGrid.RowDefinitions.Add(rowDef2);
myGrid.RowDefinitions.Add(rowDef3);
myGrid.RowDefinitions.Add(rowDef4);
// Add the first text cell to the Grid
TextBlock txt1 = new TextBlock();
txt1.Text = "2005 Products Shipped";
txt1.FontSize = 20;
txt1.FontWeight = FontWeights.Bold;
Grid.SetColumnSpan(txt1, 3);
Grid.SetRow(txt1, 0);
// Add the second text cell to the Grid
TextBlock txt2 = new TextBlock();
txt2.Text = "Quarter 1";
txt2.FontSize = 12;
txt2.FontWeight = FontWeights.Bold;
Grid.SetRow(txt2, 1);
Grid.SetColumn(txt2, 0);
// Add the third text cell to the Grid
TextBlock txt3 = new TextBlock();
txt3.Text = "Quarter 2";
txt3.FontSize = 12;
txt3.FontWeight = FontWeights.Bold;
Grid.SetRow(txt3, 1);
Grid.SetColumn(txt3, 1);
// Add the fourth text cell to the Grid
TextBlock txt4 = new TextBlock();
txt4.Text = "Quarter 3";
txt4.FontSize = 12;
txt4.FontWeight = FontWeights.Bold;
Grid.SetRow(txt4, 1);
Grid.SetColumn(txt4, 2);
// Add the sixth text cell to the Grid
TextBlock txt5 = new TextBlock();
Double db1 = new Double();
db1 = 50000;
txt5.Text = db1.ToString();
Grid.SetRow(txt5, 2);
Grid.SetColumn(txt5, 0);
// Add the seventh text cell to the Grid
TextBlock txt6 = new TextBlock();
Double db2 = new Double();
db2 = 100000;
txt6.Text = db2.ToString();
Grid.SetRow(txt6, 2);
Grid.SetColumn(txt6, 1);
// Add the final text cell to the Grid
TextBlock txt7 = new TextBlock();
Double db3 = new Double();
db3 = 150000;
txt7.Text = db3.ToString();
Grid.SetRow(txt7, 2);
Grid.SetColumn(txt7, 2);
// Total all Data and Span Three Columns
TextBlock txt8 = new TextBlock();
txt8.FontSize = 16;
txt8.FontWeight = FontWeights.Bold;
txt8.Text = "Total Units: " + (db1 + db2 + db3).ToString();
Grid.SetRow(txt8, 3);
Grid.SetColumnSpan(txt8, 3);
// Add the TextBlock elements to the Grid Children collection
myGrid.Children.Add(txt1);
myGrid.Children.Add(txt2);
myGrid.Children.Add(txt3);
myGrid.Children.Add(txt4);
myGrid.Children.Add(txt5);
myGrid.Children.Add(txt6);
myGrid.Children.Add(txt7);
myGrid.Children.Add(txt8);
// Add the Grid as the Content of the Parent Window Object
mainWindow.Content = myGrid;
mainWindow.Show ();
Public Sub New()
WindowTitle = "Grid Sample"
'Create a Grid as the root Panel element
Dim myGrid As New Grid()
myGrid.Height = 100
myGrid.Width = 250
myGrid.ShowGridLines = True
myGrid.HorizontalAlignment = Windows.HorizontalAlignment.Left
myGrid.VerticalAlignment = Windows.VerticalAlignment.Top
' Define and Add the Rows and Columns
Dim colDef1 As New ColumnDefinition
Dim colDef2 As New ColumnDefinition
Dim colDef3 As New ColumnDefinition
myGrid.ColumnDefinitions.Add(colDef1)
myGrid.ColumnDefinitions.Add(colDef2)
myGrid.ColumnDefinitions.Add(colDef3)
Dim rowDef1 As New RowDefinition
Dim rowDef2 As New RowDefinition
Dim rowDef3 As New RowDefinition
Dim rowDef4 As New RowDefinition
myGrid.RowDefinitions.Add(rowDef1)
myGrid.RowDefinitions.Add(rowDef2)
myGrid.RowDefinitions.Add(rowDef3)
myGrid.RowDefinitions.Add(rowDef4)
Dim txt1 As New TextBlock
txt1.Text = "2004 Products Shipped"
txt1.FontSize = 20
txt1.FontWeight = FontWeights.Bold
Grid.SetColumnSpan(txt1, 3)
Grid.SetRow(txt1, 0)
myGrid.Children.Add(txt1)
Dim txt2 As New TextBlock
txt2.Text = "Quarter 1"
txt2.FontSize = 12
txt2.FontWeight = FontWeights.Bold
Grid.SetRow(txt2, 1)
Grid.SetColumn(txt2, 0)
myGrid.Children.Add(txt2)
Dim txt3 As New TextBlock
txt3.Text = "Quarter 2"
txt3.FontSize = 12
txt3.FontWeight = FontWeights.Bold
Grid.SetRow(txt3, 1)
Grid.SetColumn(txt3, 1)
myGrid.Children.Add(txt3)
Dim txt4 As New TextBlock
txt4.Text = "Quarter 3"
txt4.FontSize = 12
txt4.FontWeight = FontWeights.Bold
Grid.SetRow(txt4, 1)
Grid.SetColumn(txt4, 2)
myGrid.Children.Add(txt4)
Dim txt5 As New TextBlock
txt5.Text = "50,000"
Grid.SetRow(txt5, 2)
Grid.SetColumn(txt5, 0)
myGrid.Children.Add(txt5)
Dim txt6 As New Controls.TextBlock
txt6.Text = "100,000"
Grid.SetRow(txt6, 2)
Grid.SetColumn(txt6, 1)
myGrid.Children.Add(txt6)
Dim txt7 As New TextBlock
txt7.Text = "150,000"
Grid.SetRow(txt7, 2)
Grid.SetColumn(txt7, 2)
myGrid.Children.Add(txt7)
' Add the final TextBlock Cell to the Grid
Dim txt8 As New TextBlock
txt8.FontSize = 16
txt8.FontWeight = FontWeights.Bold
txt8.Text = "Total Units: 300000"
Grid.SetRow(txt8, 3)
Grid.SetColumnSpan(txt8, 3)
myGrid.Children.Add(txt8)
Me.Content = myGrid
End Sub
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" WindowTitle="Grid Sample">
<Grid VerticalAlignment="Top" HorizontalAlignment="Left" ShowGridLines="True" Width="250" Height="100">
<Grid.ColumnDefinitions>
<ColumnDefinition />
<ColumnDefinition />
<ColumnDefinition />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition />
<RowDefinition />
<RowDefinition />
<RowDefinition />
</Grid.RowDefinitions>
<TextBlock FontSize="20" FontWeight="Bold" Grid.ColumnSpan="3" Grid.Row="0">2005 Products Shipped</TextBlock>
<TextBlock FontSize="12" FontWeight="Bold" Grid.Row="1" Grid.Column="0">Quarter 1</TextBlock>
<TextBlock FontSize="12" FontWeight="Bold" Grid.Row="1" Grid.Column="1">Quarter 2</TextBlock>
<TextBlock FontSize="12" FontWeight="Bold" Grid.Row="1" Grid.Column="2">Quarter 3</TextBlock>
<TextBlock Grid.Row="2" Grid.Column="0">50000</TextBlock>
<TextBlock Grid.Row="2" Grid.Column="1">100000</TextBlock>
<TextBlock Grid.Row="2" Grid.Column="2">150000</TextBlock>
<TextBlock FontSize="16" FontWeight="Bold" Grid.ColumnSpan="3" Grid.Row="3">Total Units: 300000</TextBlock>
</Grid>
</Page>
注解
一 Grid 个对象集合，该集合 UIElement 位于属性中 Children 。
在一个 Grid 范围内定义的列和行可以利用 Star 大小调整来按比例分布剩余空间。 当选择为行或列的高度或宽度时 Star ，该列或行将接收剩余可用空间的加权比例。 这与它形成鲜明对比 Auto的是，它根据列或行中的内容的大小均匀分布空间。 此值表示为 * 使用可扩展应用程序标记语言（XAML）或 2* 何时表示。 在第一种情况下，行或列将接收一次可用空间，而在第二种情况下，行或列将接收两倍的可用空间，依此等。 通过将此方法与 a HorizontalAlignment 和 VerticalAlignment 值 Stretch成比例地分布空间相结合，可以按屏幕空间百分比对布局空间进行分区。
Grid 是唯一能够以这种方式分配空间的布局面板。
默认情况下，行和列占用最少的空间，以容纳给定行或列中包含的任何单元格中的最大内容。 例如，如果列包含一个单元格，其中包含一个长字（如“hippopotamus”）的单元格，但列中的所有其他单元格都有较小的单词（如“dog”），则列的宽度将是最大单词（hippopotamus）的宽度。
通过使用属性和对齐属性的组合Margin，可以精确定位 a Grid 的子元素。
子 Grid 元素的绘制顺序以标记或代码中出现的顺序绘制。 因此，当元素共享相同的坐标时，可以实现分层顺序（也称为 z 顺序）。
Grid 并 Table 共享一些常见功能，但每个功能都可以在适当的方案中应用，以更好地使用其内置功能。 Grid 基于行和列索引添加元素; Table 不。 该 Grid 元素允许对内容进行分层，其中多个元素可以存在于单个单元格中。 Table 不支持分层。 相对于其“单元格”边界左上角，可以绝对定位某个 Grid 子元素。 Table 不支持此功能。 Grid 还提供比 Table. 更灵活的调整行为大小。
Grid使用GridLength对象定义或的大小ColumnDefinition调整特征RowDefinition。 有关每个单元类型的定义，请参阅 GridUnitType。
如果将子元素添加到某个 Grid列内，并且该列的属性 Width 设置为 Auto该列，则子元素将不受限制地测量。 此行为可以防止水平滚动条在正在使用时 ScrollViewer 显示，因为子元素被测量为未绑定。 出于显示目的，将剪切子级而不是滚动。
默认情况下，面板元素不会接收焦点。 若要强制面板元素接收焦点，请将 Focusable 属性设置为 true。
构造函数
| 名称 | 说明 |
|---|---|
| Grid() |
初始化 Grid 的新实例。 |
字段
| 名称 | 说明 |
|---|---|
| ColumnProperty |
标识 Column 附加属性。 |
| ColumnSpanProperty |
标识 ColumnSpan 附加属性。 |
| IsSharedSizeScopeProperty |
标识 IsSharedSizeScope 附加属性。 |
| RowProperty |
标识 Row 附加属性。 |
| RowSpanProperty |
标识 RowSpan 附加属性。 |
| ShowGridLinesProperty |
标识 ShowGridLines 依赖属性。 |
属性
| 名称 | 说明 |
|---|---|
| ActualHeight |
获取此元素的呈现高度。 (继承自 FrameworkElement) |
| ActualWidth |
获取此元素的呈现宽度。 (继承自 FrameworkElement) |
| AllowDrop |
获取或设置一个值，该值指示此元素是否可以用作拖放操作的目标。 这是依赖项属性。 (继承自 UIElement) |
| AreAnyTouchesCaptured |
获取一个值，该值指示是否至少捕获到此元素的一个触摸。 (继承自 UIElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示是否至少捕获一个触摸到此元素或其可视化树中的任何子元素。 (继承自 UIElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示是否在此元素上按下至少一次触摸。 (继承自 UIElement) |
| AreAnyTouchesOver |
获取一个值，该值指示是否在该元素或其可视化树中的任何子元素上按下至少一个触摸。 (继承自 UIElement) |
| Background |
获取或设置一个 Brush 用于填充边框之间的 Panel区域。 (继承自 Panel) |
| BindingGroup |
获取或设置 BindingGroup 用于元素的元素。 (继承自 FrameworkElement) |
| BitmapEffect |
已过时.
已过时.
获取或设置直接应用于此元素的呈现内容的位图效果。 这是依赖项属性。 (继承自 UIElement) |
| BitmapEffectInput |
已过时.
已过时.
获取或设置位图效果的输入源，该效果直接应用于此元素的呈现内容。 这是依赖项属性。 (继承自 UIElement) |
| CacheMode |
获取或设置缓存的 UIElement表示形式。 (继承自 UIElement) |
| Children |
UIElementCollection获取此Panel元素的子元素。 (继承自 Panel) |
| Clip |
获取或设置用于定义元素内容的轮廓的几何图形。 这是依赖项属性。 (继承自 UIElement) |
| ClipToBounds |
获取或设置一个值，该值指示是剪辑此元素的内容（还是来自此元素的子元素的内容），以适应包含元素的大小。 这是依赖项属性。 (继承自 UIElement) |
| ColumnDefinitions |
ColumnDefinitionCollection获取在此实例Grid上定义的 。 |
| CommandBindings |
获取与此元素关联的对象的集合 CommandBinding 。 启用 CommandBinding 此元素的命令处理，并声明命令、其事件和此元素附加的处理程序之间的链接。 (继承自 UIElement) |
| ContextMenu |
获取或设置上下文菜单元素，该元素应在通过用户界面（UI）从此元素中请求上下文菜单时显示。 (继承自 FrameworkElement) |
| Cursor |
获取或设置当鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkElement) |
| DefaultStyleKey |
获取或设置用于引用此控件的样式的键，当使用或定义主题样式时。 (继承自 FrameworkElement) |
| DependencyObjectType |
获取包装 DependencyObjectType 此实例的 CLR 类型。 (继承自 DependencyObject) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 UIElement) |
| Dispatcher |
获取与此DispatcherDispatcherObject关联的值。 (继承自 DispatcherObject) |
| Effect |
获取或设置要应用于的 UIElement位图效果。 这是依赖项属性。 (继承自 UIElement) |
| FlowDirection |
获取或设置文本和其他用户界面（UI）元素在控制布局的任何父元素中流动的方向。 (继承自 FrameworkElement) |
| Focusable |
获取或设置一个值，该值指示元素是否可以接收焦点。 这是依赖项属性。 (继承自 UIElement) |
| FocusVisualStyle |
获取或设置一个属性，该属性允许自定义在捕获键盘焦点时应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkElement) |
| ForceCursor |
获取或设置一个值，该值指示这是否 FrameworkElement 应强制用户界面（UI）呈现由属性声明的 Cursor 游标。 (继承自 FrameworkElement) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何动画属性。 (继承自 UIElement) |
| HasEffectiveKeyboardFocus |
获取一个值，该值指示是否 UIElement 具有焦点。 (继承自 UIElement) |
| HasLogicalOrientation |
获取一个值，该值指示它 Panel 是否在单个维度中排列其后代。 (继承自 Panel) |
| HasLogicalOrientationPublic |
获取一个值，该值指示它 Panel 是否在单个维度中排列其后代。 (继承自 Panel) |
| Height |
获取或设置元素的建议高度。 (继承自 FrameworkElement) |
| HorizontalAlignment |
获取或设置在父元素（如面板或项控件）内组合时应用于此元素的水平对齐特征。 (继承自 FrameworkElement) |
| InheritanceBehavior |
获取或设置属性值继承、资源键查找和 RelativeSource FindAncestor 查找的范围限制。 (继承自 FrameworkElement) |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 UIElement) |
| InputScope |
获取或设置此 FrameworkElement输入的上下文。 (继承自 FrameworkElement) |
| InternalChildren |
UIElementCollection获取子元素。 (继承自 Panel) |
| IsArrangeValid |
获取一个值，该值指示此元素布局中子元素的计算大小和位置是否有效。 (继承自 UIElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面（UI）中启用此元素。 这是依赖项属性。 (继承自 UIElement) |
| IsEnabledCore |
获取一个值，该值将成为派生类中的返回值 IsEnabled 。 (继承自 UIElement) |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 这是依赖项属性。 (继承自 UIElement) |
| IsHitTestVisible |
获取或设置一个值，该值声明此元素是否可以作为其呈现内容的某些部分的命中测试结果返回。 这是依赖项属性。 (继承自 UIElement) |
| IsInitialized |
获取一个值，该值指示此元素是在 XAML 处理器处理期间还是显式调用其 EndInit() 方法进行初始化。 (继承自 FrameworkElement) |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用输入法系统（如输入法编辑器（IME）来处理此元素的输入。 (继承自 UIElement) |
| IsItemsHost |
获取或设置一个值，该值指示这是 Panel 由用户界面（UI）项生成的 ItemsControl容器。 (继承自 Panel) |
| 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) |
| LogicalChildren |
获取可循环访问此 Grid逻辑子项的枚举数。 |
| LogicalOrientation |
如果 Orientation 面板仅支持单个维度中的布局，则面板的面板。 (继承自 Panel) |
| LogicalOrientationPublic |
如果 Orientation 面板仅支持单个维度中的布局，则面板的面板。 (继承自 Panel) |
| Margin |
获取或设置元素的外部边距。 (继承自 FrameworkElement) |
| MaxHeight |
获取或设置元素的最大高度约束。 (继承自 FrameworkElement) |
| MaxWidth |
获取或设置元素的最大宽度约束。 (继承自 FrameworkElement) |
| MinHeight |
获取或设置元素的最小高度约束。 (继承自 FrameworkElement) |
| MinWidth |
获取或设置元素的最小宽度约束。 (继承自 FrameworkElement) |
| Name |
获取或设置元素的标识名称。 该名称提供引用，以便代码隐藏（如事件处理程序代码）可以在 XAML 处理器处理期间构造标记元素后引用它。 (继承自 FrameworkElement) |
| Opacity |
获取或设置在用户界面（UI）中呈现时应用于整个 UIElement 的不透明度因子。 这是依赖项属性。 (继承自 UIElement) |
| OpacityMask |
获取或设置不透明度掩码，作为 Brush 应用于此元素呈现内容的任何 alpha 通道掩码的实现。 这是依赖项属性。 (继承自 UIElement) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否包含主题样式中的样式属性。 (继承自 FrameworkElement) |
| Parent |
获取此元素的逻辑父元素。 (继承自 FrameworkElement) |
| PersistId |
已过时.
获取唯一标识此元素的值。 (继承自 UIElement) |
| RenderSize |
获取（或设置）此元素的最终呈现大小。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响此元素呈现位置的转换信息。 这是依赖项属性。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置由元素边界声明 RenderTransform的任何可能呈现转换的中心点。 这是依赖项属性。 (继承自 UIElement) |
| Resources |
获取或设置本地定义的资源字典。 (继承自 FrameworkElement) |
| RowDefinitions |
RowDefinitionCollection获取在此实例Grid上定义的 。 |
| ShowGridLines |
获取或设置一个值，该值指示网格线是否在此范围内 Grid可见。 |
| SnapsToDevicePixels |
获取或设置一个值，该值确定此元素的呈现是否应在呈现过程中使用特定于设备的像素设置。 这是依赖项属性。 (继承自 UIElement) |
| Style |
获取或设置呈现时此元素使用的样式。 (继承自 FrameworkElement) |
| StylusPlugIns |
获取与此元素关联的所有触笔插件（自定义）对象的集合。 (继承自 UIElement) |
| Tag |
获取或设置可用于存储有关此元素的自定义信息的任意对象值。 (继承自 FrameworkElement) |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果未通过模板创建元素，则此属性不相关。 (继承自 FrameworkElement) |
| ToolTip |
获取或设置用户界面 （UI） 中为此元素显示的工具提示对象。 (继承自 FrameworkElement) |
| TouchesCaptured |
获取捕获到此元素的所有触摸设备。 (继承自 UIElement) |
| TouchesCapturedWithin |
获取捕获到此元素的所有触摸设备或其可视化树中的任何子元素。 (继承自 UIElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 UIElement) |
| TouchesOver |
获取位于此元素上的所有触摸设备或其可视化树中的任何子元素。 (继承自 UIElement) |
| Triggers |
获取直接在此元素或子元素上建立的触发器的集合。 (继承自 FrameworkElement) |
| Uid |
获取或设置此元素的唯一标识符（用于本地化）。 这是依赖项属性。 (继承自 UIElement) |
| UseLayoutRounding |
获取或设置一个值，该值指示布局舍入是否应用于布局期间此元素的大小和位置。 (继承自 FrameworkElement) |
| VerticalAlignment |
获取或设置在父元素（如面板或项控件）内组合时应用于此元素的垂直对齐特征。 (继承自 FrameworkElement) |
| Visibility |
获取或设置此元素的用户界面（UI）可见性。 这是依赖项属性。 (继承自 UIElement) |
| VisualBitmapEffect |
已过时.
已过时.
获取或设置 BitmapEffectVisual.. (继承自 Visual) |
| VisualBitmapEffectInput |
已过时.
已过时.
获取或设置 BitmapEffectInputVisual.. (继承自 Visual) |
| VisualBitmapScalingMode |
获取或设置 .BitmapScalingModeVisual (继承自 Visual) |
| VisualCacheMode |
获取或设置缓存的 Visual表示形式。 (继承自 Visual) |
| VisualChildrenCount | |
| VisualClearTypeHint |
获取或设置 ClearTypeHint 确定 ClearType 在 Visual中的呈现方式。 (继承自 Visual) |
| VisualClip | (继承自 Visual) |
| VisualEdgeMode | (继承自 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) |
附加属性
| 名称 | 说明 |
|---|---|
| Column |
获取或设置一个值，该值指示应在其中 Grid 显示哪个列子内容。 |
| ColumnSpan |
获取或设置一个值，该值指示子内容在一个 Grid范围内跨越的列总数。 |
| IsSharedSizeScope |
获取或设置一个值，该值指示多个 Grid 元素共享大小信息。 |
| Row |
获取或设置一个值，该值指示应在其中 Grid 显示哪个行子内容。 |
| RowSpan |
获取或设置一个值，该值指示子内容在一个 Grid范围内跨越的行总数。 |
方法
活动
| 名称 | 说明 |
|---|---|
| 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 |
在此元素上 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） 基础结构，不打算直接从代码使用。 |
| IAddChild.AddText(String) |
此类型或成员支持 Windows Presentation Foundation （WPF） 基础结构，不打算直接从代码使用。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参阅 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkElement) |
