ItemsControl.AlternationIndex 添付プロパティ

  • リファレンス

定義

名前空間:
System.Windows.Controls
アセンブリ:
PresentationFramework.dll

代替項目コンテナーが使用される場合に、項目コンテナーに代入された値を取得します。

see GetAlternationIndex, and SetAlternationIndex
see GetAlternationIndex
see GetAlternationIndex, and SetAlternationIndex
see GetAlternationIndex
see GetAlternationIndex, and SetAlternationIndex
see GetAlternationIndex

例

次の例では、(継承元ItemsControl) に交互の項目コンテナー (種類ListBoxItem) があることを指定ListBoxし、それぞれ異なる背景と前景を指定します。 この例では、プロパティとBackgroundForegroundプロパティを各プロパティにItemsControl.AlternationIndexバインドし、各プロパティに対して指定AlternationConverterします。

<Grid>
  <Grid.Resources>
    <AlternationConverter x:Key="BackgroundConverter">
      <SolidColorBrush>Blue</SolidColorBrush>
      <SolidColorBrush>CornflowerBlue</SolidColorBrush>
      <SolidColorBrush>LightBlue</SolidColorBrush>
    </AlternationConverter>

    <AlternationConverter x:Key="AlternateForegroundConverter">
      <SolidColorBrush>White</SolidColorBrush>
      <SolidColorBrush>Black</SolidColorBrush>
      <SolidColorBrush>Navy</SolidColorBrush>
    </AlternationConverter>

    <Style x:Key="alternatingWithBinding" TargetType="{x:Type ListBoxItem}">
      <Setter Property="Background" 
              Value="{Binding RelativeSource={RelativeSource Self},
                     Path=(ItemsControl.AlternationIndex),
                     Converter={StaticResource BackgroundConverter}}"/>

      <Setter Property="Foreground" 
              Value="{Binding RelativeSource={RelativeSource Self},
                     Path=(ItemsControl.AlternationIndex),
                     Converter={StaticResource AlternateForegroundConverter}}"/>
    </Style>

  </Grid.Resources>

  <ListBox AlternationCount="3" ItemsSource="{StaticResource data}"
           ItemContainerStyle="{StaticResource alternatingWithBinding}"/>
</Grid>

次の例では、オブジェクトを使用して前の例と同じ処理を行 Trigger います。

<Grid>
  <Grid.Resources>
    <Style x:Key="alternatingWithTriggers" TargetType="{x:Type ListBoxItem}">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="Foreground" Value="White"/>
      <Style.Triggers>
        <Trigger Property="ListBox.AlternationIndex" Value="1">
          <Setter Property="Background" Value="CornflowerBlue"/>
          <Setter Property="Foreground" Value="Black"/>
        </Trigger>
        <Trigger Property="ListBox.AlternationIndex" Value="2">
          <Setter Property="Background" Value="LightBlue"/>
          <Setter Property="Foreground" Value="Navy"/>
        </Trigger>
      </Style.Triggers>
    </Style>

  </Grid.Resources>
  <ListBox AlternationCount="3" ItemsSource="{StaticResource data}" 
           ItemContainerStyle="{StaticResource alternatingWithTriggers}">
  </ListBox>
</Grid>

注釈

プロパティ AlternationCount を ItemsControl.AlternationIndex 使用すると、2 つ以上の交互の項目コンテナーの外観を指定できます。 たとえば、3 つ目の項目ごとに交互の背景色を ItemsControl指定できます。 内の ItemsControl.AlternationIndex 各項目コンテナーに ItemsControl割り当てられます。 ItemsControl.AlternationIndex は 0 から始まり、マイナス 1 になるまで AlternationCount インクリメントし、0 で再起動します。 たとえば、3 で 7 つの項目がある場合AlternationCountは、次の表に各項目の一覧をItemsControl.AlternationIndex示ItemsControlします。

内の項目の位置 ItemsControl ItemsControl.AlternationIndex
1 0
2 1
3 2
4 0
5 1
6 2
7 0

交互の項目コンテナーに対して異なる外観を指定するために使用できる方法はいくつかあります。 1 つの方法は、項目コンテナー ItemsControl.AlternationIndexのプロパティを . その後、an を AlternationConverter 使用して、特定 ItemsControl.AlternationIndex の値を持つ項目コンテナーに適用する値を指定できます。 トリガーを使用して、項目コンテナーの値に応じて項目コンテナーのプロパティの ItemsControl.AlternationIndex値を変更することもできます。

適用対象