{
* UCtrlArranger.pas
*
* Implements a static class that provides methods to assist in aligning a the
* controls on a form or frame etc.
*
* $Rev$
* $Date$
*
* ***** BEGIN LICENSE BLOCK *****
*
* Version: MPL 1.1
*
* The contents of this file are subject to the Mozilla Public License Version
* 1.1 (the "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
* the specific language governing rights and limitations under the License.
*
* The Original Code is UCtrlArranger.pas
*
* The Initial Developer of the Original Code is Peter Johnson
* (http://www.delphidabbler.com/).
*
* Portions created by the Initial Developer are Copyright (C) 2009 Peter
* Johnson. All Rights Reserved.
*
* Contributors:
* NONE
*
* ***** END LICENSE BLOCK *****
}
unit UCtrlArranger;
interface
uses
// Delphi
Controls, StdCtrls,
// Projects
UBaseObjects;
type
{
TCtrlArranger:
Static class used to arrange and size controls in forms and frames etc.
}
TCtrlArranger = class(TNoConstructObject)
public
class function SetLabelHeight(const Lbl: TLabel): Integer;
{Sets height of a label to accommodate the text it contains in its font.
@param Lbl [in] Label whose height is to be set.
@return New label height.
}
class procedure SetLabelHeights(const Container: TControl;
const IgnoreAutoSize: Boolean = False);
{Sets heights of labels owned by a container control such as a form to
accommodate the text they contain in the appropriate font.
@param Container [in] Control that owns the labels.
@param IgnoreAutoSize [in] Flagthat determines if labels with AutoSize
property set to true are sized. When False only labels with AutoSize
true are sized, otherwise all labels are sized.
}
class function BottomOf(const Ctrl: TControl;
const BM: Integer = 0): Integer; overload;
{Gets Y coordinate of bottom of a control, leaving space for an optional
margin unser the control, relative to its parent controls in pixels.
@param Ctl [in] Control to check.
@param BM [in] Bottom margin to leave under control. Optional.
@return Required position.
}
class function BottomOf(const Ctrls: array of TControl;
const BM: Integer = 0): Integer; overload;
{Gets Y co-ordinate of bottom of the lowermost of a set of controls,
leaving space for an optional under the controls.
@param Ctrls [in] Controls to be examined.
@param BM [in] Bottom margin to leave under all controls. Optional.
@return Required position. This is maximum value of bottom of all
controls.
}
class function AlignVCentres(const ATop: Integer;
const Ctrls: array of TControl): Integer;
{Vertically centres a list of controls.
@param ATop [in] Top of tallest control to be aligned.
@param Ctrls [in] Array of controls to be aligned.
@return Height occupied by controls (= height of tallest control).
}
class function MaxContainerHeight(
const Containers: array of TWinControl): Integer;
{Checks the maximum height of controls parented by a set of controls. Can
be used to determine the height of a control that has to be able to
display all the controls from any of the containers.
@param Containers [in] Controls that parent the controls being measured.
@return Required height.
}
class function TotalControlHeight(const Container: TWinControl): Integer;
{Gets the height that a container needs to be to accommodate all its
contained controls.
@param Container [in] Container to be checked.
@return Required height.
}
class function TotalControlWidth(const Container: TWinControl): Integer;
{Gets the width that a container needs to be to accommodate all its
contained controls.
@param Container [in] Container to be checked.
@return Required width.
}
end;
implementation
uses
// Delphi
Math,
// Project
UGraphicUtils;
{ TCtrlArranger }
class function TCtrlArranger.AlignVCentres(const ATop: Integer;
const Ctrls: array of TControl): Integer;
{Vertically centres a list of controls.
@param ATop [in] Top of tallest control to be aligned.
@param Ctrls [in] Array of controls to be aligned.
@return Height occupied by controls (= height of tallest control).
}
var
I: Integer; // loops thru all controls to be aligned
begin
Result := 0;
for I := Low(Ctrls) to High(Ctrls) do
if Ctrls[I].Height > Result then
Result := Ctrls[I].Height;
for I := Low(Ctrls) to High(Ctrls) do
Ctrls[I].Top := ATop + (Result - Ctrls[I].Height) div 2;
end;
class function TCtrlArranger.BottomOf(const Ctrl: TControl;
const BM: Integer): Integer;
{Gets Y coordinate of bottom of a control, leaving space for an optional
margin unser the control, relative to its parent controls in pixels.
@param Ctl [in] Control to check.
@param BM [in] Bottom margin to leave under control. Optional.
@return Required position.
}
begin
Result := Ctrl.Top + Ctrl.Height + BM;
end;
class function TCtrlArranger.BottomOf(const Ctrls: array of TControl;
const BM: Integer): Integer;
{Gets Y co-ordinate of bottom of the lowermost of a set of controls, leaving
space for an optional under the controls.
@param Ctrls [in] Controls to be examined.
@param BM [in] Bottom margin to leave under all controls. Optional.
@return Required position. This is maximum value of bottom of all controls.
}
var
Idx: Integer; // loops thru all controls
begin
Result := 0;
for Idx := Low(Ctrls) to High(Ctrls) do
Result := Max(Result, BottomOf(Ctrls[Idx]));
Inc(Result, BM);
end;
class function TCtrlArranger.MaxContainerHeight(
const Containers: array of TWinControl): Integer;
{Checks the maximum height of controls parented by a set of controls. Can be
used to determine the height of a control that has to be able to display all
the controls from any of the containers.
@param Containers [in] Controls that parent the controls being measured.
@return Required height.
}
var
ContainerIdx: Integer; // loops through all containers
begin
Result := 0;
for ContainerIdx := Low(Containers) to High(Containers) do
Result := Max(Result, TotalControlHeight(Containers[ContainerIdx]));
end;
class function TCtrlArranger.SetLabelHeight(const Lbl: TLabel): Integer;
{Sets height of a label to accommodate the text it contains in its font.
@param Lbl [in] Label whose height is to be set.
@return New label height.
}
begin
Lbl.Height := StringExtent(Lbl.Caption, Lbl.Font, Lbl.Width).cy;
Result := Lbl.Height;
end;
class procedure TCtrlArranger.SetLabelHeights(const Container: TControl;
const IgnoreAutoSize: Boolean);
{Sets heights of labels owned by a container control such as a form to
accommodate the text they contain in the appropriate font.
@param Container [in] Control that owns the labels.
@param IgnoreAutoSize [in] Flagthat determines if labels with AutoSize
property set to true are sized. When False only labels with AutoSize true
are sized, otherwise all labels are sized.
}
var
Idx: Integer; // loops through all components owned by container control
Lbl: TLabel; // references each label component
begin
for Idx := 0 to Pred(Container.ComponentCount) do
begin
if Container.Components[Idx] is TLabel then
begin
Lbl := Container.Components[Idx] as TLabel;
if IgnoreAutoSize or not Lbl.AutoSize then
SetLabelHeight(Lbl);
end;
end;
end;
class function TCtrlArranger.TotalControlHeight(
const Container: TWinControl): Integer;
{Gets the height that a container needs to be to accommodate all its contained
controls.
@param Container [in] Container to be checked.
@return Required height.
}
var
CtrlIdx: Integer; // loops through all controls in Container
Ctrls: array of TControl; // array of controls contained in each container
begin
SetLength(Ctrls, Container.ControlCount);
for CtrlIdx := 0 to Pred(Container.ControlCount) do
Ctrls[CtrlIdx + Low(Ctrls)] := Container.Controls[CtrlIdx];
Result := BottomOf(Ctrls);
end;
class function TCtrlArranger.TotalControlWidth(
const Container: TWinControl): Integer;
{Gets the width that a container needs to be to accommodate all its contained
controls.
@param Container [in] Container to be checked.
@return Required width.
}
var
CtrlIdx: Integer; // loops through all controls in Container
Ctrl: TControl; // references each control in Container
begin
Result := 0;
for CtrlIdx := 0 to Pred(Container.ControlCount) do
begin
Ctrl := Container.Controls[CtrlIdx];
Result := Max(Result, Ctrl.Left + Ctrl.Width);
end;
end;
end.
