バージョン

選択と展開の構成 (UltraDoughnutChart)

トピックの概要

目的

このトピックでは、UltraDoughnutChart のスライスの選択および展開を構成する方法を説明します。

前提条件

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック 目的

このトピックは、 UltraDoughnutChart コントロールおよびその主要機能の概要を説明します。

このトピックではコード例を使用して、UltraDoughnutChart コントロールを Windows Forms アプリケーションに追加する方法を説明します。

スライス選択構成のサマリー

コントロール構成の要点チャート

以下の表に、 UltraDoughnutChart コントロールの、スライスの選択に関して構成可能な項目の一覧を示します。

構成可能な項目 詳細 プロパティ/イベント

スライス選択の有効化/無効化

スライスを選択する機能を有効または無効にできます。

選択済みスライスの見た目の構成

スタイルを定義し、 RingSeries の SelectedStyle プロパティに割り当てることで選択されたスライスがどのように見えるかを定義できます。

スライスのクリック時の選択状態の変更

SliceClick イベント用イベント ハンドラーをアタッチする場合、選択状態を修正可能なイベント引数でクリックされたスライスへの参照を提供します。

SelectedSlices コレクションのコンテンツの修正

SelectedSlices コレクションのコンテンツを変更することにより選択されたスライスを変更できます。

スライス選択の有効化 / 無効化

概要

UltraDoughnutChart でスライス選択を有効 (デフォルト設定) または無効にできます。

Note
注:

このトピックで残っているスライス選択構成のすべてをスライス選択を有効にして実行します。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するプロパティ: 設定の選択肢:

スライス選択の有効化/無効化

True または False

選択済みスライスの見た目の構成

概要

UltraDoughnutChart は、選択されたスライスの見た目を決定する SelectedStyle プロパティを公開します。デフォルトでは、適用されるスタイルはありません。スライスを選択しても、その見た目はどのようにも変わりません。独自のスタイルを選択されたスライスに適用すると、 Style を定義して、 SelectedStyle プロパティの値として設定する必要があります。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するプロパティ: 設定の選択肢:

選択済みスライスの見た目の構成

以下のスクリーンショットは、以下の設定結果として UltraDoughnutChart の選択されたスライス (一番上のスライス) がどのように見えるかが示されます。

プロパティ

C# の場合:

Style sliceStyle = new Style
{
 Fill = Color.Gray,
 Opacity = .75,
};
this.ultraDoughnutChart1.SelectedStyle = sliceStyle;

VB の場合:

Dim sliceStyle As New Style
{
 .Fill = Color.Gray, _
 .Opacity = .75, _
}
Me.UltraDoughnutChart1.SelectedStyle = sliceStyle
Selection Doughnut Xamarin.png

スライスのクリック時の選択状態の変更

概要

UltraDoughnutChart は、スライスされた選択/非選択状態を変更するために使用する SliceClick イベントを公開します。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するイベント/プロパティ: 手順

IsSelected プロパティを設定します。

SliceClickEventArgs.IsSelected

SliceClickEventArgs の IsSelected プロパティを True または False に設定します。

以下のコード例は、クリック時に選択状態の切り替え方法を示します。

C# の場合:

void DoughnutChart_SliceClick(object sender, DoughnutSliceClickEventArgs e)
{
 e.IsSelected = !e.IsSelected;
}

VB の場合:

Private Sub dc_SliceClick(sender As Object, e As DoughnutSliceClickEventArgs)
      e.IsSelected = Not e.IsSelected
End Sub

SelectedSlices コレクションのコンテンツの修正

概要

選択されたスライスは、 UltraDoughnutChartSelectedSlices コレクションのコンテンツを修正することでも管理できます。それには、選択して SelectedSlices に追加しようとする 1 つ以上の slice オブジェクトへの参照を取得しなければなりません。スライスを選択しない場合、コレクションから削除します。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するイベント/プロパティ: 手順

SelectedSlices コレクションのコンテンツを修正します。

SelectedSlices コレクションから各スライスを追加または削除します。

以下のコード例は、 UltraDoughnutChart の最初のスライスへの参照を取得し、選択されたスライスでコレクションに追加する方法を示します。項目の削除例も利用できます。このコードは、特定のリング シリーズをロード後に実行する点にご注意ください。

C# の場合:

