Clase TXLSFormatSnapshot - Referencia para desarrolladores de HotXLS

Unidad: lxHandle

Una instantánea reutilizable del formato completo de un rango de celdas, capturada por IXLSRange.CaptureFormat y aplicada con IXLSRange.ApplyFormat

Descripción

TXLSFormatSnapshot contiene el formato completo de la celda (fuentes, rellenos, bordes, formatos de número, alineación, protección y espacios de color de texto enriquecido) capturado en un momento determinado. La instantánea es independiente del libro de trabajo del que proviene, por lo que se puede aplicar a rangos del mismo libro o de uno diferente. Las instancias se crean mediante IXLSRange.CaptureFormat; el llamador es propietario del objeto devuelto y debe liberarlo.

Cada atributo de color consciente del tema y de la paleta se guarda como un registro TXLSXfRichSlot —el color resuelto más la fuente más rica de la que proviene— y las posiciones de las ranuras se identifican con TXLSXfRichSlotID (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); la instantánea las agrupa en un agregado TXLSXfRichColors, y TXLSXfRichSlotSet selecciona varias ranuras en una sola llamada, de modo que un único definidor puede restilizar a la vez los colores de relleno, fuente y borde.

Métodos

procedure ApplyTo(const ARange: IXLSRange) — aplica esta instantánea al rango dado

Ejemplo

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

Ver también

Método IXLSRange.CaptureFormat
Método IXLSRange.ApplyFormat
Interfaz IXLSRange