مستندات HotXLS

TXLSXChartAxis class

Unit: lxHandleX
Chart axis descriptor (orientation, log base, gridlines, min/max, major/minor units, cross point, tick-label position, display units)

Description

هر chart محورهای category و value اصلی، محورهای category و value ثانویه و یک محور عمق سری دارد. نوع محور می‌تواند خودکار بماند یا به category، value، تاریخ یا سری تنظیم شود، در حالی که شناسه‌های محور واردشده و پیوندهای تقاطع در چرخه‌های ذخیره‌سازی پایدار می‌مانند

اعلان

type
  TXLSXChartAxis = class
    property Kind: TXLSXChartAxisKind;
    property Position: TXLSXChartAxisPosition;
    property AxisId: Integer;
    property CrossAxisId: Integer;
    property Visible: Boolean;
    property Title: WideString;
    property LogBase: Double;
    property Orientation: TXLSXChartAxisOrientation;
    property MajorGridlines: Boolean;
    property MinorGridlines: Boolean;
    property MinValue: Double;
    property MaxValue: Double;
    property MajorUnit: Double;
    property MinorUnit: Double;
    property MajorUnitSet: Boolean;
    property MinorUnitSet: Boolean;
    property CrossesAt: Double;
    property TickLblPos: WideString;
    property Crosses: TXLSXChartCrosses;
    property CrossesSet: Boolean;
    property MajorTickMark: TXLSXChartTickMark;
    property MinorTickMark: TXLSXChartTickMark;
    property DispUnits: Double;
    property ShowDispUnitsLabel: Boolean;
    property BaseTimeUnit: TXLSXChartTimeUnit;
    property MajorTimeUnit: TXLSXChartTimeUnit;
    property MinorTimeUnit: TXLSXChartTimeUnit;
    property BaseTimeUnitSet: Boolean;
    property MajorTimeUnitSet: Boolean;
    property MinorTimeUnitSet: Boolean;
    property AutoDateAxis: Boolean;
    property AutoDateAxisSet: Boolean;
    property NumberFormat: WideString;
    property NumberFormatSourceLinked: Boolean;
    property NumberFormatSet: Boolean;
    property LabelInterval: Integer;
    property TickMarkInterval: Integer;
    property NoMultiLevelLabels: Boolean;
    property TextStyle: TXLSXChartTextStyle;
    property TitleTextStyle: TXLSXChartTextStyle;
    property TitleLayout: TXLSXChartLayout;
    procedure Assign(Source: TXLSXChartAxis);
    procedure AssignClassicDateAxis(Source: TXLSChartAxis);
  end;

ویژگی‌ها

Kindنوع محور — خودکار، category، value، تاریخ یا سری
Positionموقعیت محور در plot area — normal، low یا high
AxisIdشناسه پایدار محور که در چرخه‌های ذخیره‌سازی حفظ می‌شود
CrossAxisIdشناسه محوری که محور متقاطع با آن برخورد می‌کند
Visibleاینکه آیا محور رندر می‌شود
Titleمتن عنوان محور
LogBaseپایه مقیاس لگاریتمی؛ صفر یعنی خطی
Orientationجهت محور — normal یا معکوس
MajorGridlinesنمایش خطوط شبکه major با فاصله واحد major
MinorGridlinesنمایش خطوط شبکه minor با فاصله واحد minor
MinValueحداقل مقدار ثابت؛ NaN یعنی خودکار
MaxValueحداکثر مقدار ثابت؛ NaN یعنی خودکار
MajorUnitفاصله خطوط شبکه major؛ صفر یعنی خودکار
MinorUnitفاصله خطوط شبکه minor؛ صفر یعنی خودکار
MajorUnitSetاینکه آیا مقدار مثبت واحد major صراحتاً موجود است
MinorUnitSetاینکه آیا مقدار مثبت واحد minor صراحتاً موجود است
CrossesAtمقداری که محور متقاطع در آن برخورد می‌کند؛ NaN یعنی خودکار
TickLblPosموقعیت برچسب tick — ‏nextTo، low، high یا none
Crossesحالت برخورد محور. انتساب Crosses به‌جای برخورد خودکار <c:crosses val="..."/> منتشر می‌کند؛ وقتی تنظیم شده باشد، CrossesAt صریح همچنان برنده است (تنظیم هم‌زمان هر دو در OOXML نامعتبر است و CrossesAt اولویت می‌گیرد)
CrossesSetاینکه آیا حالت برخورد صراحتاً تنظیم شده است
MajorTickMarkسبک علامت tick major که در تقاطع‌های خطوط شبکه major رسم می‌شود
MinorTickMarkسبک علامت tick minor که در تقاطع‌های خطوط شبکه minor رسم می‌شود
DispUnitsضریب مقیاس واحد نمایشی (10، 100، 1000 ...) یا یک واحد داخلی؛ صفر غیرفعال می‌کند
ShowDispUnitsLabelنمایش برچسب واحد نمایشی ('Thousands'، 'Millions'، ...) کنار محور
BaseTimeUnitواحد زمانی پایه یک محور تاریخ؛ انتساب آن مقدار را صریح علامت‌گذاری می‌کند، حتی وقتی xlsxChartTimeDays باشد
MajorTimeUnitواحد زمانی major یک محور تاریخ؛ انتساب آن مقدار را صریح علامت‌گذاری می‌کند
MinorTimeUnitواحد زمانی minor یک محور تاریخ؛ انتساب آن مقدار را صریح علامت‌گذاری می‌کند
BaseTimeUnitSetکنترل می‌کند که آیا baseTimeUnit منتشر شود؛ False عنصر غایب منبع را حفظ می‌کند به‌جای نوشتن صریح واحد روز
MajorTimeUnitSetکنترل می‌کند که آیا majorTimeUnit مستقل از MajorUnit منتشر شود
MinorTimeUnitSetکنترل می‌کند که آیا minorTimeUnit مستقل از MinorUnit منتشر شود
AutoDateAxisمقدار صریح تشخیص خودکارِ category برای محور تاریخ
AutoDateAxisSetکنترل می‌کند که آیا عنصر auto محور تاریخ منتشر شود
NumberFormatقالب عددی اعمال‌شده روی برچسب‌های محور؛ انتساب آن قالب را صریح علامت‌گذاری می‌کند
NumberFormatSourceLinkedاینکه آیا قالب برچسب محور از داده منبع پیروی می‌کند؛ انتساب آن قالب را صریح علامت‌گذاری می‌کند
NumberFormatSetکنترل می‌کند که آیا عنصر numFmt در ChartML منتشر شود
LabelIntervalفاصله بین برچسب‌های category
TickMarkIntervalفاصله بین علامت‌های tick روی یک محور category
NoMultiLevelLabelsTrue فقط سطح برگ category را نمایش می‌دهد و کلید noMultiLvlLbl محور category را می‌نویسد
TextStyleسبک متن برچسب‌های tick
TitleTextStyleسبک متن عنوان محور
TitleLayoutموقعیت و اندازه عنوان محور

