JA - Grid Lite topics, OSS and other updates

doc/jp/components/blazor-excel-library-temporarily-stop-automatic-calculation-of-formulas-to-speed-up-processing.md

@@ -1,8 +1,9 @@
 ---
 title: {Platform} Excel ライブラリ | 数式の自動計算を一時的に停止して処理速度を上げる | インフラジスティックス
 _description: Infragistics Blazor Excel ライブラリ – 数式の自動計算を一時的に停止して処理速度を上げる
-_keywords: {Platform} excel ライブラリ, 計算, 処理の高速化, $ProductName$, インフラジスティックス
+_keywords: {Platform} excel ライブラリ, 計算, 処理の高速化, {ProductName}, インフラジスティックス
 _language: ja
+_license: commercial
 mentionedTypes: []
 ---
 

doc/jp/components/blazor-webassembly-how-to-read-and-write-excel-files-to-reduce-server-load.md

@@ -1,8 +1,9 @@
 ---
 title: Blazor Webassembly | Blazor Excel ライブラリ | インフラジスティックス
 _description: Infragistics Blazor Webassembly - Blazor WebAssembly 上で Excel ファイルを読み書きし、サーバー負荷を減らす
-_keywords: Blazor Webassembly, Excel ライブラリ, Excel ファイルの読み書き, $ProductName$, インフラジスティックス
+_keywords: Blazor Webassembly, Excel ライブラリ, Excel ファイルの読み書き, {ProductName}, インフラジスティックス
 _language: ja
+_license: commercial
 mentionedTypes: []
 ---
 
@@ -251,7 +252,7 @@ Infragistics Blazor Excel ライブラリが提供するアセンブリファイ
 
         // アセンブリの遅延読み込みを行なってから、その遅延読み込みされるアセンブリ内の機能を使うメソッドを呼び出します。
         // (アセンブリの遅延読み込みを行なうメソッド内で直接、遅延読み込みしたアセンブリ内の機能を参照していると、
-        //  System.IO.FileNotFoundException: Could not load file or assembly 例外が発生します。)
+        // System.IO.FileNotFoundException: Could not load file or assembly 例外が発生します。)
         Await this.DownloadAsExcelAsync();
     }
     // <summary>

doc/jp/components/charts/features/chart-data-aggregations.md

@@ -12,7 +12,7 @@ _language: ja
 
 {ProductName} `CategoryChart` コントロールのデータ集計機能を使用すると、チャート内のデータを `XAxis` の一意の値でグループ化し、それらのグループをソートすることができます。次に、`YAxis` の範囲に反映され、シリーズにカーソルを合わせるとツールチップに表示される集計を適用できます。
 
-# {Platform} データ集計の例
+## {Platform} データ集計の例
 
 次の例は、`XAxis` の Country メンバーごとにグループ化する[縦棒チャート](../types/column-chart.md)を示しており、各データ項目内の他のプロパティ (Product、MonthName、Year など) に変更して販売データを集計できます。また、グループ化されたプロパティを望ましい順序で取得するために、概要とソートのオプションも利用できます。
 

doc/jp/components/charts/features/chart-markers.md

@@ -12,7 +12,7 @@ _language: ja
 
 {ProductName} マーカーは、カテゴリ チャートのプロット領域にデータ ポイントの値を表示する視覚要素です。値が主グリッド線と副グリッド線の間にある場合も指定したデータ ポイントの値をただちに識別できるようユーザーをサポートします。
 
-# {Platform} チャート マーカーの例
+## {Platform} チャート マーカーの例
 
 次の例では、[折れチャート](../types/line-chart.md)は、2009 年から 2019 年までのヨーロッパ、中国、および米国の国々の再生可能エネルギーの発電量を比較しています。マーカーが `MarkerType` プロパティを `Circle` 列挙値に設定して有効になっています。
 
@@ -24,7 +24,7 @@ _language: ja
 
 <div class="divider--half"></div>
 
-# {Platform} チャート マーカー テンプレート
+## {Platform} チャート マーカー テンプレート
 
 以下の例に示すように、マーカー プロパティに加えて、`XamCategoryChart` コントロールで描画されたシリーズの `MarkerTemplate` プロパティに関数を設定することで、独自のマーカーを実装できます。
 

doc/jp/components/charts/features/chart-trendlines.md

@@ -16,7 +16,7 @@ _language: ja
 
 トレンドラインを有効にすると、ダッシュ配列を適用することもできます。これを行うには、`TrendLineDashArray` プロパティを数値の配列に設定します。数値配列は、トレンドラインの破線の長さを表します。
 
