HotXLS Docs
HomeContentsTXLSXChart

TXLSXChartLayout class

TXLSXChartLayout stores a complete normalized manual layout for plot areas, chart or axis titles and legends

Declaration

type
  TXLSXChartLayoutTarget = (xlsxChartLayoutOuter, xlsxChartLayoutInner);
  TXLSXChartLayoutMode = (xlsxChartLayoutFactor, xlsxChartLayoutEdge);

  TXLSXChartLayout = class
    property Enabled: Boolean;
    property HasTarget: Boolean;
    property HasXMode, HasYMode, HasWidthMode, HasHeightMode: Boolean;
    property HasX, HasY, HasWidth, HasHeight: Boolean;
    property Target: TXLSXChartLayoutTarget;
    property XMode, YMode, WidthMode, HeightMode: TXLSXChartLayoutMode;
    property X, Y, Width, Height: Double;
    procedure ClearTarget;
    procedure ClearXMode;
    procedure ClearYMode;
    procedure ClearWidthMode;
    procedure ClearHeightMode;
    procedure ClearX;
    procedure ClearY;
    procedure ClearWidth;
    procedure ClearHeight;
    procedure SetPositionAndSize(AX, AY, AWidth, AHeight: Double);
    procedure Assign(Source: TXLSXChartLayout);
    procedure Clear;
  end;

Coordinate model

X, Y, Width and Height are normalized against the chart rectangle Width and height are constrained to 0 through 1, while factor-based X and Y may use -1 through 1
モデルは各フィールドとモードを独立して保持します。読み込まれた省略は省略のまま維持され、無効な数値トークンは保存時もそのまま残りますが、描画時は自動ジオメトリにフォールバックします
タイトルのレイアウトには X と Y のみを含めることができ、自動的に測定されたサイズが保持されます。プロット エリアと凡例のレイアウトでは 4 つの座標すべてが必要です
SetPositionAndSize assigns all four values and enables the layout in one call This satisfies Excel's requirement that manual coordinates be emitted as a complete group

Modes and target

xlsxChartLayoutEdgePosition from the chart edge, used by default for X and Y
xlsxChartLayoutFactorSize or offset factor, used by default for width and height
TargetInner or outer plot rectangle and meaningful only for PlotAreaLayout

Example

TXLSXChartLayoutResolver は、ページング、SVG、PDF、画像、プレビュー、印刷、ビューアー、HTML 出力のために、タイトル、凡例、内側/外側のプロット領域、軸タイトルの矩形を 1 回だけ解決します。無効または不完全なジオメトリでは自動矩形が維持され、有効な範囲外の矩形はサイズを変えずにチャート内の最も近い位置へ移動します
ODF 変換では、解決されたジオメトリがチャートの絶対距離へマッピングされます。タイトルと凡例は svg:x and svg:y, while the plot area also uses svg:width and svg:height A manual ODF legend omits chart:legend-position を使用します。この属性は絶対座標をオーバーライドするためです

Example

Chart.PlotAreaLayout.Target := xlsxChartLayoutInner;
Chart.PlotAreaLayout.SetPositionAndSize(0.12, 0.18, 0.72, 0.64);
Chart.TitleLayout.SetPositionAndSize(0.1, 0.02, 0.6, 0.12);
Chart.LegendLayout.SetPositionAndSize(0.2, 0.84, 0.6, 0.1);

See also