Unit: lxHandleX
Serie di grafico con intervalli di formule, valori in cache, etichette dati, raccolta di linee di tendenza e barre di errore X/Y
Descrizione
Una serie conserva il proprio nome visualizzato, la formula opzionale per il nome, la formula della categoria o dell'asse X, la formula dei valori o dell'asse Y, la formula della dimensione delle bolle e la cache di stringhe o numeri memorizzata accanto a ogni formula. I punti in cache migliorano il rendering offline e sopravvivono alle modifiche del grafico, alle copie dei fogli di lavoro e ai cicli di apertura/salvataggio
Marcatori della serie e smussatura
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Colore di riempimento del marcatore della serie per i grafici a linee o a dispersione, come LongWordRGB; 0 mantiene il colore a tema automatico di Excel |
| MarkerBorderColor | Colore del bordo del marcatore della serie, come LongWord |
| Smooth | la serie viene disegnata come curva smussata invece che come segmenti rettilinei; da abbinare a MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Indica se il flag di smussatura è stato impostato esplicitamente, e ne regola di conseguenza l'emissione del flag smooth OOXML |
| LegendDeleted | questa serie viene rimossa dalla legenda restando però disegnata nel grafico, con l'emissione di una voce c:legendEntry di eliminazione per il suo indice di serie |
Categorie multilivello
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;
I livelli di categoria sono ordinati partendo dalla foglia, secondo l'ordine fisico della cache ChartML. Ogni livello è una cache di stringhe indicizzata di tipo sparse. I punti mancanti ereditano l'etichetta precedente in quel livello, mentre una stringa vuota memorizzata esplicitamente apre un intervallo vuoto e impedisce l'unione attraverso gruppi adiacenti
ResolveCategoryLevels materializza una volta sola un intervallo di categorie bidimensionale accessibile e in tutti gli altri casi conserva la cache importata. BuildCategorySpans restituisce intervalli consapevoli del padre in tempo O(levels × points) , così il testo figlio uguale viene unito solo all'interno dello stesso intervallo padre
Etichette dati provenienti dalle celle
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 è una formula A1 per singola serie e DataLabelsCache conserva il testo indicizzato memorizzato insieme al grafico. Gli intervalli interni del foglio di lavoro vengono aggiornati una volta per generazione del workbook, mentre le formule inaccessibili o esterne mantengono la propria cache importata e non attivano mai accessi impliciti a file o alla rete
ShowDataLabelsRangeSet preserva il fatto che la visibilità condivisa fosse presente esplicitamente, e i metodi per punto gestiscono override di visibilità sparsi con base zero. Il testo personalizzato delle celle viene composto prima dei componenti nome della serie, categoria, valore, percentuale e dimensione delle bolle, inserendo il separatore solo tra componenti non vuoti
TXLSXChart.DataLabelsRange resta una facade di compatibilità: il suo setter propaga il valore alle serie esistenti e lo preimposta per le serie create dopo, mentre il getter restituisce un valore solo quando tutte le serie usano la stessa formula
Proprietà
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
Punti in cache
Impostare il tipo di cache su xlsxChartCacheString o xlsxChartCacheNumber, impostare facoltativamente FormatCode per i dati numerici, quindi aggiungere i punti indicizzati. Le cache numeriche senza un codice di formato esplicito usano General quando vengono scritte
Metodi
procedure Assign
function AddTrendline
function AddErrorBar
function AddCategoryLevel
procedure ClearCategoryLevels
procedure ResolveCategoryLevels
function BuildCategorySpans
procedure ResolveDataLabelsRange
procedure SetPointShowDataLabelsRange
procedure ClearPointShowDataLabelsRangeOverrides
function TryGetPointShowDataLabelsRange
Vedere anche