CreateLoadedCellCursor metoda
Ustvari vlečni kazalec nad shranjenimi celicami v naloženem delovnem zvezku XLSX, z možnostjo vključitve samostojno oblikovanih praznih celic
Skladnja
function CreateLoadedCellCursor: IXLSLoadedCellCursor; overload; function CreateLoadedCellCursor( AIncludeStoredBlanks: Boolean): IXLSLoadedCellCursor; overload;
Vrstni red prehoda in stroški
Kazalec obišče delovne liste v vrstnem redu zbirke, nato pa celice po naraščajoči vrstici in stolpcu
SheetIndex, Row in Col so javne koordinate s številčenjem od 1
Materializirani delovni listi se berejo neposredno iz njihovih dodeljenih redkih blokov po 256 vrsticah, brez izgradnje razvrščenega seznama celic
Zapakirani delovni listi se berejo neposredno prek iteratorja zapakirane shrambe in po prehodu ostanejo zapakirani
Stanje kazalca je konstantno glede na velikost delovnega zvezka in ne dodeljuje tabel, velikih kot so meje vrstic ali stolpcev XLSX
Preobtežitev brez parametrov izpusti prazne celice, oblikovane samo s slogom, shranjene vnosnike Empty in shranjene vnosnike Null
Posredujte True, če želite vključiti samostojno oblikovane prazne koordinate iz materializirane ali zapakirane shrambe, brez materializacije zapakiranih celic
Neoblikovani vnosniki Empty in Null ostanejo izključeni v obeh načinih
Polja posnetka
| Polje | Pomen |
|---|---|
SheetIndex / SheetName | Identiteta lastniškega delovnega lista v trenutku zajemanja |
Row / Col | Koordinate celice s številčenjem od 1 |
StyleIndex | Indeks formata celice XLSX, zajet iz materializirane ali zapakirane shrambe |
Kind | xlckText, xlckNumber, xlckDateTime, xlckBoolean, xlckFormula, xlckError ali xlckBlank |
Value | Lastniška vrednost Variant, zajeta za trenutno celico |
Formula | Besedilo formule za formulske celice, sicer prazen niz |
Nizi in Variant vrednosti v TXLSLoadedCellSnapshot so lastniške vrednosti in ne razkrijejo notranjih kazalcev celic ali zapakirane shrambe
Pri formulskih celicah XLSX je Value trenutno shranjena predpomnjena vrednost in prehod ne ponovno izračuna formule
Za xlckBlank je Value enak Unassigned, Formula je prazen, StyleIndex pa opredeli shranjeni format celice
Stanje, razveljavitev in življenjska doba
State je xlccBeforeFirst do prvega uspešnega MoveNext, xlccActive, dokler je Current na voljo, in xlccEof po zaključenem prehodu
Branje Current pred prvo celico ali po EOF sproži EXLSLoadedCellCursorState
Ustvarjanje ali brisanje shranjenih celic, materializacija zapakirane shrambe, izrecne ponovne izgradnje indeksov ali dodajanje, brisanje, premikanje ali počiščenje delovnih listov razveljavi kazalec
Naslednji klic MoveNext ali Current nato sproži EXLSLoadedCellCursorInvalidated
Spreminjanje vrednosti, formule ali oblike obstoječe celice ne razveljavi kazalca, že zajet posnetek pa ostane nespremenjen
Sprostitev delovnega zvezka pred kazalcem prav tako sproži EXLSLoadedCellCursorInvalidated, namesto da bi pustila kazalcu viseč kazalec na delovni zvezek
Preverjanje generacij je zaznavanje s hitro odpovedjo in ne naredi sočasnega spreminjanja ter prehoda varnega za niti
Primer
Cursor := Workbook.CreateLoadedCellCursor;
while Cursor.MoveNext do
begin
Cell := Cursor.Current;
Memo1.Lines.Add(Format('%s!R%dC%d = %s',
[Cell.SheetName, Cell.Row, Cell.Col, VarToStr(Cell.Value)]));
end;