ItemsControl.ItemContainerStyle 속성


각 항목에 대해 생성된 컨테이너 요소에 적용된 Style 을 가져오거나 설정합니다.Gets or sets the Style that is applied to the container element generated for each item.

 property System::Windows::Style ^ ItemContainerStyle { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style ItemContainerStyle { get; set; }
member this.ItemContainerStyle : System.Windows.Style with get, set
Public Property ItemContainerStyle As Style

속성 값


각 항목에 대해 생성된 컨테이너 요소에 적용된 Style 입니다.The Style that is applied to the container element generated for each item. 기본값은 null입니다.The default is null.



다음 예제에서는이 속성을 사용 하는 방법에 설명 합니다.The following example demonstrates how to use this property. 다음 데이터 바인딩된 ListBox을 고려 하십시오.Consider the following data-bound ListBox:

<ListBox ItemsSource="{Binding Source={StaticResource MyPhotos}}"
         Background="Silver" Width="600" Margin="10" SelectedIndex="0"/>

데이터 항목을 포함 하는 요소에 대 한 스타일을 만들려면 다음 예제와 같이 ListBoxItem 스타일을 만듭니다.To create a style for the elements that contain the data items, create a ListBoxItem style, as shown in the following example. 스타일은 스타일이 정의 된 범위 내의 모든 ListBoxItem 요소에 적용 됩니다.The style is applied to all ListBoxItem elements within the scope the style is defined in.

<Style TargetType="ListBoxItem">
  <Setter Property="Opacity" Value="0.5" />
  <Setter Property="MaxHeight" Value="75" />
    <Trigger Property="IsSelected" Value="True">
        <Setter Property="Opacity" Value="1.0" />
    <EventTrigger RoutedEvent="Mouse.MouseEnter">
              To="90"  />
    <EventTrigger RoutedEvent="Mouse.MouseLeave">
              Storyboard.TargetProperty="MaxHeight"  />

ListBoxItemListBox 컨트롤의 컨테이너 요소입니다.The ListBoxItem is the container element for the ListBox control. 따라서 앞의 대안은 ListBoxItemContainerStyle 속성을 정의 된 스타일로 설정 하는 것입니다.Therefore, an alternative to the preceding is to set the ItemContainerStyle property of the ListBox to the defined style. 이렇게 하려면 ListBoxItem 스타일을 리소스로 제공 하 여 리소스로 사용할 수 있도록 x:Key 합니다.To do that, give the ListBoxItem style an x:Key so it is available as a resource:

<Style TargetType="ListBoxItem" x:Key="ContainerStyle">
  <Setter Property="Opacity" Value="0.5" />
  <Setter Property="Opacity" Value="0.5" />
  <Setter Property="MaxHeight" Value="75" />
    <Trigger Property="IsSelected" Value="True">
      <Setter Property="Opacity" Value="1.0" />

다음 예제와 같이 ItemContainerStyle 속성을 리소스로 설정 합니다.Next, set the ItemContainerStyle property to the resource, as in the following example:

<ListBox ItemsSource="{Binding Source={StaticResource MyPhotos}}"
         ItemContainerStyle="{StaticResource ContainerStyle}" 
         Background="Silver" Width="600" Margin="10" SelectedIndex="0"/>

이전 시나리오의 동일한 결과 생성합니다.Both of the preceding scenarios produce the same result. 그러나 스타일을 리소스로 사용할 수 있도록의 장점 중 하나는 스타일 다시 사용할 수 있습니다.However, one of the advantages of making the style available as a resource is that you can reuse the style. ItemContainerStyle 속성을 명시적으로 설정 하면 가독성을 높일 수도 있습니다.Setting the ItemContainerStyle property explicitly can also provide greater readability.

전체 예제는 스타일 지정 및 템플릿 샘플 소개를 참조 하세요.For the complete example, see Introduction to Styling and Templating Sample.

다음 예제는 ItemsControl에서 제공 하는 다양 한 스타일 및 템플릿 관련 속성의 함수를 보여 주기 위해 디자인 되었습니다.The following example is designed to illustrate the function of the different styling and templating related properties provided by the ItemsControl. 이 예제의 ItemsControlTask 개체의 컬렉션에 바인딩됩니다.The ItemsControl in this example is bound to a collection of Task objects. 설명을 위해 이 예제의 스타일 및 템플릿은 모두 인라인으로 선언됩니다.For demonstration purposes, the styles and templates in this example are all declared inline.

<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.-->
    <ControlTemplate TargetType="ItemsControl">
      <Border BorderBrush="Aqua" BorderThickness="1" CornerRadius="15">
  <!--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.-->
      <WrapPanel />
  <!--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 Proriity
      and TaskName on top of a silver ellipse.-->
        <Style TargetType="TextBlock">
          <Setter Property="FontSize" Value="18"/>
          <Setter Property="HorizontalAlignment" Value="Center"/>
        <Ellipse Fill="Silver"/>
          <TextBlock Margin="3,3,3,0"
                     Text="{Binding Path=Priority}"/>
          <TextBlock Margin="3,0,3,7"
                     Text="{Binding Path=TaskName}"/>
  <!--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.-->
      <Setter Property="Control.Width" Value="100"/>
      <Setter Property="Control.Margin" Value="5"/>
        <Trigger Property="Control.IsMouseOver" Value="True">
          <Setter Property="Control.ToolTip"
                  Value="{Binding RelativeSource={x:Static RelativeSource.Self},

렌더링될 때 예제의 스크린샷은 다음과 같습니다.The following is a screenshot of the example when it is rendered:

ItemsControl 예제 스크린 샷ItemsControl example screenshot

여기에 표시 되지 않은 ItemsControl의 다른 두 가지 스타일 관련 속성은 GroupStyleGroupStyleSelector입니다.Two other style-related properties of the ItemsControl that are not shown here are GroupStyle and GroupStyleSelector.


이 속성을 사용 또는 ItemContainerStyleSelector 데이터 항목을 포함 하는 요소의 모양을 적용할 스타일을 설정 하는 속성입니다.You use this property or the ItemContainerStyleSelector property to set a style to affect the appearance of the elements that contain the data items. 예를 들어 ListBox, 생성 된 컨테이너는 ListBoxItem 제어;에 대 한 ComboBox, 이들은 ComboBoxItem 컨트롤입니다.For example, for ListBox, the generated containers are ListBoxItem controls; for ComboBox, they are ComboBoxItem controls.

ItemsControl는 시각적 사용자 지정에 뛰어난 유연성을 제공 하 고 다양 한 스타일 및 템플릿 속성을 제공 합니다.The ItemsControl provides great flexibility for visual customization and provides many styling and templating properties. 항목의 레이아웃에 영향을 주려면 ItemsPanel 속성을 사용 합니다.To affect the layout of the items, use the ItemsPanel property. 컨트롤에서 그룹화를 사용 하는 경우 GroupStyle 또는 GroupStyleSelector 속성을 사용할 수 있습니다.If you are using grouping on your control, you can use the GroupStyle or GroupStyleSelector property. 데이터 개체의 시각화를 지정 하려면 ItemTemplate 또는 ItemTemplateSelector 속성을 사용 합니다.To specify the visualization of data objects, use the ItemTemplate or ItemTemplateSelector property. ItemTemplate지정 하는 경우에 대 한 자세한 내용은 데이터 템플릿 개요를 참조 하세요.For more information about when to specify an ItemTemplate, see Data Templating Overview.

XAML 특성 사용XAML Attribute Usage

<object ItemContainerStyle="ResourceExtension StyleResourceKey"/>  


다음 중 하나: StaticResource, 또는 DynamicResource합니다.One of the following: StaticResource, or DynamicResource. 스타일 자체에 시스템 리소스 또는 사용자 기본 설정과 같은 잠재적 런타임 참조에 대 한 참조가 포함 되어 있지 않으면 일반적으로 스타일에 대 한 참조 StaticResource는 성능을 위해 권장 됩니다.Unless the styles themselves contain references to potential run-time references such as system resources or user preferences, StaticResource reference to a style is usually recommended for performance.

리소스로 요청 되는 스타일을 참조 하는 문자열 값을 x:Key 합니다.x:Key string value referring to the style being requested as a resource.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field ItemContainerStyleProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보