Grid 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義彈性的格線區域,由欄與列組成。 Grid 的子元素會根據其數據列/數據行指派來測量和排列, (使用 Grid.Row 和 Grid.Column 附加屬性) 和其他邏輯來設定。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Grid : Panel
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Grid : Panel
Public Class Grid
Inherits Panel
<Grid ...>
oneOrMoreUIElements
</Grid>
-or-
<Grid .../>
- 繼承
- 衍生
- 屬性
範例
提示
如需詳細資訊、設計指引和程式碼範例,請參閱 版面配置面板。
WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式,或在 GitHub 上取得原始程式碼。
這個 XAML 範例示範如何使用 Grid 設計版面配置。
<Grid x:Name="LayoutRoot" Background="#555555"
Width="400" Height="300"
ColumnDefinitions="250, 150"
RowDefinitions="Auto, 2*, *">
<TextBlock Grid.Row="0" Grid.Column="0"
Grid.ColumnSpan="2"
Margin="10" FontWeight="Bold"
Text="Contoso Corporation"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
<Grid x:Name="FormLayoutGrid" Grid.Row="1" Grid.Column="0">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto" />
<ColumnDefinition />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition Height="*" />
<RowDefinition Height="*" />
<RowDefinition Height="*" />
</Grid.RowDefinitions>
<TextBlock Grid.Row="0" Grid.Column="0" Text="First Name" Margin="10"
HorizontalAlignment="Left" VerticalAlignment="Center" />
<TextBox Grid.Row="0" Grid.Column="1" Margin="10" />
<TextBlock Grid.Row="1" Grid.Column="0" Text="Last Name" Margin="10"
HorizontalAlignment="Left" VerticalAlignment="Center" />
<TextBox Grid.Row="1" Grid.Column="1" Margin="10" />
<TextBlock Grid.Row="2" Grid.Column="0" Text="Address" Margin="10"
HorizontalAlignment="Left" VerticalAlignment="Center" />
<TextBox Grid.Row="2" Grid.Column="1" Margin="10" />
</Grid>
</Grid>
public MainPage()
{
this.InitializeComponent();
LayoutDesign();
}
private void LayoutDesign()
{
//Create Stackpanel for ListBox Control and its description
StackPanel DeptStackPanel = new StackPanel();
DeptStackPanel.Margin = new Thickness(10);
LayoutRoot.Children.Add(DeptStackPanel);
Grid.SetColumn(DeptStackPanel, 1);
Grid.SetRow(DeptStackPanel, 1);
TextBlock DeptListHeading = new TextBlock();
DeptListHeading.Text = "Department";
ListBox DeptList = new ListBox();
DeptList.Items.Add("Finance");
DeptList.Items.Add("Marketing");
DeptList.Items.Add("Human Resources");
DeptList.Items.Add("Payroll");
DeptStackPanel.Children.Add(DeptListHeading);
DeptStackPanel.Children.Add(DeptList);
//Create StackPanel for buttons
StackPanel ButtonsStackPanel = new StackPanel();
ButtonsStackPanel.Margin = new Thickness(10);
ButtonsStackPanel.Orientation = Orientation.Horizontal;
ButtonsStackPanel.HorizontalAlignment = HorizontalAlignment.Center;
LayoutRoot.Children.Add(ButtonsStackPanel);
Grid.SetColumn(ButtonsStackPanel, 0);
Grid.SetRow(ButtonsStackPanel, 2);
Grid.SetColumnSpan(ButtonsStackPanel, 2);
Button BackButton = new Button();
BackButton.Content = "Back";
BackButton.Width = 100;
Button CancelButton = new Button();
CancelButton.Content = "Cancel";
CancelButton.Width = 100;
Button NextButton = new Button();
NextButton.Content = "Next";
NextButton.Width = 100;
ButtonsStackPanel.Children.Add(BackButton);
ButtonsStackPanel.Children.Add(CancelButton);
ButtonsStackPanel.Children.Add(NextButton);
BackButton.Margin = new Thickness(10);
CancelButton.Margin = new Thickness(10);
NextButton.Margin = new Thickness(10);
}
}
備註
提示
如需詳細資訊、設計指引和程式碼範例,請參閱 版面配置面板。
Grid 是一種配置面板,可支援排列數據列和數據行中的子元素。
![格線配置面板](microsoft.ui.xaml.controls/images/controls/grid.png?view=windows-app-sdk-1.5)
您通常會在 XAML 中定義 Grid 的配置行為,方法是提供一或多個 RowDefinition 元素做為 Grid.RowDefinitions 的值,以及一或多個 ColumnDefinition 元素做為 Grid.ColumnDefinitions 的值。 然後,您會將 Grid.Row 和 Grid.Column 附加屬性套用至 Grid 的每個元素子系,以指出要使用哪一個數據列/數據行組合將該元素放在父方格內。
若要設定數據列的高度和數據行的寬度,您可以為每個 ColumnDefinition 設定 RowDefinition.Height 和 ColumnDefinition.Width。 ColumnDefinition.Width 和 RowDefinition.Height 是 ColumnDefinition 和 RowDefinition 的個別內容屬性。
根據預設,每個數據列或數據行會平均分割版面配置空間。 您可以藉由提供絕對圖元值,或使用加權因數來分割可用空間的 星 形重設大小來變更此行為。 如需如何在 Grid 中使用星形重設大小的詳細資訊,請參閱使用 XAML 或 GridLength定義版面配置。 您也可以使用大小調整為內容的 自動 重設大小。
請注意,有兩種方式可以定義 Grid。 如果您只定義數據列和數據行 ,而不 使用數據系結或定義 MinHeight 或 MaxWidth 等屬性,您可以使用下列簡潔語法:
<Grid ColumnDefinitions="1*, 2*, Auto, 5"
RowDefinitions="1*, Auto, 5, 3, 1">
<!-- Grid content goes here -->
</Grid>
如果您需要在 Grid 定義中新增更多詳細數據,例如在數據列/資料行定義中提供數據列的 MaxHeight 或使用數據系結,您應該使用原始、完整的 Grid 語法:
<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition MaxWidth="30"/>
<ColumnDefinition Width="*"/>
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition Height="{x:Bind RowHeight}"/>
<RowDefinition Height="{x:Bind RowHeight}"/>
</Grid.RowDefinitions>
<!-- Grid content goes here -->
</Grid>
若要指出元素子應該跨越 Grid 中的多個資料列或多個數據行,您可以將 Grid.RowSpan 或 Grid.ColumnSpan 附加屬性套用至 Grid 的子元素。
根據預設,Grid 包含一個數據列和一個數據行。
在 Grid 中的子元素上設定 Margin 屬性,會設定元素與其方格單元格界限之間的距離。 HorizontalAlignment 和 VerticalAlignment 屬性描述子元素應該如何放置在方格單元格內。 您可以使用 Margin 屬性和對齊屬性的組合,精確地定位 Grid 的子元素。 如果您需要更充分掌控個別子元素的配置,請考慮使用 VariableSizedWrapGrid。
WrapGrid 是另一個類似的版面配置面板,其優點是較佳地處理過寬的內容,可能會根據其他版面配置屬性的值,由一般 Grid 裁剪。
跨越多個數據列之第一個數據行中的元素可能會影響每個跨越數據列的高度,即使第一個數據列具有足夠的高度來容納元素,後續跨越的數據列也會有0的高度。 例如,此 Grid 中的第二個數據列的高度設定為 0,因此通常看不到藍色矩形。 在此情況下,您可能會預期紅色橢圓形不會影響第二個數據列,因為第一個數據列夠高,足以包含橢圓形。 不過,Grid 會計算每個數據列的 MinHeight 足以容納紅色省略號,然後跨數據列跨越元素。 因此,第二個數據列的MinHeight為50,紅色橢圓形會置中於150px範圍中,而藍色矩形的一半則會顯示在第二個數據列中。
注意
(此範例會使用跨越數據行的專案,但也適用於跨越多個數據列之第一個數據行中的元素。)
<Grid Background="Yellow" Width="300"
ColumnDefinitions="50, *" RowDefinitions="Auto, 0">
<Ellipse Grid.Row="0" Grid.Column="0" Height="50" Fill="Red" Grid.RowSpan="2"/>
<Rectangle Grid.Row="0" Grid.Column="1" Fill="Green" Height="100"/>
<Rectangle Grid.Row="1" Grid.Column="1" Fill="Blue" Height="100"/>
</Grid>
框線屬性
Grid 會定義框線屬性,讓您在 Grid 周圍繪製框線,而不需使用額外的 Border 元素。 這些屬性為 Grid.BorderBrush、 Grid.BorderThickness、 Grid.CornerRadius 和 Grid.Padding。
<Grid BorderBrush="Red" BorderThickness="2" CornerRadius="10" Padding="12">
<TextBlock Text="Hello World!"/>
</Grid>
方格 衍生類別
Grid 是 SwapChainPanel 和 SwapChainBackgroundPanel 的父類別。
XAML 附加屬性
Grid 是數個 XAML 附加屬性的主機服務類別。 這些附加屬性可讓子元素報告它們應該如何放置在其 Grid 父系中。
為了支援 XAML 處理器對附加屬性的存取,以及公開對等 的 get 和 set 作業給程式代碼,每個 XAML 附加屬性都有一對 Get 和 Set 存取子方法。 在程序代碼中取得或設定值的另一種方式是使用相依性屬性系統,呼叫 GetValue 或 SetValue 並將識別符字段傳遞為相依性屬性識別碼。
附加屬性 | 描述 |
---|---|
資料行 | 當父方格配置容器處理子配置時,取得或設定元素的數據行對齊方式。
|
ColumnSpan | 取得或設定值,這個值表示元素內容在父方格內跨越的數據行總數。
|
資料列 | 取得或設定父方格配置容器處理子版面配置時元素的數據列對齊方式。
|
RowSpan | 取得或設定值,這個值表示元素內容在父方格內跨越的數據列總數。
|
建構函式
Grid() |
初始化 Grid 類別的新實例。 |
屬性
AccessKey |
取得或設定這個專案的訪問鍵 (助記鍵) 。 (繼承來源 UIElement) |
AccessKeyScopeOwner |
取得或設定提供這個專案存取索引鍵範圍的來源專案,即使它不在來源專案的可視化樹狀結構中也一樣。 (繼承來源 UIElement) |
ActualHeight |
取得 FrameworkElement 的呈現高度。 請參閱<備註>。 (繼承來源 FrameworkElement) |
ActualOffset |
取得這個 UIElement 的位置,相對於其父系,在配置程式的排列階段期間計算。 (繼承來源 UIElement) |
ActualSize |
取得此 UIElement 在配置程式的排列階段期間計算的大小。 (繼承來源 UIElement) |
ActualTheme |
取得專案目前使用的UI主題,可能與 RequestedTheme不同。 (繼承來源 FrameworkElement) |
ActualWidth |
取得 FrameworkElement 的呈現寬度。 請參閱<備註>。 (繼承來源 FrameworkElement) |
AllowDrop |
取得或設定值,這個值會決定此 UIElement 是否可為拖放作業的置放目標。 (繼承來源 UIElement) |
AllowFocusOnInteraction |
取得或設定值,這個值表示當使用者與其互動時,專案是否會自動取得焦點。 (繼承來源 FrameworkElement) |
AllowFocusWhenDisabled |
取得或設定停用的控制項是否可以接收焦點。 (繼承來源 FrameworkElement) |
Background |
取得或設定填滿面板內容區域的 Brush 。 (繼承來源 Panel) |
BackgroundSizing |
取得或設定值,這個值表示背景相對於這個專案框線的延伸距離。 |
BackgroundSizingProperty |
識別 BackgroundSizing 相依性屬性。 |
BackgroundTransition |
取得或設定 BrushTransition 的實例,以自動建立 Background 屬性變更的動畫效果。 (繼承來源 Panel) |
BaseUri |
取得統一資源識別元 (URI) ,代表 XAML 載入時間 XAML 建構物件的基底 URI。 此屬性適用於運行時間的 URI 解析。 (繼承來源 FrameworkElement) |
BorderBrush |
取得或設定筆刷,描述面板的框線填滿。 |
BorderBrushProperty |
識別 BorderBrush 相依性屬性。 |
BorderThickness |
取得或設定面板的框線粗細。 |
BorderThicknessProperty |
識別 BorderThickness 相依性屬性。 |
CacheMode |
取得或設定值,這個值表示盡可能將轉譯的內容快取為復合位圖。 (繼承來源 UIElement) |
CanBeScrollAnchor |
取得或設定值,這個值表示 UIElement 是否可為卷動錨定候選專案。 (繼承來源 UIElement) |
CanDrag |
取得或設定值,這個值表示是否可以將專案拖曳為拖放作業中的數據。 (繼承來源 UIElement) |
CenterPoint |
取得或設定專案的中心點,也就是發生旋轉或縮放的點。 影響項目的轉譯位置。 (繼承來源 UIElement) |
Children |
取得面板子專案的集合。 (繼承來源 Panel) |
ChildrenTransitions |
取得或設定套用至 Panel 子類別子內容的 Transition 樣式專案集合。 (繼承來源 Panel) |
Clip |
取得或設定用來定義UIElement內容的大綱的 RectangleGeometry。 (繼承來源 UIElement) |
ColumnDefinitions |
取得在此 Grid 實例上定義的 ColumnDefinition 物件清單。 |
ColumnProperty |
識別 Grid.Column XAML 附加屬性。 |
ColumnSpacing |
取得或設定網格線數據行之間) 圖元 (的統一距離。 |
ColumnSpacingProperty |
識別 ColumnSpacing 相依性屬性。 |
ColumnSpanProperty |
識別 Grid.ColumnSpan XAML 附加屬性。 |
CompositeMode |
取得或設定屬性,這個屬性會宣告其父版面配置和視窗中專案的替代組合和混合模式。 這與混合 XAML/Microsoft DirectX UI 相關的元素相關。 (繼承來源 UIElement) |
ContextFlyout |
取得或設定與這個項目相關聯的飛出視窗。 (繼承來源 UIElement) |
CornerRadius |
取得或設定面板框線角落的半徑。 |
CornerRadiusProperty |
識別 CornerRadius 相依性屬性。 |
DataContext |
取得或設定 FrameworkElement 的數據內容。 數據內容的常見用法是當 |
DesiredSize |
取得此 UIElement 在版面配置程式的量值階段期間計算的大小。 (繼承來源 UIElement) |
Dispatcher |
一律會在 Windows 應用程式 SDK 應用程式中傳 |
DispatcherQueue |
|
ExitDisplayModeOnAccessKeyInvoked |
取得或設定值,這個值會指定叫用存取金鑰時,是否關閉存取密鑰顯示。 (繼承來源 UIElement) |
FlowDirection |
取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 |
FocusState |
取得值,這個值會指定這個控件是否有焦點,以及取得焦點的模式。 (繼承來源 UIElement) |
FocusVisualMargin |
取得或設定 FrameworkElement 焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
FocusVisualPrimaryBrush |
取得或設定筆刷,用來繪製 FrameworkElement 之或 |
FocusVisualPrimaryThickness |
取得或設定 FrameworkElement 之外部 |
FocusVisualSecondaryBrush |
取得或設定筆刷,用來繪製 FrameworkElement 之或 |
FocusVisualSecondaryThickness |
取得或設定 FrameworkElement 之 |
Height |
取得或設定 FrameworkElement 的建議高度。 (繼承來源 FrameworkElement) |
HighContrastAdjustment |
取得或設定值,這個值表示當啟用高對比度主題時,架構是否會自動調整專案的視覺屬性。 (繼承來源 UIElement) |
HorizontalAlignment |
取得或設定在版面配置父系中撰寫時套用至 FrameworkElement 的水準對齊特性,例如面板或專案控件。 (繼承來源 FrameworkElement) |
IsAccessKeyScope |
取得或設定值,這個值表示專案是否定義自己的訪問鍵範圍。 (繼承來源 UIElement) |
IsDoubleTapEnabled |
取得或設定值,這個值會判斷 DoubleTapped 事件是否可能來自該專案。 (繼承來源 UIElement) |
IsHitTestVisible |
取得或設定這個 UIElement 的包含區域是否可以傳回 true 值來進行點擊測試。 (繼承來源 UIElement) |
IsHoldingEnabled |
取得或設定值,這個值會判斷 Holding 事件是否可以來自該專案。 (繼承來源 UIElement) |
IsItemsHost |
取得值,指出此 面板 是否為 ItemsControl 所產生的 UI 專案的容器。 (繼承來源 Panel) |
IsLoaded |
取得值,這個值表示專案是否已加入至專案樹狀結構,且已準備好進行互動。 (繼承來源 FrameworkElement) |
IsRightTapEnabled |
取得或設定值,這個值會判斷 RightTapped 事件是否可能來自該專案。 (繼承來源 UIElement) |
IsTabStop |
取得或設定值,這個值表示控制項是否包含於索引標籤巡覽。 (繼承來源 UIElement) |
IsTapEnabled |
取得或設定值,這個值會判斷 Tapped 事件是否可能來自該專案。 (繼承來源 UIElement) |
KeyboardAcceleratorPlacementMode |
取得或設定值,這個值表示控件 工具提示 是否顯示其相關聯鍵盤快捷方式的按鍵組合。 (繼承來源 UIElement) |
KeyboardAcceleratorPlacementTarget |
取得或設定值,這個值表示顯示快速鍵組合的控件 工具提示 。 (繼承來源 UIElement) |
KeyboardAccelerators |
取得使用鍵盤叫用動作的按鍵組合集合。 快捷鍵通常會指派給按鈕或功能表項。
|
KeyTipHorizontalOffset |
取得或設定值,這個值表示相對於UIElement放置按鍵提示的左邊或右邊。 (繼承來源 UIElement) |
KeyTipPlacementMode |
取得或設定值,這個值表示相對於UIElement界限放置訪問鍵按鍵提示的位置。 (繼承來源 UIElement) |
KeyTipTarget |
取得或設定值,這個值表示以訪問鍵提示為目標的專案。 (繼承來源 UIElement) |
KeyTipVerticalOffset |
取得或設定值,這個值表示相對於UI元素放置按鍵提示的上下距離。 (繼承來源 UIElement) |
Language |
取得或設定套用至 FrameworkElement 的當地語系化/全球化語言資訊,以及套用至物件表示法和 UI 中目前 FrameworkElement 的所有子元素。 (繼承來源 FrameworkElement) |
Lights |
取得附加至這個專案的 XamlLight 物件集合。 (繼承來源 UIElement) |
ManipulationMode |
取得或設定用於UIElement行為與手勢互動的ManipulationModes值。 設定此值可讓您處理來自應用程式程式碼中這個專案的操作事件。 (繼承來源 UIElement) |
Margin |
取得或設定 FrameworkElement 的外部邊界。 (繼承來源 FrameworkElement) |
MaxHeight |
取得或設定 FrameworkElement 的最大高度條件約束。 (繼承來源 FrameworkElement) |
MaxWidth |
取得或設定 FrameworkElement 的最大寬度條件約束。 (繼承來源 FrameworkElement) |
MinHeight |
取得或設定 FrameworkElement 的最小高度條件約束。 (繼承來源 FrameworkElement) |
MinWidth |
取得或設定 FrameworkElement 的最小寬度條件約束。 (繼承來源 FrameworkElement) |
Name |
取得或設定對象的識別名稱。 當 XAML 處理器從 XAML 標記建立物件樹狀結構時,運行時間程式代碼可以依這個名稱參考 XAML 宣告的物件。 (繼承來源 FrameworkElement) |
Opacity |
取得或設定物件的不透明度程度。 (繼承來源 UIElement) |
OpacityTransition |
取得或設定 ScalarTransition,以動畫顯示 Opacity 屬性的變更。 (繼承來源 UIElement) |
Padding |
取得或設定框線與其子對象之間的距離。 |
PaddingProperty |
識別 Padding 相依性屬性。 |
Parent |
取得物件樹狀結構中這個 FrameworkElement 的父物件。 (繼承來源 FrameworkElement) |
PointerCaptures |
取得所有擷取指標的集合,表示為 指標 值。 (繼承來源 UIElement) |
Projection |
取得或設定轉譯這個專案時要套用的 3D 效果) (3D 效果。 (繼承來源 UIElement) |
ProtectedCursor |
取得或設定指標在這個專案上方時所顯示的游標。 默認值為 null,表示數據指標沒有變更。 (繼承來源 UIElement) |
RasterizationScale |
取得值,表示每個檢視圖元的原始 (實體) 像素數目。 (繼承來源 UIElement) |
RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用,請參閱。 (繼承來源 UIElement) |
RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
RenderTransformOrigin |
取得或設定 RenderTransform 所宣告之任何可能轉譯轉換的原點,相對於 UIElement 的界限。 (繼承來源 UIElement) |
RequestedTheme |
取得或設定 UIElement (及其子元素所使用的 UI 主題,) 資源判斷。 您指定的 |
Resources |
取得本機定義的資源字典。 在 XAML 中,您可以透過 XAML 隱含集合語法,將資源專案建立為屬性元素的 |
Rotation |
取得或設定順時針旋轉的角度,以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響項目的轉譯位置。 (繼承來源 UIElement) |
RotationAxis |
取得或設定座標軸,以繞著旋轉專案。 (繼承來源 UIElement) |
RotationTransition |
取得或設定 ScalarTransition,以動畫顯示 Rotation 屬性的變更。 (繼承來源 UIElement) |
RowDefinitions |
取得在此 Grid 實例上定義的 RowDefinition 物件清單。 |
RowProperty |
識別 Grid.Row XAML 附加屬性。 |
RowSpacing |
取得或設定網格線列之間) 像素 (的統一距離。 |
RowSpacingProperty |
識別 RowSpacing 相依性屬性。 |
RowSpanProperty |
識別 Grid.RowSpan XAML 附加屬性。 |
Scale |
取得或設定專案的刻度。 相對於專案的 CenterPoint 進行調整。 影響項目的轉譯位置。 (繼承來源 UIElement) |
ScaleTransition |
取得或設定 Vector3Transition,以動畫顯示 Scale 屬性的變更。 (繼承來源 UIElement) |
Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
Style |
取得或設定配置和轉譯期間,針對這個物件套用的實例 Style 。 (繼承來源 FrameworkElement) |
TabFocusNavigation |
取得或設定值,這個值會修改Tabbing和 TabIndex 對此控件的運作方式。 (繼承來源 UIElement) |
TabIndex |
取得或設定值,決定當使用者使用 Tab 鍵瀏覽控制項時,元素接收焦點的順序。 (繼承來源 UIElement) |
Tag |
取得或設定可用來儲存此物件之自定義資訊的任意物件值。 (繼承來源 FrameworkElement) |
Transform3D |
取得或設定轉譯這個專案時要套用的 3D 轉換效果。 (繼承來源 UIElement) |
TransformMatrix |
取得或設定要套用至項目的轉換矩陣。 (繼承來源 UIElement) |
Transitions |
取得或設定套用至 UIElement 的 Transition 樣式專案集合。 (繼承來源 UIElement) |
Translation |
取得或設定專案的 x、y 和 z 轉譯位置。 (繼承來源 UIElement) |
TranslationTransition |
取得或設定 Vector3Transition,以動畫顯示 Translation 屬性的變更。 (繼承來源 UIElement) |
Triggers |
取得針對 FrameworkElement 定義的動畫觸發程式集合。 不常使用。 請參閱<備註>。 (繼承來源 FrameworkElement) |
UseLayoutRounding |
取得或設定值,這個值會決定物件及其視覺子樹的轉譯是否應該使用四捨五入行為,將轉譯對齊整個圖元。 (繼承來源 UIElement) |
UseSystemFocusVisuals |
取得或設定值,這個值表示控件是否使用由系統繪製的焦點視覺效果,或控件範本中定義的焦點視覺效果。 (繼承來源 UIElement) |
VerticalAlignment |
取得或設定垂直對齊特性,當 FrameworkElement 是由面板或專案控件等父物件所組成時套用至 FrameworkElement 。 (繼承來源 FrameworkElement) |
Visibility |
取得或設定 UIElement的可見性。
|
Width |
取得或設定 FrameworkElement 的寬度。 (繼承來源 FrameworkElement) |
XamlRoot |
取得或設定 |
XYFocusDown |
取得或設定當使用者按下遊戲控制器的 Directional Pad (D-pad) 時取得焦點的物件。 (繼承來源 UIElement) |
XYFocusDownNavigationStrategy |
取得或設定值,指定用來判斷向下導覽目標元素的策略。 (繼承來源 UIElement) |
XYFocusKeyboardNavigation |
取得或設定值,這個值會啟用或停用使用鍵盤方向箭號的流覽。 (繼承來源 UIElement) |
XYFocusLeft |
取得或設定當用戶在遊戲控制器的 Directional Pad (D-pad) 左鍵時取得焦點的物件。 (繼承來源 UIElement) |
XYFocusLeftNavigationStrategy |
取得或設定值,指定用來判斷左側導覽目標元素的策略。 (繼承來源 UIElement) |
XYFocusRight |
取得或設定當使用者在遊戲控制器的 Directional Pad (D-pad) 上按下滑鼠右鍵時取得焦點的物件。 (繼承來源 UIElement) |
XYFocusRightNavigationStrategy |
取得或設定值,指定用來判斷右導覽之目標元素的策略。 (繼承來源 UIElement) |
XYFocusUp |
取得或設定當使用者按下遊戲控制器的 Directional Pad (D-pad) 時取得焦點的物件。 (繼承來源 UIElement) |
XYFocusUpNavigationStrategy |
取得或設定值,指定用來判斷向上瀏覽目標元素的策略。 (繼承來源 UIElement) |
附加屬性
Column |
取得或設定父方格配置容器處理子版面配置時元素的數據行對齊方式。 |
ColumnSpan |
取得或設定值,這個值表示元素內容在父方格內跨越的數據行總數。 |
Row |
取得或設定父方格配置容器處理子版面配置時元素的數據列對齊方式。 |
RowSpan |
取得或設定值,這個值表示元素內容在父方格內跨越的數據列總數。 |
方法
事件
AccessKeyDisplayDismissed |
發生於不應再顯示訪問鍵時。 (繼承來源 UIElement) |
AccessKeyDisplayRequested |
發生於使用者要求顯示存取金鑰時。 (繼承來源 UIElement) |
AccessKeyInvoked |
發生於使用者完成存取金鑰序列時。 (繼承來源 UIElement) |
ActualThemeChanged |
發生於 ActualTheme 屬性值已變更時。 (繼承來源 FrameworkElement) |
BringIntoViewRequested |
在這個專案或其其中一個子系上呼叫 StartBringIntoView 時發生。 (繼承來源 UIElement) |
CharacterReceived |
發生於輸入佇列收到單一撰寫字元時。 (繼承來源 UIElement) |
ContextCanceled |
當內容輸入手勢繼續進入操作手勢時發生,以通知專案不應開啟內容飛出視窗。 (繼承來源 UIElement) |
ContextRequested |
發生於使用者完成內容輸入手勢時,例如按滑鼠右鍵。 (繼承來源 UIElement) |
DataContextChanged |
發生於 FrameworkElement.DataContext 屬性的值變更時。 (繼承來源 FrameworkElement) |
DoubleTapped |
發生於此元素的點擊測試區域上發生未處理的 DoubleTap 互動時。 (繼承來源 UIElement) |
DragEnter |
當輸入系統報告具有這個專案作為目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
DragLeave |
當輸入系統報告基礎拖曳事件,並將這個項目當做原點時發生。 (繼承來源 UIElement) |
DragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
DragStarting |
發生於起始拖曳作業時。 (繼承來源 UIElement) |
Drop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement) |
DropCompleted |
發生於以這個專案做為來源結束的拖放作業時。 (繼承來源 UIElement) |
EffectiveViewportChanged |
發生於 FrameworkElement的有效檢視區 變更時。 (繼承來源 FrameworkElement) |
GettingFocus |
發生於 UIElement 收到焦點之前。 此事件會同步引發,以確保事件反升時不會移動焦點。 (繼承來源 UIElement) |
GotFocus |
發生於 UIElement 收到焦點時。 這個事件會以異步方式引發,因此焦點可以在反升完成之前再次移動。 (繼承來源 UIElement) |
Holding |
發生於此元素的點擊測試區域上發生未處理的 保留 互動時。 (繼承來源 UIElement) |
KeyDown |
發生於 UIElement 有焦點時按下鍵盤按鍵時。 (繼承來源 UIElement) |
KeyUp |
發生於 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
LayoutUpdated |
發生於可視化樹狀結構的版面配置變更時,因為配置相關屬性變更值或重新整理版面配置的其他動作。 (繼承來源 FrameworkElement) |
Loaded |
當 FrameworkElement 已建構並新增至物件樹狀結構,且已準備好進行互動時發生。 (繼承來源 FrameworkElement) |
Loading |
發生於 FrameworkElement 開始載入時。 (繼承來源 FrameworkElement) |
LosingFocus |
發生於 UIElement 失去焦點之前。 此事件會同步引發,以確保事件反升時不會移動焦點。 (繼承來源 UIElement) |
LostFocus |
發生於 UIElement 失去焦點時。 此事件會以異步方式引發,因此焦點可以在反升完成之前再次移動。 (繼承來源 UIElement) |
ManipulationCompleted |
發生於 UIElement 上的操作完成時。 (繼承來源 UIElement) |
ManipulationDelta |
輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
ManipulationInertiaStarting |
在操作和慣性開始的時候,只要輸入裝置不與 UIElement 物件接觸便發生。 (繼承來源 UIElement) |
ManipulationStarted |
當輸入裝置開始在 UIElement 進行操作時發生。 (繼承來源 UIElement) |
ManipulationStarting |
發生於第一次建立操作處理器時。 (繼承來源 UIElement) |
NoFocusCandidateFound |
發生於用戶嘗試透過索引標籤或方向箭號移動焦點 () ,但焦點不會移動,因為不會在移動方向找到任何焦點候選專案。 (繼承來源 UIElement) |
PointerCanceled |
發生於讓聯繫人異常失去聯繫人的指標時。 (繼承來源 UIElement) |
PointerCaptureLost |
發生於這個專案先前保留的指標擷取移至另一個專案或其他地方時。 (繼承來源 UIElement) |
PointerEntered |
發生於指標進入這個項目的點擊測試區域時。 (繼承來源 UIElement) |
PointerExited |
發生於指標離開這個項目的點擊測試區域時。 (繼承來源 UIElement) |
PointerMoved |
當指標在指標保留在這個項目的點擊測試區域中時移動時發生。 (繼承來源 UIElement) |
PointerPressed |
發生於指標裝置在這個專案內起始 Press 動作時。 (繼承來源 UIElement) |
PointerReleased |
發生於先前起始 按下 動作的指標裝置放開時,同時在此元素內。 請注意, 按下動作的 結尾不保證會引發 |
PointerWheelChanged |
發生於指標滾輪的差異值變更時。 (繼承來源 UIElement) |
PreviewKeyDown |
在 UIElement 有焦點時按下鍵盤按鍵時發生。 (繼承來源 UIElement) |
PreviewKeyUp |
發生於 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
ProcessKeyboardAccelerators |
發生於按下 鍵盤快捷方式 (或快捷鍵) 時。 (繼承來源 UIElement) |
RightTapped |
發生於在指標位於 元素上方時發生右鍵輸入回應時。 (繼承來源 UIElement) |
SizeChanged |
發生於 FrameworkElement 上的 ActualHeight 或 ActualWidth 屬性值變更時。 (繼承來源 FrameworkElement) |
Tapped |
發生於未處理的 點 選互動發生於這個項目的點擊測試區域。 (繼承來源 UIElement) |
Unloaded |
當這個物件不再連接到主要物件樹狀結構時發生。 (繼承來源 FrameworkElement) |