Copyright: Opaque Software 1995


yesOXDOCKBR.O__001yesoxDockBar for Delphi Help 3yesyesyesoxdockbryesyes30/04/95


Table of Contents

OXControls

oxDockBr Unit

ToxDockBar Component

ToxDockBar_props

ToxDockBar_events

ToxDockBar_methods

Using the ToxDockBar Component

Dock Property

FloatHeight Property

FloatLeft Property

FloatTop Property

FloatWidth Property

Options Property

Style Property

TitleFont Property

TDockAlign Type

TDockBarStyle Type

TOptions Type

Registration

Order Form


OXControls
ObjectEXtensionControls

Opaque Software ©	oxDockBar ver. 1.0 for Delphi

ToxDockBar	ToolBar Control

Order Form


oxDockBr Unit

The oxDockBr unit contains the declarations for ToxDockBar and for the enumerated type associated with them.When you add a component declared in this unit to a form, the unit is automatically added to the uses clause of that form's unit.The following items are declared in the oxDockBr unit:

Components

ToxDockBar

Types

TDockAlign

TDockBarStyle

TOptions


  ToxDockBar Component

Properties	Methods	Events	Tasks

Unit

oxDockBr

Description

ToxDockBar is a Delphi specific toolbar type component. oxDockBar allows the application developer to add any control to a sizable toolbar. Users can move oxDockBar by dragging the mouse to a new position. oxDockBar will snap to the edges of the parent window. Users can also resize the toolbar and the contained controls will realign themselves automatically. oxDockBar will also remember its last location automatically. oxDockBar supports alternate TitleBar sizes and fonts and Windows 95 styles.


ToxDockBar_props
Properties

Runtime only	Key Properties

Align	FloatHeight	ParentCtl3D
BoundsRect	FloatLeft	ParentFont
Caption	FloatTop	ParentShowHint
Color	FloatWidth	PopupMenu
ComponentCount	Font	ShowHint
ComponentIndex	Height	Showing
Components	HelpContext	Style
ControlCount	Hint	TabOrder
Controls	Left	TabStop
Ctl3D	Locked	Tag
Cursor	Name	TitleFont
Dock	Options	Top
DragCursor	Owner	Visible
DragMode	Parent	Width
Enabled	ParentColor


ToxDockBar_methods
 Methods

 Key Methods

BeginDrag	GetTextBuf	ScreenToClient
BringToFront	GetTextLen	ScrollBy
CanFocus	Hide	SendToBack
ClientDrag	InsertComponent	SetBounds
ClientToScreen	InsertControl	SetFocus
ContainsControl	Invalidate	SetTextBuf
Dragging	Refresh	Show
EndDrag	RemoveComponent	Update
FindComponent	Repaint
Focused	ScaleBy


ToxDockBar_events
 Events

 Key Events

OnClick	OnEndDrag	OnMouseMove
OnDblClick	OnEnter	OnMouseUp
OnDragDrop	OnExit	OnResize
OnDragOver	OnMouseDown


  Using the ToxDockBar Component

ToxDockBar Reference

Purpose

The oxDockBar provides the programmer with an easy to use adjustable toolbar, which the user can move and configure at runtime.

Note:	When you place components within container components, you create a new parent-child relationship between the container and the components it contains. The form remains the owner of all components, regardless of whether they are parented within another component.

Tips

When enabling opAutoSize of the Options property best results are obtained if all child control's Align property is set to alNone.

Controls should be placed in a single row for best results during resizing. If multiple rows of controls are desired or you wish to use the Align property for child controls best results are obtained by not setting opSizeable ot the Options property.

Each toolbar should have at least one child control.


Dock Property

Applies to

ToxDockBar components

Declaration

property Dock: TDockAlign;

Description

The Dock property is similar to the Align property. It designates how and where the component will be placed. These are the possible values for the Dock property for ToxDockBar controls.

Value	Meaning

dkFloat	The component can be moved any place on screen. (This value can not be set at design time).

dkTop	The component will be aligned at the top of the parent window.

