home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 2000 October / tst.iso / programs / borland / RUNIMAGE / DELPHI40 / DOC / EXTCTRLS.INT < prev    next >
Encoding:
Text File  |  1998-06-17  |  17.9 KB  |  587 lines
  1.  
  2. {*******************************************************}
  3. {                                                       }
  4. {       Borland Delphi Visual Component Library         }
  5. {                                                       }
  6. {       Copyright (c) 1995,98 Inprise Corporation       }
  7. {                                                       }
  8. {*******************************************************}
  9.  
  10. unit ExtCtrls;
  11.  
  12. {$S-,W-,R-}
  13. {$C PRELOAD}
  14.  
  15. interface
  16.  
  17. uses Messages, Windows, SysUtils, Classes, Controls, Forms, Menus, Graphics,
  18.   StdCtrls;
  19.  
  20. type
  21.  
  22.   TShapeType = (stRectangle, stSquare, stRoundRect, stRoundSquare,
  23.     stEllipse, stCircle);
  24.  
  25.   TShape = class(TGraphicControl)
  26.   protected
  27.     procedure Paint; override;
  28.   public
  29.     constructor Create(AOwner: TComponent); override;
  30.     destructor Destroy; override;
  31.   published
  32.     procedure StyleChanged(Sender: TObject);
  33.     property Align;
  34.     property Anchors;
  35.     property Brush: TBrush;
  36.     property DragCursor;
  37.     property DragKind;
  38.     property DragMode;
  39.     property Enabled;
  40.     property Constraints;
  41.     property ParentShowHint;
  42.     property Pen: TPen;
  43.     property Shape: TShapeType default stRectangle;
  44.     property ShowHint;
  45.     property Visible;
  46.     property OnDragDrop;
  47.     property OnDragOver;
  48.     property OnEndDock;
  49.     property OnEndDrag;
  50.     property OnMouseDown;
  51.     property OnMouseMove;
  52.     property OnMouseUp;
  53.     property OnStartDock;
  54.     property OnStartDrag;
  55.   end;
  56.  
  57.   TPaintBox = class(TGraphicControl)
  58.   protected
  59.     procedure Paint; override;
  60.   public
  61.     constructor Create(AOwner: TComponent); override;
  62.     property Canvas;
  63.   published
  64.     property Align;
  65.     property Anchors;
  66.     property Color;
  67.     property Constraints;
  68.     property DragCursor;
  69.     property DragKind;
  70.     property DragMode;
  71.     property Enabled;
  72.     property Font;
  73.     property ParentColor;
  74.     property ParentFont;
  75.     property ParentShowHint;
  76.     property PopupMenu;
  77.     property ShowHint;
  78.     property Visible;
  79.     property OnClick;
  80.     property OnDblClick;
  81.     property OnDragDrop;
  82.     property OnDragOver;
  83.     property OnEndDock;
  84.     property OnEndDrag;
  85.     property OnMouseDown;
  86.     property OnMouseMove;
  87.     property OnMouseUp;
  88.     property OnPaint: TNotifyEvent;
  89.     property OnStartDock;
  90.     property OnStartDrag;
  91.   end;
  92.  
  93.   TImage = class(TGraphicControl)
  94.   protected
  95.     function CanAutoSize(var NewWidth, NewHeight: Integer): Boolean; override;
  96.     function DestRect: TRect;
  97.     function DoPaletteChange: Boolean;
  98.     function GetPalette: HPALETTE; override;
  99.     procedure Paint; override;
  100.     procedure Progress(Sender: TObject; Stage: TProgressStage;
  101.       PercentDone: Byte; RedrawNow: Boolean; const R: TRect; const Msg: string); dynamic;
  102.   public
  103.     constructor Create(AOwner: TComponent); override;
  104.     destructor Destroy; override;
  105.     property Canvas: TCanvas;
  106.   published
  107.     property Align;
  108.     property Anchors;
  109.     property AutoSize;
  110.     property Center: Boolean default False;
  111.     property Constraints;
  112.     property DragCursor;
  113.     property DragKind;
  114.     property DragMode;
  115.     property Enabled;
  116.     property IncrementalDisplay: Boolean default False;
  117.     property ParentShowHint;
  118.     property Picture: TPicture;
  119.     property PopupMenu;
  120.     property ShowHint;
  121.     property Stretch: Boolean default False;
  122.     property Transparent: Boolean default False;
  123.     property Visible;
  124.     property OnClick;
  125.     property OnDblClick;
  126.     property OnDragDrop;
  127.     property OnDragOver;
  128.     property OnEndDock;
  129.     property OnEndDrag;
  130.     property OnMouseDown;
  131.     property OnMouseMove;
  132.     property OnMouseUp;
  133.     property OnProgress: TProgressEvent;
  134.     property OnStartDock;
  135.     property OnStartDrag;
  136.   end;
  137.  
  138.   TBevelStyle = (bsLowered, bsRaised);
  139.   TBevelShape = (bsBox, bsFrame, bsTopLine, bsBottomLine, bsLeftLine,
  140.     bsRightLine, bsSpacer);
  141.  
  142.   TBevel = class(TGraphicControl)
  143.   protected
  144.     procedure Paint; override;
  145.   public
  146.     constructor Create(AOwner: TComponent); override;
  147.   published
  148.     property Align;
  149.     property Anchors;
  150.     property Constraints;
  151.     property ParentShowHint;
  152.     property Shape: TBevelShape default bsBox;
  153.     property ShowHint;
  154.     property Style: TBevelStyle default bsLowered;
  155.     property Visible;
  156.   end;
  157.  
  158.   TTimer = class(TComponent)
  159.   protected
  160.     procedure Timer; dynamic;
  161.   public
  162.     constructor Create(AOwner: TComponent); override;
  163.     destructor Destroy; override;
  164.   published
  165.     property Enabled: Boolean default True;
  166.     property Interval: Cardinal default 1000;
  167.     property OnTimer: TNotifyEvent;
  168.   end;
  169.  
  170.   TPanelBevel = TBevelCut;
  171.  
  172.   TCustomPanel = class(TCustomControl)
  173.   protected
  174.     procedure CreateParams(var Params: TCreateParams); override;
  175.     procedure AdjustClientRect(var Rect: TRect); override;
  176.     function CanAutoSize(var NewWidth, NewHeight: Integer): Boolean; override;
  177.     procedure Paint; override;
  178.     property Alignment: TAlignment default taCenter;
  179.     property BevelInner: TPanelBevel default bvNone;
  180.     property BevelOuter: TPanelBevel default bvRaised;
  181.     property BevelWidth: TBevelWidth default 1;
  182.     property BorderWidth: TBorderWidth default 0;
  183.     property BorderStyle: TBorderStyle default bsNone;
  184.     property Color default clBtnFace;
  185.     property FullRepaint: Boolean default True;
  186.     property Locked: Boolean default False;
  187.     property ParentColor default False;
  188.   public
  189.     constructor Create(AOwner: TComponent); override;
  190.     function GetControlsAlignment: TAlignment; override;
  191.   end;
  192.  
  193.   TPanel = class(TCustomPanel)
  194.   public
  195.     property DockManager;
  196.   published
  197.     property Align;
  198.     property Alignment;
  199.     property Anchors;
  200.     property AutoSize;
  201.     property BevelInner;
  202.     property BevelOuter;
  203.     property BevelWidth;
  204.     property BiDiMode;
  205.     property BorderWidth;
  206.     property BorderStyle;
  207.     property Caption;
  208.     property Color;
  209.     property Constraints;
  210.     property Ctl3D;
  211.     property UseDockManager default True;
  212.     property DockSite;
  213.     property DragCursor;
  214.     property DragKind;
  215.     property DragMode;
  216.     property Enabled;
  217.     property FullRepaint;
  218.     property Font;
  219.     property Locked;
  220.     property ParentBiDiMode;
  221.     property ParentColor;
  222.     property ParentCtl3D;
  223.     property ParentFont;
  224.     property ParentShowHint;
  225.     property PopupMenu;
  226.     property ShowHint;
  227.     property TabOrder;
  228.     property TabStop;
  229.     property Visible;
  230.     property OnCanResize;
  231.     property OnClick;
  232.     property OnConstrainedResize;
  233.     property OnDockDrop;
  234.     property OnDockOver;
  235.     property OnDblClick;
  236.     property OnDragDrop;
  237.     property OnDragOver;
  238.     property OnEndDock;
  239.     property OnEndDrag;
  240.     property OnEnter;
  241.     property OnExit;
  242.     property OnGetSiteInfo;
  243.     property OnMouseDown;
  244.     property OnMouseMove;
  245.     property OnMouseUp;
  246.     property OnResize;
  247.     property OnStartDock;
  248.     property OnStartDrag;
  249.     property OnUnDock;
  250.   end;
  251.  
  252.   TPage = class(TCustomControl)
  253.   protected
  254.     procedure ReadState(Reader: TReader); override;
  255.     procedure Paint; override;
  256.   public
  257.     constructor Create(AOwner: TComponent); override;
  258.   published
  259.     property Caption;
  260.     property Height stored False;
  261.     property TabOrder stored False;
  262.     property Visible stored False;
  263.     property Width stored False;
  264.   end;
  265.  
  266.   TNotebook = class(TCustomControl)
  267.   protected
  268.     procedure CreateParams(var Params: TCreateParams); override;
  269.     function GetChildOwner: TComponent; override;
  270.     procedure GetChildren(Proc: TGetChildProc; Root: TComponent); override;
  271.     procedure ReadState(Reader: TReader); override;
  272.     procedure ShowControl(AControl: TControl); override;
  273.   public
  274.     constructor Create(AOwner: TComponent); override;
  275.     destructor Destroy; override;
  276.   published
  277.     property ActivePage: string;
  278.     property Align;
  279.     property Anchors;
  280.     property Color;
  281.     property Ctl3D;
  282.     property DragCursor;
  283.     property DragKind;
  284.     property DragMode;
  285.     property Font;
  286.     property Enabled;
  287.     property Constraints;
  288.     property PageIndex: Integer default 0;
  289.     property Pages: TStrings;
  290.     property ParentColor;
  291.     property ParentCtl3D;
  292.     property ParentFont;
  293.     property ParentShowHint;
  294.     property PopupMenu;
  295.     property ShowHint;
  296.     property TabOrder;
  297.     property TabStop;
  298.     property Visible;
  299.     property OnClick;
  300.     property OnDblClick;
  301.     property OnDragDrop;
  302.     property OnDragOver;
  303.     property OnEndDock;
  304.     property OnEndDrag;
  305.     property OnEnter;
  306.     property OnExit;
  307.     property OnMouseDown;
  308.     property OnMouseMove;
  309.     property OnMouseUp;
  310.     property OnPageChanged: TNotifyEvent;
  311.     property OnStartDock;
  312.     property OnStartDrag;
  313.   end;
  314.  
  315. { THeader
  316.   Purpose  - Creates sectioned visual header that allows each section to be
  317.              resized with the mouse.
  318.   Features - This is a design-interactive control.  In design mode, the
  319.              sections are named using the string-list editor.  Each section
  320.              can now be manually resized using the right mouse button the grab
  321.              the divider and drag to the new size.  Changing the section list
  322.              at design (or even run-time), will attempt to maintain the
  323.              section widths for sections that have not been changed.
  324.   Properties:
  325.     Align - Standard property.
  326.     AllowResize - If True, the control allows run-time mouse resizing of the
  327.                   sections.
  328.     BorderStyle - Turns the border on and off.
  329.     Font - Standard property.
  330.     Sections - A special string-list that contains the section text.
  331.     ParentFont - Standard property.
  332.     OnSizing - Event called for each mouse move during a section resize
  333.                operation.
  334.     OnSized - Event called once the size operation is complete.
  335.  
  336.     SectionWidth - Array property allowing run-time getting and setting of
  337.                    each section's width. }
  338.  
  339.   TSectionEvent = procedure(Sender: TObject;
  340.     ASection, AWidth: Integer) of object;
  341.  
  342.   THeader = class(TCustomControl)
  343.   protected
  344.     procedure Paint; override;
  345.     procedure CreateParams(var Params: TCreateParams); override;
  346.     procedure Sizing(ASection, AWidth: Integer); dynamic;
  347.     procedure Sized(ASection, AWidth: Integer); dynamic;
  348.   public
  349.     constructor Create(AOwner: TComponent); override;
  350.     destructor Destroy; override;
  351.     property SectionWidth[X: Integer]: Integer;
  352.   published
  353.     property Align;
  354.     property AllowResize: Boolean default True;
  355.     property Anchors;
  356.     property BorderStyle: TBorderStyle default bsSingle;
  357.     property Constraints;
  358.     property Enabled;
  359.     property Font;
  360.     property ParentFont;
  361.     property ParentShowHint;
  362.     property PopupMenu;
  363.     property Sections: TStrings;
  364.     property ShowHint;
  365.     property TabOrder;
  366.     property TabStop;
  367.     property Visible;
  368.     property OnSizing: TSectionEvent;
  369.     property OnSized: TSectionEvent;
  370.   end;
  371.  
  372.   TCustomRadioGroup = class(TCustomGroupBox)
  373.   protected
  374.     procedure ReadState(Reader: TReader); override;
  375.     function CanModify: Boolean; virtual;
  376.     procedure GetChildren(Proc: TGetChildProc; Root: TComponent); override;
  377.     property Columns: Integer default 1;
  378.     property ItemIndex: Integer default -1;
  379.     property Items: TStrings;
  380.   public
  381.     constructor Create(AOwner: TComponent); override;
  382.     destructor Destroy; override;
  383.     procedure FlipChildren(AllLevels: Boolean); override;
  384.   end;
  385.  
  386.   TRadioGroup = class(TCustomRadioGroup)
  387.   published
  388.     property Align;
  389.     property Anchors;
  390.     property BiDiMode;
  391.     property Caption;
  392.     property Color;
  393.     property Columns;
  394.     property Ctl3D;
  395.     property DragCursor;
  396.     property DragKind;
  397.     property DragMode;
  398.     property Enabled;
  399.     property Font;
  400.     property ItemIndex;
  401.     property Items;
  402.     property Constraints;
  403.     property ParentBiDiMode;
  404.     property ParentColor;
  405.     property ParentCtl3D;
  406.     property ParentFont;
  407.     property ParentShowHint;
  408.     property PopupMenu;
  409.     property ShowHint;
  410.     property TabOrder;
  411.     property TabStop;
  412.     property Visible;
  413.     property OnClick;
  414.     property OnDragDrop;
  415.     property OnDragOver;
  416.     property OnEndDock;
  417.     property OnEndDrag;
  418.     property OnEnter;
  419.     property OnExit;
  420.     property OnStartDock;
  421.     property OnStartDrag;
  422.   end;
  423.  
  424.   NaturalNumber = 1..High(Integer);
  425.  
  426.   TCanResizeEvent = procedure(Sender: TObject; var NewSize: Integer;
  427.     var Accept: Boolean) of object;
  428.  
  429.   TResizeStyle = (rsNone, rsLine, rsUpdate, rsPattern);
  430.  
  431.   TSplitter = class(TGraphicControl)
  432.   protected
  433.     function CanResize(var NewSize: Integer): Boolean; reintroduce; virtual;
  434.     function DoCanResize(var NewSize: Integer): Boolean; virtual;
  435.     procedure MouseDown(Button: TMouseButton; Shift: TShiftState;
  436.       X, Y: Integer); override;
  437.     procedure MouseMove(Shift: TShiftState; X, Y: Integer); override;
  438.     procedure MouseUp(Button: TMouseButton; Shift: TShiftState;
  439.       X, Y: Integer); override;
  440.     procedure Paint; override;
  441.     procedure RequestAlign; override;
  442.     procedure StopSizing; dynamic;
  443.   public
  444.     constructor Create(AOwner: TComponent); override;
  445.     destructor Destroy; override;
  446.   published
  447.     property Align default alLeft;
  448.     property Beveled: Boolean default False;
  449.     property Color;
  450.     property Constraints;
  451.     property MinSize: NaturalNumber default 30;
  452.     property ParentColor;
  453.     property ResizeStyle: TResizeStyle default rsPattern;
  454.     property Visible;
  455.     property OnCanResize: TCanResizeEvent;
  456.     property OnMoved: TNotifyEvent;
  457.     property OnPaint: TNotifyEvent;
  458.   end;
  459.  
  460. { TControlBar }
  461.  
  462.   TBandPaintOption = (bpoGrabber, bpoFrame);
  463.   TBandPaintOptions = set of TBandPaintOption;
  464.  
  465.   TBandDragEvent = procedure (Sender: TObject; Control: TControl;
  466.     var Drag: Boolean) of object;
  467.   TBandInfoEvent = procedure (Sender: TObject; Control: TControl;
  468.     var Insets: TRect; var PreferredSize, RowCount: Integer) of object;
  469.   TBandMoveEvent = procedure (Sender: TObject; Control: TControl;
  470.     var ARect: TRect) of object;
  471.   TBandPaintEvent = procedure (Sender: TObject; Control: TControl;
  472.     Canvas: TCanvas; var ARect: TRect; var Options: TBandPaintOptions) of object;
  473.  
  474.   TRowSize = 1..MaxInt;
  475.  
  476.   TCustomControlBar = class(TCustomControl)
  477.   protected
  478.     procedure AlignControls(AControl: TControl; var ARect: TRect); override;
  479.     function CanAutoSize(var NewWidth, NewHeight: Integer): Boolean; override;
  480.     procedure CreateParams(var Params: TCreateParams); override;
  481.     procedure DoBandMove(Control: TControl; var ARect: TRect); virtual;
  482.     procedure DoBandPaint(Control: TControl; Canvas: TCanvas; var ARect: TRect;
  483.       var Options: TBandPaintOptions); virtual;
  484.     procedure DockOver(Source: TDragDockObject; X, Y: Integer; State: TDragState;
  485.       var Accept: Boolean); override;
  486.     function DoPaletteChange: Boolean;
  487.     function DragControl(AControl: TControl; X, Y: Integer;
  488.       KeepCapture: Boolean = False): Boolean; virtual;
  489.     procedure GetControlInfo(AControl: TControl; var Insets: TRect;
  490.       var PreferredSize, RowCount: Integer); virtual;
  491.     function GetPalette: HPALETTE; override;
  492.     procedure GetSiteInfo(Client: TControl; var InfluenceRect: TRect;
  493.       MousePos: TPoint; var CanDock: Boolean); override;
  494.     function HitTest(X, Y: Integer): TControl;
  495.     procedure MouseDown(Button: TMouseButton; Shift: TShiftState;
  496.       X, Y: Integer); override;
  497.     procedure MouseMove(Shift: TShiftState; X, Y: Integer); override;
  498.     procedure MouseUp(Button: TMouseButton; Shift: TShiftState;
  499.       X, Y: Integer); override;
  500.     procedure Paint; override;
  501.     procedure PaintControlFrame(Canvas: TCanvas; AControl: TControl;
  502.       var ARect: TRect); virtual;
  503.   public
  504.     constructor Create(AOwner: TComponent); override;
  505.     destructor Destroy; override;
  506.     procedure FlipChildren(AllLevels: Boolean); override;
  507.     procedure StickControls; virtual;
  508.     property Picture: TPicture;
  509.   protected
  510.     property AutoDrag: Boolean default True;
  511.     property AutoSize;
  512.     property BevelKind default bkTile;
  513.     property DockSite default True;
  514.     property RowSize: TRowSize default 26;
  515.     property RowSnap: Boolean default True;
  516.     property OnBandDrag: TBandDragEvent;
  517.     property OnBandInfo: TBandInfoEvent;
  518.     property OnBandMove: TBandMoveEvent;
  519.     property OnBandPaint: TBandPaintEvent;
  520.     property OnPaint: TNotifyEvent;
  521.   end;
  522.  
  523.   TControlBar = class(TCustomControlBar)
  524.   public
  525.     property Canvas;
  526.   published
  527.     property Align;
  528.     property Anchors;
  529.     property AutoDrag;
  530.     property AutoSize;
  531.     property BevelEdges;
  532.     property BevelInner;
  533.     property BevelOuter;
  534.     property BevelKind;
  535.     property BevelWidth;
  536.     property BorderWidth;
  537.     property Color;
  538.     property Constraints;
  539.     property DockSite;
  540.     property DragCursor;
  541.     property DragKind;
  542.     property DragMode;
  543.     property Enabled;
  544.     property ParentColor;
  545.     property ParentCtl3D;
  546.     property ParentFont;
  547.     property ParentShowHint;
  548.     property Picture;
  549.     property PopupMenu;
  550.     property RowSize;
  551.     property RowSnap;
  552.     property ShowHint;
  553.     property TabOrder;
  554.     property TabStop;
  555.     property Visible;
  556.     property OnBandDrag;
  557.     property OnBandInfo;
  558.     property OnBandMove;
  559.     property OnBandPaint;
  560.     property OnCanResize;
  561.     property OnClick;
  562.     property OnConstrainedResize;
  563.     property OnDockDrop;
  564.     property OnDockOver;
  565.     property OnDblClick;
  566.     property OnDragDrop;
  567.     property OnDragOver;
  568.     property OnEndDock;
  569.     property OnEndDrag;
  570.     property OnEnter;
  571.     property OnExit;
  572.     property OnGetSiteInfo;
  573.     property OnMouseDown;
  574.     property OnMouseMove;
  575.     property OnMouseUp;
  576.     property OnPaint;
  577.     property OnResize;
  578.     property OnStartDock;
  579.     property OnStartDrag;
  580.     property OnUnDock;
  581.   end;
  582.  
  583. procedure Frame3D(Canvas: TCanvas; var Rect: TRect;
  584.   TopColor, BottomColor: TColor; Width: Integer);
  585.  
  586. implementation
  587.