Class Chart

チャートを取り扱うクラスです。

Methods

chartWizard clearAllCategoryFilter clearAllSeriesFilter clearBackgroundPicture clearCategoryFilter clearSeriesFilter deleteAxis getAutoScaling getAxes getBackWall getBarShape getCategoryNameLevel getChartArea getChartColor getChartGroups getChartStyle getChartTitle getChartType getDataSource getDataTable getDepthPercent getDisplayBlanksAs getDisplayValueNotAvailableAsBlank getElevation getFloor getFullSeriesCollection getGapDepth getHeightPercent getLegend getPageSetupObject getPerspective getPlotArea getPlotBy getPlotVisibleOnly getProtectContents getProtectDrawingObjects getProtectFormatting getProtectSelection getRightAngleAxes getRotation getSeriesCollection getSeriesNameLevel getSideWall hasAxis hasDataTable hasLegend hasTitle pivotChartWizard setAllFieldButtons setAutScaling setAxis setAxisFieldButtons setBackgroundPicture setBarShape setCategoryFilter setCategoryNameLevel setChartType setDataLabels setDataLabelsOverMaximum setDataSource setDataTable setDepthPercent setDisplayBlanksAs setDisplayValueNotAvailableAsBlank setElevation setExpandCollapseEntireFieldButtons setGapDepth setHeightPercent setLegend setLegendFieldButtons setPageSetupObject setPerspective setPlotVisibleOnly setProtectContents setProtectDrawingObjects setProtectFormatting setProtectSelection setRightAngleAxes setSeriesFilter setSeriesNameLevel setTitle setValueFieldButtons showAllFieldButtons showAxisFieldButtons showDataLabelsOverMaximum showExpandCollapseEntireFieldButtons showLegendFieldButtons showReportFilterFieldButtons showValueFieldButtons

Methods

chartWizard

  • chartWizard(source, chartType, plotBy, seriesLabelLines, categoryLabelLines, chartStyleNo?, chartColorNo?, hasLegend?, title?, categoryTitle?, valueTitle?, extraTitle?): void

  • チャートを作成します。

    1. Excelマクロとメソッドの引数の順番が違うので、注意してください。

    Parameters

    • source: string

      チャートに用いるデータ領域(A1C1形式またはテーブル名)

    • chartType: XlChartType

      チャート種類

    • plotBy: XlRowCol

      チャートの向き (データ系列が行方向にある場合、XlRowCol.Columnsとなります)

    • seriesLabelLines: number

      シリーズ方向のヘッダ行数(ヘッダなしの場合は、0となります)

    • categoryLabelLines: number

      カテゴリ方向のヘッダ行数(ヘッダなしの場合は、0となります)

    • chartStyleNo: number = 1

      チャートのグラフスタイル(1 ~ 最大14: チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します)

    • chartColorNo: XlChartColorPalette = enums.XlChartColorPalette.XlPaletteColorful1

      チャート色番号列挙体(Excel画面のグラフデザイン項目の色の変更項目を参照してください)

    • hasLegend: boolean = false

      true:凡例を表示する false:凡例を表示しない

    • title: string = ""

      チャートのタイトル(空文字の場合は設定しない)

    • categoryTitle: string = ""

      カテゴリー軸方向タイトル(空文字の場合は設定しない)

    • valueTitle: string = ""

      シリーズ軸方向タイトル(空文字の場合は設定しない)

    • extraTitle: string = ""

      3D軸方向タイトル(空文字の場合は設定しない)

    Returns void

clearAllCategoryFilter

  • clearAllCategoryFilter(): void

  • すべてのカテゴリー軸のフィルターを解除します。

    Returns void

clearAllSeriesFilter

  • clearAllSeriesFilter(): void

  • すべてのシリーズ軸のフィルターを解除します。

    Returns void

clearBackgroundPicture

  • clearBackgroundPicture(): void

  • チャートの背面の画像を除去します。

    Returns void

