Bu sayfa, lxHandle, lxDataToXLS ve lxGridToXLS'e ait genel klasik XLS API üyelerini kapsar
IXLSWorkbook hesaplama özellikleri
property CalculationMode: LongWord;
property FormulaArrayMemoryLimit: Int64;
property EnableIteration: Boolean;
property MaxIterations: LongWord;
property MaxIterationChange: Double;
property RecalcOnSave: Boolean;
property UseFullPrecision: Boolean;
| CalculationMode |
Dosyayla birlikte saklanan çalışma kitabı hesaplama modunu denetler |
| FormulaArrayMemoryLimit |
MUNIT gibi üretilen formül dizilerinin ayırdığı yükü sınırlar, varsayılan olarak 64 MiB'dir ve bir Double elemanının altına düşen değerleri sıkıştırır |
| EnableIteration |
Döngüsel formüller için yinelemeli hesaplamayı etkinleştirir |
| MaxIterations |
Her döngüsel başvuru güçlü bağlı bileşeni için azami Gauss-Seidel geçiş sayısı |
| MaxIterationChange |
Bir döngüsel başvuru bileşeni yinelemeyi durdurmadan önce kabul edilen azami sayısal fark |
| RecalcOnSave |
Excel dosyayı kaydettiğinde çalışma kitabının yeniden hesaplanmasını ister |
| UseFullPrecision |
Tam formül duyarlılığını korur; devre dışı bırakıldığında formül ve What-If veri tablosu önbellekleri, bağımlılar onları okumadan önce etkin görüntüleme duyarlılığına yuvarlanır |
Formül girişi doğrulaması
property IXLSWorkbook.FormulaEntryPolicy: TXLSFormulaEntryPolicy;
function TXLSWorksheet.ValidateFormulaEntry(Row, Col: Integer;
const Formula: WideString): TXLSFormulaEntryValidationResult;
Paylaşılan doğrulama sözleşmesi; boş girdiyi, bilinmeyen fonksiyonları, bilinmeyen adları, sözdizimi hatalarını, geçersiz koordinatları ve Classic XLS hedefinin çalışma sayfası durumunu değiştirmeden temsil edemediği formülleri sınıflandırır; bkz.
Formül girişi doğrulama ilkesi
IXLSWorkbook işleme kalibrasyonu
property RenderCalibration: TXLSRenderCalibration;
function CaptureRenderCalibration: TXLSRenderCalibration;
procedure ResetRenderCalibration;
function CreateRenderGeometry(ABackend: TXLSRenderGeometryBackend;
ACacheCapacity: Integer = 4096): IXLSRenderGeometry;
Kaydın tamamına atama, çalışma kitabını değiştirmeden önce altı alanın tümünü doğrular; CaptureRenderCalibration tek bir ölçüm veya dışa aktarma işlemi için bağımsız bir değer anlık görüntüsü döndürür ve ResetRenderCalibration standart 1/1/1/1/100/96 değerlerini geri yükler
Bu yalnızca çalışma zamanına ait yapılandırma XLS dosyasına serileştirilmez ve çalışma sayfası satır yüksekliklerini veya sütun genişliklerini değiştirmez
CreateRenderGeometry, geçerli kalibrasyonu işlem sahipliğindeki bir hizmete kopyalar ve önbellek kimliğini geçerli çalışma kitabı jenerasyonuna ile seçilen arka uca bağlar; çalışma kitabında sonradan yapılan kalibrasyon değişiklikleri mevcut bir hizmeti değiştiremez
Aralık AutoFit'i ve her TXLSPaginationModel.Build çağrısı çalışma kitabı kalibrasyonunu bir kez yakalar; kasıtlı olarak sığdırılmış boyutları yazan tek tüketici AutoFit'tir, sayfalama ise saklanan her satır yüksekliğini ve sütun genişliğini olduğu gibi korur
IXLSWorkbook belge özellikleri
property Title: WideString;
property Subject: WideString;
property Author: WideString;
property Keywords: WideString;
property Comments: WideString;
property Company: WideString;
property Manager: WideString;
Bu özellikler, klasik XLS dosyasıyla birlikte kaydedilen çalışma kitabı özet bilgisi alanlarını okur ve yazar
IXLSWorkbook Close yöntemi
function Close: Integer;
Çalışma kitabı nesnesini kapatır ve klasik XLS nesne modeli tarafından tutulan çalışma kitabına ait içeriği serbest bırakır
property MetadataOnly: Boolean;
property SelectedSheets: TStringList;
property IncompleteLoad: Boolean;
| MetadataOnly |
Open'dan önce ayarlandığında yalnızca çalışma kitabı meta verilerini ve sayfa tanımlayıcılarını okur, hücre verilerini atlar |
| SelectedSheets |
Çalışma kitabı açıldığında yüklenecek sayfa adlarının listesi; boş liste her sayfayı yükler |
| IncompleteLoad |
MetadataOnly veya SelectedSheets kullanıldığı için hücre verileri atlandığında Open sonrasında True |
MetadataOnly veya boş olmayan bir SelectedSheets ile açılan çalışma kitabı kaydedilemez; Save, çalışma kitabı bu seçenekler olmadan yeniden açılana kadar hata yükseltir
TXLSColumnInfo daraltılmış durum
property TXLSWorksheet._ColumnInfo: TXLSColumnInfoList;
property TXLSColumnInfo.Collapsed: Boolean;
property TXLSRowInfo.Collapsed: Boolean;
property TXLSColumnInfoList.Collapsed[Index: Integer]: Boolean;
Collapsed, BIFF sütun anahat işaretini Hidden ve OutlineLevel'dan bağımsız olarak açığa çıkarır. Liste dizini, sıfıra dayalı klasik XLS sütun dizinidir. Eksik sütunlar False okunur ve eksik bir sütuna False atamak meta veri tahsis etmez. Sütun biçim kopyaları, çalışma sayfası kopyaları ve kaydet-yeniden yükle döngüleri işareti korur
Altta depolama erişimcileri, düşük seviyeli çalışma kitabı inceleme için geneldir. TXLSRowInfo; MinCol ve MaxCol (kapsanan bire dayalı sütun aralığı), CustomHeight ve CustomFormat (açık bir yükseklik ya da XF dizininin saklanıp saklanmadığı) ile XFIndexSet bilgisini bildirir; TXLSColumnInfo.isEqual iki sütun meta veri girdisini alan alan karşılaştırır
TXLSColumnInfoList, sınır ve varsayılan genişlik tanılaması için ColCount, MinCol, MaxCol, StdWidth ve MaxOutlineLevel özelliklerini açığa çıkarır; CalcMaxOutLineLevel doğrudan meta veri düzenlemelerinden sonra önbelleğe alınmış azami anahat düzeyini yeniden hesaplar, CopyColFormat bir sütun girdisini başka bir dizine klonlar, DeleteCol bir girdiyi kaldırır ve FindNextColToStore BIFF COLINFO kayıt yazıcıları için saklanan girdileri dolaşarak sonraki aralığı MinCol / MaxCol out-parametrelerinde bildirir
TXLSWorksheet anahat düğümü yöntemleri
function TryGetOutlineNode(AAxis: TXLSOutlineAxis; ANodeIndex: Integer; out ANode: TXLSOutlineNode): Boolean;
function SetOutlineNodeCollapsed(AAxis: TXLSOutlineAxis; ANodeIndex: Integer; ACollapsed: Boolean; AChildMode: TXLSOutlineChildMode = xocPreserve): Boolean;
procedure SetOutlineDisplayLevel(AAxis: TXLSOutlineAxis; ADisplayLevel: Integer; AChildMode: TXLSOutlineChildMode = xocPreserve);
Bu yöntemler, klasik satır ve sütun meta verilerini paylaşılan seyrek anahat modeline uyarlar, istenen özet düğümünü anahat yönünden türetir ve kullanılmayan çalışma sayfası koordinatlarını yoklamadan sıkıştırılmış gizleme ile daraltma değişikliklerini uygular
ANodeIndex bire dayalı fiziksel özet satırı ya da sütunudur, ADisplayLevel bire dayalı anahat düğmesi sözleşmesini izler ve xocPreserve, iç içe çocuk daraltma işaretlerini varsayılan olarak bağımsız tutar
TXLSWorksheet bölme ve baskı başlığı yöntemleri
function ThawPanes(Y, X: Single; RowTop, ColLeft: Word): Integer;
function SplitPanes(Width, Height: Single): Integer;
function UnsplitPanes: Integer;
function GetSelectedAreas(APane: TXLSPanePosition; out ActiveAreaIndex: Integer): TXLSSelectedAreas;
function SelectAreas(APane: TXLSPanePosition; const Areas: array of WideString; ActiveAreaIndex: Integer = 0): Boolean;
function TryGetWindowScroll(APane: TXLSPanePosition; out ARow, ACol: Integer): Boolean;
function ScrollWindow(APane: TXLSPanePosition; ARow, ACol: Integer): Boolean;
function RepeatRows(FirstRow, LastRow: Word): Integer;
function RepeatColumns(FirstCol, LastCol: Word): Integer;
ThawPanes, SplitPanes ve UnsplitPanes bölünmüş bölme durumunu denetler; RepeatRows ve RepeatColumns ise çalışma sayfası için baskı başlığı satırlarını veya sütunlarını ayarlar
GetSelectedAreas ve bölme-öncelikli
SelectAreas aşırı yüklemesi,
Çalışma sayfası bölme seçimleri sayfasında açıklanan paylaşılan mantıksal bölme seçim sözleşmesini sağlar
Aynı bölme için ardışık BIFF seçim kayıtları tek bir mantıksal grup oluşturur; düzenlenen gruplar en fazla 1369 aralık yığınlar halinde yazılır ve çalışma sayfası kopyaları her bölme grubunu korur
Tüm satırı ve tüm sütunu etkileyen yapısal düzenlemeler, sıralı kalanları ve etkin aralık kimliğini koruyarak her geçerli bölme grubunu yeniden eşler; bunun için belirlenimci ardıl, öncül ve sınır hücresi geri dönüşleri kullanılır
Biçimi bozuk veya çelişkili seçim kayıtları opak kalır, kaydedilirken bayt bayt yeniden üretilir ve kısmen güvenilen tipli bir durum açığa çıkarmak yerine xlsDiagnosticSelectionRecordInvalid bildirir
TryGetWindowScroll ve ScrollWindow, üst ve sol eksenleri Window2'ye, alt ve sağ eksenleri Pane'e eşleyerek paylaşılan bire dayalı dört bölmeli kaydırma sözleşmesini açığa çıkarır
TXLSWorksheet yazılmış veri doğrulama yöntemleri
function AddWholeNumberValidation(ARange: WideString; AOp: TXLSDvOperator; const AFormula1: WideString; const AFormula2: WideString = ''): TDataValidation;
function AddDecimalValidation(ARange: WideString; AOp: TXLSDvOperator; const AFormula1: WideString; const AFormula2: WideString = ''): TDataValidation;
function AddDateValidation(ARange: WideString; AOp: TXLSDvOperator; const AFormula1: WideString; const AFormula2: WideString = ''): TDataValidation;
function AddTimeValidation(ARange: WideString; AOp: TXLSDvOperator; const AFormula1: WideString; const AFormula2: WideString = ''): TDataValidation;
function AddTextLengthValidation(ARange: WideString; AOp: TXLSDvOperator; const AFormula1: WideString; const AFormula2: WideString = ''): TDataValidation;
function AddCustomValidation(ARange: WideString; const AFormula: WideString): TDataValidation;
Her yardımcı, ARange için yazılmış bir veri doğrulama kuralı oluşturur ve oluşturulan TDataValidation örneğini döndürür; böylece bilgi istemi, hata ve boş hücre işleme seçenekleri ayarlanabilir
TXLSWorksheet pivot table üyeleri
property PivotTables: TXLSPivotTables;
function AddPivotTable(const SourceRangeA1: WideString; DestRow, DestCol: Integer; const Name: WideString): TXLSPivotTable;
function PivotSetDataFieldFormat(DataField: TXLSPivotDataField; const FormatStr: WideString): Word;
Kaynak aralıktan yazılmış bir pivot tablo oluşturmak için
AddPivotTable'ı kullanın, ardından oluşturulan modeli incelemek veya biçimlendirmek için
PivotTables ve
PivotSetDataFieldFormat'ı kullanın.
Klasik XLS pivot tablo API'sine bakın
function SetArrayFormula(const Formula: WideString): Integer;
function XFIndex: Integer;
property FirstRow: Word;
property LastRow: Word;
property FirstCol: Byte;
property LastCol: Byte;
SetArrayFormula, aralığa bir dizi formülü atar. FirstRow, LastRow, FirstCol ve LastCol, saklanan 1 tabanlı aralık sınırlarını açığa çıkarır; XFIndex ise aralık için etkin klasik XLS biçim dizinini döndürür
IXLSRange aktarım yardımcıları
procedure PasteFrom(SrcRange: TXLSRange; PasteMode: LongWord; CopyMode: Boolean);
procedure ShiftTo(Row: Word; Col: Byte);
procedure ExtendRange;
procedure ContractRange;
PasteFrom, seçilen yapıştırma modunu kullanarak başka bir klasik XLS aralığından hücre içeriğini uygular. ShiftTo bir aralık nesnesini yeniden konumlandırırken, ExtendRange ve ContractRange, genişletilmiş veya normalleştirilmiş sınırlar gerektiren aralık işlemlerinden önce saklanan dikdörtgeni ayarlar
IXLS satır ve sütun aralığı arabirimleri
interface IXLSRowsRange = interface(IXLSRange)
property Item[Row: Integer]: IXLSRowRange;
property Hidden: OleVariant;
property Count: LongWord;
procedure AutoFit(Columns: Boolean = False);
interface IXLSRowRange = interface(IXLSRange)
property Item[Col: Integer]: IXLSColRange;
property Hidden: OleVariant;
property Count: LongWord;
procedure AutoFit(Columns: Boolean = False);
interface IXLSColsRange = interface(IXLSRange)
property Item[Col: Integer]: IXLSColRange;
property Hidden: OleVariant;
property Count: LongWord;
procedure AutoFit(Columns: Boolean = True);
procedure Group(Rows: Boolean = False);
procedure UnGroup(Rows: Boolean = False);
property OutlineLevel: Integer;
interface IXLSColRange = interface(IXLSRange)
property Item[Row: Integer]: IXLSRowRange;
property Hidden: OleVariant;
property Count: LongWord;
procedure AutoFit(Columns: Boolean = True);
procedure Group(Rows: Boolean = False);
procedure UnGroup(Rows: Boolean = False);
property OutlineLevel: Integer;
IXLSRowsRange, IXLSRowRange, IXLSColsRange ve IXLSColRange, IXLSRange.Rows, IXLSRange.Columns, IXLSRange.EntireRow ve IXLSRange.EntireColumn tarafından döndürülür. Normal IXLSRange düzenleme yüzeyini korurken, aralık yönünün desteklediği yerlerde dizinlenmiş satır veya sütun erişimi, gizli durum denetimi, sayımlar, otomatik sığdırma ve anahat gruplama eklerler
IXLSHyperLink DisplayText özelliği
property DisplayText: WideString;
DisplayText, Excel'in klasik bir XLS köprüsü için gösterdiği görünür metni, hedef adresten ve ekran ipucundan ayrı olarak okur veya değiştirir
TXLSWorksheets kimlik eşleme özellikleri
property IndexByID[SheetID: Integer]: Integer;
property IDByName[SheetName: WideString]: Integer;
property NameByID[SheetID: Integer]: WideString;
Bu salt okunur arama özellikleri, iç sayfa kimliği, geçerli çalışma sayfası dizini ve görünür çalışma sayfası adı arasında eşleme yapar. Geçerli sekme sırası yerine saklanan tanımlayıcılara göre sayfalara başvuran formülleri, tanımlı adları veya kayıtları korurken kullanışlıdırlar
TXLSWorksheet SheetTypeRaw özelliği
property SheetTypeRaw: Byte;
SheetTypeRaw, çalışma kitaplarını yüklerken ve kaydederken ham klasik XLS BoundSheet8.dt değerini korur; böylece makro, VBA, çalışma sayfası, iletişim kutusu ve diğer sayfa türü kayıtları standart bir çalışma sayfası sekmesine düzleştirilmeden gidiş-dönüş yapabilir
IXLSPageSetup gelişmiş yazdırma özellikleri
property PrintNotesAtEnd: Boolean;
property UseFirstPageNumber: Boolean;
property FirstPageNumber: Integer;
property PrintCellErrors: LongWord;
property PrintResolution: LongWord;
property PrintVResolution: LongWord;
property Copies: LongWord;
property HasSetupRecord: Boolean; read only
property PrinterSettingsInitialized: Boolean; read only
property PrinterDriverData: TBytes;
property HasPrinterDriverData: Boolean; read only
procedure ClearPrinterDriverData;
Bu özellikler, sona yazdırılan yorumlar, özel ilk sayfa numarası, yazdırılan hücre hatası işleme, yazıcı çözünürlüğü ve kopya sayısı gibi gelişmiş sayfa düzeni seçimlerini korur
HasSetupRecord, yüklenen bir klasik XLS çalışma sayfasında BIFF Setup kaydı bulunup bulunmadığını, PrinterSettingsInitialized ise kağıt boyutu, ölçek, yön, çözünürlük ve kopya sayısının bu kayıtla tanımlanıp tanımlanmadığını bildirir
Dokunulmamış bir çalışma sayfası kaydedilirken eksik bir Setup kaydı eksik, mevcut bir kayıt bayt bayt olduğu gibi kalır; bir sayfa düzeni alanı değiştiğinde kayıt gerektiğinde oluşturulur, yazıcıya bağımlı bir alan değiştiğinde ise yazıcı ayarları başlatılır
PrinterDriverData opak BIFF PLS yazıcı sürücüsü yükünü okur veya değiştirir, HasPrinterDriverData yükün yokluğunu ayırt eder ve ClearPrinterDriverData onu tipli sayfa düzeni alanlarına dokunmadan kaldırır
Getter ve setter bayt dizileri kopyalanır; böylece çağıranlar ve çalışma sayfası kopyaları bağımsız sahipliğe sahip olur, Classic yükler gereken iki baytlık ayrılmış öneki içermeli ve 1 MiB'ı aşmamalıdır
SaveXLSWorkbookAsXLSX, tipli sayfa düzeni değerleri ile opak yazıcı sürücüsü yükünü XLSX modeline bağımsız olarak taşır; özel sürücü baytları yinelenen yazıcı varsayılanları içerdiğinde tipli standart alanlar bağlayıcı kalmaya devam eder
IXLSFont karakter kümesi özellikleri
property CharSet: Byte;
property Family: Byte;
CharSet ve Family, yerel ayara özgü yazı tipi meta verilerini koruması gereken çağıranlar için klasik XLS yazı tipinin karakter kümesi ve aile baytlarını açığa çıkarır
TDataToXLS ve TGridToXLS Abort yöntemleri
procedure TDataToXLS.Abort;
procedure TGridToXLS.Abort;
Çalışan bir veri kümesi veya ızgara dışa aktarımının tamamlanmadan durdurulması gerektiğinde dışa aktarma olay işleyicilerinden Abort çağırın
Klasik XLS başvuru yardımcı fonksiyonları
function GetCellRef(Cell: String; var Row, Col: Word): Integer;
function GetCellRange(CellRange: String; var StartRow, StartCol, EndRow, EndCol: Word): Integer;
function EncodeCellRef(Row, Col: Word): String;
function EncodeCellRange(StartRow, StartCol, EndRow, EndCol: Word): String;
function Width2Excel(Value: Single): Word;
function Excel2Width(Value: Word): Single;
function Height2Excel(Value: Single): Word;
function Excel2Height(Value: Word): Single;
function ColIndexToColName(Index: Integer): String;
function ColNameToColIndex(Name: String): Integer;
Bu yardımcılar, klasik A1 başvurularını, aralıkları, sütun etiketlerini, satır veya sütun boyutlarını ve klasik XLS nesne modeli tarafından kullanılan Excel depolama birimlerini dönüştürür