ScanIndexedColorUsage metoda
Vrne determinističen popis vseh 56 fizičnih rež palete delovnega zvezka ter definicij in sklicev indeksiranih barv, ki jih uporabljajo
Metoda je na voljo tako pri IXLSWorkbook kot pri TXLSXWorkbook in ne spreminja palete, celic, slogev, pogojnih oblik ali stanja delovnega zvezka
Skladnja
function ScanIndexedColorUsage: TXLSIndexedColorUsageArray;
Rezultat
Vrnjena tabela vedno vsebuje 56 vnosov v naraščajočem vrstnem redu fizičnih rež od 8 do 63
| Polje | Pomen |
|---|---|
ColorIndex | Ustrezni javni indeks palete od 1 do 56 |
PaletteSlot | Fizična reža indeksiranih barv BIFF ali OOXML od 8 do 63 |
ARGB | Normalizirana motna barva, ki je trenutno shranjena v reži, ali nič, če je ni mogoče razrešiti |
DefinitionCount | Število indeksiranih definicij, ki kažejo na režo |
ReferenceCount | Število objektov, celic ali pokritih položajev pogojnih oblik, ki se sklicujejo na te definicije |
Kinds | Množica, ki opisuje vsako opaženo kategorijo porabnikov |
Locked | Res, ko ima reža vsaj eno definicijo ali sklic in jo mora zato ohraniti načrt optimizacije palete |
Pokritje porabnikov
Kinds lahko vključuje pisave, ospredja polnil, ozadja polnil, prelivanja, robove, pogojne oblike, diagrame, oblike, pripombe, nastavitve delovnih listov in druge indeksirane porabnike
Preiskovanje Classic XLS vključuje pisave, polnila in robove XF, mrežne črte delovnih listov, barve oblik in pripomb, sklice pisav bogatega besedila in diagramov, zapuščinske pogojne oblike ter podatkovne pasove ali barvna merila BIFF12
Preiskovanje XLSX vključuje materializirane sklice na stile celic, preglasitve slogev, poimenovane sloge, zbirke pisav, polnil, prelivanj in robov, diferencialne sloge, podatkovne pasove in barvna merila
Direktni RGB, teme, samodejne, sistemske in neveljavne barvne žetone ne zaklenijo fizičnih rež palete
Učinkovitost in pogodba o stanju
Preiskovanje preišče samo shranjene redke celice in obstoječe metapodatke o stilih; ne materializira zapakiranih celic in ne ponavlja neuporabljenih koordinat delovnega lista
Števci uporabljajo nasičeno 64-bitno aritmetiko, zato veliki obsegi ne morejo prelivati v manjšo vrednost
Ponovljeni klici nad nespremenjenim delovnim zvezkom vrnejo identične vnose in pustijo števce barv po meri ter statistiko shrambe nespremenjene
Primer
Usage := Workbook.ScanIndexedColorUsage;
for I := 0 to High(Usage) do
if Usage[I].Locked then
PreservePaletteSlot(Usage[I].PaletteSlot);