Skip to main content
All docs
V26.1
  • Splash Form Designer

    • 4 minutes to read

    The modal Splash Form Designer dialog allows you to configure the layout of a predefined or custom Splash/Wait Form at design time.

    VCL Shared Libraries: The Splash Form Designer Dialog

    Open Splash Form Designer

    To display the Splash Form Designer dialog for a Splash or Wait Form defined in a project, open the Project Settings dialog in your RAD Studio IDE and do the following:

    1. Switch to the Splash Forms tab.
    2. Select a Splash or Wait Form in the corresponding category.
    3. Click the Customize… button.

    VCL Shared Libraries: Project Settings — Open the "Splash Form Designer" Dialog

    Splash Form Designer UI

    The Splash Form Designer dialog includes the following tools/panes:

    VCL Shared Libraries: The "Splash Form Designer" Dialog UI Layout

    The main menu toolbar lists the following options from left to right:

    VCL Shared Libraries: Splash Form Designer — Main Menu

    Form Design

    Undo | Redo

    Action History Commands. Click UndoCtrl + Z ) and RedoCtrl + Y ) buttons to undo/redo individual changes to the displayed Splash or Wait form layout within the Design Pane (move, resize, add/remove Splash Form widgets, etc.).

    Undo and Redo buttons are disabled when corresponding action lists are empty.

    Cut | Copy | Paste

    Clipboard Operation Commands for Splash Form widget management:

    Cut & Copy Buttons

    Click the CutCtrl + X ) or CopyCtrl + C ) button to cut or copy the selected widget in the Design Pane to the clipboard.

    Cut and Copy buttons are disabled when no Splash Form widget is selected in the Design Pane.

    Paste Button

    A subsequent PasteCtrl + V ) command inserts the copied widget to the displayed form. The target position is shifted by 10 pixels down and right from the copied/cut Splash Form widget’s position.

    The Paste button is disabled if the clipboard contains no previously copied or cut Splash Form widget.

    Bring to Front | Send to Back

    Z-Order Management Commands. Click the Bring to Front button to display the selected Splash Form widget on top of all others. The Send to Back button moves the selected widget to the nethermost (background layer). These commands are useful if you need to display overlapping widgets on a Splash or Wait Form.

    Bring to Front and Send to Back buttons are disabled when no Splash Form widget is selected in the Design Pane.

    State Management

    Reset to Standard
    Click this button to revert all changes made to the initial[1] state of a Splash or Wait Form.
    Preview
    Click this button to display the opened Splash or Wait Form in Preview mode, similar to the Preview button in the Project Settings dialog. A subsequent mouse click closes the form preview.
    Save & Close
    Click this button to save all pending changes and close the Splash Form Designer dialog.

    Design Pane

    The Design Pane displays the opened form’s layout in Design mode. The Design Pane allows you to add, delete, resize, and move individual Splash Form widgets as well as resize the form (similar to the Form Designer in the RAD Studio IDE).

    VCL Shared Libraries: Splash Form Designer — Design Pane

    Widget Toolbox

    Splash and Wait Forms use dedicated non-interactive UI elements (Splash Form widgets) instead of controls (TControl descendants) to avoid excessive dependencies. The Widget Toolbox displays all available Splash Form widgets:

    VCL Shared Libraries: Splash Form Designer — Widget Toolbox

    Drag-and-drop individual widgets to the Design Pane to add them to the form.

    Available Splash Form Widgets

    Text

    A static multi-line label designed to display a custom message.

    VCL Shared Libraries: Wait Form — A "Text" Widget Example

    Animation

    An activity indicator that displays looped animation while the Splash or Wait Form is displayed. This widget supports custom looped GIF animations.

    VCL Shared Libraries: Wait Form — An "Animation" Widget Example

    Image

    Displays a static image, similar to the TcxImage editor.

    VCL Shared Libraries: Splash Form — An "Image" Widget Example

    Progress

    An animated progress bar, similar to the TcxProgressBar editor.

    VCL Shared Libraries: Splash Form — An Animated "Progress" Widget Example

    Application Property

    A static multi-line label designed to display an individual application property (product name, version number, copyrights, etc.) defined as part of version-related information stored in application resources.

    VCL Shared Libraries: Splash Form — "Application Property" Widget Examples

    Formatted Info

    A static multi-line label designed to display multiple application properties using placeholder fields defined within a custom message string.

    VCL Shared Libraries: Splash Form — A "Formatted Info" Widget Example

    Object Inspector

    The Object Inspector allows you to view and customize individual properties of the Splash Form widget currently selected in the Design Pane, similar to the Object Inspector tool in the RAD Studio IDE.

    VCL Shared Libraries: Splash Form Designer — Object Inspector

    Footnotes
    1. The form layout at the moment when a predefined or custom Splash or Wait Form was created (automatically or using the Project Settings dialog).

    See Also