مستندات HotXLS

اعضای اضافی API کلاسیک XLS

این صفحه اعضای عمومی API XLS کلاسیک را که به lxHandle، lxDataToXLS و lxGridToXLS تعلق دارند پوشش می‌دهد

خاصیت‌های محاسباتی IXLSWorkbook

property CalculationMode: LongWord;
property EnableIteration: Boolean;
property MaxIterations: LongWord;
property MaxIterationChange: Double;
property RecalcOnSave: Boolean;
property UseFullPrecision: Boolean;
      
CalculationMode حالت محاسبه Workbook ذخیره‌شده در فایل را کنترل می‌کند
EnableIteration محاسبه تکراری را برای فرمول‌های حلقوی فعال می‌کند
MaxIterations بیشترین تعداد تکرار مورد استفاده هنگام فعال بودن محاسبه تکراری
MaxIterationChange Maximum accepted calculation delta before iteration stops
RecalcOnSave هنگام ذخیره فایل توسط Excel، بازمحاسبه Workbook را درخواست می‌کند
UseFullPrecision دقت کامل را نگه می‌دارد و دقت نمایش‌داده‌شده را روی مقادیر ذخیره‌شده اعمال نمی‌کند

خاصیت‌های سند IXLSWorkbook

property Title: WideString;
property Subject: WideString;
property Author: WideString;
property Keywords: WideString;
property Comments: WideString;
property Company: WideString;
property Manager: WideString;
      
این خاصیت‌ها اطلاعات خلاصه workbook ذخیره‌شده در فایل XLS کلاسیک را می‌خوانند و می‌نویسند

متد Close در IXLSWorkbook

function Close: Integer;
      
شیء workbook را می‌بندد و محتوای متعلق به workbook که توسط مدل شیء XLS کلاسیک نگه داشته می‌شود را آزاد می‌کند

متدهای pane و print-title در TXLSWorksheet

function ThawPanes(Y, X: Single; RowTop, ColLeft: Word): Integer;
function SplitPanes(Width, Height: Single): Integer;
function UnsplitPanes: Integer;
function RepeatRows(FirstRow, LastRow: Word): Integer;
function RepeatColumns(FirstCol, LastCol: Word): Integer;
      
ThawPanes، SplitPanes و UnsplitPanes حالت split-pane را کنترل می‌کنند، در حالی که RepeatRows و RepeatColumns سطرها یا ستون‌های print-title را برای worksheet تنظیم می‌کنند

متدهای اعتبارسنجی داده نوع‌دار در TXLSWorksheet

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;
      
هر کمک‌کننده یک قانون اعتبارسنجی داده نوع‌دار برای ARange ایجاد می‌کند و نمونه TDataValidation ایجادشده را برمی‌گرداند تا گزینه‌های prompt، error و blank-handling قابل تنظیم باشند

اعضای pivot table در TXLSWorksheet

property PivotTables: TXLSPivotTables;
function AddPivotTable(const SourceRangeA1: WideString; DestRow, DestCol: Integer; const Name: WideString): TXLSPivotTable;
function PivotSetDataFieldFormat(DataField: TXLSPivotDataField; const FormatStr: WideString): Word;
      
از AddPivotTable برای ایجاد یک pivot table نوع‌دار از یک محدوده منبع استفاده کنید، سپس از PivotTables و PivotSetDataFieldFormat برای بررسی یا قالب‌بندی مدل تولیدشده استفاده کنید. به API pivot table XLS کلاسیک مراجعه کنید

اعضای فرمول آرایه‌ای و محدوده IXLSRange

function SetArrayFormula(const Formula: WideString): Integer;
function XFIndex: Integer;
property FirstRow: Word;
property LastRow: Word;
property FirstCol: Byte;
property LastCol: Byte;
      
SetArrayFormula یک فرمول آرایه‌ای را به محدوده اختصاص می‌دهد. FirstRow، LastRow، FirstCol و LastCol محدوده‌های ذخیره‌شده مبتنی بر 1 را نشان می‌دهند، در حالی که XFIndex اندیس قالب XLS کلاسیک مؤثر را برای محدوده برمی‌گرداند

کمک‌کننده‌های انتقال IXLSRange