clearCategoryFilter

  • clearCategoryFilter(categoryIndex): void

  • 特定のカテゴリー軸のフィルターを解除します。

    Parameters

    • categoryIndex: number

      カテゴリー軸番号(1から始まります)

    Returns void

clearSeriesFilter

  • clearSeriesFilter(seriesIndex): void

  • 特定のシリーズ軸のフィルターを解除します。

    Parameters

    • seriesIndex: number

      シリーズ軸番号(1から始まります)

    Returns void

deleteAxis

  • deleteAxis(axisType, axisGroup?): void

  • チャートの軸を除去します。

    Parameters

    Returns void

getAutoScaling

  • getAutoScaling(): boolean

  • チャートのオブジェクトが自動スケールするかどうかを取得します。

    Returns boolean

    true:自動スケールする false:自動スケールしない

getAxes

  • getAxes(axisType, axisGroup?): Axis

  • チャートの軸クラスを取得します。

    Parameters

    Returns Axis

    チャートの軸クラス

getBackWall

  • getBackWall(): Walls

  • チャートの背面クラスを取得します。

    Returns Walls

    チャートの背面クラス

getBarShape

  • getBarShape(): XlBarShape

  • 3D棒グラフまたは列グラフで使用するBar形状を取得します。

    Returns XlBarShape

    Bar形状

getCategoryNameLevel

  • getCategoryNameLevel(): number

  • カテゴリラベルの表示行を取得します。

    1. -1は、非表示、0 は全表示、1以降は、ラベルの表示行となります。

    Returns number

    カテゴリラベルの表示行

getChartArea

  • getChartArea(): ChartArea

  • チャートの表示領域を取得します。

    Returns ChartArea

    チャートの表示領域

getChartColor

  • getChartColor(): number

  • チャート色番号列挙体の整数値を取得します。 (チャート色番号は、Excel画面のグラフデザイン項目の色の変更項目を参照してください)

    Returns number

    チャート色番号列挙体を整数値に変換した値

getChartGroups

  • getChartGroups(index): ChartGroup

  • チャートグループクラスを取得します。

    Parameters

    • index: number

      グループ番号(1から始まります)

    Returns ChartGroup

    チャートグループクラス

getChartStyle

  • getChartStyle(): number

  • チャートのグラフスタイルの内部番号を取得します。 (チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します) この番号は、Excel内部で保持しているグラフスタイルの番号となり、chartWizardメソッドで設定した1~14の値ではありません。

    Returns number

    チャートのグラフスタイルの内部番号

getChartTitle

  • getChartTitle(): ChartTitle

  • チャートのタイトルクラスを取得します。

    Returns ChartTitle

    チャートのタイトルクラス

getChartType

getDataSource

  • getDataSource(): string

  • チャートのデータソース(A1C1)領域を取得します。

    1. ピボットチャートの場合は、ピボットテーブル名を取得します。

    Returns string

    データソース(A1C1)領域

getDataTable

  • getDataTable(): DataTable

  • チャートのデータテーブルクラスを取得します。

    Returns DataTable

    チャートのデータテーブルクラス

getDepthPercent

  • getDepthPercent(): number

  • チャートの奥ゆき(パーセント)を取得します。

    Returns number

    奥ゆき(20～2000)

getDisplayBlanksAs

  • getDisplayBlanksAs(): XlDisplayBlanksAs

  • チャートの空白データの扱い方を取得します。

    Returns XlDisplayBlanksAs

    チャートの空白データの扱い方

getDisplayValueNotAvailableAsBlank

  • getDisplayValueNotAvailableAsBlank(): boolean

  • チャートの表示データのERRORデータを空白として扱うかどうかを示します。

    Returns boolean

    true：エラーを空白として扱う false：エラーを空白として扱わない

getElevation

  • getElevation(): number

  • チャートの表示角度を取得します。

    Returns number

    3D横棒グラフ(0～44) それ以外(-90～90)

getFloor

  • getFloor(): Floor

  • チャートの床領域クラスを取得します。

    Returns Floor

    チャートの床領域クラス

