このトピックでは、XamDoughnutChart のスライスの選択および展開を構成する方法を説明します。
本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。
以下の表に、 XamDoughnutChart コントロールの、スライスの選択に関して構成可能な項目の一覧を示します。
XamDoughnutChart でスライス選択を有効 (デフォルト設定) または無効にできます。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
XamDoughnutChart は、選択されたスライスの見た目を決定する SelectedStyle プロパティを公開します。デフォルトでは、適用されるスタイルはありません。スライスを選択しても、その見た目はどのようにも変わりません。独自のスタイルを選択されたスライスに適用すると、 Slice の TargetType を持つ Style を定義して、 SelectedStyle プロパティの値として設定する必要があります。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のスクリーンショットは、以下の設定結果として XamDoughnutChart の選択されたスライス (一番上のスライス) がどのように見えるかが示されます。
XamDoughnutChart は、スライスされた選択/非選択状態を変更するために使用する SliceClick イベントを公開します。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のコード例は、クリック時に選択状態の切り替え方法を示します。
XAML の場合:
<ig:XamDoughnutChart SliceClick="DoughnutSliceClicked">
…C# の場合:
private void DoughnutSliceClicked(object sender, SliceClickEventArgs e)
{
e.IsSelected = !e.IsSelected;
}Visual Basic の場合:
Private Sub DoughnutSliceClicked(sender As Object, e As SliceClickEventArgs)
e.IsSelected = Not e.IsSelected
End SubXamDoughnutChart は、 Slice オブジェクトへに対し IsSelected プロパティを直接修正できるすべてのスライスへの参照を保持します。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のコード例は、 IsSelected プロパティを設定するために、 XamDoughnutChart の最初のスライスへの参照の取得方法を示します。このコードは、特定のリング シリーズをロード後に実行する点にご注意ください。
XAML の場合:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…C# の場合:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice;
firstSlice.IsSelected = true;
}Visual Basic の場合:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs )
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
firstSlice.IsSelected = True
End Sub選択されたスライスは、 XamDoughnutChart の SelectedSlices コレクションのコンテンツを修正することでも管理できます。それには、選択して SelectedSlices に追加しようとする 1 つ以上の Slice オブジェクトへの参照を取得しなければなりません。スライスを選択しない場合、コレクションから削除します。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のコード例は、 XamDoughnutChart の最初のスライスへの参照を取得し、選択されたスライスでコレクションに追加する方法を示します。項目の削除例も利用できます。このコードは、特定のリング シリーズをロード後に実行する点にご注意ください。
XAML の場合:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…C# の場合:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice; {}; "]
// 項目を選択します:
this.doughnutChart.SelectedSlices.Add(3);
// 項目を選択解除します:
this.doughnutChart.SelectedSlices.RemoveAt(3);
}Visual Basic の場合:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs )
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
' 項目を選択します:
Me.doughnutChart.SelectedSlices.Add(firstSlice)
' 項目を選択解除します:
Me.doughnutChart.SelectedSlices.RemoveAt(0)
End Sub以下の表に、 XamDoughnutChart コントロールの、スライスの展開に関して構成可能な項目の一覧を示します。
XamDoughnutChart でスライス展開を有効 (デフォルト設定) または無効にできます。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のスクリーンショットは、1 つのスライスが展開された XamDoughnutChart を示します。
XamDoughnutChart は、スライスが展開されるかどうかを変更するために使用する SliceClick イベントを公開します。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のコード例は、クリック時に展開状態の切り替え方法を示します。
XAML の場合:
<ig:XamDoughnutChart SliceClick="DoughnutSliceClicked">
…C# の場合:
private void DoughnutSliceClicked(object sender, SliceClickEventArgs e)
{
e.IsExploded = !e.IsExploded;
}Visual Basic の場合:
Private Sub DoughnutSliceClicked(sender As Object, e As RoutedEventArgs)
e.IsExploded = Not e.IsExploded
End SubXamDoughnutChart は、スライスが展開されるかどうかを変更するために使用する SliceClick イベントを公開します。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のコード例は、 IsExploded プロパティを設定するために、 XamDoughnutChart の最初のスライスへの参照の取得方法を示します。このコードは、特定のリング シリーズをロード後に実行する点にご注意ください。
XAML の場合:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…
</ig:RingSeries>
…
</ig:XamDoughnutChart>C# の場合:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice;
firstSlice.IsExploded = true;
}Visual Basic の場合:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs)
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
firstSlice.IsExploded = True
End Sub展開されたスライスは、 XamDoughnutChart の ExplodedSlices コレクションのコンテンツを修正することでも管理できます。それには、展開して ExplodedSlices に追加しようとする 1 つ以上の Slice オブジェクトへの参照を取得しなければなりません。スライスの非展開状態を設定しない場合、コレクションから削除します。
以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。
以下のコード例は、 XamDoughnutChart の最初のスライスへの参照を取得し、展開されたスライスでコレクションに追加する方法を示します。項目の削除例も利用できます。このコードは、特定のリング シリーズをロード後に実行する点にご注意ください。
XAML の場合:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…
</ig:RingSeries>
…
</ig:XamDoughnutChart>C# の場合:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice;
// 項目を展開します:
this.doughnutChart.ExplodedSlices.Add(firstSlice);
// 項目の展開を解除します:
this.doughnutChart.ExplodedSlices.RemoveAt(0);
}Visual Basic の場合:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs)
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
' 項目を展開します:
Me.doughnutChart.ExplodedSlices.Add(firstSlice)
' 項目の展開を解除します:
Me.doughnutChart.ExplodedSlices.RemoveAt(0)
End Sub