-# {Platform} チャート トレンドラインの例
+## {Platform} チャート トレンドラインの例
 
 次のサンプルは、**QuinticFit** トレンドラインが最初に適用された、2013 年から 2017 年までの Microsoft の株価トレンドを示す `FinancialChart` を示しています。適用されるトレンドラインのタイプを変更できるドロップダウンがあり、可能なすべてのトレンドライン タイプがそのドロップダウン内に一覧表示されます。
 
@@ -25,7 +25,7 @@ _language: ja
 
 <div class="divider--half"></div>
 
-# {Platform} チャート トレンドラインのダッシュ配列の例
+## {Platform} チャート トレンドラインのダッシュ配列の例
 
 次のサンプルは、`TrendLineDashArray` プロパティを介して適用された **QuarticFit** 破線トレンドラインを持つ `FinancialPriceSeries` を示す `XamDataChart` を示しています。
 
@@ -34,17 +34,17 @@ _language: ja
 
 <div class="divider--half"></div>
 
-# {Platform} チャートト レンドライン レイヤー
+## {Platform} チャートト レンドライン レイヤー
 
 `TrendLineLayer` は、ターゲット シリーズに対して単一のトレンドライン タイプを表示するように設計されたシリーズ タイプです。これと既存のシリーズ タイプの既存のトレンド ライン機能との違いは、`TrendLineLayer` はシリーズ タイプであるため、チャートの `Series` コレクションに複数のトレンド ラインを追加して、同じシリーズに複数のトレンド ラインを添付できることです。また、これまでできなかったトレンドラインを凡例に表示する ことも可能です。
 
-### トレンドライン レイヤーの使用
+## トレンドライン レイヤーの使用
 
 `TrendLineLayer` が正しく動作するには、`TargetSeries` と `TrendLineType` を指定する必要があります。利用可能なさまざまなトレンドラインのタイプは、シリーズで利用可能なトレンドラインと同じです。
 
 凡例に `TrendLineLayer` を表示する場合は、`UseLegend` プロパティを **true** に設定します。
 
-### トレンドライン レイヤーのスタイル設定
+## トレンドライン レイヤーのスタイル設定
 
 デフォルトでは、`TrendLineLayer` は `TargetSeries` と同じ色の破線で描画されます。これは、`TrendLineLayer` のさまざまなスタイル設定プロパティを使用して構成できます。
 

doc/jp/components/charts/features/chart-user-annotations.md