getFullSeriesCollection

  • getFullSeriesCollection(index): Series

  • 非表示のシリーズを含めたシリーズ(系列)クラスを取得します。

    Parameters

    • index: number

      シリーズ番号(1から始まります)

    Returns Series

    シリーズ(系列)クラス

getGapDepth

  • getGapDepth(): number

  • 3-Dグラフのデータ系列間の距離を取得します。

    Returns number

    (0～500) 値はマーカーの幅に対するパーセント値 (%)です。

getHeightPercent

  • getHeightPercent(): number

  • 3-Dグラフの高さをグラフの幅に対するパーセント値 (%) で取得します。

    Returns number

    (5～500)

getLegend

  • getLegend(): Legend

  • チャートの凡例領域のクラスを取得します。

    Returns Legend

    チャートの凡例領域のクラス

getPageSetupObject

  • getPageSetupObject(): PageSetupObject

  • 現在の印刷設定オブジェクトを取得します。

    Returns PageSetupObject

    現在の印刷設定オブジェクト

getPerspective

  • getPerspective(): number

  • 3Dグラフの視点位置(パーセント)を取得します。

    Returns number

    視点位置(パーセント) (0～100)

getPlotArea

  • getPlotArea(): PlotArea

  • チャートの表示ベース領域クラスを取得します。

    Returns PlotArea

    チャートの表示ベース領域クラス

getPlotBy

  • getPlotBy(): XlRowCol

  • チャートのデータの向きを取得します。

    Returns XlRowCol

    チャートのデータの向き

getPlotVisibleOnly

  • getPlotVisibleOnly(): boolean

  • チャートを非表示データを含めて描画するか取得します。

    Returns boolean

    true: 非表示データは含めない false:非表示データも含める

getProtectContents

  • getProtectContents(): boolean

  • チャートのデータの保護状態を取得します。

    Returns boolean

    true: 保護状態である false:保護状態でない

getProtectDrawingObjects

  • getProtectDrawingObjects(): boolean

  • チャートのグラフの保護状態を取得します。

    Returns boolean

    true: 保護状態である false:保護状態でない

getProtectFormatting

  • getProtectFormatting(): boolean

  • チャートの書式の保護状態を取得します。

    Returns boolean

    true: 書式が保護状態である false:書式が保護状態でない

getProtectSelection

  • getProtectSelection(): boolean

  • チャートの選択領域の保護状態を取得します。

    Returns boolean

    true: 選択領域が保護状態である false:選択領域が保護状態でない

getRightAngleAxes

  • getRightAngleAxes(): boolean

  • グラフの軸を直角、グラフの回転角または仰角とは無関係かどうかを取得します。

    1. 3D線グラフ、列グラフ、および棒グラフにのみ適用されます。

    Returns boolean

    true: 無関係 false: 無関係でない

getRotation

  • getRotation(): number

  • 3Dグラフの回転角(プロットエリアのz軸周りの回転角度)を取得します。

    Returns number

    3Dグラフの回転角

getSeriesCollection

  • getSeriesCollection(index): Series

  • シリーズ(系列)クラスを取得します。

    Parameters

    • index: number

      シリーズ番号(1から始まります)

    Returns Series

    シリーズ(系列)クラス

getSeriesNameLevel

  • getSeriesNameLevel(): number

  • シリーズラベルの表示行を取得します。

    1. -1は、非表示、0 は全表示、1以降は、ラベルの表示行となります。

    Returns number

    カテゴリラベルの表示行

getSideWall

  • getSideWall(): Walls

  • チャートの側面領域クラスを取得します

    Returns Walls

    チャートの側面領域クラス

hasAxis

  • hasAxis(axisType, axisGroup?): boolean

  • チャートが軸を持っているかどうかを取得します。

    Parameters

    Returns boolean

    true: 軸を持っている false:軸を持っていない

hasDataTable

  • hasDataTable(): boolean

  • チャートのデータテーブル領域が表示されているかどうかを取得します。

    Returns boolean

    true: チャートのデータテーブル領域が表示されている false: チャートのデータテーブル領域が表示されていない

