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包含 位於 屬性中的 Children 物件集合 UIElement 。
內 Grid 定義的資料行和資料列可以利用 Star 調整大小來按比例分配剩餘的空間。 當 Star 選取 為數據列或資料行的高度或寬度時，該資料行或資料列會收到剩餘可用空間的加權比例。 這與 Auto 相反地，它會根據資料行或資料列內的內容大小平均分配空間。 當您使用 Extensible Application Markup Language (XAML) 時，此值會以 或 2* 表示 * 。 在第一個案例中，資料列或資料行會收到一倍的可用空間，而在第二個案例中，資料列或資料行會收到兩倍的可用空間，依此類推斷。 藉由結合這項技術，將空間 HorizontalAlignment 與 和 VerticalAlignment 值 Stretch 成正比分配，即可依螢幕空間百分比分割版面配置空間。
Grid 是唯一可以以這種方式散發空間的版面配置面板。
根據預設，資料列和資料行會佔用最少的空間，以容納指定資料列或資料行中包含的任何儲存格內的最大內容。 例如，如果資料行有一個包含長字的儲存格，例如內含 「hippopotamus」，但資料行中所有其他儲存格都有較小的字組，例如 「dog」，則資料行的寬度會是最大單字的寬度， (hippopotamus) 。
您可以使用 屬性和對齊屬性的組合 Margin ，精確地定位 的 Grid 子項目。
的 Grid 子專案會以標記或程式碼中出現的順序繪製。 因此，當元素共用相同的座標時，可以達到分層順序 (也稱為迭置順序) 。
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 |
取得這個 Grid 執行個體上所定義的 ColumnDefinitionCollection。 |
| 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) |
| 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 |
取得值，指出是否啟用輸入法編輯器 (輸入法) 等輸入法系統來處理此專案的輸入。 (繼承來源 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 |
取得或設定套用至任何 Alpha 色板遮罩 (用來遮住此項目的呈現內容) 時實作 Brush 的不透明度遮罩。 這是相依性屬性。 (繼承來源 UIElement) |
| OverridesDefaultStyle |
取得或設定此元素的樣式屬性是否來自佈景主題樣式的值。 (繼承來源 FrameworkElement) |
| Parent |
取得這個專案的邏輯父元素。 (繼承來源 FrameworkElement) |
| PersistId |
已淘汰.
取得值，這個值可唯一識別此項目。 (繼承來源 UIElement) |
| RenderSize |
取得 (或設定) 這個項目的最終呈現大小。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定影響這個項目呈現位置的轉換資訊。 這是相依性屬性。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform (相對於項目邊界) 宣告任何可能呈現轉換的中心點。 這是相依性屬性。 (繼承來源 UIElement) |
| Resources |
取得或設定在本機定義的資源字典。 (繼承來源 FrameworkElement) |
| RowDefinitions |
取得這個 Grid 執行個體上所定義的 RowDefinitionCollection。 |
| 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 |
已淘汰.
已淘汰.
取得或設定 BitmapEffect 的 Visual 值。 (繼承來源 Visual) |
| VisualBitmapEffectInput |
已淘汰.
已淘汰.
取得或設定 BitmapEffectInput 的 Visual 值。 (繼承來源 Visual) |
| VisualBitmapScalingMode |
取得或設定 BitmapScalingMode 的 Visual。 (繼承來源 Visual) |
| VisualCacheMode |
取得或設定 Visual 的快取表示。 (繼承來源 Visual) |
| VisualChildrenCount | |
| 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) |
附加屬性
| 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) |