انتخاب محور

xlsxAxisAutomatic برای گروه‌های chart معمولی یک محور category و برای گروه‌های scatter یا bubble یک محور value انتخاب می‌کند. xlsxAxisDate را همراه با property های واحد زمان برای مقیاس‌بندی تقویمی به کار ببرید و xlsxAxisSeries را برای محور عمق سه‌بعدی
مقادیر واحد محور تاریخ و فلگ‌های حضورشان مستقل‌اند. بنابراین فایل‌های واردشده عناصر غایب را حفظ می‌کنند، در حالی که انتساب یک واحد آن مقدار را صریح می‌نویسد. AssignClassicDateAxis تنظیمات فعال محور تاریخ Classic را نگاشت می‌کند و فیلدهای خام ماسک‌شده یا نامعتبر را برای round-trip بدون افتِ Classic در مدل منبع باقی می‌گذارد
وقتی واحدها یا فواصل غایب باشند، رندر همه سری‌های نمایان را یک‌بار بررسی می‌کند، مقیاس‌بندی روز، ماه یا سال را استنتاج می‌کند و چگالی برچسب محدودشده‌ای را با توجه به بازه نمایان، عرض محور، متن اندازه‌گیری‌شده، قالب عددی و چرخش انتخاب می‌کند. برچسب‌ها، مختصات، tick ها و خطوط شبکه major و minor از مجموعه‌های مشترک حاصل تغذیه می‌شوند
NumberFormat و NumberFormatSourceLinked وضعیت قالب برچسب ChartML را حفظ می‌کنند. محورهای تاریخ از آن قالب برای برچسب‌های tick رندرشده استفاده می‌کنند و Orientation مختصات tick و داده را بدون فشرده‌سازی تاریخ‌های تکراری یا فاصله‌گذاری یکنواخت تاریخ‌های پراکنده معکوس می‌کند
محورهای category کش‌های سلسله‌مراتبی سری‌ها را از نزدیک‌ترین سطح برگ به محور تا سطوح والد بالاتر رندر می‌کنند. NoMultiLevelLabels سطوح والد را سرکوب می‌کند و هنگام تبدیل مدل‌ها فلگ معادل chart کلاسیک را نگاشت می‌کند

چیدمان متن و عنوان

TextStyle برچسب‌های tick را قالب‌بندی می‌کند و TitleTextStyle عنوان محور را. هر دو تنظیمات نوع‌دار نام، اندازه، رنگ، تأکید و چرخش را در معرض می‌گذارند. مقادیر چرخش مثبت در ChartML ساعت‌گرد هستند و به قرارداد بومی هر backend خروجی تبدیل می‌شوند
TitleLayout عنوان محور را با مختصات نرمال‌شده ChartML جای‌گذاری و اندازه‌بندی می‌کند. از SetPositionAndSize استفاده کنید تا هر چهار مقدار را به‌عنوان یک گروه سازگار با Office در یک فراخوانی فعال و تنظیم کنید

روش‌ها

procedure Assign

همچنین ببینید

XLSX Facade Overview
TXLSXWorksheet class
TXLSXWorkbook class
TXLSXChartTextStyle class
TXLSXChartLayout class