TApColorDialog

Inherited from : TColorDialog

Unit: ApColorDlg

Custom version: TApCustomColorDialog.

More powerful replacement for TColorDialog component shipped with Delphi/C++Builder.

Types

Properties

Methods

Events



Types



Properties


SelectedDevice : string  R

Public, Protected in custom version

Return the printer name you selected in this dialog. Can be access when the dialog is active (in event handlers for example).


CustDlgParams : TApCustDlgParams

Published; protected in custom version

This variable contains all information about panels of the standard dialog. See TApCustDlgPatams type for details.

For color dialog you can use only BottomForm (and BottomFormName) property. Sorry, but other extensions are not supported.

But your bottom form correctly works when you expand your color dialog by pressing "Define Custom Color" button (bottom form expands with color dialog).


DlgItemsCaptions : TApColorDlgCaptions

Published; protected in custom version

You can set items in this property to replace labels for standard controls inside dialog. For example you can replace OK button caption using DlgItemsCaptions.OK property and so on. If there is no value in any subitem then original text is displayed.


Title : string

Published; protected in custom version

The title of the dialog



Methods



Events


All the new properties below are "dialog-time".

For all handlers: Published; Protected in custom version.


OnFullOpening : TApCtrlQueryEvent;

Occurs when user tries to fully open color dialog pressing "Define Custom color >>" button. You can set AllowProceed to false to prevent this dialog box's expanding.


OnFullOpen : TNotifyEvent;

Occurs when user has fully opened color dialog box.


OnCustomColorAdding : TApColorQueryEvent;

TApColorQueryEvent = procedure(Sender : Tobject; var AColor : TColor; var AllowedColor : boolean) of object;

Occurs when user tries to add new color to custom palette. AColor parameter contains this color. Note that this is var parameter. So you can change it. If you do not set AllowedColor to false then this color is added to custom color palette.


OnCustomColorAdd : TNotifyEvent;

Occurs after user has added new custom color to palette.


OnEventHook : TWndMethod

General hook procedure. You can hook any message you want directry in this handler. This handler occurs after dialog procedure has processed current message.


OnEventHooking : TApMsgQueryEvent

You can determine here whether dialog box procedure should process current message (m parameter).  Set AllowDispatch to false to prevent this message's processing by dialog box procedure.