ZEXMLSS
zexmlss - гэта бібліятэка, якая дазваляе ствараць і загружаць файлы фармату excel 2002/2003 XML (SpreadsheetML / XML Spreadsheet),
OpenDocument Format (ODS), Office Open XML (xlsx) БЕЗ выкарыстанні MS Office ці Open Office.
Працуе ў Lazarus (праверана з Lazarus 1.2.6 і FPC 2.6 пад Linux-ом і Windows),
у Delphi 7, Borland Developer Studio 2005, BDS 2006, CodeGear Delphi 2007, CodeGear RAD Studio 2009 і 2010, Delphi XE і Delphi XE2,
у C++ Builder 6.
Ліцэнзія: zlib License
Апошняя версія: 0.0.15 ад 2016.11.25 (бэта).
Дакумент, створаны з дапамога zexmlss, адкрыты ў excel 2003
|
zexmlss + ZColorStringGrid
|
Дакумент, створаны з дапамога zexmlss, адкрыты ў OpenOffice.org 3.0.1
|
zexmlss_0_0_15_src.zip (860Kb) - Зыходны код.
Асноўныя магчымасці:
- Чытанне/запіс excel XML файлаў у кадоўках windows-1251, CP866, UTF-8, UTF-16 (Little Endian і Big Endian)
- Запіс/чытанне Open Document Format (ODS) у/з дырэкторыю (Lazarus/Delphi) і як запакаваны файл (пакуль толькі Lazarus (калі прачытаць readme.by, то і Delphi))
- Чытанне/запіс Office Open XML (xlsx) з дырэкторыі (Lazarus/Delphi) і з запакаванага файла (Lazarus (readme.by для Delphi))
- Простае капіяванне вочак у/з StringGrid
- Простае капіяванне вочак (са стылем і аб'яднанымі вочкамі) у/з ZColorStringGrid (толькі для Delphi і C++Builder без усталяванага ў zexml.inc NOZCOLORSTRINGGRID)
::: Прыклады кода
::: Гісторыя версій ::: Delphi+zexmlss+zip :::
::: Умоўнае фарматаванне ::: Коды лікавых фарматаў
Асноўныя класы:
Асноўныя функцыі:
|
Функцыя
|
Кароткае апісанне
|
|
function GridToXmlSS(var XMLSS: TZEXMLSS; const PageNum: integer;
var Grid: TStringGrid; ToCol: integer; ToRow: integer;
BCol, BRow, ECol, ERow: integer; ignorebgcolor: boolean; _border: byte): boolean; overload;
|
Капіюе дадзеныя з Grid на старонку XMLSS.
XMLSS - Сховішча. PageNum - Нумар старонкі. Grid - стрынггрыд, з якога трэба браць дадзеныя.
ToCol - нумар слупка для ўстаўкі. ToRow - нумар радка для ўстаўкі.
BCol - верхняя левая калонка грыда. BRow - верхні левы радок грыда.
ECol - ніжняя правая калонка грыда. ERow - ніжні правы радок грыда.
ignorebgcolor - калі true, тое ігнаруе колер фону вочка. _border - апрацоўка рамкі вочка
(1 - усё ў рамках, 0 - усё без рамак).
Вяртае True пры паспяховым капіяванні.
|
|
function GridToXmlSS(var XMLSS: TZEXMLSS; const PageNum: integer;
var Grid: TZColorStringGrid; ToCol: integer; ToRow: integer;
BCol, BRow, ECol, ERow: integer; ignorebgcolor: boolean; _border: byte): boolean; overload;
|
Капіюе дадзеныя з Grid на старонку XMLSS.
XMLSS - Сховішча. PageNum - Нумар старонкі. Grid - zcolorstringgrid, з якога трэба браць дадзеныя.
ToCol - нумар слупка для ўстаўкі. ToRow - нумар радка для ўстаўкі.
BCol - верхняя левая калонка грыда. BRow - верхні левы радок грыда.
ECol - ніжняя правая калонка грыда. ERow - ніжні правы радок грыда.
ignorebgcolor - калі true, тое ігнаруе колер фону вочка. _border - апрацоўка рамкі вочка
(1 - усё ў рамках, 0 - усё без рамак, 2 - усё з рамкамі, акрамя стылю sgNone).
Толькі для Delphi і CBuilder-а!
Вяртае True пры паспяховым капіяванні.
|
|
function XmlSSToGrid(var Grid: TStringGrid; var XMLSS: TZEXMLSS; const PageNum: integer;
ToCol: integer; ToRow: integer; BCol, BRow, ECol, ERow: integer; InsertMode: byte; StyleCopy: integer = 511): boolean; overload;
|
Капіюе дадзеныя са старонкі TZEXMLSS у TStringGrid.
Grid - грыд, у які трэба ўставіць вочкі. XMLSS - сховішча. PageNum - Нумар старонкі.
ToCol - нумар слупка для ўстаўкі. ToRow - нумар радка для ўстаўкі.
BCol - верхняя левая калонка сховішча. BRow - верхні левы радок сховішча.
ECol - ніжняя правая калонка сховішча. ERow - ніжні правы радок сховішча.
InsertMode - дадаваць ці замяняць вочкі (0 - вочкі ў грыде не ссоўваюцца;
1 - вочкі ў грыде ссоўваюцца направа на памер дадаванай вобласці;
2 - вочкі ў грыде ссоўваюцца ўніз на памер дадаванай вобласці;
3 - вочкі ў грыде ссоўваюцца направа і ўніз на памер дадаванай вобласці).
StyleCopy - спосаб капіявання стылю (0 - нічога са стылю не капіюецца, калі StyleCopy and 16 = 16 - капіюецца памер вочка).
Вяртае True пры паспяховым капіяванні.
|
|
function XmlSSToGrid(var Grid: TZColorStringGrid; var XMLSS: TZEXMLSS; const PageNum: integer;
ToCol: integer; ToRow: integer; BCol, BRow, ECol, ERow: integer; InsertMode: byte; StyleCopy: integer = 1023): boolean; overload;
|
Капіюе дадзеныя са старонкі TZEXMLSS у TZColorStringGrid.
Grid - грыд, у які трэба ўставіць вочкі. XMLSS - сховішча. PageNum - Нумар старонкі.
ToCol - нумар слупка для ўстаўкі. ToRow - нумар радка для ўстаўкі.
BCol - верхняя левая калонка сховішча. BRow - верхні левы радок сховішча.
ECol - ніжняя правая калонка сховішча. ERow - ніжні правы радок сховішча.
InsertMode - дадаваць ці замяняць вочкі (0 - вочкі ў грыде не ссоўваюцца;
1 - вочкі ў грыде ссоўваюцца направа на памер дадаванай вобласці;
2 - вочкі ў грыде ссоўваюцца ўніз на памер дадаванай вобласці;
3 - вочкі ў грыде ссоўваюцца направа і ўніз на памер дадаванай вобласці).
StyleCopy - спосаб капіявання стылю:
- 0 - нічога са стылю не капіюецца
- StyleCopy and 1 = 1 - капіюецца BGColor
- StyleCopy and 2 = 2 - капіюецца Vertical Alignment
- StyleCopy and 4 = 4 - капіюецца Horizontal Alignment
- StyleCopy and 8 = 8 - капіюецца Font
- StyleCopy and 16 = 16 - капіюецца Памер вочка
- StyleCopy and 32 = 32 - WordWrap
- StyleCopy and 64 = 64 - капіюецца Merge Area
- StyleCopy and 128 = 128 - выдаляць аб'яднаныя вочкі на месцы ўстаўкі
- StyleCopy and 256 = 256 - усталяваць на месцы ўстаўкі BorderCellStyle = sqNone
- StyleCopy and 512 = 512 - Павялічваць вышыню вочка, калі тэкст не змяшчаецца
- StyleCopy and 1024 = 1024 - Павялічваць даўжыню вочка, калі тэкст не змяшчаецца
- StyleCopy and 2048 = 2048 - усталёўваць default-стыль з XMLSS для дададзеных на месца зруху вочак замест
default-стылю з грыда
Толькі для Delphi і CBuilder-а!
Вяртае True пры паспяховым капіяванні.
|
|
function SaveXmlssToEXML(var XMLSS: TZEXMLSS; Stream: TStream; const SheetsNumbers:array of integer;
const SheetsNames: array of string; TextConverter: TAnsiToCPConverter; CodePageName: string; BOM: ansistring = ''): integer; overload;
|
Захоўвае ў струмень Stream у фармаце Excel XML SpreadSheet.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
TextConverter - канвертар тэксту з лакальнай у патрэбную кадоўку (напрыклад, AnsiToUtf8 - перакладае ў кадоўку UTF-8).
CodePageName - імя кадоўкі. BOM - Byte Order Mark кадоўкі.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToEXML(var XMLSS: TZEXMLSS; FileName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string; TextConverter: TAnsiToCPConverter; CodePageName: string; BOM: ansistring = ''): integer; overload;
|
Захоўвае ў файл FileName у фармаце Excel XML SpreadSheet.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
TextConverter - канвертар тэксту з з лакальна ў патрэбную кадоўку.
CodePageName - імя кадоўкі. BOM - Byte Order Mark кадоўкі.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToEXML(var XMLSS: TZEXMLSS; FileName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string): integer; overload;
|
Захоўвае ў файл FileName у фармаце Excel XML SpreadSheet.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToEXML(var XMLSS: TZEXMLSS; FileName: string): integer; overload;
|
Захоўвае ў файл FileName у фармаце Excel XML SpreadSheet.
XMLSS - сховішча.
Захоўвае ў UTF-8 кадоўке ўсе старонкі з XMLSS.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToODFS(var XMLSS: TZEXMLSS; FileName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string; TextConverter: TAnsiToCPConverter; CodePageName: string; BOM: ansistring = ''): integer; overload;
|
Увага: толькі для Lazarus!
Захоўвае дакумент у фармаце Open Document (ODS) у файл FileName.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
TextConverter - канвертар тэксту з з лакальна ў патрэбную кадоўку.
CodePageName - імя кадоўкі. BOM - Byte Order Mark кадоўкі.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToODFS(var XMLSS: TZEXMLSS; FileName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string): integer; overload;
|
Увага: толькі для Lazarus!
Захоўвае дакумент у фармаце Open Document (ODS) у файл FileName.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToODFS(var XMLSS: TZEXMLSS; FileName: string): integer; overload;
|
Увага: толькі для Lazarus!
Захоўвае дакумент у фармаце Open Document (ODS) у файл FileName.
XMLSS - сховішча. Захоўвае ўсе старонкі.
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToODFSPath(var XMLSS: TZEXMLSS; PathName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string; TextConverter: TAnsiToCPConverter; CodePageName: string; BOM: ansistring = ''): integer; overload;
|
Захоўвае незапакаваны дакумент у дырэкторыю PathName у фармаце Open Document (ODS).
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
TextConverter - канвертар тэксту з з лакальна ў патрэбную кадоўку.
CodePageName - імя кадоўкі. BOM - Byte Order Mark кадоўкі.
Вяртае 0 пры паспяховым захаванні.
Шлях павінен існаваць!
|
|
function SaveXmlssToODFSPath(var XMLSS: TZEXMLSS; PathName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string): integer; overload;
|
Захоўвае незапакаваны дакумент у дырэкторыю PathName у фармаце Open Document (ODS).
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
Шлях павінен існаваць!
|
|
function SaveXmlssToODFSPath(var XMLSS: TZEXMLSS; PathName: string): integer; overload;
|
Захоўва ўсе старонкі з XMLSS у незапакаваны дакумент у дырэкторыю PathName у фармаце Open Document (ODS).
XMLSS - сховішча.
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
Шлях павінен існаваць!
|
|
function SaveXmlssToXLSXPath(var XMLSS: TZEXMLSS; PathName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string; TextConverter: TAnsiToCPConverter; CodePageName: string; BOM: ansistring = ''): integer; overload;
|
Захоўвае незапакаваны дакумент у дырэкторыю PathName у фармаце xlsx.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
TextConverter - канвертар тэксту з з лакальна ў патрэбную кадоўку.
CodePageName - імя кадоўкі. BOM - Byte Order Mark кадоўкі.
Вяртае 0 пры паспяховым захаванні.
Шлях павінен існаваць!
|
|
function SaveXmlssToXLSXPath(var XMLSS: TZEXMLSS; PathName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string): integer; overload;
|
Захоўвае незапакаваны дакумент у дырэкторыю PathName у фармаце xlsx.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
Шлях павінен існаваць!
|
|
function SaveXmlssToXLSXPath(var XMLSS: TZEXMLSS; PathName: string): integer; overload;
|
Захоўвае незапакаваны дакумент у дырэкторыю PathName у фармаце Office Open XML (xlsx).
XMLSS - сховішча.
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
Шлях павінен існаваць!
|
|
function SaveXmlssToXLSX(var XMLSS: TZEXMLSS; FileName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string; TextConverter: TAnsiToCPConverter; CodePageName: string; BOM: ansistring = ''): integer; overload;
|
Увага: толькі для Lazarus!
Захоўвае дакумент у фармаце xlsx у файл FileName.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
TextConverter - канвертар тэксту з з лакальна ў патрэбную кадоўку.
CodePageName - імя кадоўкі. BOM - Byte Order Mark кадоўкі.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToXLSX(var XMLSS: TZEXMLSS; FileName: string; const SheetsNumbers: array of integer;
const SheetsNames: array of string): integer; overload;
|
Увага: толькі для Lazarus!
Захоўвае дакумент у фармаце xlsx у файл FileName.
XMLSS - сховішча. SheetsNumbers - масіў нумароў старонак у патрэбнай паслядоўнасці (калі масіў пустой - бяруцца ўсе лісты са сховішча).
SheetsNames - масіў назваў старонак (колькасць элементаў у двух масівах павінны супадаць).
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
|
|
function SaveXmlssToXLSX(var XMLSS: TZEXMLSS; FileName: string): integer; overload;
|
Увага: толькі для Lazarus!
Захоўвае дакумент у фармаце xlsx у файл FileName.
XMLSS - сховішча.
Кадоўка - UTF-8.
Вяртае 0 пры паспяховым захаванні.
|
|
function ReadEXMLSS(var XMLSS: TZEXMLSS; Stream: TStream): integer; overload;
|
Чытае са струменя Stream Excel XML SpreadSheet у сховішча XMLSS.
Вяртае 0 пры паспяховым чытанні.
|
|
function ReadEXMLSS(var XMLSS: TZEXMLSS; FileName: string): integer; overload;
|
Чытае з файла FileName Excel XML SpreadSheet у сховішча XMLSS.
Вяртае 0 пры паспяховым чытанні.
|
|
function ReadODFSPath(var XMLSS: TZEXMLSS; DirName: string): integer;
|
Чытае распакаваны ODS з дырэкторыі DirName у сховішча XMLSS.
Вяртае 0 пры паспяховым чытанні.
|
|
function ReadODFS(var XMLSS: TZEXMLSS; FileName: string);
|
Увага: толькі для Lazarus!
Чытае з файла FileName ODS у сховішча XMLSS.
Вяртае 0 пры паспяховым чытанні.
|
|
function ReadXLSXPath(var XMLSS: TZEXMLSS; DirName: string): integer;
|
Чытае распакаваны xlsx з дырэкторыі DirName у сховішча XMLSS.
Вяртае 0 пры паспяховым чытанні.
|
|
function ReadXLSX(var XMLSS: TZEXMLSS; FileName: string): integer;
|
Увага: толькі для Lazarus!
Чытае з файла FileName xlsx у сховішча XMLSS.
Вяртае 0 пры паспяховым чытанні.
|
Успадкаваны ад TComponent. З'яўляецца кантэйнерам для змесціва электроннай табліцы.
Уласцівасці:
Успадкаваны ад TPersistent. Утрымоўвае лісты дакумента.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Count: integer;
|
Кол-у лістоў у дакуменце.
|
|
Sheet[num: integer]: TZSheet;
|
Доступ да ліста дакумента па нумары num.
|
Успадкаваны ад TPersistent. Утрымоўвае ліст дакумента.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Cell[ACol, ARow: integer]: TZCell;
|
Вочка на скрыжаванні слупка ACol і радкі ARow.
|
|
ColCount: integer;
|
Колькасць слупкоў у лісце.
|
|
Columns[num: integer]: TZColOptions;
|
Налады слупка num.
|
|
ColWidths[num: integer]: real;
|
Шырыня слупка num.
|
|
DefaultColWidth: real;
|
Шырыня слупка па-змаўчанню.
|
|
DefaultRowHeight: real;
|
Вышыня радка па-змаўчанню.
|
|
MergeCells: TZMergeCells;
|
Аб'яднаныя вочкі.
|
|
Protect: boolean;
|
Прыкмета абароны ліста.
|
|
RightToLeft: boolean;
|
Праглядаць ліст справа налева.
Па-змаўчанню false.
|
|
RowCount: integer;
|
Колькасць радкоў.
|
|
RowHeights[num: integer]: real;
|
Вышыня радка num.
|
|
Rows[num: integer]: TZRowOptions;
|
Налады радка num.
|
|
Selected: boolean;
|
Прыкмета выбару ліста.
|
|
SheetOptions: TZSheetOptions;
|
Налады ліста.
|
|
ConditionalFormatting: TZConditionalFormatting;
|
Умоўныя фарматаванні, якія ўжываюцца да ліста.
|
|
Title: string;
|
Загаловак ліста.
|
Успадкаваны ад TPersistent. Уяўляе сабою вочка.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
AlwaysShowComment: boolean;
|
Заўсёды паказваць нататку.
Па-змаўчанню False.
|
|
CellStyle: integer;
|
Нумар стылю вочка.
Па-змаўчанню -1.
|
|
CellType: TZCellType;
|
Тып вочка.
Па-змаўчанню ZEansistring (string).
|
|
Comment: string;
|
Тэкст нататкі.
|
|
CommentAuthor: string;
|
Аўтар нататкі.
|
|
Data: string;
|
Адлюстроўванае змесціва вочка.
|
|
Formula: string;
|
Формула ў стылі адрасавання R1C1.
|
|
Href: string;
|
Гіперспасылка.
|
|
HRefScreenTip: string;
|
Адлюстроўваная на экране подпіс гіперспасылкі.
|
|
ShowComment: boolean;
|
Паказваць нататку.
Па-змаўчанню False.
|
Успадкаваны ад TPersistent. Параметры старонкі.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
ActiveCol: word;
|
Нумар актыўнага слупка.
Па-змаўчанню 0.
|
|
ActiveRow: word;
|
Нумар актыўнага радка.
Па-змаўчанню 0.
|
|
CenterHorizontal: boolean;
|
Пры друку цэнтраваць табліцу гарызантальна.
Па-змаўчанню False.
|
|
CenterVertical: boolean;
|
Пры друку цэнтраваць табліцу вертыкальна.
Па-змаўчанню False.
|
|
FooterMargin: word;
|
Памер поля ніжняга калантытула ў міліметрах.
Па-змаўчанню 13 мм.
Састарэлы! Выкарыстоўвайце FooterMargins.Height!
|
|
HeaderMargin: word;
|
Памер поля верхняга калантытула ў міліметрах.
Па-змаўчанню 13 мм.
Састарэлы! Выкарыстоўвайце HeaderMargins.Height!
|
|
FooterMargins: TZHeaderFooterMargins;
|
Памеры і водступы поля ніжняга калантытула.
|
|
HeaderMargins: TZHeaderFooterMargins;
|
Памеры і водступы поля верхняга калантытула ў міліметрах.
|
|
FooterData: string;
|
Тэкст ніжняга калантытула.
Састарэлы! Выкарыстоўвайце Footer.Data!
|
|
HeaderData: string;
|
Тэкст верхняга калантытула.
Састарэлы! Выкарыстоўвайце Header.Data!
|
|
IsEvenFooterEqual: boolean;
|
Прыкмета таго, што ніжні калантытул на цотных і няцотных старонках аднолькавы.
Па-змаўчанню True.
|
|
IsEvenHeaderEqual: boolean;
|
Прыкмета таго, што верхні калантытул на цотных і няцотных старонках аднолькавы.
Па-змаўчанню True.
|
|
Footer: TZSheetFooterHeader;
|
Ніжні калантытул.
|
|
Header: TZSheetFooterHeader;
|
Верхні калантытул.
|
|
EvenFooter: TZSheetFooterHeader;
|
Ніжні калантытул для цотных старонак. Выкарыстоўваецца толькі пры IsEvenFooterEqual = true.
|
|
EvenHeader: TZSheetFooterHeader;
|
Верхні калантытул для цотных старонак. Выкарыстоўваецца толькі пры IsEvenHeaderEqual = true.
|
|
HeaderBGColor: TColor;
|
Колер фона верхняга калантытула.
Па-змаўчанню clWindow.
|
|
FooterBGColor: TColor;
|
Колер фона ніжняга калантытула.
Па-змаўчанню clWindow.
|
|
MarginBottom: word;
|
Ніжняе поле ў міліметрах.
Па-змаўчанню 25 мм.
|
|
MarginLeft: word;
|
Левае поле ў міліметрах.
Па-змаўчанню 20 мм.
|
|
MarginTop: word;
|
Верхняе поле ў міліметрах.
Па-змаўчанню 25 мм.
|
|
MarginRight: word;
|
Правае поле ў міліметрах.
Па-змаўчанню 20 мм.
|
|
PaperSize: byte;
|
Памер паперы (Табліца памераў паперы).
Па-змаўчанню 9 (А4).
|
|
PaperWidth: byte;
|
Шырыня ліста паперы ў мм. Выкарыстоўваецца толькі пры PaperSize = 0!
|
|
PaperHeight: byte;
|
Вышыня ліста паперы ў мм. Выкарыстоўваецца толькі пры PaperSize = 0!
|
|
PortraitOrientation: boolean;
|
Арыентацыя ліста (True - партрэтная, False - альбомная).
Па-змаўчанню True.
|
|
StartPageNumber: integer;
|
Нумар першай старонкі.
Па-змаўчанню 1.
|
|
SplitVerticalMode: TZSplitMode;
|
Спосаб разбіцця/замацаванні калонак. Робіць тое ж самае, што і ў LibreOffice Calc
каманды "Акно - Фіксаваць"/
"Акно - Падзяліць"
Па-змаўчанню ZSplitNone.
|
|
SplitHorizontalMode: TZSplitMode;
|
Спосаб разбіцця/замацаванні радкоў у якасці загалоўкаў.
Па-змаўчанню ZSplitNone.
|
|
SplitVerticalValue: integer;
|
Калі SplitVerticalMode = ZSplitFrozen, то колькасць слупкоў для замацавання.
Калі ZSplitSplit, то водступ у пікселях.
Па-змаўчанню 0.
|
|
SplitHorizontalValue: integer;
|
Калі SplitHorizontalMode = ZSplitFrozen, то колькасць радкоў для замацавання.
Калі ZSplitSplit, то водступ у пікселях.
Па-змаўчанню 0.
|
|
ScaleToPercent: integer;
|
Маштабаванне дакумента ў адсотках (100 - дакумент не маштабуецца).
Па-змаўчанню 100.
|
|
ScaleToPages: integer;
|
Маштабаванне: змясціць патрэбнае кол-у старонак на лісце (1 - не маштабуецца).
Па-змаўчанню 1.
|
Успадкаваны ад TPersistent. Ніжні ці верхні калантытул.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
ADataLeft: string;
|
Тэкст калантытула злева.
|
|
Data: string;
|
Тэкст калантытула па цэнтры.
|
|
DataRight: string;
|
Тэкст калантытула з права.
|
|
IsDisplay: boolean;
|
Ці трэба паказваць калантытул.
|
Успадкаваны ад TPersistent. Водступы калантытулаў.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
MarginTopBottom: word;
|
Водступ знізу/зверху для калантытула ў мм.
Па-змаўчанню 13.
|
|
MarginLeft: word;
|
Водступ злева ў мм.
Па-змаўчанню 0.
|
|
MarginRight: word;
|
Водступ справа ў мм.
Па-змаўчанню 0.
|
|
Height: word;
|
Вышыня калантытула ў мм.
Па-змаўчанню 7.
|
|
UseAutoFitHeight: boolean;
|
Аўтападбор вышыні.
Па-змаўчанню true.
|
Успадкаваны ад TPersistent. Агульныя налады слупкоў і радкоў. Продак для TZColOptions
і TZRowOptions.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Hidden: boolean;
|
Ці ўтоены слупок/радок.
Па-змаўчанню False (не ўтоены).
|
|
StyleID: integer;
|
Нумар стылю для слупка/радкі.
Па-змаўчанню -1.
|
|
Breaked: boolean;
|
Парыў старонкі пасля радка/слупка.
Па-змаўчанню False (без парыву).
|
Успадкаваны ад TZRowColOptions. Налады радка.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
AutoFitHeight: boolean;
|
Аўтаматычна павялічваць вышыню радка.
|
|
Height: real;
|
Вышыня радка ў друкарскіх пунктах (1 пункт = 1/72" = 0.3528 мм).
|
|
HeightMM: real;
|
Вышыня радка ў міліметрах.
|
|
HeightPix: real;
|
Вышыня радка ў пікселях.
|
Успадкаваны ад TZRowColOptions. Налады слупка.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
AutoFitWidth: boolean;
|
Аўтаматычна павялічваць шырыню слупка.
|
|
Width: real;
|
Шырыня слупка ў друкарскіх пунктах.
|
|
WidthMM: real;
|
Шырыня слупка ў міліметрах.
|
|
WidthPix: real;
|
Шырыня слупка ў пікселях.
|
Успадкаваны ад TPersistent. Аб'яднаныя вочкі.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Count: integer;
|
Колькасць аб'яднаных вочак
Read Only!
|
|
Items[Num: Integer]: TRect;
|
Вяртае каардынаты аб'яднанай вобласці Num.
(Left, Top) - левае верхняе вочка,
(Right, Bottom) - правае ніжняе вочка.
Num - нумар аб'яднанага вочка.
Read Only!
|
Метады:
|
Метады TZMergeCells
|
Кароткае апісанне
|
|
function AddRect(Rct: TRect): byte;
|
Дадае аб'яднаную вобласць/вочка, складзеную прастакутнікам Rct.
Вяртае:
0 - усё звычайна, вобласць дадалася
1 - паказаная вобласць выходзіць за межы ліста
2 - паказаная вобласць перасякаецца(уваходзіць) ва ўведзеныя раней вобласці
3 - вобласць з аднаго вочка не дадае
4 - спроба аб'яднаць фіксаваныя і не фіксаваныя вочкі
|
|
function AddRectXY(x1, y1, x2, y2: integer): byte;
|
Дадае аб'яднаную вобласць/вочка, складзеную прастакутнікам (x1, y1, x2, y2).
(x1, y1) - левае верхняе вочка, (x2, y2) - правае ніжняе вочка.
Вяртае таксама, што і AddRect(Rct: TRect).
|
|
procedure Clear();
|
Выдаляе ўсе аб'яднаныя вобласці/вочкі
|
|
function DeleteItem(num: integer): boolean;
|
Выдаляе вобласць num.
Вяртае True калі вобласць паспяхова выдалена.
|
|
function InLeftTopCorner(ACol, ARow: integer): integer;
|
Вяртае нумар аб'яднанага вочка/вобласці, у якой вочка [ACol, ARow] з'яўляецца
левай верхняй. Калі вяртае адмоўнае значэнне, значыць такая вобласць не існуе.
|
|
function InMergeRange(ACol, ARow: integer): integer;
|
Вяртае нумар аб'яднанага вочка/вобласці, у якую ўваходзіць вочка [ACol, ARow].
Калі вяртае адмоўнае значэнне - вочка [ACol, ARow] не ўтрымоўваецца ў Merge вобласці.
|
Успадкаваны ад TPersistent. Утрымоўвае стылі дакумента.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Count: integer;
|
Кол-у стыляў у дакуменце.
|
|
Items[num: integer]: TZStyle;
|
Стыль num (-1 - DefaultStyle).
|
|
DefaultStyle: TZStyle;
|
Стыль па-змаўчанню (аналог Items[-1]).
|
Метады:
|
Метады TZStyles
|
Кароткае апісанне
|
|
function Add(const Style: TZStyle; CheckMatch: boolean = false): integer;
|
Дадае стыль.
Style - стыль, CheckMatch - ці правяраць уваходжанне дадзенага стылю раней.
Вяртае нумар дададзенага (ці, калі CheckMatch = True, уведзенага раней) стылю.
|
|
procedure Clear();
|
Выдаляе ўсе стылі.
|
|
function DeleteStyle(num: integer): integer;
|
Выдаляе стыль num, стылі з вялікім нумарам зрушваюцца. num - нумар стылю.
Вяртае:
0 - выдаліўся паспяхова
-1 - стыль не выдаліўся
|
|
function Find(const Style: TZStyle): integer;
|
Шукае супадзенне стылю Style з уведзенымі стылямі.
Вяртае:
-2 - стыль не знойдзены
-1 - супадае са стылем па-змаўчанню
0..Count-1 - нумар стылю
|
Успадкаваны ад TPersistent. Стыль вочка.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Alignment: TZAlignment;
|
Выраўноўванне вочка.
|
|
BGColor: TColor;
|
Колер залівання вочка.
Па-змаўчанню clWindow.
|
|
Border: TZBorder;
|
Рамка вочка.
|
|
CellPattern: TZCellPattern;
|
Шаблон залівання вочка.
Па-змаўчанню ZPNone.
|
|
Font: TFont;
|
Шрыфт.
|
|
HideFormula: boolean;
|
Хавае формулу, калі ўсталявана ў True.
Па-змаўчанню False.
|
|
NumberFormat: string;
|
Фармат ліку.
|
|
PatternColor: TColor;
|
Колер шаблону залівання.
Па-змаўчанню clWindow.
|
|
Protect: boolean;
|
Абаронена-ці вочка ад рэдагавання.
Па-змаўчанню True.
|
Метад:
function IsEqual(Source: TPersistent): boolean; - Вяртае True,
калі стыль супадае з Source.
Успадкаваны ад TPersistent. Выраўноўванне ў вочку.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Horizontal: TZHorizontalAlignment;
|
Гарызантальнае выраўноўванне тэксту ў вочку.
Па-змаўчанню ZHAutomatic.
|
|
Indent: integer;
|
Водступ.
|
|
Rotate: integer;
|
Кут заваротку тэксту ў вочку (ад -90 да 90).
Па-змаўчанню 0.
|
|
ShrinkToFit: boolean;
|
True - памяншае памер шрыфта, каб тэкст змясціўся ў вочка.
Па-змаўчанню False.
|
|
Vertical: TZVerticalAlignment;
|
Вертыкальнае выраўноўванне тэксту ў вочку.
Па-змаўчанню ZVAutomatic.
|
|
VerticalText: boolean;
|
True - тэкст па адной літары ў радку вертыкальна.
Па-змаўчанню False.
|
|
WrapText: boolean;
|
перанос тэксту.
Па-змаўчанню False.
|
Метад:
function IsEqual(Source: TPersistent): boolean; - Вяртае True,
калі выраўноўванне супадае з Source.
Успадкаваны ад TPersistent. Налада рамак вочка ў стылі.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Border[Num: integer]: TZBorderStyle;
|
Усталёўвае рамкі вочка, дзе num:
- 0 - Left (левая мяжа)
- 1 - Top (верхняя мяжа)
- 2 - Right (правая мяжа)
- 3 - Bottom (ніжняя мяжа)
- 4 - DiagonalLeft (дыяганаль ад верхняга левага кута да ніжняга правага)
- 5 - DiagonalRight (дыяганаль ад ніжняга левага кута да правага верхняга)
|
|
Left: TZBorderStyle;
|
Левая мяжа рамкі.
|
|
Top: TZBorderStyle;
|
Верхняя мяжа рамкі.
|
|
Right: TZBorderStyle;
|
Правая мяжа рамкі.
|
|
Bottom: TZBorderStyle;
|
Ніжняя мяжа рамкі.
|
|
DiagonalLeft: TZBorderStyle;
|
Дыяганаль ад верхняга левага кута да ніжняга правага.
|
|
DiagonalRight: TZBorderStyle;
|
Дыяганаль ад ніжняга левага кута да правага верхняга.
|
Метад:
function IsEqual(Source: TPersistent): boolean; - Вяртае True,
калі змесціва супадае з Source.
Успадкаваны ад TPersistent. Стыль мяжы рамкі вочка.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
LineStyle: TZBorderType;
|
Стыль лініі.
Па-змаўчанню ZENone.
|
|
Weight: byte;
|
Таўшчыня рамкі (0-3).
Па-змаўчанню 0.
|
|
Color: TColor;
|
Колер лініі рамкі.
Па-змаўчанню ClBlack.
|
Метад:
function IsEqual(Source: TPersistent): boolean; - Вяртае True,
калі змесціва супадае з Source.
Успадкаваны ад TPersistent. Уласцівасці дакумента.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Author: string;
|
Імя аўтара дакумента.
|
|
LastAuthor: string;
|
Імя аўтара апошніх змен у дакуменце.
|
|
Created: TdateTime;
|
Дата і час стварэння дакумента.
|
|
Company: string;
|
Імя арганізацыі.
|
|
ModeR1C1: boolean;
|
Уключае адрасаванне R1C1.
Па-змаўчанню False.
|
Успадкаваны ад TPersistent. Клас-пісьменнік, запісвае xml у радок,
струмень ці файл у кадоўках CP866 (і ASCII), Windows-1251, UTF-8, UTF-16 (BE і LE).
Можна запісаць у любой іншай кадоўцы (уласцівасць TextConverter).
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Attributes: TZAttributes;
|
Атрыбуты тэга.
|
|
AttributeQuote: ansichar;
|
Двукоссі атрыбутаў (падвойныя ці адзінарныя).
Па змаўчанні падвойныя - ".
|
|
Buffer: ansistring;
|
Буфер. (толькі чытанне)
|
|
InProcess: boolean;
|
Вяртае True, калі вядзецца запіс. (толькі чытанне)
|
|
MaxBufferLength: integer;
|
Памер буфера (>0). Толькі для чытання пры InProcess = True.
Па-змаўчанню 4096 байт.
|
|
NewLine: boolean;
|
True - кожны тэг з новага радка. Толькі для чытання пры InProcess = True.
Па-змаўчанню True.
|
|
TabLength: integer;
|
На колькі знакаў табуляцыі перад кожным узроўнем адыходзіць ад пачатку радка новы тэг.
Толькі для чытання пры InProcess = True.
Па-змаўчанню 0.
|
|
TabSymbol: ansichar;
|
Знак табуляцыі (#32 (прабел) ці #9 (таб)).
Толькі для чытання пры InProcess = True.
Па-змаўчанню #32.
|
|
TagCount: integer;
|
Колькасць адкрывалых тэгаў да бягучага тэга. (толькі чытанне)
|
|
Tags[num: integer]: ansistring;
|
Вяртае адкрыты тэг num. (толькі чытанне)
|
|
TextConverter: TAnsiToCPConverter;
|
Усталёўвае канвертар тэксту. Калі пачаўся запіс - канвертар змяняць нельга.
|
|
UnixNLSeparator: boolean;
|
Калі True, то падзельнік радкоў = #10, інакш - #13#10.
|
Метады:
|
Метады TZsspXMLWriter
|
Кароткае апісанне
|
|
function BeginSaveToStream(Stream: TStream): boolean;
|
Пачаць запіс у струмень Stream.
Вяртае:
True - запіс пачаўся, усталёўвае InProcess у True.
False - запіс не магчымая.
|
|
function BeginSaveToFile(FileName: ansistring): boolean;
|
Пачаць запіс у файл FileName.
Вяртае:
True - запіс пачаўся, усталёўвае InProcess у True.
False - запіс не магчымая.
|
|
function BeginSaveToString(): boolean;
|
Пачаць запіс у радок Buffer.
Вяртае:
True - запіс пачаўся, усталёўвае InProcess у True.
False - запіс не магчымая.
|
|
procedure EndSaveTo();
|
Скончыць запіс у радок/файл/струмень. Усталёўвае InProcess у False.
|
|
procedure FlushBuffer();
|
Прымусова запісвае дадзеныя з буфера ў струмень/файл і чысціць Buffer.
|
|
procedure WriteCDATA(CDATA: ansistring; CorrectCDATA: boolean; StartNewLine: boolean = true); overload;
|
Запісаць секцыю CDATA. CDATA - змесціва секцыі.
CorrectCDATA - пры true замяняе ў CDATA усе ўваходжанні ']]>' на ']]>'
StartNewLine - пачынаць з новага радка (ігнаруецца, калі NewLine = false).
|
|
procedure WriteCDATA(CDATA: ansistring); overload;
|
Запісаць секцыю CDATA. CDATA - змесціва секцыі (CorrectCDATA = true; StartNewLine = true).
|
|
procedure WriteComment(Comment: ansistring; StartNewLine: boolean = true);
|
Запісаць каментар. Comment - змесціва каментара. StartNewLine - пачынаць з новага радка (ігнаруецца, калі NewLine = false).
|
|
procedure WriteEmptyTag(TagName: ansistring; SAttributes: TZAttributes; StartNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць пусты тэг. TagName - імя тэга. SAttributes - атрыбуты тэга. StartNewLine - пачынаць з новага радка (ігнаруецца, калі NewLine = false).
CheckEntity - правярае і карэктуе спецзнакі.
|
|
procedure WriteEmptyTag(TagName: ansistring; StartNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць пусты тэг. TagName - імя тэга. StartNewLine - пачынаць з новага радка (ігнаруецца, калі NewLine = false).
CheckEntity - правярае і карэктуе спецзнакі. Атрыбуты берэт з Attributes.
|
|
procedure WriteEmptyTag(TagName: ansistring); overload;
|
Запісаць пусты тэг. TagName - імя тэга. (StartNewLine = True; CheckEntity = True)
Атрыбуты берэт з Attributes.
|
|
procedure WriteEndTagNode();
|
Запісаць канчатак каранёвага/вузлавога элемента.
|
|
procedure WriteInstruction(InstructionName: ansistring; SAttributes: TZAttributes; StartNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць інструкцыю (<?instructionname ...?>). InstructionName - імя інструкцыі. SAttributes - атрыбуты.
StartNewLine - пачынаць з новага радка (ігнаруецца, калі NewLine = false).
CheckEntity - правярае і карэктуе спецзнакі.
|
|
procedure WriteInstruction(InstructionName: ansistring; StartNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць інструкцыю (<?instructionname ...?>). InstructionName - імя інструкцыі.
StartNewLine - пачынаць з новага радка (ігнаруецца, калі NewLine = false).
CheckEntity - правярае і карэктуе спецзнакі. Атрыбуты берэт з Attributes.
|
|
procedure WriteInstruction(InstructionName: ansistring); overload;
|
Запісаць інструкцыю (<?instructionname ...?>). InstructionName - імя інструкцыі. (StartNewLine = True; CheckEntity = True)
Атрыбуты берэт з Attributes.
|
|
procedure WriteRaw(Text: ansistring; UseConverter: boolean; StartNewLine: boolean = true);
|
Запісаць неапрацаваны тэкст.
Text - тэкст, UseConverter - выкарыстоўваць канвертар TextConverter, StartNewLine - пачынаць з новага радка (ігнаруецца,
калі NewLine = false).
ПАПЯРЭДЖАННЕ: пры выкарыстанні WriteRaw XML можа апынуцца некарэктным/сапсаваным!
|
|
procedure WriteTag(TagName: ansistring; Text: ansistring; SAttributes: TZAttributes; StartNewLine: boolean; CloseTagNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць тэг (<tag ...>text</tag>). TagName - імя тэга. SAttributes - атрыбуты. StartNewLine - пачынаць з новага радка
(ігнаруецца, калі NewLine = false). CloseTagNewLine - пачынаць які зачыняе тэг з новага радка. CheckEntity - правярае і карэктуе спецзнакі.
|
|
procedure WriteTag(TagName: ansistring; Text: ansistring; StartNewLine: boolean; CloseTagNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць тэг. TagName - імя тэга. StartNewLine - пачынаць з новага радка (ігнаруецца, калі
NewLine = false). CloseTagNewLine - пачынаць які зачыняе тэг з новага радка. CheckEntity - правярае і карэктуе спецзнакі. Атрыбуты берэт з Attributes.
|
|
procedure WriteTag(TagName: ansistring); overload;
|
Запісаць тэг. TagName - імя тэга. Атрыбуты берэт з Attributes. (StartNewLine = True; CloseTagNewLine = False; CheckEntity = True)
|
|
procedure WriteTagNode(TagName: ansistring; SAttributes: TZAttributes; StartNewLine: boolean; CloseTagNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць каранёвы/вузлавы элемент. TagName - імя тэга. SAttributes - атрыбуты. StartNewLine - пачынаць з новага радка
(ігнаруецца, калі NewLine = false). CloseTagNewLine - пачынаць які зачыняе тэг з новага радка. CheckEntity - правярае і карэктуе спецзнакі.
|
|
procedure WriteTagNode(TagName: ansistring; StartNewLine: boolean; CloseTagNewLine: boolean; CheckEntity: boolean = true); overload;
|
Запісаць каранёвы/вузлавы элемент. TagName - імя тэга. StartNewLine - пачынаць з новага радка
(ігнаруецца, калі NewLine = false). CloseTagNewLine - пачынаць які зачыняе тэг з новага радка. CheckEntity - правярае і карэктуе спецзнакі.
Атрыбуты берэт з Attributes
|
|
procedure WriteTagNode(TagName: ansistring); overload;
|
Запісаць каранёвы/вузлавы элемент. TagName - імя тэга.
Атрыбуты берэт з Attributes. (StartNewLine = True; CloseTagNewLine = False; CheckEntity = True)
|
Успадкаваны ад TPersistent. Клас-чытач, чытае XML з радка,
струменя ці файла ў кадоўках CP866 (і ASCII), Windows-1251, UTF-8, UTF-16 (BE і LE).
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Attributes: TZAttributes;
|
Атрыбуты тэга.
|
|
ErrorCode: integer;
|
Вяртае памылку чытання/апрацоўкі тэга. 0 - усё звычайна, 1 - значэнне параметру без двукоссяў, і г.д. (RO)
|
|
IgnoreCase: boolean;
|
Пры True ігнаруе рэгістр тэгаў. Толькі для чытання пры InProcess = True.
Па-змаўчанню False.
|
|
InProcess: boolean;
|
Вяртае True, калі ідзе апрацоўка XML. (толькі чытанне)
|
|
MaxBufferLength: integer;
|
Памер буфера (>=512). Толькі для чытання пры InProcess = True.
Па-змаўчанню 4096 байт.
|
|
RawTextTag: ansistring;
|
Неапрацаваны тэкст прачытанага тэга. (RO)
|
|
TagCount: integer;
|
Колькасць адкрывалых тэгаў да бягучага тэга. (RO)
|
|
Tags[num: integer]: ansistring;
|
Вяртае адкрыты тэг num. (RO)
|
|
TagName: ansistring;
|
Вяртае імя прачытанага тэга/інструкцыі/каментара. (RO)
|
|
TagValue: ansistring;
|
Вяртае тэкст CDATA ці каментара. (RO)
|
|
TagType: byte;
|
Вяртае тып тэга:
- 0 - штосьці незразумелае
- 1 - <?...?>
- 2 - <![CDATA[..]]>
- 3 - <!--..-->
- 4 - <...>
- 5 - <.../>
- 6 - </...>
|
Метады:
|
Метады TZsspXMLReader
|
Кароткае апісанне
|
|
function BeginReadFile(FileName: ansistring): integer;
|
Пачаць чытаць XML з файла FileName.
Вяртае:
- 0 - усё звычайна
- 1 - дадзены аб'ект ужо працуе над чытаннем
- 2 - памылка
- 3 - Stream = nil
|
|
function BeginReadStream(Stream: TStream): integer;
|
Пачаць чытаць XML са струменя Stream.
Вяртае 0 пры адсутнасці памылак.
|
|
function BeginReadString(Source: ansistring; IgnoreCodePage: boolean = true): integer;
|
Пачаць чытанне з радка Source. Пры IgnoreCodePage = True ігнаруе кадоўку.
Вяртае 0 пры адсутнасці памылак.
|
|
function ReadTag(): boolean;
|
Чытае тэг.
|
|
procedure EndRead();
|
Скончыць чытанне.
|
|
Eof(): boolean;
|
Вяртае True пры дасягненні канца файла/струменя/радкі.
|
Успадкаваны ад TPersistent. Пабудоўнік атрыбутаў для тэгаў.
Уласцівасці:
|
Property
|
Кароткае апісанне
|
|
Count: integer;
|
Колькасць атрыбутаў. (RO)
|
|
Items[num: integer]: TZAttrArray;
|
Доступ да пары Атрыбут-Значэнне па нумары num.
|
|
ItemsByName[Att: ansistring]: ansistring;
|
Доступ да значэння атрыбуту па яго імі Att.
|
|
ItemsByNum[num: integer]: ansistring;
|
Доступ да значэння атрыбуту па яго нумары num.
|
Метады:
|
Метады TZAttributes
|
Кароткае апісанне
|
|
procedure Add(AttrName: ansistring; Value: ansistring; TestMatch: boolean = true); overload;
|
Дадае атрыбут з імем AttrName і значэннем Value. Пры TestMatch = true правярае, ці быў ранняе ўвядзе атрыбут AttrName, калі быў, тое
змяняе значэнне, інакш дадае новы атрыбут.
|
|
procedure Add(Attr: TZAttrArray; TestMatch: boolean = true); overload;
|
Дадаць атрыбут Attr.
|
|
procedure Clear();
|
Выдаляе ўсе атрыбуты.
|
|
procedure DeleteItem(Index: integer);
|
Выдаляе атрыбут c нумарам Index. Атрыбуты, якія стаяць правей выдалянага, зрушваюцца на адзінку налева.
|
|
procedure Insert(Index: integer; AttrName: ansistring; Value: ansistring; TestMatch: boolean = true); overload;
|
Дадае атрыбут AttrName са значэннем Value у пазіцыю Index.
|
|
procedure Insert(Index: integer; Attr: TZAttrArray; TestMatch: boolean = true); overload;
|
Дадае атрыбут Attr у пазіцыю Index.
|
|
function ToString(quote: ansichar; CheckEntity: boolean; addempty: boolean): ansistring; overload;
|
Вяртае радок з атрыбутаў. quote - двукоссе для значэння атрыбуту. Калі CheckEntity = true, тое карэктуе спецзнакі ў значэннях атрыбутаў. Калі addempty = true,
то атрыбуты з пустымі значэннямі не дадаюцца.
|
|
function ToString(CheckEntity: boolean): ansistring; overload;
|
Вяртае радок з атрыбутаў. Калі CheckEntity = true, тое карэктуе спецзнакі ў значэннях атрыбутаў. (quote = "; addempty = true)
|
|
function ToString(): ansistring; overload;
|
Вяртае радок з атрыбутаў. (quote = "; CheckEntity = true; addempty = true)
|
Тыпы:
Тып дадзеных вочкі
TZCellType = (ZENumber, ZEDateTime, ZEBoolean, ZEansistring, ZEError);
Стыль напісання ліній рамкі вочка
TZBorderType = (ZENone, ZEContinuous, ZEDot, ZEDash, ZEDashDot, ZEDashDotDot,ZESlantDashDot, ZEDouble);
Гарызантальнае выраўноўванне
TZHorizontalAlignment = (ZHAutomatic, ZHLeft, ZHCenter, ZHRight, ZHFill, ZHJustify, ZHCenterAcrossSelection, ZHDistributed, ZHJustifyDistributed);
Вертыкальнае выраўноўванне ў вочку
TZVerticalAlignment = (ZVAutomatic, ZVTop, ZVBottom, ZVCenter, ZVJustify, ZVDistributed, ZVJustifyDistributed);
Шаблон залівання вочка
TZCellPattern = (ZPNone, ZPSolid, ZPGray75, ZPGray50, ZPGray25, ZPGray125, ZPGray0625, ZPHorzStripe, ZPVertStripe,
ZPReverseDiagStripe, ZPDiagStripe, ZPDiagCross, ZPThickDiagCross, ZPThinHorzStripe, ZPThinVertStripe,
ZPThinReverseDiagStripe, ZPThinDiagStripe, ZPThinHorzCross, ZPThinDiagCross);
Канвертар тэксту з лакальнай кадоўкі ў патрэбную
TAnsiToCPConverter = function (AnsiText: ansistring): ansistring;
Канвертар тэксту з чытанай кадоўкі ў лакальную
TCPToAnsiConverter = TAnsiToCPConverter;
Атрыбут-значэнне
TZAttrArray = array [0..1] of ansistring;
Спосаб разбіцця/замацаванні радкоў і слупкоў у якасці загалоўкаў.
TZSplitMode = (ZSplitNone, ZSplitFrozen, ZSplitSplit);
Для сумяшчальнасці з юнікоднымі дэльфамі (>= RAD Studio 2009) уведзены:
- TZAttrArrayH
- TZAttributesH
- TZsspXMLWriterH
- TZsspXMLReaderH
Для Free Pascal і Delphi < 2009 яны эквіваленты тыпам без постфікса "H", для юнікодных версій Delphi у гэтых тыпах усе ansistring заменены на string.
|