dkBottom	The component will be aligned at the bottom of the parent window.

dkLeft	The component will be aligned at the left side of the parent window. (This value can not be set at design time).

dkRight	The component will be aligned at the right side of the parent window. (This value can not be set at design time).


FloatHeight Property

Applies to

ToxDockBar components

Declaration

property FloatHeight: Integer;

Description

Sets or returns the height in pixels of the ToxDockBar while Dock property is := dkFloat.

This property can be set at design time, but will not take effect until runtime.


FloatLeft Property

Applies to

ToxDockBar components

Declaration

property FloatLeft: Integer;

Description

Sets or returns the distance of the left edge in pixels from the left side of the screen of the ToxDockBar while Dock property is := dkFloat.

This property can be set at design time, but will not take effect until runtime.


FloatTop Property

Applies to

ToxDockBar components

Declaration

property FloatTop: Integer;

Description

Sets or returns the distance of the top edge in pixels from the top of the screen of the ToxDockBar while Dock property is := dkFloat.

This property can be set at design time, but will not take effect until runtime.


FloatWidth Property

Applies to

ToxDockBar components

Declaration

property FloatWidth: Integer;

Description

Sets or returns the width in pixels of the ToxDockBar while Dock property is := dkFloat.

This property can be set at design time, but will not take effect until runtime.


Options Property

Applies to

ToxDockBar components

Declaration

property Options: TOptions;

Description

These are the possible values for the Options property for ToxDockBar controls.

Value	Meaning

opAllowFloat	When true, the component can be allowed to float any place on the screen.

opAllowSideDock	When true, the component can be docked to the side of it's parent window.

opAutoHide	When true, the component will be hidden automatically when the application is not active.

opAutoSave	When true, the component's size and postion will be saved and restored when the application starts and ends.

opAutoSize	When true, the component will set its own size and move child controls for the best fit.

opCaption	When true and floating, the component will have a titlebar or caption.

opCloseBox	When true and floating, the component will have a closebox. The user can click the close box to hide the component.

opLock	When true, the application user can not drag the component to a new location.

opSizeable	When true, the user can size the component.


Style Property

Applies to

ToxDockBar components

Declaration

property Style: TDockBarStyle;

Description

These are the possible values for the Style property for ToxDockBar controls.

Value	Meaning

bsAuto	The button takes on the appearance of either Windows 3.1 borders or Windows 95 borders, depending on which the application is running under.

bsWin31	Uses the Windows 3.1 look.

bsWin95	Uses the Windows 95 look.


TitleFont Property

Applies to

ToxDockBar components

Declaration

property TitleFont: TFont;

Description

The TitleFont property is a font object that controls the attributes of the text of the titlebar when ToxDockBar is floating. See also Font property.


TDockAlign Type

Unit

oxDockBr

Declaration

TDockAlign = (dkFloat, dkTop, dkBottom, dkLeft, dkRight);

Description

TDockAlign is the set of values the Dock property can have.


TDockBarStyle Type

Unit

oxDockBr

Declaration

TDockBarStyle = (bsAuto, bsWin31, bsWin95);

Description

TDockBarStyle is the set of values the Style poperty can have.


TOptions Type

Unit

oxDockBr

Declaration

TOption = (opAllowFloat, opAllowSideDock, opAutoHide, opAutoSave, opAutoSize, opCaption, opCloseBox, opLock, opSizeable);

TOptions = set of TOption;

Description

TOptions is the set of values the Option property can have.


Registration

OxDockBar  © is written by Brett Liddicoet

Copyright © 1991-1995

Opaque Software ©

P.O. Box 2483.

Napa, CA 94558

CIS  GO OPAQUE

(707) 253-9466

oxDockBar for DELPHI ver 1.0 has been written using Borland Delphi. I welcome all comments, suggestions and problems with OxDockBar. Feel free to contact me via US mail or CompuServe E-MAIL. Registered users will be given priority. Thanks for using oxDockBar.

 REGISTRATION COSTS

