TFormPlacement Component

Unit
Placemnt

Description
Компонента FormPlacement сохраняет и восстанавливает размеры и положение формы, которой она принадлежит.
Компонента предназначена для работы с формами всех стилей: Normal, MDIForm, MDIChild, StayOnTop и т.д. Сохранение происходит перед уничтожением формы, а восстановление перед тем, как форма станет видимой. Необходимая информация о размерах и положении сохраняется в INI-файле. Используемый INI-файл можно задать с помощью свойства IniFileName.

Свойство Active определяет, будет ли происходить сохранение/восстановление. Свойство Options позволяет указать, какие параметры формы будут восстанавливаться при чтении из INI-файла. В большинстве случаев достаточно поместить компоненту из палитры в форму — необходимые действия будут происходить автоматически при показе/скрытии формы.


Purpose
Компонента осуществляет сохранение и восстановление размеров, состояния и положения формы, которой она принадлежит.
Вы можете также использовать эту компоненту для ограничения изменения размеров формы со стилем рамки bsSizeable.
Tasks
Используйте свойство Active для включения/выключения сохранения и восстановления состояния формы.

Вы можете задать имя используемого INI-файла, если вы не хотите использовать INI-файл приложения по умолчанию.

В обработчиках событий OnSavePlacement и OnRestorePlacement вы можете записать или считать дополнительные параметры формы или других ее компонент. Из обработчиков этих событий Вы можете обратиться к свойству IniFile для доступа к объекту типа TIniFile, используемому компонентой TFormPlacement.


Declaration
property Active: Boolean;

Description
Свойство определяет будет ли компонента восстанавливать состояние формы при загрузке и сохранять его при уничтожении формы.


Declaration
property IniFileName: string;

Description
С помощью этого свойства можно определить INI-файл используемый для хранения информации о размерах и положении формы (для компонент TFormPlacement, TFormStorage) или имени пользователя БД (TDBSecurity).
По умолчанию, свойство содержит пустую строку, что означает использование INI-файла приложения (имя исполнимого файла приложения, предоставляемого свойством ExeName без пути, + расширение '.INI'). Если файл не существует, то он будет создан. В некоторых случаях вы можете задать имя файла.

ПРИМЕЧАНИЕ
Если вы оставили значение свойства пустым в дизайнере Delphi, во время выполнения оно будет равно значению, возвращаемому функцией GetDefaultIniName.


Declaration
function GetDefaultIniName: string;
Description
Функция возвращает имя INI-файла "по умолчанию" для приложения. Таковым она считает имя EXE-файла (получаемое с помощью Application.ExeName) с расширением ".INI", при этом из имени удаляется путь, что задает размещение INI-файла в директории Windows.


Example
begin
...
IniFile := TIniFile.Create(GetDefaultIniName);
...
end;


Declaration
property Options: TPlacementOptions;

Description
Значения свойства Options определяют, какие параметры формы будут сохраняться/восстанавливаться компонентой TFormPlacement. Следующие значения могут быть включены в свойство Options:
fpState — состояние формы (нормальное, максимизированное, минимизированное);
fpPosition — положение и размеры формы;

fpActiveControl — активный элемент управления на форме (значение свойства ActiveControl формы-владельца).


Declaration
type
TPlacementOption = (fpState, fpPosition, fpActiveControl);
Description
Тип определяет возможные значения свойства Options компоненты TFormPlacement.