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