hasLegend

  • hasLegend(): boolean

  • チャートの凡例領域が表示されているかどうかを示します。

    Returns boolean

    true: チャートの凡例領域が表示されている false:チャートの凡例領域が表示されていない

hasTitle

  • hasTitle(): boolean

  • チャートのタイトル領域が表示されているかどうかを取得します。

    Returns boolean

    true: チャートのタイトル領域が表示されている false: チャートのタイトル領域が表示されていない

pivotChartWizard

  • pivotChartWizard(source, chartType, chartStyleNo?, chartColorNo?): void

  • ピボットチャートを作成します。

    Parameters

    • source: string

      チャートに用いるデータ領域(ピボットテーブル名となります)

    • chartType: XlChartType

      チャート種類

    • chartStyleNo: number = 1

      チャートのグラフスタイル(1 ~ 最大14: チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します)

    • chartColorNo: XlChartColorPalette = enums.XlChartColorPalette.XlPaletteColorful1

      チャート色番号列挙体(Excel画面のグラフデザイン項目の色の変更項目を参照してください)

    Returns void

setAllFieldButtons

  • setAllFieldButtons(show): void

  • ピボットグラフのすべてのフィールド ボタンを表示するかどうかを取得します。

    Parameters

    • show: boolean

      true: 表示状態 false: 非表示状態

    Returns void

setAutScaling

  • setAutScaling(scaling): void

  • チャートのオブジェクトが自動スケールするかどうかを設定します。

    Parameters

    • scaling: boolean

      true:自動スケールする false:自動スケールしない

    Returns void

setAxis

  • setAxis(axisType, axisGroup?): void

  • チャートの軸を設定します。

    Parameters

    Returns void

setAxisFieldButtons

  • setAxisFieldButtons(show): void

  • ピボットグラフの軸フィールドボタンを表示するかどうかを設定します。

    Parameters

    • show: boolean

      true: 表示状態 false: 非表示状態

    Returns void

setBackgroundPicture

  • setBackgroundPicture(filePath): void

  • チャートの背面の画像を設定します。

    Parameters

    • filePath: string

      画像のファイルパス

    Returns void

    Throws

    IOError

setBarShape

  • setBarShape(shape): void

  • 3D棒グラフまたは列グラフで使用するBar形状を取得します。

    Parameters

    • shape: XlBarShape

      3D棒グラフまたは列グラフで使用するBar形状

    Returns void

setCategoryFilter

  • setCategoryFilter(categoryIndex): void

  • 特定のカテゴリー軸をフィルターします。

    Parameters

    • categoryIndex: number

      カテゴリー軸番号(1から始まります)。

    Returns void

setCategoryNameLevel

  • setCategoryNameLevel(categoryNameLevel): void

  • カテゴリラベルの表示行を設定します。

    1. -1は、非表示、0 は全表示、1以降は、ラベルの表示行となります。

    Parameters

    • categoryNameLevel: number

      カテゴリラベルの表示行

    Returns void

setChartType

  • setChartType(chartType): void

  • チャート種類を設定します。

    Parameters

    Returns void

setDataLabels

  • setDataLabels(legendKey, showLeaderLines, showSeriesName, showCategoryName, showValue, showPercentage, showBubbleSize, separator?): void

  • データラベルの表示有無を設定します。チャート全体に適用されます。

    Parameters

    • legendKey: boolean

      true:凡例のデータラベルを表示 false:表示しない

    • showLeaderLines: boolean

      true:導線のデータラベルを表示 false:表示しない

    • showSeriesName: boolean

      true:シリーズ名のデータラベルを表示 false:表示しない

    • showCategoryName: boolean

      true:カテゴリー名のデータラベルを表示 false:表示しない

    • showValue: boolean

      true:値のデータラベルを表示 false:表示しない

    • showPercentage: boolean

      true:値のパーセントのデータラベルを表示 false:表示しない

    • showBubbleSize: boolean

      true:バブルグラフのサイズのデータラベルを表示 false:表示しない

    • separator: string = ","

      データラベルの区切り文字(既定値:,)

    Returns void

