CreateLoadedCellCursor yöntemi
Yüklü bir klasik XLS çalışma kitabında saklanan hücreler üzerinde pull modelinde bir imleç oluşturur; bağımsız biçimlendirilmiş boşlukları dahil etme seçeneği sunar
Sözdizimi
function CreateLoadedCellCursor: IXLSLoadedCellCursor; overload; function CreateLoadedCellCursor( AIncludeStoredBlanks: Boolean): IXLSLoadedCellCursor; overload;
Gezinme sırası ve maliyet
İmleç çalışma sayfalarını koleksiyon sırasında, ardından hücreleri artan satır ve sütun sırasına göre ziyaret eder
SheetIndex, Rowve Col bire dayalı genel koordinatlardır
Gezinme, ayrılmış klasik seyrek depolama dallarını doğrudan izler; böylece imleç durumu sabit kalır ve çalışma sayfasının satır veya sütun sınırlarına göre boyutlanmış diziler ayırmaz
Parametresiz aşırı yükleme boşlukları atlar ve mevcut değer ve formül geçiş sözleşmesini korur
Hücre XF'i devralınan satır, sütun veya çalışma sayfası biçiminden farklı olan saklanan boş hücreleri dahil etmek için True geçirin
Yalnızca devralınan biçimlendirme bir boş koordinat oluşturmaz veya yaymaz
Anlık görüntü alanları
| Alan | Anlam |
|---|---|
SheetIndex / SheetName | Yakalama anında sahip çalışma sayfasının kimliği |
Row / Col | Bire dayalı hücre koordinatları |
StyleIndex | Klasik XF stil indeksi |
Kind (TXLSLoadedCellKind) | xlckText, xlckNumber, xlckDateTime, xlckBoolean, xlckFormulaveya xlckBlank |
Value | Geçerli hücre için yakalanan, sahip olunan Variant değeri |
Formula | Formül hücreleri için formül metni, aksi takdirde boş dize |
Strings and Variants in TXLSLoadedCellSnapshot içindeki dizeler ve Variant'lar sahip olunan değerlerdir ve iç hücre nesnelerini açığa çıkarmaz
Formül hücrelerinde Value gerektiğinde hesaplama dahil klasik çalışma kitabının normal değer erişim anlamını izler
For xlckBlankiçin Value is Unassigned, Formula boş ve StyleIndex saklanan hücre XF'ini tanımlar
Durum ve geçersizleştirme
State , ilk başarılı TXLSLoadedCellCursorState'e kadar xlccBeforeFirst , MoveNextkullanılabilir olduğu sürece xlccActive ve geçiş tamamlandıktan sonra Current olur xlccEof after traversal completes
İlk hücreden önce veya EOF sonrasında Current okumak EXLSLoadedCellCursorState
Saklanan hücre oluşturmak veya silmek, çalışma sayfası eklemek, silmek, taşımak veya çalışma kitabı modelini değiştirmek imleci geçersiz kılar
Sonraki MoveNext veya Current çağrısı bu durumda EXLSLoadedCellCursorInvalidated
Mevcut bir hücrenin değerini, formülünü veya biçimini değiştirmek imleci geçersiz kılmaz ve halihazırda yakalanmış bir anlık görüntü değişmeden kalır
Örnek
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;