ScanIndexedColorUsage metódus
Determinisztikus leltárt ad a munkafüzet mind az 56 fizikai palettahelyéről, valamint az azokat használó indexeltszín-definíciókról és hivatkozásokról
A metódus az IXLSWorkbook és a TXLSXWorkbook esetében egyaránt elérhető, és nem módosítja a palettát, a cellákat, a stílusokat, a feltételes formátumokat vagy a munkafüzet állapotát
Szintaxis
function ScanIndexedColorUsage: TXLSIndexedColorUsageArray;
Eredmény
A visszaadott tömb mindig 56 bejegyzést tartalmaz a fizikai helyek növekvő sorrendjében, 8-tól 63-ig
| Mező | Jelentés |
|---|---|
ColorIndex | A megfelelő nyilvános palettaindex 1-től 56-ig |
PaletteSlot | A fizikai BIFF vagy OOXML indexeltszín-hely 8-tól 63-ig |
ARGB | A helyen jelenleg tárolt normalizált, átlátszatlan szín, vagy nulla, ha nem oldható fel |
DefinitionCount | A helyre mutató indexelt definíciók száma |
ReferenceCount | Azoknak az objektumoknak, celláknak vagy fedett feltételes formátumú pozícióknak a száma, amelyek ezekre a definíciókra hivatkoznak |
Kinds | Minden megfigyelt fogyasztói kategóriát leíró halmaz |
Locked | True, ha a helynek van legalább egy definíciója vagy hivatkozása, ezért egy palettaoptimalizálási tervnek meg kell őriznie |
Fogyasztói lefedettség
A Kinds tartalmazhat betűtípusokat, kitöltés-előtereket, kitöltés-háttereket, gradienskitöltéseket, kereteket, feltételes formátumokat, diagramokat, alakzatokat, megjegyzéseket, munkalapbeállításokat és egyéb indexelt fogyasztókat
A Classic XLS átvizsgálás lefedi a betűtípusokat, az XF kitöltéseket és kereteket, a munkalap rácsvonalait, az alakzat- és megjegyzésszíneket, a rich-text és diagram betűtípus-hivatkozásokat, az örökölt feltételes formátumokat, valamint a BIFF12 adatsávokat vagy színskálákat
Az XLSX átvizsgálás lefedi a materializált cellastílus-hivatkozásokat, a stílusátfedéseket, a nevesített stílusokat, a betűtípus-, kitöltés-, gradiens- és keretkészleteket, a differenciális stílusokat, az adatsávokat és a színskálákat
A közvetlen RGB, téma, automatikus, rendszer- és érvénytelen színtokenek nem zárolnak fizikai palettahelyeket
Teljesítmény- és állapotszerződés
Az átvizsgálás csak a tárolt ritka cellákat és a meglévő stíluszmetaadatokat járja be; nem materializál csomagolt cellákat, és nem iterál a nem használt munkalapkoordinátákon
A számlálók szaturáló 64 bites aritmetikát használnak, így a nagy tartományok nem csomagolhatnak kisebb értékre
Az ismételt hívások változatlan munkafüzeten azonos bejegyzéseket adnak vissza, és az egyéni palettaszámokat és tárolási statisztikákat változatlanul hagyják
Példa
Usage := Workbook.ScanIndexedColorUsage;
for I := 0 to High(Usage) do
if Usage[I].Locked then
PreservePaletteSlot(Usage[I].PaletteSlot);