HotXLS-dokumentaatio

TXLSFormatSnapshot class

Unit: lxHandle
Uudelleenkäytettävä tilannevedos solualueen täydestä muotoilusta, jonka IXLSRange.CaptureFormat tallentaa ja jota käytetään IXLSRange.ApplyFormat-metodilla

Kuvaus

TXLSFormatSnapshot sisältää tiettynä hetkenä tallennetun täyden solumuodon (fontit, täytöt, reunukset, numeromuodot, tasaus, suojaus ja rikkaan tekstin väripaikat). Tilannevedos on riippumaton työkirjasta, josta se on peräisin, joten se voidaan käyttää alueisiin samassa tai eri työkirjassa. Instanssit luo IXLSRange.CaptureFormat; kutsuja omistaa palautetun olion ja sen on vapautettava se.
Jokainen teema- ja palettitietoinen väriominaisuus tallennetaan TXLSXfRichSlot-tietueena — ratkaistu väri sekä tieto siitä, mistä rikkaammasta lähteestä se on peräisin — ja paikat tunnistaa TXLSXfRichSlotID-luettelolla (rsFillFg, rsFillBg, rsFont, rsTop, rsBottom, rsLeft, rsRight, rsDiag); tilannevedos ryhmittelee ne TXLSXfRichColors-aggregaattiin, ja TXLSXfRichSlotSet valitsee useita paikkoja yhdellä kutsulla, joten yksittäinen asettaja voi vaihtaa täytön, fontin ja reunusten värit yhtä aikaa.

Metodit

procedure ApplyTo(const ARange: IXLSRange) — käyttää tämän tilannevedoksen annettuun alueeseen

Esimerkki

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

Katso myös