Данный пакет содержит в себе вспомогательные классы и утилиты, которые необходимы во время разработки программы.
Все эти данные не используются во время работы готовой программы, поэтому этот код не включается в финальные версии программ.
Компонента TRxDBGrid предназначена, как и стандартная компонента TDBGrid, для отображения данных таблиц БД или результатов запросов в табличной форме. Являясь наследником TDBGrid, компонента TRxDBGrid имеет все те же свойства и методы, и, кроме того, некоторые свойства, находящиеся у TDBGrid в секции protected, вынесены в секцию public. Это такие свойства, как Col, Row, LeftCol, Canvas.
Другие отличия от TDBGrid:
- BLOB-поля базы данных, такие как графические изображения, текстовые мемо-поля, другие BLOB'ы могут отображаться в таблице в виде пиктограмм при установленном в True значении свойства ShowGlyphs;
- вы можете изменить цвет шрифта и фона любой ячейки таблицы (либо любой ее строки или столбца) в зависимости от значения поля или имени поля набора данных, определив обработчик события OnGetCellParams;
- имеются методы SaveLayout и RestoreLayout для сохранения и восстановления порядка и ширин столбцов компоненты TRxDBGrid в INI или XML-файле. Вы можете также автоматически сохранять и восстанавливать эти параметры, присвоив значение свойству IniStorage.
- заголовки колонок Grid-а могут быть с помощью свойства TitleButtons использованы как кнопки, например, для изменения порядка сортировки отображаемых данных.
- вы можете зафиксировать несколько первых колонок в Grid-е с помощью свойства FixedCols.
Событие получения параметров ячейки в RxDBGrid-е
Свойство позволяет автоматически сохранять специфические установки компоненты в INI-файле или (для 32-разрядной версии) в системном регистре при помощи компонент TFormPlacement или TFormStorage.
При задании значения свойству IniStorage (и непустом имени компоненты), некоторые ее настройки, которые не являются published-свойствами и не могут быть заданы для TFormStorage напрямую, будут сохраняться и восстанавливаться одновременни с другими значениями, заданными для соответствующей компоненты TFormPlacement (TFormStorage).
Для TSpeedbar - это расположение кнопок на панели и положение самой панели, для TMRUManager - список строк, для TRxDBGrid - ширины и положение полей в таблице и т.д. Все компоненты, имеющие свойство IniStorage, имеют также методы для сохранения и восстановления их настроек вручную, такие как Save/RestoreLayout и т.д.
Набор флагов, управлюящих поведением RxDBGrid-а.
Маркер направления сортировки.
Определяет отображение маркера сортировки в заголовке столбца RxDBGrid-а.
Параметр | Описание |
smNone | Не отображать маркер |
smDown | Отображать маркер "Вниз" - прямая сортировка |
smUp | Отображать маркер "Вверх" - обратная сортировка |
Данный тип описывает событие при отображении в списке заголовка колонки
Параметр | Тип | Описание |
Sender: TObject | Вх. | Указывает на экземпляр объекта RxDBGrid |
Field: TField | Вх. | Определяет колонку, для которой необходимо определить параметры |
AFont: TFont | Вх. | С помощью данного объекта можно указать параметры шрифта заголовка |
Background: TColor | Вых. | Можно указать цвет фона заголовка колонки |
SortMarker: TSortMarker | Вых. | Можно указать тип маркера сортировки |
IsDown: Boolean | Вх. | Определяет, был ли клик мышкой по данному заголовку |
Данный тип описывает событие получения параметров ячейки в RxDBGrid-е
Параметр | Тип параметра | Описание |
Sender: TObject | вх. | Указывает на экземпляр объекта RxDBGrid |
Field: TField | вх. | Определяет колонку, для которой произошло событие |
AFont: TFont | вх. | С помощью данного объекта можно указать параметры шрифта ячейки |
Background: TColor | вых. | Можно указать цвет фона ячейки |
Флаги, определяющие параметры изменения данных в RxDBGrid
Параметр | Описание |
aoInsert | Доступна вставка строки данных в RxDBGrid |
aoUpdate | Доступна изменение данных в строке RxDBGrid |
aoDelete | Доступно удаление строки данных из RxDBGrid |
aoAppend | Доступно добавление строки данных в конец списка в RxDBGrid |
Набор флагов, определяющие поведение при редактировании/добавлении или удалении данных в RxDBGrid
Определяем тип занчения, автоматически расчитываемого в итоговой строке
Параметр | Значение |
fvtNon | По умолчанию, ничего не отображаем |
fvtSum | Отображается сумма по указанной колонке |
fvtAvg | Расчитывается среднее значение по указанной колонке |
fvtCount | Отображается общее количество строк в списке |
fvtFieldValue | Отображается значение указанной колонки |
fvtStaticText | Отображается текст из поля Value |
fvtMin | Отображается минимальное значние указанного в свойстве FieldNameполя |
fvtMax | Отображается максимальное значние указанного в свойстве FieldNameполя |
fvtRecNo | Отображается номер текущей записи из списка |
Набор флагов, управляющих поведением RxDBGrid
Параметр | Описание |
rdgAllowColumnsForm | Разрешает вызов формы управления отображением и порядком расположения колонок в RxDBGrid-е |
rdgAllowDialogFind | Разрешает вызов формы поиска данных в RxDBGrid-е |
rdgHighlightFocusCol | Подсвечивать текущую колонку |
rdgHighlightFocusRow | Подсвечивать текущую строку |
rdgDblClickOptimizeColWidth | При двойном щелчке по разделителю между колонками в RxDBGrid-е автоматически подбирать размер колонки по ширине отображаемых данных |
rdgFooterRows | Отображать итоговую строку (подвал) спика |
rdgXORColSizing | При изменении размера колонки отображать только будущую границу колонки, саму колонку при этом не менять. В противном случае при изменении размера ширина колонки меняется сразу. Параметр полезен для медленных компьютеров или терминального режима |
rdgFilter | Разрешить локальную фильтрацию данных |
rdgMultiTitleLines | Разрешить объединение заголовков колонок |
rdgMrOkOnDblClik | При двойном щелчке мышки генерировать для формы-владельца грида событие mrOk - полезно при создании формы выбора из списка |
rdgAllowQuickSearch | Разрешить быстрыый поиск в гриде - в этом режиме нажатие клавиш включет механизм встроенного поиска по текущей колонке, прямое редактирование в списке будет запрещено. |
rdgAllowQuickFilter | Разрешить быструю фильтрацию в колонках - в заголовке списка будет доступна по нажатию клавиши Ctrl+E дополнительная строка, содержащая ComboBox-ы со значениями колонок. Аналогично сортировки в электронных таблицах. |
rdgAllowFilterForm | Разрешает к использованию форму фильтрации в RxDBGrid-е |
rdgAllowSortForm | Разрешает к использованию формы сортировки данных в RxDBGrid-е |
rdgAllowToolMenu | Включает отображение меню инструментов в RxDBGrid-е. При активации данного параметра в верхнем левом углу грида отрисовывается специальный значок и при его нажатии мышкой выдаётся меню иснтрументов |
rdgCaseInsensitiveSort | Параметр включает режим сортировки без учёта регистра символов в столбце RxDBGrid-а |
Набор флагов, управлюящих поведением RxDBGrid-а.
Параметры сортировки данных
Параметр | Описание |
seoCaseInsensitiveSort | При сортировке данных не учитывать регистр |
RxDBGridSortEngineClass:TRxDBGridSortEngineClass - класс сортировщика
DataSetClass:TDataSetClass -
Компонента TRxLabel аналогична стандартной компоненте VCL TLabel, однако дополнительно позволяет придать тексту статического элемента управления (Label) 3-мерный вид, либо отобразить "тень" текста.
С помощью свойст ShadowPos, ShadowColor и ShadowSize вы можете задать расположение, цвет и толщину "тени" букв текста. Значения, заданные для этих свойств по умолчанию, создают "трехмерный" эффект изображения текста.
Компонента TSecretPanel предназначена, как и компонента TPanel, для помещения в форму "панелей", на которых могут быть размещены другие элементы управления.
В дополнение к свойствам и методам компоненты TPanel, TSecretPanel имеет возможность размещения "скрытого" текста и изображения, доступных для отображения при установленном в True значении свойства Active. Свойство LinesLines задает список строк текста, который будет "прокручиваться" в направлении снизу вверх или справа налево (в зависимости от значения свойства ScrollDirection) в клиентской области компоненты TSecretPanel при установке Active = True. Если свойство Glyph ассоциировано с графическим изображением, то одновременно это изображение будет показано в области TSecretPanel, заданной свойством GlyphLayout. По окончании прокрутки текста, если свойство Cycled = False, свойство Active автоматически установится в значение False, если же Cycled = True, прокрутка текста возобновится сначала. Вы можете также прервать прокрутку, вручную установив свойство Active в значение False.
Событие OnPaintClient позволяет вам достигать всевозможных эффектов при отрисовке клиентской области панели как в активном состоянии (при прокрутке текста), так и в неактивном.
Свойство определяет, как будет осуществляться перерисовка компоненты при "прокрутке" текста, т.е. когда свойство Active = True.
Если AsyncDrawing = False, то перерисовка синхронизируется с основным потоком приложения. Если AsyncDrawing = True (по умолчанию), то прокрутка текста и перерисовка осуществляется асинхронно, в отдельном потоке.
Свойство определяет состояние компоненты TSecretPanel. При установке значения этого свойства в True, все компоненты, размещенные на TSecretPanel (у которых свойство Parent указывает на этот объект), скрываются, отображается изображение, заданное свойством Glyph, и начинается автоматическая прокрутка текста, определенного свойством Lines.
Если свойство Cycled = False, то при прокрутке всего текста свойство Active автоматически устанавливается в значение False. Вы можете также прервать прокрутку ранее, присвоив свойству Active значение False.
Свойство Cycled определяет поведение компоненты после прокрутки всего текста, заданного свойством Lines. Если Cycled = True, то прокрутка текста будет продолжена с начала, если же Cycled = False (по умолчанию), то после прокрутки всего текста свойство Active будет установлено в значение False.
Событие возникает при перерисовке панели как в активном состоянии (Active=True) при прокрутке текста, так и в неактивном. Вы можете использовать это событие для создания всевозможных эффектов при отрисовке панели.
Компонента служит для ввода и редактирования чисел и денежных сумм. TCurrencyEdit имеет те же свойства, что и ее предок TEdit, но позволяет дополнительно указать формат отображения числа и символы для обозначения вида валюты с помощью свойства DisplayFormat, а также максимальное число символов после десятичной точки (при вводе данных) с помощью свойства DecimalPlaces. Свойство Value позволяет получить или установить численную величину отображаемого в компоненте значения.
Если свойство BeepOnError установлено в True, то при вводе в строку недопустимых символов раздается звуковой сигнал.
Свойство позволяет обратиться к значению Value, сохраненному в компоненте - редакторе для ввода чисел, как к целому числу.
Свойство определяет, будет ли проверяться допустимый диапазон числа в компонентах TCurrencyEdit при потере фокуса строкой редактирования.
Если CheckOnExit = True, то в случае ввода недопустимого значения происходит исключение (exception).
The CurrEdit unit contains the declarations for the certain components on the RX Controls page of the Component palette and their associated objects, types, and constants. When you add a component declared in this unit to a form, the unit is automatically added to the uses clause of that form's unit.
The following items are declared in the CurrEdit unit:
Components and objects
TCurrencyEdit
To see a listing of items declared in this unit including their declarations, use the ObjectBrower.
Компонента TRxLookupEdit представляет собой редактор с возможностью как прямого ввода текста пользователем в строке редактирования, так и выбора текста из выпадающего списка, заполняемого значениями из базы данных. При открытом списке набор пользователем символов с клавиатуры приводит к позиционированию списка на ближайшую запись, совпадающую с введенным текстом.
Для заполнения выпадающего списка используются свойства LookupSource, LookupField, LookupDisplay и LookupDisplayIndex, аналогично списку компоненты TRxDBLookupCombo.
Введенное пользователем или выбранное из списка значение доступно через свойство Text. Свойство LookupValue (read-only) позволяет получить значение ключевого поля из lookup-набора данных (заданного свойством LookupField), если пользвателем был сделан выбор из списка.
The RxLookup unit contains the declarations for the certain components on the RX DBAware page of the Component palette and their associated objects, types, and constants. When you add a component declared in this unit to a form, the unit is automatically added to the uses clause of that form's unit.
Свойство - массив, содержит в себе список всех файлов и каталогов, которые были обнаружены в указанной папке.
Кол-во элементов данного массива находится в свойстве CountСвойство содержит в себе кол-во прочитанных файлов
Свойство FileFolder определяет каталог с файлами, который будет сканироваться при вызове метода Execute и по содержимому которого будет произведено заполнение массива Files
Свойство OnExecuteItem вызывается при выборе пункта меню, которые было сформировано по элементам массива Files
Данное свойство определяет место в меню, где будет добавлено в виде подменю содержимое каталога FileFolder
Компонента из числа "безделушек", позволяющая вам использовать в формах изображения игральных костей в различных положениях.
Текущее состояние компоненты (положение игральной кости) задается свойством Value, которое может изменяться от 1 до 6. Вы можете установить свойство Value в случайное значение, вызвав метод RandomValue. Если вы установите свойство Rotate в значение True, изображение игральной кости начнет случайным образом "вращаться", изменяя значение Value, с частотой, задаваемой свойством Interval. Остановить вращение можно, присвоив значение False свойству
При изменении значения Value происходит событие OnChange.
Свойство задает интервал (в мсек), по прошествии которого после установки свойства Rotate в значение True вращение игральной кости будет остановлено.
Если значение AutoStopInterval = 0, то вращение автоматически не останавливается и может быть прекращено присваиванием Rotate = False.
Свойство определяет временной интервал (в милисекундах), с которым происходит смена изображений в компоненте.
при Rotate = True это частота смены битовых изображений.
Свойство позволяет автоматически сохранять специфические установки компоненты в INI-файле или (для 32-разрядной версии) в системном регистре при помощи компонент TFormPlacement или TFormStorage.
При задании значения свойству IniStorage (и непустом имени компоненты), некоторые ее настройки, которые не являются published-свойствами и не могут быть заданы для TFormStorage напрямую, будут сохраняться и восстанавливаться одновременни с другими значениями, заданными для соответствующей компоненты TFormPlacement (TFormStorage).
Для TSpeedbar - это расположение кнопок на панели и положение самой панели, для TMRUManager - список строк, для TRxDBGrid - ширины и положение полей в таблице и т.д. Все компоненты, имеющие свойство IniStorage, имеют также методы для сохранения и восстановления их настроек вручную, такие как Save/RestoreLayout и т.д.
Стиль | Описание |
tbrButton | Кнопка |
tbrCheck | Чек-бокс |
tbrDropDown | Выпадающее меню |
tbrSeparator | Разделитель |
tbrDivider | Разделитель с линией |
tbrDropDownExtra | Кнопка с выпадающим меню |
Стиль отображения на панели инструментов
Сталь | Описание |
tbsStandart | Отображение кнопок обёмными и квадратными (как было в Windows 95-2000) |
tbsWindowsXP | Отображение "плоских" голубых кнопок (как в Windows XP) |
tbsNative | При отображении кнопок используется внешний вид согласно текущей системной темы отрисовки элементов интерфейса |
Выравнивание кнопок на панели инструментов
Выравнивание | Описание |
tbaNone | Нет автоматического выравнивания кнопок |
tbaLeft | Выравнивани по левому краю |
tbaRignt | Выравнивание по правому краю |
Элемент | Описание |
tpFlatBtns | Всплывающие кнопки |
tpTransparentBtns | Прозрачные кнопки, актуально если сама панель инструментов отрисовывется не стандартно, например с фоновым рисунком |
tpStretchBitmap | Растягивать изображения |
tpCustomizable | Доступно во время работы приложения возможность настройки панели (скрывать или отображать кнопки) |
tpGlyphPopup | При наведении указателя мышки изображения на кнопках будут "приподниматься" |
tpCaptionPopup | При наведении указателя мышки текст на кнопках будет "приподниматься" |
function GetFileOwnerUser(const SearchDomain, FileName:String):String;
Функция возвращает имя пользователя операционной системы владельца указанного файла.
Входные параметры:
SearchDomain - Домен, в котором будет производится поиск оператора (пустой для текущего домена оператора).
FileName - Полное имя файла.
procedure GetFileOwnerData( const SearchDomain, FileName: String; out UserName, DomainName: String);
Процедура возвращает имя и домен пользователя операционной системы владельца указанного файла.
Входные параметры:
- SearchDomain - Домен, в котором будет производится поиск оператора (пустой для текущего домена оператора).
- FileName - Полное имя файла.
Выходные параметры:
- UserName - Имя пльзователя.
- DomainName - Домен, в котором найден данный пользователь.
function NormalizeDirectoryName( const DirName: string): string;
Функция проверяет все разделители каталогов в указанном имени файла/каталога и, если нужно, меняет их на значение константыDirectorySeparator.
function GetUserName: string;
Функция GetUserName возвращает имя оператора, залогиненго в системе
Класс TRxVersionInfo предоставляет доступ к информации о версии программы.
После создания объекта этого класса вы можете получить доступ к информации из ресурса VERSIONINFO через свойства (только-для-чтения) объекта, если чтение ресурса из специфицированного файла окончилось успешно. Вы можете проверить результат чтения информации из файла по значению свойства Valid - значение True соответствует успешному чтению данных. При изменении свойства, задающего имя исполняемого файла с ресурсом VERSIONINFO, происходит обновление данных объекта. Успешность обновления можно также проверить по значению свойства Valid.
Данный класс предоставляет информацию о наиболее часто используемых свойствах скомпилируемого исполняемого модуля. Фактически является надстройкой над пакетом fpc fcl-res
Параметры отображени окна информации о программе
Значение | Описание |
radHelpButton | Отображать кнопку "Помощь" |
radLicenseTab | Отображать закладку лицензии |
radShowImageLogo | Отображать логотип на первой закладке |
Набор флагов, определяющий параметры отображения окна информации о программе
Набор флагов, определяющий параметры отображения окна информации о программе
Событие возникает при нажатии на кнопку переключения вида.
ItemIndex | Порядковый номер кнопку |
Item | указатель на кнопку |