@@ -0,0 +1,94 @@
+---
+title: {Platform} チャートのユーザー注釈 | データ可視化 | インフラジスティックス
+_description: インフラジスティックスの {Platform} チャートのユーザー注釈
+_keywords: {Platform} Charts, User Annotations, Infragistics, {Platform} チャート, ユーザー注釈, インフラジスティックス
+mentionedTypes: ["DataChart", "UserAnnotationLayer", "UserStripAnnotation", "UserSliceAnnotation", "UserPointAnnotation", "Toolbar", "UserAnnotationInformation", "SeriesViewer"]
+namespace: Infragistics.Controls.Charts
+_language: ja
+---
+
+# {Platform} チャートのユーザー注釈レイヤー <label>PREVIEW</label>
+
+{ProductName} では、ユーザー注釈機能を使用して、実行時に `XamDataChart` にスライス注釈、ストリップ注釈、ポイント注釈を追加できます。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりするなど、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。
+
+これは、`Toolbar` のデフォルトのツールと統合されています。このトピックでは、`Toolbar` を使用してチャートのプロット領域にユーザー注釈を追加する方法と、これらのユーザー注釈をプログラムから追加する方法を、例と共に解説します。
+
+`sample="/charts/data-chart/user-annotation-layer", height="500", alt="{Platform} 近似曲線の例"`
+
+> [!Note]
+> この機能は X 軸と Y 軸をサポートするように設計されており、現在、ラジアル軸やアンギュラー軸はサポートされていません。
+
+## Toolbar でユーザー注釈を使用する
+
+`Toolbar` には、「Annotate Chart」 と 「Delete Note」 という 2 つのツールを含む Annotations メニュー項目が用意されています。このメニュー項目を表示するには、対象のチャートで `IsUserAnnotationsEnabled` プロパティを **true** に設定する必要があります。
+
+開いた後に表示される 「Annotate Chart」 オプションを使用すると、`XamDataChart` のプロット領域に注釈を付けることができます。追加できる注釈はスライス注釈、ストリップ注釈、ポイント注釈です。X 軸または Y 軸のラベルをクリックすると、スライス注釈を追加できます。プロット領域をクリックしてドラッグすることで、ストリップ注釈を追加できます。また、チャートにプロットされたシリーズ内のポイントをクリックして、ポイント注釈を追加することもできます。
+
+<img class="responsive-img" src="../../../images/charts/data-chart-user-annotation-create.gif"
+alt="{Platform} user-annotation-create"/>
+
+以前に追加した注釈を削除するには、[Delete Note] メニュー項目を選択した後、スライスまたは ストリップのユーザー注釈に対応する軸注釈、またはポイントのユーザー注釈に対応するデータ ポイントをクリックします。
+
+<img class="responsive-img" src="../../../images/charts/data-chart-user-annotation-delete.gif"
+alt="{Platform} user-annotation-delete"/>
+
+`XamToolbar` を使用してこれらのユーザー注釈を追加すると、`XamDataChart` は `UserAnnotationInformationRequested` イベントを発生させ、そこでユーザー注釈に関する追加情報を提供できます。このイベント引数には `AnnotationInfo` プロパティがあり、追加される注釈のさまざまな要素を構成可能な `UserAnnotationInformation` オブジェクトを返します。
+
+以下の表は、`UserAnnotationInformation` で構成可能なさまざまなプロパティの詳細を示しています。
+
+| プロパティ | タイプ | 説明 |
+|------------|---------|-------------|
+|`AnnotationData`|`string`|このプロパティは、ユーザー注釈に追加情報を提供するためのものです。このプロパティは、`UserAnnotationToolTipContentUpdating` イベントと組み合わせて使用され、注釈のツールチップに追加情報を表示するよう設計されています。|
+|`AnnotationId`|`string`|この読み取り専用プロパティは、ユーザー注釈の一意の文字列 ID を返します。|
+|`BadgeColor`|`string`|このプロパティは、ユーザー注釈のバッジに使用する色を取得または設定します。|
+|`BadgeImageUri`|`string`|このプロパティは、ユーザー注釈のバッジに使用する画像へのパスを取得または設定します。|
+|`DialogSuggestedXLocation`|`double`|このプロパティは、ユーザー注釈が追加された位置に基づいて、ダイアログを表示する推奨 X 座標を取得します。|
+|`DialogSuggestedYLocation`|`double`|このプロパティは、ユーザー注釈が追加された位置に基づいて、ダイアログを表示する推奨 Y 座標を取得します。|
+|`Label`|`string`|このプロパティは、ユーザー注釈に表示するラベルを取得または設定します。|
+|`MainColor`|`string`|このプロパティは、ユーザー注釈の背景を塗りつぶすために使用する色を取得または設定します。|
+
+`UserAnnotationInformationRequested` イベントで注釈情報を更新した後、`XamDataChart` の `FinishAnnotationFlow` メソッドを呼び出して注釈の作成を完了し、変更を確定する必要があります。あるいは、`CancelAnnotationFlow` を呼び出して注釈の `AnnotationId` を渡すことで注釈の作成をキャンセルすることもできます。注釈の `AnnotationId` は、前述のように、`UserAnnotationInformationRequested` イベントの引数の AnnotationInfo パラメーターから取得できます。これにより、プロット領域から注釈が削除されます。
+
+## ユーザー注釈をプログラムで使用する
+
+`UserAnnotationLayer` をプログラムで使用する場合、`XamDataChart` に対して 2 つのメソッドを呼び出し、ユーザー注釈の追加または削除を行えるモードに切り替えることができます。これらのメソッドは `StartCreatingAnnotation` と `StartDeletingAnnotation` です。
+
+`StartCreatingAnnotation` を呼び出した後は、X または Y 軸のラベルをクリックしてスライス注釈を追加したり、プロット領域をクリックしドラッグしてからマウスボタンを離してストリップ注釈を追加したり、チャート内のシリーズ上のデータ ポイントをクリックしてポイント注釈を追加したりできます。
+
+これらのユーザー注釈のいずれかを追加すると、`UserAnnotationInformationRequested` イベントが発生し、ユーザー注釈に関する詳細情報を提供できます。このイベント引数には `AnnotationInfo` プロパティがあり、追加される注釈のさまざまな要素を構成可能な `UserAnnotationInformation` オブジェクトを返します。
+
+`UserAnnotationInformationRequested` イベントで注釈情報を更新した後、`XamDataChart` の `FinishAnnotationFlow` メソッドを呼び出して注釈の作成を完了し、変更を確定する必要があります。あるいは、`CancelAnnotationFlow` を呼び出して注釈の `AnnotationId` を渡すことで注釈の作成をキャンセルすることもできます。注釈の `AnnotationId` は、前述のように、`UserAnnotationInformationRequested` イベントの引数の AnnotationInfo パラメーターから取得できます。これにより、プロット領域から注釈が削除されます。
+
+ユーザー注釈がチャートに追加されると、`Series` コレクションに `UserAnnotationLayer` として表示されます。`UserAnnotationLayer` には、プロット領域に追加された注釈の種類に応じて `UserSliceAnnotation`、`UserStripAnnotation`、および `UserPointAnnotation` 要素を保存できる `Annotations` コレクションがあります。
+
+## UserAnnotationToolTip
+
+各ユーザー注釈は、マウス ホバー時にツールチップを表示し、さらに詳細な情報を提供できます。
+
+チャートは `UserAnnotationToolTipContentUpdating` イベントを公開しており、ツールチップが表示される際にその内容を更新できます。このイベント引数には `Content` と `AnnotationInfo` の 2 つのプロパティがあります。
+
+ツールチップは `UserAnnotationInformationRequested` イベントと連動する設計になっており、そのイベントで `AnnotationInfo.AnnotationData` に設定した追加情報を、ツールチップ表示時にも利用できます。`UserAnnotationToolTipContentUpdating` イベントのイベント引数の `AnnotationInfo` プロパティは、そのイベントで変更できる `UserAnnotationInformationRequested` の `AnnotationInfo` プロパティと同じインスタンスになります。これにより、ユーザー注釈の作成時に提供された情報を活用し、ツールチップ内にさらに多くの情報を提供できるようになります。
+
+
+## API リファレンス
+
+以下は上記のセクションで説明した API メンバーのリストです。
+
+- `XamDataChart`.`SeriesViewer.IsUserAnnotationsEnabled`
+- `XamDataChart`.`SeriesViewer.UserAnnotationInformationRequested`
+- `XamDataChart`.`SeriesViewer.userAnnotationToolTipContentUpdating`
+- `XamDataChart`.`SeriesViewer.CancelAnnotationFlow`
+- `XamDataChart`.`SeriesViewer.StartCreatingAnnotation`
+- `XamDataChart`.`SeriesViewer.StartDeletingAnnotation`
+- `UserAnnotationInformation`
+- `UserSliceAnnotation`
+- `UserStripAnnotation`
+- `UserPointAnnotation`
+- `Toolbar`
+
+## その他のリソース
+
+関連するチャート機能の詳細については、次のトピックを参照してください。
+
+- [チャートの注釈](chart-annotations.md)
+- [チャートのデータ注釈](chart-data-annotations.md)

