TLCLTaskDialog.SetupControls

Configures and initializes properties and controls used on the emulated task dialog form.

Declaration

Source position: taskdlgemulation.pp line 164

Description

SetupControls is a method used to configure / initialize controls and content on the emulated task dialog. Values from the TTaskDialog owner are copied to the dialog form, including:

• Buttons
• CommonButtons
• RadioButtons
• Caption (application title or main form caption when omitted)
• Title (or the IconMessage when omitted)
• Text
• ExpandButtonCaption
• CollapseButtonCaption
• ExpandedText
• FooterText
• VerificationText

Values from the Flags property in TTaskDIalog are used to determine which content and UI elements are enabled on the dialog form.

SetupControls calls private method in the class to layout and align the elements on the dialog form. This includes setting the border style, border icons, and position for the dialog form. The font typeface and size used on the dialog are assigned in the method.

It creates and populates three (3) panels with the controls needed for the dialog. The top panel holds the main icon, title, text, and expanded text. The middle panel contains any radio buttons, command link buttons, query controls, or the progress bar for the dialog. The bottom panel contains the remainder of the controls on the dialog form including the expand /collapse button, verification check box, and footer text.

A timer enabled for the form is created, initialized, and started in the method.

SetupControls calculates the width needed for the dialog form. It uses the length of common elements (like Title, Text, and the cumlative length for button captions) when an explict Width has not been assigned for the task dialog. A minimum width of 120 pixels is assumed, but common calculated widths include 300, 420, amd 480 pixels. A minimum height of 200 pixels is assumed.

SetupControls is called from the Execute method before the ShowModal method is called for the emulated task dialog.

See also