private void SeriesLoaded(object sender, SeriesLoadedEventArgs e)
{
    RingSeries ringSeries1 = doughnutChart.Series[0];
    // 項目を選択します:
    ringSeries1.SelectedSlices.Add(3);
    // 項目を選択解除します:
    ringSeries1.SelectedSlices.Remove(3);
}

Visual Basic の場合:

Private Sub SeriesLoaded(sender As Object, e As SeriesLoadedEventArgs )
    Dim ringSeries1 = doughnutChart.Series(0)
	' 項目を選択します:
	ringSeries1.SelectedSlices.Add(3);
	' 項目を選択解除します:
    ringSeries1.SelectedSlices.Remove(3);
End Sub

スライス展開構成のサマリー

コントロール構成の要点チャート

以下の表に、 UltraDoughnutChart コントロールの、スライスの展開に関して構成可能な項目の一覧を示します。

構成可能な項目 詳細 プロパティ/イベント

スライス展開の有効化/無効化

スライスを展開する機能を有効または無効にできます。

スライスのクリック時にスライスの展開状態を変更

SliceClick イベント用イベント ハンドラーをアタッチする場合、イベント引数でクリックされたスライスへの参照を提供するので、展開状態を修正できます。

ExplodedSlices コレクションのコンテンツの修正

ExplodedSlices コレクションのコンテンツを変更することにより展開されたスライスを変更できます。

スライス展開の有効化 / 無効化

概要

UltraDoughnutChart でスライス展開を有効 (デフォルト設定) または無効にできます。

Note
注:

このトピックで残っているスライス展開構成のすべてをスライス展開を有効にして実行します。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するプロパティ: 設定の選択肢:

スライス展開の有効化/無効化

True または False

以下のスクリーンショットは、1 つのスライスが展開された UltraDoughnutChart を示します。

XamDoughnutChart Selection Explosion Xamarin.png

スライスのクリック時の展開状態の変更

概要

UltraDoughnutChart は、スライスが展開されるかどうかを変更するために使用する SliceClick イベントを公開します。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するイベント/プロパティ: 手順

IsExploded プロパティの設定

SliceClickEventArgs.IsExploded

SliceClickEventArgs の IsExploded プロパティを True または False に設定します。

以下のコード例は、クリック時に展開状態の切り替え方法を示します。

C# の場合:

private void DoughnutSliceClicked(object sender, DoughnutSliceClickedEventArgs e)
{
    e.IsExploded = !e.IsExploded;
}

Visual Basic の場合:

Private Sub DoughnutSliceClicked(sender As Object, e As DoughnutSliceClickedEventArgs)
      e.IsExploded = Not e.IsExploded
End Sub

ExplodedSlices コレクションのコンテンツの修正

概要

展開されたスライスは、 UltraDoughnutChartExplodedSlices コレクションのコンテンツを修正することでも管理できます。それには、展開して ExplodedSlices に追加しようとする 1 つ以上の slice オブジェクトへの参照を取得しなければなりません。スライスの非展開状態を設定しない場合、コレクションから削除します。

プロパティ設定

以下の表は、要求ビヘイビアーをプロパティ設定にマップしています。

目的: 使用するイベント/プロパティ: 手順

ExplodedSlices コレクションのコンテンツを修正します。

ExplodedSlices コレクションから各スライスを追加または削除します。

以下のコード例は、 UltraDoughnutChart の最初のスライスへの参照を取得し、展開されたスライスでコレクションに追加する方法を示します。項目の削除例も利用できます。このコードは、特定のリング シリーズをロード後に実行する点にご注意ください。

C# の場合:

private void SeriesLoaded(object sender, SeriesLoadedEventArgs e)
{
     RingSeries ringSeries1 = new doughnutChart.Series[0];
	// 項目を展開します:
	ringSeries1.ExplodedSlices.Add(3);
    // 項目の展開を解除します:
    ringSeries.ExplodedSlices.Remove(3);
}

Visual Basic の場合:

Private Sub SeriesLoaded(sender As Object, e As SeriesLoadedEventArgs)
    Dim ringSeries1 = doughnutChart.Series(0)
	' 項目を展開します:
	ringSeries1.ExplodedSlices.Add(3);
	' 項目の展開を解除します:
    ringSeries.ExplodedSlices.Remove(3)
End Sub