Skip over navigation

Welcome to the all new DelphiDabbler website.

I hope you like it.

There are going to be bugs. Please report any you find on the website's issues page (GitHub account required). Thanks.

Click the close button and you won't see this message again.

About Box Component

An about box that can display version information.

Version 3.6.1
Released 11 Jan 2014
Platforms Win32 & Win64
Framework VCL
Compatibilty Delphi 2 and later

Overview

This non-visual component encapsulates an About Box. When displayed the About Box appears like this:

Vista screenshot of About dialog box

The dialogue box can either display information stored in its properties or from the host program's version information resources.

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

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

  • Title – The dialogue box's window caption. 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 TApplications's Title property.
  • Version – This version number of the program. Optional property – default is nothing.
  • Copyright – A copyright message. Optional property – default is nothing.
  • Notes – Up to three lines of notes. Optional property – default is nothing.

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 dialog's position can be specified relative to the screen, desktop or parent application. The dialog has a single close button whose appearance and position can be customised. The About box also displays the program's icon.

Finally, the dialog box's font can be specified using the component's Font property.

A demo program is included in the Demo sub-directory of download that can be used to exercise the component.

Get The Code

You can download the latest version of the About Box Component directly from SourceForge as dd-aboutbox-3.6.1.zip.

Download v3.6.1

About Box Component is a sub-project of the DDabLib project which is maintained in a Subversion repository. The code is developed in the trunk/projects/aboutbox branch.

Subversion users can check out the source code of the current release from the repository on SourceForge by doing:

svn checkout http://svn.code.sf.net/p/ddablib/code/tags/projects/aboutbox/release-3.6.1 codedir

where codedir is the directory where you want to checkout code. To check out other versions, simply specify a different version number.

The latest development tree can be checked out using:

 svn checkout http://svn.code.sf.net/p/ddablib/code/trunk/projects/aboutbox codedir

Check outs are read only, but you can easily contribute code: see Feedback & Queries below.

Installation

The About Box Component is 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.htm – read-me file.
  • ChangeLog.txt – project change log.
  • MPL-2.txt – the Mozilla Public License v2.0.
  • Documentation.URL – short-cut to the component's online documentation.
  • PJAbout.hlp – component help file that integrates with the Delphi 3-7 OpenHelp system. Deprecated
  • PJAbout.als – a-link keyword file for integration with the Delphi 6 or 7 OpenHelp system. Deprecated

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

You may now install the component into the Delphi IDE. To do this, the files PJAbout.pas, PJAbout.dfm and PJAbout.dcr should be added to a design time package. If you need help doing this see here.

Documentation

The About Box Component is comprehensively documented online here

The project's change log can be viewed on SourceForge

A read-me file (ReadMe.htm) is included in the project download.

A legacy WinHelp help file is included in the download that can only be integrated with the IDE in Delphi 7 and earlier. This article explains how to do it.

This help file is deprecated and is no longer being updated. The last update was in the v3.6.1 release. The help file will be removed from any future release.

WinHelp is an optional download for Windows Vista through to Windows 8.1 and can't be installed at all on Windows 10.

There is also an FAQ.

Feedback & Queries

If you find any bugs or want to suggest a new feature please report them using the Issue Tracker.

Click the Create Ticket button to create a ticket then complete the form giving as much information as possible.

The issue tracker is shared among all the projects in the DelphiDabbler Code Library, so please make sure you enter aboutbox in the Project edit box to make it clear which project you are referring to. You should also choose Defect in the Type drop down list to report a bug or Enhancement to request a new feature.

If you have created a bug fix or have implemented a new feature please attach a zip file to your ticket that contains your source code.

Should you have any queries about using the component please read the documentation and/or FAQ. If you can't find an answer in the documentation then post a message in the discussion group.

License

The About Box Component is open source. It is copyright © 1998-2014 by Peter Johnson. The source code is made available under the terms of the Mozilla Public License v2.0. All relevant trademarks are acknowledged.