توثيق HotXLS

فئة TXLSXChartAxis

الوحدة: lxHandleX
وصف مكتوب الأنواع لمحاور الفئات والقيم والتاريخ والسلاسل، للمحاور الرئيسية والثانوية وثلاثية الأبعاد في المخططات

الوصف

يملك كل مخطط محورَي فئات وقيم رئيسيين ومحورَي فئات وقيم ثانويين ومحور عمق للسلاسل. يمكن أن يبقى نوع المحور تلقائياً أو يُضبط إلى فئات أو قيم أو تاريخ أو سلاسل، بينما تبقى معرفات المحاور المستوردة وروابط التقاطع مستقرة عبر دورات الحفظ

الإعلان

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نوع المحور — تلقائي، فئات، قيم، تاريخ أو سلاسل
Positionموضع المحور داخل منطقة الرسم — عادي، منخفض أو مرتفع
AxisIdمعرف محور مستقر يُحفظ عبر دورات الحفظ
CrossAxisIdمعرف المحور الذي يتقاطع معه محور التقاطع
Visibleما إذا كان المحور يُرسَم
Titleنص عنوان المحور
LogBaseأساس المقياس اللوغاريتمي؛ الصفر يختار الخطي
Orientationاتجاه المحور — عادي أو معكوس
MajorGridlinesإظهار خطوط الشبكة الرئيسية على مسافة الوحدة الرئيسية
MinorGridlinesإظهار خطوط الشبكة الثانوية على مسافة الوحدة الثانوية
MinValueقيمة دنيا ثابتة؛ NaN يختار التلقائي
MaxValueقيمة عظمى ثابتة؛ NaN يختار التلقائي
MajorUnitتباعد خطوط الشبكة الرئيسية؛ الصفر يختار التلقائي
MinorUnitتباعد خطوط الشبكة الثانوية؛ الصفر يختار التلقائي
MajorUnitSetما إذا كانت قيمة وحدة رئيسية موجبة موجودةً صراحة
MinorUnitSetما إذا كانت قيمة وحدة ثانوية موجبة موجودةً صراحة
CrossesAtالقيمة التي يتقاطع عندها محور التقاطع؛ NaN يختار التلقائي
TickLblPosموضع تسميات التدريج — ‏'nextTo' أو 'low' أو 'high' أو 'none'
Crossesوضع تقاطع المحور. إسناد Crosses يُصدر <c:crosses val="..."/> بدلاً من التقاطع التلقائي؛ ويبقى CrossesAt الصريح متفوقاً عندما يُضبط (ضبط كليهما معاً يخالف OOXML ولهما CrossesAt الأولوية)
CrossesSetما إذا كان وضع التقاطع قد ضُبط صراحة
MajorTickMarkنمط علامة التدريج الرئيسية، وتُرسَم عند تقاطعات خطوط الشبكة الرئيسية
MinorTickMarkنمط علامة التدريج الثانوية، وتُرسَم عند تقاطعات خطوط الشبكة الثانوية
DispUnitsمعامل قياس وحدات العرض ‏(10، 100، 1000 ...) أو وحدة مدمجة؛ الصفر يعطّل
ShowDispUnitsLabelإظهار تسمية وحدة العرض ‏('Thousands' أو 'Millions' ...) بجانب المحور
BaseTimeUnitوحدة الوقت الأساسية لمحور التاريخ؛ إسنادها يجعل القيمة صريحة حتى عندما تكون xlsxChartTimeDays
MajorTimeUnitوحدة الوقت الرئيسية لمحور التاريخ؛ إسنادها يجعل القيمة صريحة
MinorTimeUnitوحدة الوقت الثانوية لمحور التاريخ؛ إسنادها يجعل القيمة صريحة
BaseTimeUnitSetيتحكم فيما إذا كان baseTimeUnit يُصدَر؛ False يحافظ على عنصر المصدر المحذوف بدلاً من كتابة وحدة يوم صريحة
MajorTimeUnitSetيتحكم فيما إذا كان majorTimeUnit يُصدَر باستقلال عن MajorUnit
MinorTimeUnitSetيتحكم فيما إذا كان minorTimeUnit يُصدَر باستقلال عن MinorUnit
AutoDateAxisقيمة صريحة لكشف الفئات التلقائي لمحور التاريخ
AutoDateAxisSetيتحكم فيما إذا كان عنصر auto لمحور التاريخ يُصدَر
NumberFormatتنسيق الأرقام المطبق على تسميات المحور؛ إسناده يجعل التنسيق صريحاً
NumberFormatSourceLinkedما إذا كان تنسيق تسميات المحور يتبع بيانات المصدر؛ إسناده يجعل التنسيق صريحاً
NumberFormatSetيتحكم فيما إذا كان عنصر ChartML ‏numFmt يُصدَر
LabelIntervalالفاصل بين تسميات الفئات
TickMarkIntervalالفاصل بين علامات التدريج على محور الفئات
NoMultiLevelLabelsقيمة True تعرض مستوى الفئات الورقي فقط وتكتب مفتاح noMultiLvlLbl لمحور الفئات
TextStyleنمط النص لتسميات التدريج
TitleTextStyleنمط النص لعنوان المحور
TitleLayoutموضع عنوان المحور وحجمه