setDataLabelsOverMaximum

  • setDataLabelsOverMaximum(show): void

  • 値が値軸の最大値より大きい場合にデータラベルを表示するかどうかを設定します。

    Parameters

    • show: boolean

      true:データラベルを表示しない false:データラベルを表示しない

    Returns void

setDataSource

  • setDataSource(source, plotBy, seriesLabelLines, categoryLabelLines): void

  • データソースを設定します。

    1. チャートがピボットチャートの場合、このメソッドは使用できません。

    Parameters

    • source: string

      データソース領域(A1C1またはテーブル名)

    • plotBy: XlRowCol

      データの向き

    • seriesLabelLines: number

      シリーズ方向のヘッダ行数(ヘッダなしの場合は、0となります)

    • categoryLabelLines: number

      カテゴリ方向のヘッダ行数(ヘッダなしの場合は、0となります)

    Returns void

setDataTable

  • setDataTable(show): void

  • チャートのデータテーブル領域が表示されているかどうかを設定します。

    Parameters

    • show: boolean

      true: 表示する false:表示しない

    Returns void

setDepthPercent

  • setDepthPercent(percent): void

  • チャートの奥ゆき(パーセント)を設定します。

    Parameters

    • percent: number

      奥ゆき(20～2000)

    Returns void

setDisplayBlanksAs

  • setDisplayBlanksAs(blank): void

  • チャートの空白データの扱い方を設定します。

    Parameters

    Returns void

setDisplayValueNotAvailableAsBlank

  • setDisplayValueNotAvailableAsBlank(blank): void

  • チャートの表示データのERRORデータを空白として扱うかどうかを設定します。

    Parameters

    • blank: boolean

      true：エラーを空白として扱う false：エラーを空白として扱わない

    Returns void

setElevation

  • setElevation(elevation): void

  • チャートの表示角度を設定します。

    Parameters

    • elevation: number

      角度

    Returns void

setExpandCollapseEntireFieldButtons

  • setExpandCollapseEntireFieldButtons(show): void

  • ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示するかどうかを設定します。

    Parameters

    • show: boolean

      true: 表示する false:表示しない

    Returns void

setGapDepth

  • setGapDepth(depth): void

  • 3-Dグラフのデータ系列間の距離を設定します。

    Parameters

    • depth: number

      距離(0～500) 値はマーカーの幅に対するパーセント値 (%)です。

    Returns void

setHeightPercent

  • setHeightPercent(percent): void

  • 3-Dグラフの高さをグラフの幅に対するパーセント値 (%) で設定します。

    Parameters

    • percent: number

      パーセント値 5～500

    Returns void

setLegend

  • setLegend(show): void

  • チャートの凡例領域が表示されているかどうかを設定します。

    Parameters

    • show: boolean

      true: チャートの凡例領域を表示する false:チャートの凡例領域を表示しない

    Returns void

setLegendFieldButtons

  • setLegendFieldButtons(show): void

  • ピボットグラフの凡例フィールドボタンを表示するかどうかを設定します。

    Parameters

    • show: boolean

      true:ピボットグラフの凡例フィールドボタンを表示する false:ピボットグラフの凡例フィールドボタンを表示しない

    Returns void

setPageSetupObject

  • setPageSetupObject(page): void

  • 現在の印刷設定を設定します。

    Parameters

    Returns void

setPerspective

  • setPerspective(perspective): void

  • 3Dグラフの視点位置(パーセント)を設定します。

    Parameters

    • perspective: number

      視点位置(パーセント) 0～100

    Returns void

setPlotVisibleOnly

  • setPlotVisibleOnly(plot): void

  • チャートを非表示データを含めて描画するかどうかを設定します。

    Parameters

    • plot: boolean

      true: 非表示データは含めない false:非表示データも含める

    Returns void

setProtectContents

  • setProtectContents(protect): void

  • チャートのデータの保護状態を設定します。

    Parameters

    • protect: boolean

      true: データを保護状態にする false:データを保護状態にしない

    Returns void

