GroupStyle.AlternationCount Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger antalet alternerande GroupItem objekt.
public:
property int AlternationCount { int get(); void set(int value); };
public int AlternationCount { get; set; }
member this.AlternationCount : int with get, set
Public Property AlternationCount As Integer
Egenskapsvärde
Antalet alternerande GroupItem objekt.
Exempel
I följande exempel skapas en ListBox som är bunden till en CollectionViewSource som grupperar objekten i samlingen. Exemplet växlar bakgrunden för rubriken för var och en GroupItem mellan två färger genom att göra följande:
Anger AlternationCount till 2.
Skapar en AlternationConverter som returnerar en SolidColorBrush, beroende på värdet för ItemsControl.AlternationIndex.
Binder BackgroundTextBlock i i HeaderTemplate till ItemsControl.AlternationIndex egenskapen och tillhandahåller AlternationConverter. Observera att den AlternationIndex bifogade egenskapen har angetts för GroupItem, och bindningen använder FindAncestor för att hämta dess värde.
Exemplet växlar också bakgrunden för objekten i mellan ListBox tre färger genom att ange AlternationCount på ListBox och binda Background var ListBox och en ItemsControl.AlternationIndextill . I det här fallet växlar bakgrunden mellan tre färger.
Det CollectionViewSource som grupperar objekten visas inte. Information om hur du grupperar objekt finns i Så här: Sortera och gruppera data med hjälp av en vy i XAML.
<StackPanel>
<StackPanel.Resources>
<!--Returns a Brush for the header of a GroupItem.-->
<AlternationConverter x:Key="GroupHeaderBackgroundConverter">
<SolidColorBrush>LightBlue</SolidColorBrush>
<SolidColorBrush>LightSteelBlue</SolidColorBrush>
</AlternationConverter>
<!--Returns a Brush for a ListBoxItem.-->
<AlternationConverter x:Key="BackgroundConverter">
<SolidColorBrush>Silver</SolidColorBrush>
<SolidColorBrush>LightGray</SolidColorBrush>
<SolidColorBrush>GhostWhite</SolidColorBrush>
</AlternationConverter>
</StackPanel.Resources>
<ListBox ItemsSource="{Binding Source={StaticResource groupedData}}"
DisplayMemberPath="CityName" AlternationCount="3" Name="lb">
<ListBox.GroupStyle>
<!--Set alternating backgrounds on the header of each group.-->
<GroupStyle AlternationCount="2">
<GroupStyle.HeaderTemplate>
<DataTemplate>
<TextBlock FontWeight="Bold"
Text="{Binding Path=Name}"
Background="{Binding
RelativeSource={RelativeSource FindAncestor,
AncestorType={x:Type GroupItem}},
Path=(ItemsControl.AlternationIndex),
Converter={StaticResource
GroupHeaderBackgroundConverter}}"/>
</DataTemplate>
</GroupStyle.HeaderTemplate>
</GroupStyle>
</ListBox.GroupStyle>
<ListBox.ItemContainerStyle>
<!--Set alternating backgrounds on the items in the ListBox.-->
<Style TargetType="{x:Type ListBoxItem}">
<Setter Property="Background"
Value="{Binding RelativeSource={RelativeSource Self},
Path=(ItemsControl.AlternationIndex),
Converter={StaticResource BackgroundConverter}}"/>
</Style>
</ListBox.ItemContainerStyle>
</ListBox>
</StackPanel>
Kommentarer
Med AlternationCount egenskapen och den ItemsControl.AlternationIndex bifogade egenskapen kan du ange utseendet för två eller flera alternerande GroupItem objekt. Du kan till exempel ange alternerande bakgrundsfärger för var tredje GroupItem i en ItemsControl. ItemsControl.AlternationIndex Är tilldelad till var och GroupItem en i ItemsControl. ItemsControl.AlternationIndex börjar vid 0, ökar tills den är AlternationCount minus 1 och startar sedan om vid 0. Om till exempel AlternationCount är 3 och det finns sju GroupItem objekt i ItemsControl, visar ItemsControl.AlternationIndex följande tabell för varje objekt.
| Positionen för GroupItem i ItemsControl | ItemsControl.AlternationIndex |
|---|---|
| 1 | 0 |
| 2 | 1 |
| 3 | 2 |
| 4 | 0 |
| 5 | 1 |
| 6 | 2 |
| 7 | 0 |
Det finns flera metoder som du kan använda för att ange olika utseenden för de alternerande GroupItem objekten. En metod är att binda egenskaper i HeaderTemplate eller ContainerStyleGroupStyle till ItemsControl.AlternationIndex. Du kan sedan använda en AlternationConverter för att ange vilket värde som ska tillämpas på det GroupItem värde som har ett visst ItemsControl.AlternationIndex värde. Du kan också använda utlösare för att ändra värdet för en egenskap beroende på värdet för dess ItemsControl.AlternationIndex.