Chart.ApplyDataLabels メソッド (Word)
グラフのすべてのデータ系列にデータ ラベルを付けます。
構文
式。ApplyDataLabels (Type、 LegendKey、 AutoText、 HasLeaderLines、 ShowSeriesName、 ShowCategoryName、 ShowValue、 ShowPercentage、 ShowBubbleSize、 Separator)
expression は Chart オブジェクトを表す変数です。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| Type | 省略可能 | XlDataLabelsType | 適用するデータ ラベルの種類を指定するいずれかの列挙値。 xlDataLabelsType クラスの定数の 1 つを指定できます。 |
| LegendKey | 省略可能 | バリアント型 (Variant) | True の 要素の横に凡例マーカーを表示します。 既定では False です 。 |
| AutoText | 省略可能 | バリアント型 (Variant) | オブジェクトにより、内容を基にした適切な文字列を自動作成させる場合は True を指定します。 |
| HasLeaderLines | 省略可能 | バリアント型 (Variant) | Chart オブジェクトおよび Series オブジェクトで、データ系列に引き出し線を追加する場合は True を指定します。 |
| ShowSeriesName | 省略可能 | バリアント型 (Variant) | の 場合は true データ ラベルに系列名を有効にするにはそれ以外の場合、 false を指定 します。 |
| ShowCategoryName | 省略可能 | バリアント型 (Variant) | の 場合は true データ ラベルの分類名を有効にするにはそれ以外の場合、 false を指定 します。 |
| ShowValue | 省略可能 | バリアント型 (Variant) | の 場合は true データ ラベルの値を有効にするにはそれ以外の場合、 false を指定 します。 |
| ShowPercentage | 省略可能 | バリアント型 (Variant) | の 場合は true データ ラベルのパーセンテージを有効にするにはそれ以外の場合、 false を指定 します。 |
| ShowBubbleSize | 省略可能 | バリアント型 (Variant) | の 場合は true データ ラベルのバブル サイズを有効にするにはそれ以外の場合、 false を指定 します。 |
| Separator | 省略可能 | バリアント型 (Variant) | データ ラベルの区切り文字を指定します。 |
例
次の使用例は、作業中の文書の最初のグラフの最初のデータ系列に項目ラベルを付けます。
With ActiveDocument.InlineShapes(1)
If .HasChart Then
.Chart.SeriesCollection(1). _
ApplyDataLabels Type:=xlDataLabelsShowLabel
End If
End With
注:
[!メモ] セパレーター パラメーターの文字列を使用する場合、区切り記号として文字列が表示されます。 xlDataLabelSeparatorDefault (= 1) を使用すると、データ ラベルに応じて、既定のデータ ラベル区切り記号 (コンマまたは改行) が取得されます。値 1 が返されると、ユーザーが既定の区切り記号 (コンマ (,) を変更しなかったことを示します。 値 1 を渡して、区切り記号を既定の区切り記号に戻すこともできます。プログラムでデータ ラベルにアクセスする前に、グラフをアクティブにする必要があります。それ以外の場合は、実行時エラーが発生します。
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。