Skip to content

ddablib/aboutbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About Box Component

Contents

Description

This non-visual component encapsulates an About Box.

The component has string properties to display five different pieces of information in the about box. These properties are:

  • Title – The text that appears in the window title. The default value is 'About'.
  • ProgramName – The name of the program. This is the title of the application. The default value is the same as the TApplication.Title property.
  • Version – The version number of the program. The default value is an empty string.
  • Copyright – A copyright message. The default value is an empty string.
  • Notes – Up to three lines of notes. The default value is an empty string.

Alternatively, the about box can display information from a VERSIONINFO resource included in the program. This is accessed via a linked TPJVersionInfo component. The values of the ProgramName, Version, Copyright and Notes properties are ignored and relevant strings from the program's version information are used in their stead.

The dialogue box's position can be specified relative to the screen, desktop or parent application. There is a single close button whose appearance and position customisable. The About box also displays the program's icon. The font used by the dialogue box can be customised.

Required component

TPJAboutBoxDlg requires that a DelphiDabbler Version Information Component is installed first in order to compile.

Compatibility

TPJAboutBoxDlg is believed to compile on all Win32 versions of Delphi. Earlier versions were tested with all Delphis from v2. Every effort has been made to retain backward compatibility, but this has not been tested for v3.6 and later. The latest version has been tested with Delphi 7, 2007, 2009, 2010, XE, and XE2 to XE4. Note: Delphi 1 support was dropped at v3.5.

This component is Windows 64 bit compatible and can be compiled into a 64 bit VCL package.

NOTE: The unit name changed to PJAbout at release 3. Programs using earlier releases will need to be modified (or to have an alias set in Delphi's Project Options) before being recompiled using the new version.

Installation

Important Note: Please ensure that you have installed the TPJVersionInfo component before installing the about box component. If you are using Delphi XE4 or earlier, v3.0.0 of TPJVersionInfo or later is required or later. Users of Delphi XE5 or later require TPJVersionInfo v3.3.2 or later.

TPJAboutBoxDlg and its demo program are supplied in a zip file. Before installing you need to extract all the files from the zip file, preserving the directory structure. The following files will be extracted:

  • PJAbout.pas – Component source code.
  • PJAbout.dfm – Form file containing the about box.
  • PJAbout.dcr – Component palette glyph.
  • README.md – This read-me file.
  • CHANGELOG.md – Change log.
  • MPL-2.txt – Mozilla Public License v2.0.
  • Documentation.URL – Short-cut to the component's online documentation.

In addition to the above files you will find the source code of a demo project in the Demo sub-directory.

You can now install the component into the Delphi IDE. The files PJAbout.pas, PJAbout.dfm and PJAbout.dcr are required to do this (PJAbout.dcr is not required for 64 bit packages). For Delphi 3 onwards you must include these files in a design time package that is installed into the Delphi IDE. If you need help doing this see here.

Demo Project

A demo program is included in the download that can be used to exercise the component. This program should be able to be compiled with any version of Delphi supported by the component, but this has only been tested in Delphi 7 or later.

See the read-me file included in the Demo directory for further details.

Update History

A complete change log is provided in CHANGELOG.md that is included in the download.

License

The About Box Component (PJAbout.pas) is released under the terms of the Mozilla Public License v2.0.

All relevant trademarks are acknowledged.

Bugs and Feature Requests

Bugs can be reported or new features requested via the Issue Tracker. A GitHub account is required.

About the Author

I'm Peter Johnson – a hobbyist programmer living in Ceredigion in West Wales, UK, writing write mainly in Delphi. My programs and other library code are available from: https://delphidabbler.com/.

This document is copyright © 2005-2022, P D Johnson.