Unit: lxHandleX
سلاسل المخططات بنطاقات صيغ وقيم مخزنة مؤقتًا وتسميات بيانات ومجموعة خطوط اتجاه وأشرطة خطأ X/Y
الوصف
تحتفظ كل سلسلة باسمها المعروض، وصيغة الاسم الاختيارية، وصيغة الفئات أو X، وصيغة القيم أو Y، وصيغة حجم الفقاعة، والذاكرة المؤقتة النصية أو الرقمية المخزنة بجوار كل صيغة. وتحسّن النقاط المخزنة مؤقتًا العرض دون اتصال وتبقى سليمة عبر تعديلات المخطط ونسخ أوراق العمل ودورات الفتح والحفظ
علامات السلسلة والتنعيم
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | لون تعبئة علامة السلسلة في المخططات الخطية والانتشار بوصفه LongWord يحمل قيمة RGB؛ والقيمة 0 تُبقي اللون المظهري التلقائي في Excel |
| MarkerBorderColor | لون حدود علامة السلسلة بوصفه LongWord يحمل قيمة RGB |
| Smooth | القيمة True تعرض السلسلة منحنى منعّمًا بدلًا من مقاطع خطوط مستقيمة؛ وتُستخدم مقترنة بـ MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | ما إذا كان علم التنعيم قد ضُبط صراحةً، إذ يتوقف على ذلك إصدار علم التنعيم في OOXML |
| LegendDeleted | القيمة True تُخرج هذه السلسلة من وسيلة الإيضاح مع إبقائها مرسومة، عبر إصدار حذف c:legendEntry لفهرس السلسلة |
فئات متعددة المستويات
property CategoriesMultiLevel: Boolean;
property CategoryLevelCount: Integer;
property CategoryLevels[Index: Integer]: TXLSXChartDataCache;
function AddCategoryLevel: TXLSXChartDataCache;
procedure ClearCategoryLevels;
procedure ResolveCategoryLevels;
function BuildCategorySpans(APointCount: Integer;
out ASpans: TXLSXChartCategorySpans): Integer;
ترتب مستويات الفئات الأوراق أولًا، بما يطابق الترتيب الفيزيائي للذاكرة المؤقتة في ChartML، ويمثل كل مستوى ذاكرة سلاسل نصية مفهرسة متناثرة. وتورّث النقاط الناقصة التسمية السابقة في مستواها، بينما تبدأ السلسلة الفارغة المخزنة صراحةً نطاقًا فارغًا وتمنع الدمج عبر المجموعات المتجاورة
يُجسّد ResolveCategoryLevels نطاق فئات ثنائي الأبعاد يمكن الوصول إليه مرة واحدة، وإلا أبقى الذاكرة المؤقتة المستوردة كما هي. ويعيد BuildCategorySpans نطاقات واعية بالأصل في زمن O(levels × points) بحيث لا يُدمج النص الابن المتساوى إلا داخل نطاق الأصل نفسه
تسميات بيانات مصدرها الخلايا
property DataLabelsRange: WideString;
property DataLabelsCache: TXLSXChartDataCache;
property ShowDataLabelsRange: Boolean;
property ShowDataLabelsRangeSet: Boolean;
property SeparatorSet: Boolean;
property DataLabelRangeOverrideCount: Integer;
property DataLabelRangeOverrideIndexes[Index: Integer]: Integer;
property DataLabelRangeOverrideValues[Index: Integer]: Boolean;
procedure ResolveDataLabelsRange;
procedure SetPointShowDataLabelsRange(APointIndex: Integer;
AVisible: Boolean);
procedure ClearPointShowDataLabelsRangeOverrides;
function TryGetPointShowDataLabelsRange(APointIndex: Integer;
out AVisible: Boolean): Boolean;
DataLabelsRange هو صيغة A1 على مستوى السلسلة، ويحتفظ DataLabelsCache بالنص المفهرس المخزن مع المخطط. وتُحدَّث نطاقات أوراق العمل الداخلية مرة واحدة لكل توليد للمصنف، بينما تحفظ الصيغ غير القابلة للوصول أو الخارجية ذاكرتها المؤقتة المستوردة ولا تطلق قط وصولًا ضمنيًا إلى الملفات أو الشبكة
يحفظ ShowDataLabelsRangeSet ما إذا كانت الرؤية المشتركة قد وردت صراحةً، وتصون طرق النقاط تجاوزات رؤية متناثرة مفهرسة من الصفر. ويُركَّب نص الخلية المخصص قبل مكونات اسم السلسلة والفئة والقيمة والنسبة وحجم الفقاعة، ولا يُدرج الفاصل إلا بين المكونات غير الفارغة
تبقى TXLSXChart.DataLabelsRange واجهة توافقية (facade)؛ وتبثّ الدالة المضبطة (setter) القيمة إلى السلاسل القائمة وتزرعها في السلاسل اللاحقة، بينما لا تعيد الدالة الراجعة (getter) قيمة إلا إذا استخدمت كل السلاسل الصيغة نفسها
الخصائص
Name
NameRange
CategoriesRange
ValuesRange
BubbleSizeRange
DataLabelsRange
NameCache
CategoryCache
CategoriesMultiLevel
CategoryLevelCount
CategoryLevels
ValueCache
BubbleSizeCache
DataLabelsCache
DataLabelRangeOverrideCount
DataLabelRangeOverrideIndexes
DataLabelRangeOverrideValues
TrendlineCount
Trendlines
ErrBarX
ErrBarY
ShowValue
ShowCategoryName
ShowSeriesName
ShowLegendKey
ShowPercent
ShowBubbleSize
ShowDataLabelsRange
ShowDataLabelsRangeSet
Separator
SeparatorSet
MarkerFillColor
MarkerBorderColor
Smooth
SmoothSet
LegendDeleted
النقاط المخزنة مؤقتًا
اضبط نوع الذاكرة المؤقتة على xlsxChartCacheString أو xlsxChartCacheNumber، واضبط FormatCode اختياريًا للبيانات الرقمية، ثم أضف النقاط المفهرسة. والذاكرات الرقمية بلا كود تنسيق صريح تستخدم General عند الكتابة
الطرق
procedure Assign
function AddTrendline
function AddErrorBar
function AddCategoryLevel
procedure ClearCategoryLevels
procedure ResolveCategoryLevels
function BuildCategorySpans
procedure ResolveDataLabelsRange
procedure SetPointShowDataLabelsRange
procedure ClearPointShowDataLabelsRangeOverrides
function TryGetPointShowDataLabelsRange
انظر أيضًا