doc/jp/components/charts/types/area-chart.md

@@ -94,11 +94,8 @@ _language: ja
 
 `sample="/charts/category-chart/step-area-multiple-sources", height="600", alt="{Platform} ステップ エリア チャート"`
 
-
 <div class="divider--half"></div>
 
-## 高度なタイプのエリア チャート
-
 次のセクションでは、簡略化された API を使用した `CategoryChart` コントロールの代わりに `XamDataChart` コントロールを使用して作成できる、より高度なタイプの {Platform} エリア チャートについて説明します。
 
 ## {Platform} 範囲エリア チャート

doc/jp/components/charts/types/line-chart.md

@@ -8,6 +8,7 @@ namespace: Infragistics.Controls.Charts
 _language: ja
 ---
 # {Platform} 折れ線チャート
+
 {ProductName} 折れ線チャート (または折れ線グラフ) は、カテゴリ チャートの一種で、一定期間にわたる 1 つ以上の数量の直線セグメントで接続されたポイントで表される連続データ値を示します。トレンドの表示や比較分析によく使用されます。Y 軸 (左側のラベル) は数値を示し、X 軸 (下側のラベル) は時系列または比較カテゴリを示します。比較する 1 つ以上のデータセットを含めることができます。これはチャートで複数の線として描画されます。
 
 ## {Platform} 折れ線チャートの例

doc/jp/components/charts/types/radial-chart.md

@@ -53,9 +53,7 @@ _language: ja
 
 ## {Platform} ラジアル チャートのスタイル設定
 
-ラジアル チャートを作成したら、線の色、マーカーの種類、またはそれらのマーカーのアウトライン色の変更など、スタイルをさらにカスタマイズしたい場合があります。
-
-この例は、`XamDataChart` コントロールのスタイルをカスタマイズする方法を示しています。
+ラジアル チャートを作成したら、線の色、マーカーの種類、またはそれらのマーカーのアウトライン色の変更など、スタイルをさらにカスタマイズしたい場合があります。この例は、`XamDataChart` コントロールのスタイルをカスタマイズする方法を示しています。
 
 `sample="/charts/data-chart/radial-area-chart-styling", height="600", alt="{Platform} ラジアル エリア チャートのスタイル設定"`
 

doc/jp/components/charts/types/stacked-chart.md

@@ -45,7 +45,6 @@ _language: ja
 `sample="/charts/data-chart/stacked-100-area-chart", height="600", alt="{Platform} 積層型 100 エリア チャート"`
 
 
-
 <div class="divider--half"></div>