19 Dollars U.S.

 SOFTWARE LICENSE

 OxDockBar is not and has never been public domain software, nor is it free software.

 Non-licensed users are granted a limited license to use OxDockBar on a 30-day trial basis for the purpose of determining whether OxDockBar is suitable for their needs.  The use of OxDockBar, except for the initial 30-day trial, requires registration.  The use of unlicensed copies of OxDockBar by any person, business, corporation, government agency or any other entity is strictly prohibited.

 A single user license permits a user to use OxDockBar only on a single computer.  Licensed users may use the program on different computers, but may not use the program on more than one computer at the same time. Licensed users may also distribute applications compiled with oxDockBar.

 No one may modify or patch the OxDockBar executable files in any way,  including but not limited to decompiling, disassembling, or otherwise reverse engineering the program.

 A limited license is granted to copy and distribute OxDockBar only for the trial use of others, subject to the above limitations, and also the following:

  1)    OxDockBar must be copied in unmodified form, complete with the file containing this license information and only the following OxDockBar files: OXDOCKBR.DCU, OXDOCKBR.DCR, OXDOCKBR.HLP, ORDER.WRI and README.TXT. You may NOT distribute the OxDockBar registration ID, control numbers, OXDOCKBR.LIC or that portion of the WIN.INI file created by OxDockBar.

  2)    The full machine-readable OxDockBar documentation must be included with each copy.

  3)    No fee, charge, or other compensation may be requested or accepted, except as

authorized below:

        A) Operators of electronic bulletin board systems (sysops) may make OxDockBar available for downloading only as long as the above conditions are met.  An overall or time-dependent charge for the use of the bulletin board system is permitted as long as there is not a specific charge for the download of OxDockBar.

        B) Vendors of user-supported or shareware software may distribute OxDockBar, subject to the above conditions, without specific permission. Vendors may charge a disk duplication and handling fee, which, when pro-rated to the OxDockBar product, may not exceed five dollars.

        C) Non-profit user groups may distribute OxDockBar, subject to the above conditions, without specific permission. Non-profit user groups may charge a disk duplication fee, which, when pro-rated to the OxDockBar product, may not exceed five dollars.

  LIMITED WARRANTY

EXCEPT AS PROVIDED ABOVE, OPAQUE SOFTWARE DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT.  SHOULD THE PROGRAM PROVE DEFECTIVE, THE   PURCHASER ASSUMES THE RISK OF PAYING THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES.  IN NO EVENT WILL OPAQUE SOFTWARE BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE INABILITY TO USE THIS PRODUCT EVEN IF OPAQUE SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

  Use of this product for any period of time constitutes your acceptance of this agreement and subjects you to its contents.

  U.S. GOVERNMENT RESTRICTED RIGHTS

  Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013.  Contractor/manufacturer is Opaque Software.


Order Form
	Print
  Opaque Software Order Form

Please return this form and your remittance to:

Opaque Software

Brett Liddicoet

PO Box 2483

Napa, CA 94558

Fax(707) 253-9466

Ship to:

Name: 	________________________________

Company:	________________________________

Address:	________________________________

________________________________

Phone (Day)	________________________________

Phone (Night)	________________________________

Phone (Fax)	________________________________

CIS# or AOL	________________________________

Please send me:

Visual Basic

_____ Copies of OXButton (VBX) @ $19	$ ___________

_____ Copies of OXDisplay (VBX) @ $15	$ ___________

_____ Copies of 3d-VB Input (VBX) @ $15	$ ___________

DELPHI

_____ Copies of OXButton for Delphi @ $19	$ ___________

_____ Copies of OXDockBar for Delphi @ $19	$ ___________

Misc

_____ Copies of Multi-Media WinJack @ $19	$ ___________

Overseas shipping add @ $5 each	$ ___________

Canada and Mexico shipping add @ $2 each	$ ___________

Total	$ ___________

Payment may be by check or money order.

(US Funds drawn on US Bank)

Payment may also be made via CompuServe, GO SWREG.