procedure PasteFrom(SrcRange: TXLSRange; PasteMode: LongWord; CopyMode: Boolean);
procedure ShiftTo(Row: Word; Col: Byte);
procedure ExtendRange;
procedure ContractRange;
      
PasteFrom محتوای سلول را از یک محدوده XLS کلاسیک دیگر با استفاده از حالت paste انتخابی اعمال می‌کند. ShiftTo یک شیء محدوده را جابجا می‌کند، در حالی که ExtendRange و ContractRange مستطیل ذخیره‌شده را قبل از عملیات محدوده‌ای که به محدوده‌های گسترش‌یافته یا نرمال‌شده نیاز دارند تنظیم می‌کنند

رابط‌های محدوده سطر و ستون IXLS

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 و IXLSColRange توسط IXLSRange.Rows، IXLSRange.Columns، IXLSRange.EntireRow و IXLSRange.EntireColumn برگردانده می‌شوند. آن‌ها سطح ویرایش عادی IXLSRange را حفظ می‌کنند و دسترسی اندیس‌شده به سطر یا ستون، کنترل حالت مخفی، تعداد، autofit و گروه‌بندی outline را اضافه می‌کنند
property DisplayText: WideString;
      
DisplayText متن نمایشی که اکسل برای یک hyperlink در XLS کلاسیک نشان می‌دهد را می‌خواند یا تغییر می‌دهد، جداگانه از آدرس هدف و screen tip

خاصیت‌های نگاشت ID در TXLSWorksheets

property IndexByID[SheetID: Integer]: Integer;
property IDByName[SheetName: WideString]: Integer;
property NameByID[SheetID: Integer]: WideString;
      
این خاصیت‌های فقط‌خواندنی بین ID داخلی sheet، اندیس worksheet جاری و نام قابل مشاهده worksheet نگاشت می‌کنند. زمانی مفید هستند که فرمول‌ها، نام‌های تعریف‌شده یا رکوردهایی که به sheet‌ها با شناسه‌های ذخیره‌شده به جای ترتیب تب جاری اشاره می‌کنند را حفظ می‌کنید

خاصیت SheetTypeRaw در TXLSWorksheet

property SheetTypeRaw: Byte;
      
SheetTypeRaw مقدار خام BoundSheet8.dt XLS کلاسیک را در طول بارگذاری و ذخیره‌سازی workbook حفظ می‌کند، تا رکوردهای macro، VBA، worksheet، dialog و سایر انواع sheet بدون تبدیل به یک تب worksheet استاندارد دور بزنند

خاصیت‌های پیشرفته چاپ IXLSPageSetup

property PrintNotesAtEnd: Boolean;
property UseFirstPageNumber: Boolean;
property FirstPageNumber: Integer;
property PrintCellErrors: LongWord;
property PrintResolution: LongWord;
property PrintVResolution: LongWord;
property Copies: LongWord;
      
این خاصیت‌ها گزینه‌های پیشرفته page setup را حفظ می‌کنند، مانند توضیحات چاپ‌شده در انتها، شماره صفحه اول سفارشی، رندر خطاهای سلولی چاپ‌شده، وضوح چاپگر و تعداد نسخه

خاصیت‌های مجموعه کاراکتر IXLSFont

property CharSet: Byte;
property Family: Byte;
      
CharSet و Family بایت‌های مجموعه کاراکتر و خانواده فونت XLS کلاسیک را برای فراخوانندگانی که نیاز به حفظ متادیتای فونت خاص زبان دارند نشان می‌دهند

متدهای Abort در TDataToXLS و TGridToXLS

procedure TDataToXLS.Abort;
procedure TGridToXLS.Abort;
      
Abort را از event handlerهای export فراخوانی کنید وقتی یک export dataset یا grid در حال اجرا باید قبل از اتمام متوقف شود

توابع کمکی مرجع XLS کلاسیک

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;
      
این کمک‌کننده‌ها ارجاعات A1 کلاسیک، محدوده‌ها، برچسب‌های ستون، ابعاد سطر یا ستون و واحدهای ذخیره‌سازی اکسل مورد استفاده توسط مدل شیء XLS کلاسیک را تبدیل می‌کنند