CSplashWindow
Модуль содержит класс TSplashWindow, являющийся потомком TThreadWindow. Используется для создания заставок
(сплэш-форм), которые появляются при запуске приложения.
TextDefaultValue
Версия: %%ProductVersion%%
%%LegalCopyright%%
%%FileDescription%%
ресурсная строка
Текст отображаемый в окне заставки по умолчанию
CaptionDefaultValue
%%ProductName%%
ресурсная строка
Заголовок окна заставки по умолчанию
SplashName
SPLASH
тип константы
string
Название ресурса с изображением заставки по умолчанию
DefaultHeight
$140
тип константы
Integer
Высота окна заставки по умолчанию
DefaultWidth
$100
тип константы
Integer
Ширина окна заставки по умолчанию
VersionInfoFields
тип константы
:1
Названия макросов, которые будут заменены на соответствующие значения взятые из ресурса Version
Текст должен иметь следующий вид: '%%ProductName%%'
UM_GetBitmap
$471
тип константы
Integer
Пользовательское сообщение, возвращающее фоновое изображение окна заставки
UM_SetBitmap
$472
тип константы
Integer
Пользовательское сообщение устанавливающее фоновое изображение окна заставки
TUMGetSetBitmap
TUMGetSetBitmap = packed record
Msg: Cardinal;
IndexProp: Word;
Part: Word;
Value: TBitmap;
Result: Integer;
end
Структура используемая для получения, или передачи фонового изображения заставки
TCSplashWindow
TCSplashWindow = class(TCWindowThread)
Предки
Модуль |
Класс |
CWindowThread |
TCWindowThread |
Classes |
TComponent |
Classes |
TPersistent |
System |
TObject |
Класс TCSplashWindow является визуальной оболочкой для TSplashWindow Если в программе есть ресурс с названием
'SPLASH', или 'SPLASH_XX' (где XX — количество бит на пиксел), то при инициализации модуля будет создано и запущено
окно с заставкой, которое будет видно в течение 3 секунд.
Замечания
В приложении может быть создан один экземпляр класса TCSplashWindow для управления заставкой.
Важная инфа
Заставка может быть отображена еще до создания формы на которой располагается компонент и
даже до создания объекта Application, поэтому загрузка dfm-данных осуществляется нестандартным образом. TCSplashWindow
самостоятельно попытается найти dfm-информацию в ресурсах приложения по имени DefaultSplashClassName. Если найти не
получится, будут использованы значения по умолчанию.
Пример использования
unit Unit2;
interface
uses CSplashWindow;
implementation
initialization
ShowSplash;
end.
//
program ProjectSplash;
uses
Unit2 in 'Unit2.pas',
Forms, ...
См. также
Содержимое
TCSplashWindow.ResourceName
published
property ResourceName: string read fResourceName write fResourceName
Название ресурса с изображением. По умолчанию 'SPLASH'. Поиск осуществляется во всех загруженных модулях,
начиная с модуля DefaultInstance.
Замечания
В приложении может быть несколько изображений с названиями вида 'SPLASH_XX' (где XX - количество бит на
пиксел). В зависимости от режима работы монитора будет выбран наиболее подходящий формат.
См. также
TSplashWindow
TSplashWindow = class(TCustomThreadWindow)
Предки
Модуль |
Класс |
CWindowThread |
TCustomThreadWindow |
WindowThread |
TThreadWindow |
Classes |
TThread |
System |
TObject |
Окно с фоновым изображением, работающее в своём собственном потоке.
См. также
Содержимое
DefaultSplashClassName
DefaultSplashClassName: string
Имя класса, которое будет найдено среди dfm ресурсов, для загрузки параметров "внутренней" заставки. Если
значение не задано, то будет использовано имя класса определенного переменной DefaultSplashClass.
См. также
DefaultInstance
DefaultInstance: Cardinal
Хэндл модуля, в котором будет осуществляться поиск ресурса в первую очередь.
Важная инфа
Поиск ресурсов осуществляется в следующих модулях:
1. В DefaultInstance, если не 0
2. В загруженном модуле языковой поддержки (ENU, RUS и т.п.). См. FindResourceHInstance
3. В текущем модуле. См. HInstance
4. Во всех остальных загруженных модулях (Dll и Bpl), если DefaultInstance = 0
EnumDLLs
function EnumDLLs(List: TStringList): Boolean
Загрузка в список всех используемых бибилиотек и их хэндлов, включая само приложение.
Параметры
List |
Список, в который производится загрузка. |
Возвращаемое значение |
В случае успешного выполнения возвращается True |
SplashWindow
function SplashWindow(): TCSplashWindow
Функция SplashWindow возвращает "внутреннюю" заставку (единственный экземпляр объекта, который создаётся и
отображается в начале работы приложения). Если заставка еще не создана, то создаётся. Класс создаваемого объекта задаётся
переменной DefaultSplashClass.
Замечания
Через некоторое время после сокрытия окна, его экземпляр будет разрушен. Самостоятельно вызывать метод Free
ненадо.
Параметры
Возвращаемое значение |
Экземпляр созданного окна-заставки |
См. также
©
Полезные примочки для Delphi