اختيار المحور

يختار xlsxAxisAutomatic محور فئات لمجموعات المخططات العادية ومحور قيم لمجموعات التشتت أو الفقاعات. استخدم xlsxAxisDate مع خصائص وحدات الوقت للقياس التقويمي، وxlsxAxisSeries لمحور عمق ثلاثي الأبعاد
قيم وحدات محور التاريخ وأعلام وجودها مستقلة عن بعضها. لذلك تحتفظ الملفات المستوردة بالعناصر المحذوفة، بينما تؤدي إسناد وحدة إلى كتابة تلك القيمة صراحة. ويعمل AssignClassicDateAxis على تعيين إعدادات محور التاريخ الكلاسيكية النشطة مع ترك الحقول الخام المقنعة أو غير الصالحة في نموذج المصدر، لضمان رجوع كلاسيكي بلا فقد
عندما تُحذف الوحدات أو الفواصل، يفحص العرض جميع السلاسل المرئية مرة واحدة، ويستنتج قياس اليوم أو الشهر أو السنة، ويختار كثافة تسميات محدودة الحدود اعتماداً على النطاق المرئي وعرض المحور والنص المقاس وتنسيق الأرقام والتدوير. وتستهلك التسميات الرئيسية والثانوية والإحداثيات وعلامات التدريج وخطوط الشبكة المجموعات المشتركة الناتجة
يحتفظ NumberFormat وNumberFormatSourceLinked بحالة تنسيق تسميات ChartML. تستخدم محاور التاريخ ذلك التنسيق لتسميات التدريج المرسومة، ويعكس Orientation إحداثيات التدريج والبيانات معاً دون طي التواريخ المكررة أو التباعد المتساوي للتواريخ المتناثرة
ترسم محاور الفئات مخازن السلاسل الهرمية من المستوى الورقي الأقرب إلى المحور وصولاً إلى المستويات الأم تلو الآخر. ويمنع NoMultiLevelLabels المستويات الأم ويطابق علم المخطط الكلاسيكي المكافئ عند تحويل النماذج

تخطيط النص والعنوان

ينسّق TextStyle تسميات التدريج، بينما ينسّق TitleTextStyle عنوان المحور. ويكشف كلاهما إعدادات مكتوبة الأنواع للاسم والحجم واللون والتوكيد والتدوير. قيم التدوير الموجبة في ChartML تكون باتجاه عقارب الساعة وتُحوَّل إلى اصطلاح كل خلفية إخراج على حدة
يحدد TitleLayout موضع عنوان المحور وحجمه بإحداثيات ChartML المطبَّعة. استخدم SetPositionAndSize لتمكين القيم الأربع وضبطها كمجموعة واحدة متوافقة مع Office

الأساليب

procedure Assign

انظر أيضاً