ItemsControl 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表呈現項目集合的控制項。
public ref class ItemsControl : System::Windows::Controls::Control, System::Windows::Markup::IAddChildpublic ref class ItemsControl : System::Windows::Controls::Control, System::Windows::Controls::Primitives::IContainItemStorage, System::Windows::Markup::IAddChild[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.ContentProperty("Items")]
[System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.FrameworkElement))]
public class ItemsControl : System.Windows.Controls.Control, System.Windows.Markup.IAddChild[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.ContentProperty("Items")]
[System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.FrameworkElement))]
public class ItemsControl : System.Windows.Controls.Control, System.Windows.Controls.Primitives.IContainItemStorage, System.Windows.Markup.IAddChild[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.ContentProperty("Items")>]
[<System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.FrameworkElement))>]
type ItemsControl = class
inherit Control
interface IAddChild[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.ContentProperty("Items")>]
[<System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.FrameworkElement))>]
type ItemsControl = class
inherit Control
interface IAddChild
interface IContainItemStorage[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.ContentProperty("Items")>]
[<System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.FrameworkElement))>]
type ItemsControl = class
inherit Control
interface IContainItemStorage
interface IAddChildPublic Class ItemsControl
Inherits Control
Implements IAddChildPublic Class ItemsControl
Inherits Control
Implements IAddChild, IContainItemStorage- 繼承
- 衍生
- 屬性
- 實作
範例
下列範例示範將資料系結至 ItemsControl 。 第一個範例會建立稱為 MyData 的類別，這是簡單的字串集合。
public class MyData : ObservableCollection<string>
{
public MyData()
{
Add("Item 1");
Add("Item 2");
Add("Item 3");
}
}
Public Class MyData
Inherits ObservableCollection(Of String)
Public Sub New() '
Add("Item 1")
Add("Item 2")
Add("Item 3")
End Sub
End Class
下列範例會將 ItemsSource 的 ItemsControl 物件系結至 MyData 。
<!--Create an instance of MyData as a resource.-->
<src:MyData x:Key="dataList"/>
<ListBox ItemsSource="{Binding Source={StaticResource dataList}}"/>
ListBox listBox1 = new ListBox();
MyData listData = new MyData();
Binding binding1 = new Binding();
binding1.Source = listData;
listBox1.SetBinding(ListBox.ItemsSourceProperty, binding1);
Dim listBox1 As New ListBox()
Dim listData As New MyData()
Dim binding1 As New Binding()
binding1.Source = listData
listBox1.SetBinding(ListBox.ItemsSourceProperty, binding1)
下圖顯示 ListBox 上一個範例中建立的控制項。
下列範例示範如何使用 屬性填入 ItemsControlItems 。 此範例會將下列不同類型的專案新增至 ListBox ：
<!--Create a ListBox that contains a string, a Rectangle,
a Panel, and a DateTime object. These items can be accessed
via the Items property.-->
<ListBox xmlns:sys="clr-namespace:System;assembly=mscorlib"
Name="simpleListBox">
<!-- The <ListBox.Items> element is implicitly used.-->
This is a string in a ListBox
<sys:DateTime>2004/3/4 13:6:55</sys:DateTime>
<Rectangle Height="40" Width="40" Fill="Blue"/>
<StackPanel Name="itemToSelect">
<Ellipse Height="40" Fill="Blue"/>
<TextBlock>Text below an Ellipse</TextBlock>
</StackPanel>
<TextBlock>String in a TextBlock</TextBlock>
</ListBox>
// Add a String to the ListBox.
listBox1.Items.Add("This is a string in a ListBox");
// Add a DateTime object to a ListBox.
DateTime dateTime1 = new DateTime(2004, 3, 4, 13, 6, 55);
listBox1.Items.Add(dateTime1);
// Add a Rectangle to the ListBox.
Rectangle rect1 = new Rectangle();
rect1.Width = 40;
rect1.Height = 40;
rect1.Fill = Brushes.Blue;
listBox1.Items.Add(rect1);
// Add a panel that contains multpile objects to the ListBox.
Ellipse ellipse1 = new Ellipse();
TextBlock textBlock1 = new TextBlock();
ellipse1.Width = 40;
ellipse1.Height = 40;
ellipse1.Fill = Brushes.Blue;
textBlock1.TextAlignment = TextAlignment.Center;
textBlock1.Text = "Text below an Ellipse";
stackPanel1.Children.Add(ellipse1);
stackPanel1.Children.Add(textBlock1);
listBox1.Items.Add(stackPanel1);
' Create a Button with a string as its content.
listBox1.Items.Add("This is a string in a ListBox")
' Create a Button with a DateTime object as its content.
Dim dateTime1 As New DateTime(2004, 3, 4, 13, 6, 55)
listBox1.Items.Add(dateTime1)
' Create a Button with a single UIElement as its content.
Dim rect1 As New Rectangle()
rect1.Width = 40
rect1.Height = 40
rect1.Fill = Brushes.Blue
listBox1.Items.Add(rect1)
' Create a Button with a panel that contains multiple objects
' as its content.
Dim ellipse1 As New Ellipse()
Dim textBlock1 As New TextBlock()
ellipse1.Width = 40
ellipse1.Height = 40
ellipse1.Fill = Brushes.Blue
textBlock1.TextAlignment = TextAlignment.Center
textBlock1.Text = "Text below an Ellipse"
stackPanel1.Children.Add(ellipse1)
stackPanel1.Children.Add(textBlock1)
listBox1.Items.Add(stackPanel1)
下圖顯示 ListBox 上一個範例中建立的 。
下列範例說明如何使用 所提供的 ItemsControl 不同樣式和範本化相關屬性。 ItemsControl此範例中的 系結至 物件的集合 Task 。 為方便示範，這個範例中的樣式和範本都是內嵌宣告的。
<ItemsControl Margin="10"
ItemsSource="{Binding Source={StaticResource myTodoList}}">
<!--The ItemsControl has no default visual appearance.
Use the Template property to specify a ControlTemplate to define
the appearance of an ItemsControl. The ItemsPresenter uses the specified
ItemsPanelTemplate (see below) to layout the items. If an
ItemsPanelTemplate is not specified, the default is used. (For ItemsControl,
the default is an ItemsPanelTemplate that specifies a StackPanel.-->
<ItemsControl.Template>
<ControlTemplate TargetType="ItemsControl">
<Border BorderBrush="Aqua" BorderThickness="1" CornerRadius="15">
<ItemsPresenter/>
</Border>
</ControlTemplate>
</ItemsControl.Template>
<!--Use the ItemsPanel property to specify an ItemsPanelTemplate
that defines the panel that is used to hold the generated items.
In other words, use this property if you want to affect
how the items are laid out.-->
<ItemsControl.ItemsPanel>
<ItemsPanelTemplate>
<WrapPanel />
</ItemsPanelTemplate>
</ItemsControl.ItemsPanel>
<!--Use the ItemTemplate to set a DataTemplate to define
the visualization of the data objects. This DataTemplate
specifies that each data object appears with the Priority
and TaskName on top of a silver ellipse.-->
<ItemsControl.ItemTemplate>
<DataTemplate>
<DataTemplate.Resources>
<Style TargetType="TextBlock">
<Setter Property="FontSize" Value="18"/>
<Setter Property="HorizontalAlignment" Value="Center"/>
</Style>
</DataTemplate.Resources>
<Grid>
<Ellipse Fill="Silver"/>
<StackPanel>
<TextBlock Margin="3,3,3,0"
Text="{Binding Path=Priority}"/>
<TextBlock Margin="3,0,3,7"
Text="{Binding Path=TaskName}"/>
</StackPanel>
</Grid>
</DataTemplate>
</ItemsControl.ItemTemplate>
<!--Use the ItemContainerStyle property to specify the appearance
of the element that contains the data. This ItemContainerStyle
gives each item container a margin and a width. There is also
a trigger that sets a tooltip that shows the description of
the data object when the mouse hovers over the item container.-->
<ItemsControl.ItemContainerStyle>
<Style>
<Setter Property="Control.Width" Value="100"/>
<Setter Property="Control.Margin" Value="5"/>
<Style.Triggers>
<Trigger Property="Control.IsMouseOver" Value="True">
<Setter Property="Control.ToolTip"
Value="{Binding RelativeSource={x:Static RelativeSource.Self},
Path=Content.Description}"/>
</Trigger>
</Style.Triggers>
</Style>
</ItemsControl.ItemContainerStyle>
</ItemsControl>
下圖是轉譯時範例的螢幕擷取畫面。
此處未顯示的 其他兩個樣式相關屬性 ItemsControl 為 GroupStyle 和 GroupStyleSelector 。
備註
ItemsControl是 的型 Control 別，可以包含多個專案，例如字串、物件或其他專案。 下圖顯示 ListBox 控制項，其中包含下列不同類型的專案：
包含多種物件類型的 ListBox
Items使用 或 ItemsSource 屬性來指定要用來產生 內容的 ItemsControl 集合。 您可以將 屬性設定 ItemsSource 為任何實作 IEnumerable 的類型。 ItemsSource 通常用來顯示資料收集，或系結 ItemsControl 至集合物件。
如果您不想使用實作 IEnumerable 的物件來填入 ItemsControl ，您可以使用 屬性來新增專案 Items 。 中的 ItemsControl 專案可以有不同的類型。 例如， ListBox 可以包含一個專案是字串，另一個專案是 Image 。
ItemsSource設定屬性時， Items 集合會設定為唯讀且固定大小。 這表示您無法直接將專案新增至集合。 使用 時 ItemsSource ，將 屬性設定為 null 移除集合，並將使用量還原為 Items ，這會是空 ItemCollection 的 。
每個 ItemsControl 類型都有對應的專案容器類型。 每個 ItemsControl 的對應專案容器會附加 Item 至其名稱。 例如，針對 ListBox ，專案容器是 ListBoxItem 控制項;如果是 ComboBox ，則為 ComboBoxItem 控制項。 您可以針對 中的每個 ItemsControl 專案明確建立容器類型，但並非必要專案。 當您未明確建立容器類型時，會產生一個包含專案集合中的資料項目。 例如，如果您將字串物件的集合系結至 ItemsSource 的 ListBox 屬性，則不會明確建立 ListBoxItem 物件，但 ListBox 會為每個字串產生一個。 您可以使用 屬性來存取產生的專案容器 ItemContainerGenerator 。
注意
當 包含重複的物件時 ItemsControl ，UI 自動化的某些功能無法正常運作。 如果物件出現多次，則只有第一個實例會出現在自動化樹狀結構中。 (如果 Object.Equals(x, y) 傳回 .) ，則會將兩個物件x和y視為重複專案 true
當物件x正由 ItemsControl x 傳回的值使用時。GetHashCode() 不得變更。 不支援對此值所做的變更，並導致無法預期的行為。
此控制項的相依性屬性可能是由控制項的預設樣式所設定。 如果屬性是以預設樣式設定，當控制項出現在應用程式中時，屬性可能會從其預設值變更。 預設樣式取決於應用程式執行時所使用的桌面主題。
建構函式
| ItemsControl() |
初始化 ItemsControl 類別的新執行個體。 |
欄位
| AlternationCountProperty |
識別 AlternationCount 相依性屬性。 |
| AlternationIndexProperty |
識別 AlternationIndex 相依性屬性。 |
| DisplayMemberPathProperty |
識別 DisplayMemberPath 相依性屬性。 |
| GroupStyleSelectorProperty |
識別 GroupStyleSelector 相依性屬性。 |
| HasItemsProperty |
識別 HasItems 相依性屬性。 |
| IsGroupingProperty |
識別 IsGrouping 相依性屬性。 |
| IsTextSearchCaseSensitiveProperty |
識別 IsTextSearchCaseSensitive 相依性屬性。 |
| IsTextSearchEnabledProperty |
識別 IsTextSearchEnabled 相依性屬性。 |
| ItemBindingGroupProperty |
識別 ItemBindingGroup 相依性屬性。 |
| ItemContainerStyleProperty |
識別 ItemContainerStyle 相依性屬性。 |
| ItemContainerStyleSelectorProperty |
識別 ItemContainerStyleSelector 相依性屬性。 |
| ItemsPanelProperty |
識別 ItemsPanel 相依性屬性。 |
| ItemsSourceProperty |
識別 ItemsSource 相依性屬性。 |
| ItemStringFormatProperty |
識別 ItemStringFormat 相依性屬性。 |
| ItemTemplateProperty |
識別 ItemTemplate 相依性屬性。 |
| ItemTemplateSelectorProperty |
識別 ItemTemplateSelector 相依性屬性。 |
屬性
| ActualHeight |
取得呈現此項目的高度。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得呈現此項目的寬度。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定此元素是否可以當做拖放操作目標的值。 這是相依性屬性。 (繼承來源 UIElement) |
| AlternationCount |
取得或設定 ItemsControl 中的交替項目容器數，它可讓交替容器具有獨特的外觀。 |
| 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) |
| ContextMenu |
取得或設定每當透過使用者介面 (UI 要求操作功能表時，應該顯示的內容功能表元素) 此元素。 (繼承來源 FrameworkElement) |
| Cursor |
取得或設定滑鼠指標在此元素上方時所顯示的游標。 (繼承來源 FrameworkElement) |
| DataContext |
取得或設定項目在參與資料繫結時的資料內容。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
取得或設定可在使用或定義佈景主題樣式時，用來參考這個控制項之樣式的索引鍵。 (繼承來源 FrameworkElement) |
| DependencyObjectType |
取得包裝 DependencyObjectType 這個實例 CLR 型別的 。 (繼承來源 DependencyObject) |
| DesiredSize |
取得這個項目在版面配置處理序的測量傳遞期間所計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| DisplayMemberPath |
取得或設定來源物件上值的路徑，以當作此物件的視覺表示。 |
| 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) |
| GroupStyle |
取得 GroupStyle 物件的集合，定義每個群組層級的外觀。 |
| GroupStyleSelector |
取得或設定方法，讓您可針對 GroupStyle 提供自訂選取邏輯，以套用至集合中的每個群組。 |
| HandlesScrolling |
取得值，這個值表示控制項是否支援捲動。 (繼承來源 Control) |
| HasAnimatedProperties |
取得值，這個值表示此項目是否有任何動畫屬性。 (繼承來源 UIElement) |
| HasEffectiveKeyboardFocus |
取得值，指出 UIElement 是否具有焦點。 (繼承來源 UIElement) |
| HasItems |
取得表示 ItemsControl 是否包含項目的值。 |
| 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) |
| IsGrouping |
取得指出控制項是否使用群組的值。 |
| IsHitTestVisible |
取得或設定宣告此元素是否可以從其呈現內容的某些部分傳回，作為點擊測試結果的值。 這是相依性屬性。 (繼承來源 UIElement) |
| 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) |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| IsStylusCaptured |
取得值，指出這個項目是否擷取手寫筆。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusCaptureWithin |
取得值，這個值決定手寫筆擷取是由這個項目持有，還是由項目範圍及其視覺化樹狀結構中的項目持有。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusDirectlyOver |
取得值，指出手寫筆位置是否與點擊測試結果相對應，該結果會將複合項目納入考量。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusOver |
取得值，指出手寫筆游標是否位在這個項目上方 (包括視覺子項目)。 這是相依性屬性。 (繼承來源 UIElement) |
| IsTabStop |
取得或設定值，這個值表示控制項是否包含於索引標籤巡覽。 (繼承來源 Control) |
| IsTextSearchCaseSensitive |
取得或設定值，其表示在搜尋項目時，大小寫是否也是條件之一。 |
| IsTextSearchEnabled |
取得或設定值，表示 TextSearch 是否已在 ItemsControl 執行個體上啟用。 |
| IsVisible |
取得值，指出使用者介面中是否顯示這個專案 (UI) 。 這是相依性屬性。 (繼承來源 UIElement) |
| ItemBindingGroup |
取得或設定複製到 ItemsControl 中每個項目的 BindingGroup。 |
| ItemContainerGenerator |
取得與控制項關聯的 ItemContainerGenerator。 |
| ItemContainerStyle |
取得或設定 Style，它會套用到為每個項目所產生的容器項目。 |
| ItemContainerStyleSelector |
取得或設定可以套用至每個產生之容器項目的樣式的自訂樣式選取邏輯。 |
| Items |
取得用來產生 ItemsControl 之內容的集合。 |
| ItemsPanel |
取得或設定樣板，這個樣板會定義控制項目配置的面板。 |
| ItemsSource |
取得或設定用來產生 ItemsControl 之內容的集合。 |
| ItemStringFormat |
取得或設定複合字串，這個字串會指定如何格式化 ItemsControl 中要以字串形式顯示的項目。 |
| ItemTemplate |
取得或設定用來顯示每個項目的 DataTemplate。 |
| ItemTemplateSelector |
取得或設定選擇用來顯示每個項目範本的自訂邏輯。 |
| Language |
取得或設定套用至項目的當地語系化/全球化語言資訊。 (繼承來源 FrameworkElement) |
| LayoutTransform |
取得或設定在執行版面配置時應該套用至這個專案的圖形轉換。 (繼承來源 FrameworkElement) |
| LogicalChildren |
取得 ItemsControl 物件的邏輯子物件列舉程式。 |
| Margin |
取得或設定項目的外邊界。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定元素的最大高度限制。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定元素的最大寬度限制。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定元素的最小高度限制。 (繼承來源 FrameworkElement) |
| 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) |
| 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 |
已淘汰.
已淘汰.
取得或設定 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) |
附加屬性
| AlternationIndex |
有使用替代項目容器時，取得項目容器受指派的值。 |
方法
事件
| 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) 基礎結構，而且不適合直接從您的程式碼使用。 |
| IAddChild.AddText(String) |
此成員支援Windows Presentation Foundation (WPF) 基礎結構，而且不適合直接從您的程式碼使用。 |
| IContainItemStorage.Clear() |
清除所有屬性關聯性。 |
| IContainItemStorage.ClearItemValue(Object, DependencyProperty) |
移除指定項目和屬性之間的關聯性。 |
| IContainItemStorage.ClearValue(DependencyProperty) |
從所有屬性清單中移除指定的屬性。 |
| IContainItemStorage.ReadItemValue(Object, DependencyProperty) |
傳回與指定的項目相關聯的指定的屬性其值。 |
| IContainItemStorage.StoreItemValue(Object, DependencyProperty, Object) |
儲存指定的屬性和值，並與指定的項目產生關聯。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
如需這個成員的描述，請參閱 IsAmbientPropertyAvailable(String) 方法。 (繼承來源 FrameworkElement) |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應