TApCustDlgParams

Inherited from : TPersistent

unit : ApDlgParams

This component is container for all new properties which are specific to all APR Dialogs components. These properties define the dialog initial position when its shown and user-defined Delphi forms - extended parts of this dialog. For example BottomFormName property defines which Delphi form will be displayed as additional bottom part of the dialog. The following picture demonstrates the result of usage of this property:

sample.gif (9819 bytes)

Properties



Properties


Position : TApDlgPosition; RW

Determines how your dialog will bw displayed at startup.

dpDefault - defult dialog position.

dpScrCenter - Show dialog in the center of the screen.

dpMainFormCenter - In the center of the app's main form. If there is no main form  then dpScrCenter is used.

dpOwnerCenter - In the center of the owner of the dialog component. If the owner is nil then dpMainFormCenter is used.

dpFormCenter - In the center of the form specified in the PosParams.Form(run-time) or PosParams.FormName(design-time) property. If this value is empty (nil) then dpMainFormCenter is used.


PosParams : TApPosParams; RW

Additional parameters for positioning of your dialog.

Nested properties are:

    public
        Form : TForm
        use this property at run-time to set form which will be used to align dialog position. This property uses when Position property is set to dpFormCenter.

    published
        FormName : stirng
        Refers to the same form as Form property but can be used at design-time.

        ShitftX : integer
        Use this property to move dialog in horizontal direction on ShiftX pixels relative to it's initial position given by Position property.

        ShiftY : integer
        Use this property to move dialog in vertical direction on ShiftY pixels relative to it's initial position given by Position property.

        FitToScreen : boolean
        Set to true if you want to be sure that the dialog is visible on the screen. If you use not dpDefault value for Position property then some situations may occur when only part of the dialog is visible(try to preview dialog in the Delphi IDE if Position is dpMainFormCenter and FitToScreen is false).


BottomFormName, TopFormName, LeftFormName, RightFormName : string; RW;

Published

These properties are for use in design-time.

These 4 froperties define additional parts of your dialog. To set this property during design-time open that form which will be inserted into your dialog in Delphi IDE (open Form Designer for that form!). Then set XXXFormName property using drop down list. Do not use one form name as value for 2 or more XXXFormName properties.

During run-time use BottomForm, TopForm, LeftForm and RightForm to specify dialog parts.


BottomForm, TopForm, LeftForm, RightForm : TForm; RW

Public

These 4 froperties define additional parts of your dialog during run-time. To set this property during design-time use XXXFormName properties. Do not use one form name as value for 2 or more XXXFormName properties.

During design-time use BottomFormName, TopFormName, LeftFormName and RightFormName properties instead.


CustomFormName : string; RW

Published

Now is used only for TApOpen/SaveDialog and TApFolderDialog components as the replacement for std shell selection list view and tree view. You should set SelectionType property of these components to stCustom to display your own Delphi form as selection control. Later will be used in some other components. Specify this property only in design-time. During run-time use CustomForm property


CustomForm : TForm; RW

Public

See CustomFormName property.