Skip to main content
All docs
V26.1
  • TdxSplashFormBase.GetItem<T>(string) Method

    Provides access to any widget on the form by type and name. Use the template parameter (T) to specify the target widget type.

    Declaration

    function GetItem<T: TContentItem>(const AName: string = ''): T;

    Parameters

    Name Type Description
    AName string

    Optional. Specifies the target widget name.

    If you omit the AName parameter, the function returns the default/predefined widget according to the instantiated type (T) (if the form contains such a content item).

    Returns

    Type Description
    T

    Returns the widget with the name passed as the AName parameter (or the corresponding default widget if the optional parameter is omitted).

    If no widget is found, an exception occurs.

    Tip

    Use the template parameter (T) to specify the target widget type (a terminal TdxSplashFormBase.TContentItem class descendant).

    Remarks

    Call the GetItem function to access any Splash/Wait Form widget and modify its settings.

    Note

    The target widget must be defined within the current form. Otherwise, a GetItem function call raises an exception.

    Design Splash Forms & Manage Widgets

    To add/remove individual widgets to/from a Splash or Wait form, select the target form in the Application Settings dialog and click Customize… to display the Splash Form Designer dialog.

    VCL Shared Libraries: The "Splash Form Designer" Dialog

    Other Widget Access Methods

    Animation
    Provides access to an Animation/Activity Indicator widget on the form.
    Image
    Provides access to an Image widget on the form.
    Progress
    Provides access to a Progress Bar widget on the form.
    Text
    Provides access to a Text/Label widget on the form.
    See Also