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 ranuras de color de texto enriquecido) capturado en un momento dado. La instantánea es independiente del libro del que procede, por lo que puede aplicarse a rangos del mismo libro o de otro diferente. Las instancias se crean mediante IXLSRange.CaptureFormat; el llamador es propietario del objeto devuelto y debe liberarlo.

Cada atributo de color que depende del tema y la paleta se guarda como un registro TXLSXfRichSlot — el color resuelto más la fuente más rica de la que procede — y las posiciones de las ranuras se identifican mediante 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 setter puede cambiar a la vez los colores de relleno, fuente y borde.

Métodos

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

Ejemplo

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

Véase también

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