setProtectDrawingObjects

  • setProtectDrawingObjects(protect): void

  • チャートのグラフの保護状態を設定します。

    Parameters

    • protect: boolean

      true: グラフを保護状態にする false:グラフを保護状態にしない

    Returns void

setProtectFormatting

  • setProtectFormatting(protect): void

  • チャートの書式の保護状態を設定します。

    Parameters

    • protect: boolean

      true: 書式を保護状態にする false:書式を保護状態にしない

    Returns void

setProtectSelection

  • setProtectSelection(protect): void

  • チャートの選択領域の保護状態を設定します。

    Parameters

    • protect: boolean

      true: 選択領域を保護状態にする false:選択領域を保護状態にしない

    Returns void

setRightAngleAxes

  • setRightAngleAxes(axis): void

  • グラフの軸を直角、グラフの回転角または仰角とは無関係かどうかを設定します。

    Parameters

    • axis: boolean

      true: 無関係 false: 無関係でない

    Returns void

setSeriesFilter

  • setSeriesFilter(seriesIndex): void

  • 特定のシリーズ軸をフィルターします。

    Parameters

    • seriesIndex: number

      シリーズ軸番号(1から始まります)。

    Returns void

setSeriesNameLevel

  • setSeriesNameLevel(seriesNameLevel): void

  • シリーズラベルの表示行を設定します。

    1. -1は、非表示、0 は全表示、1以降は、ラベルの表示行となります。

    Parameters

    • seriesNameLevel: number

      シリーズラベルの表示行

    Returns void

setTitle

  • setTitle(show): void

  • チャートのタイトル領域が表示されているかどうかを設定します。

    Parameters

    • show: boolean

      true: 表示する false:表示しない

    Returns void

setValueFieldButtons

  • setValueFieldButtons(show): void

  • ピボットグラフの値フィールドボタンを表示するかどうかを設定します。

    Parameters

    • show: boolean

      true: ピボットグラフの値フィールドボタンを表示する false:ピボットグラフの値フィールドボタンを表示する

    Returns void

showAllFieldButtons

  • showAllFieldButtons(): boolean

  • ピボットグラフのすべてのフィールド ボタンを表示しているかどうかを取得します。

    Returns boolean

    true: 表示状態 false: 非表示状態

showAxisFieldButtons

  • showAxisFieldButtons(): boolean

  • ピボットグラフの軸フィールドボタンを表示しているかどうかを取得します。

    Returns boolean

    true: 表示状態 false: 非表示状態

showDataLabelsOverMaximum

  • showDataLabelsOverMaximum(): boolean

  • 値が値軸の最大値より大きい場合にデータラベルを表示するかどうかを取得します。

    Returns boolean

    true:データラベルを表示しない false:データラベルを表示しない

showExpandCollapseEntireFieldButtons

  • showExpandCollapseEntireFieldButtons(): boolean

  • ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示されているかどうかを取得します。

    Returns boolean

    true: ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示されている

showLegendFieldButtons

  • showLegendFieldButtons(): boolean

  • ピボットグラフの凡例フィールドボタンを表示するかどうかを取得します。

    Returns boolean

    true: ピボットグラフの凡例フィールドボタンを表示する false: ピボットグラフの凡例フィールドボタンを表示しない

showReportFilterFieldButtons

  • showReportFilterFieldButtons(): boolean

  • ピボットグラフのレポートフィルターフィールドボタンを表示するかどうかを取得します。

    Returns boolean

    true: ピボットグラフのレポートフィルターフィールドボタンを表示する false:ピボットグラフのレポートフィルターフィールドボタンを表示しない

showValueFieldButtons

  • showValueFieldButtons(): boolean

  • ピボットグラフの値フィールドボタンを表示するかどうかを取得します。

    Returns boolean

    true: ピボットグラフの値フィールドボタンを表示する false:ピボットグラフの値フィールドボタンを表示する

Settings

Member Visibility

Theme

On This Page

   Copyright © 2023. OSB-OFFICE.Inc, All rights reserved.   Generated using TypeDoc