New Component

From RAD Studio
Jump to: navigation, search

Go Up to Component Menu


Component > New Component

Use this wizard to create a new component for Delphi or C++Builder. The personality of your current project is detected and used for the component.

Note: Not all of the features described here are present for every instance of the wizard.

Personality, Framework, and Platform page

This initial page is displayed (Personality, Framework, and Platform) only if you do not have a project open when you invoke the wizard. If you have a project open when you invoke this wizard, this initial page is not displayed, and the personality, framework, and platform are derived from your current project settings.


This initial page displays the available personalities (Delphi or C++), frameworks (VCL or FireMonkey), and platforms (such as Win32). Specify the personality, framework, and platform that you want the component to use:

  • VCL for C++ Win32 - supported in Win32 and Win64 applications*
  • FireMonkey for C++ - supported in Win32, Win64, macOS, iOS, and Android applications
  • VCL for Delphi Win32 - supported in Win32 and Win64 applications*
  • FireMonkey for Delphi - supported in Win32, Win64, macOS, iOS, and Android applications
Note: For Win64 applications you need to create a 32-bit version of your component on this page of the wizard. Later you should compile your component again, as a Win64 component, by setting the Target Platform to be Win64 (in the Projects Window). RAD Studio saves output files (such as .bpl and .dcp) in platform-specific directories located inside your project output directory.

Ancestor Component page

Displays a list of installed components that can be used as ancestors for the new component.

Item Description

Component list

Shows a list of installed components, including the Component Name and the Unit Name (namespace). Select the component that will be used as the ancestor of the component you want to create.

Search Glass Search

Enter a search string. The list automatically includes only those components that match your search string. Click X to clear the search string.

Component page

Allows you to edit the parameters that will be used to create the new component.

Item Description

Class Name

Enter a class name for the new component, or accept the default value.

Palette Page

Select the Tool Palette category where you want the new component to appear.

Unit name

Enter the name of the unit for the new component. To browse for a file, click [...] (ellipsis).

Search path

Enter an optional search path for the new component.

The default value being used is the Library Path set on the following pages:

Create Unit page

Specify whether you want to create a new unit, install the new component in an existing package, or install the component in a new package. If you have a project open, you can also add the component to the current project.

Item Description

Create Unit

Click to cause the IDE to create a new unit.

Install to Existing Package

Click to install the new component into a package that already exists.

Install to New Package

Click to cause the IDE to generate a new package.

Add unit to <my_new_package> project

Click to install the new component in the specified package. You can create this package by invoking File > New > Other > Delphi or C++Builder Projects > Package before starting the New Component wizard, as described in Using the New Component Wizard.

Existing Package page

Allows you to select an existing package in which to install the new component. This page is displayed only if you choose 'Install to Existing Package' on the Create Unit page of the wizard.

Item Description

Installed package list

Lists all the packages currently installed on the system, including the Package Name, the Description, and the Filename.

Search Glass Search

Enter a search string. The list automatically includes only those packages that match your search string. Click X to clear the search string.

Browse

Click Browse to look for a package that is not on the list.

New Package page

Allows you to enter the name of a new package that the wizard will create to contain the new component. This page is displayed only if you choose 'Install to New Package' on the Create Unit page of the wizard.

Item Description

Package name

Enter a file name for the new package. Click the [...] button to navigate to the folder where the new package will reside.

Description

Enter a description for the new package.

See Also