תיעוד HotXLS
בית תוכן IXLSRange

מחלקת TXLSFormatSnapshot

יחידה: lxHandle
תמונת מצב לשימוש חוזר של העיצוב המלא של טווח תאים, שנלכדה על ידי IXLSRange.CaptureFormat ומוחלת עם IXLSRange.ApplyFormat

תיאור

TXLSFormatSnapshot מכיל את פורמט התא המלא (גופנים, מילוי, גבולות, פורמטים של מספרים, יישור, הגנה וחריצי צבע טקסט עשיר) שנלכד בנקודת זמן מסוימת. תמונת המצב בלתי תלויה בחוברת העבודה שממנה הגיעה, כך שניתן להחיל אותה על טווחים באותה חוברת עבודה או בחוברת עבודה אחרת. מופעים נוצרים על ידי IXLSRange.CaptureFormat; הפונה הוא הבעלים של האובייקט המוחזר ועליו לשחררו.
כל תכונת צבע מודעת-ערכת-נושא ומודעת-לוח נשמרת כרשומת TXLSXfRichSlot — הצבע שנפתר וכן מקור העושר (richer source) שממנו הגיע — ומיקומי החריצים מזוהים באמצעות TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); תמונת המצב מקבצת אותם בצבירה אחת מסוג TXLSXfRichColors, ו־TXLSXfRichSlotSet בוחר כמה חריצים בקריאה אחת, כך שקובע אחד יכול לעצב יחד את צבעי המילוי, הגופן והגבולות.

מתודות

procedure ApplyTo(const ARange: IXLSRange) — מחיל תמונת מצב זו על הטווח הנתון

דוגמה

var
  Snapshot: TXLSFormatSnapshot;
begin
  Snapshot:= Workbook.Sheets[1].Range['A1', 'D1'].CaptureFormat;
  Snapshot.ApplyTo(Workbook.Sheets[2].Range['A1', 'D1']);
  Snapshot.Free;
end;

ראה גם

מתודת CaptureFormat
מתודת ApplyFormat
ממשק IXLSRange