New Component
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.
Contents
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. |
|
|
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. |
|
|
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. |