Installing Custom Components

From RadPHP XE2 Documentation
Jump to: navigation, search

Summary: Describes how to install custom components onto the Tool Palette.


After you have created and saved a custom component, you can install it to the "Tool Palette" in RadPHP for use in creating applications. You will do this by editing the package file source code directly. A package file is simply a   .php file which passes information to the IDE about that package such as which components to add, and includes the RPCL and a special unit containing functions for communicating with the IDE.


Important: You must save your package and component files in RadPHP  rpcl folder if you want to install your components on RadPHP "Tool Palette". Putting your components into subfolders enables you to build your own libraries without affecting the RPCL code base and makes deployment easier. To install custom components

  • Select the  <component name>

.package.php file in RadPHP.

  • Replace the string value in  setPackageTitle(" ")''''' with the name of the package so the IDE will now what it is named. For example,

setPackageTitle("MyMenu Package");

  • Modify the path in  setIconPath() to point to the  icons subfolder for the project.
  • Modify  registerComponents() to tell IDE to add the component to the "Tool Palette", the page on which to put the component, and the name of the unit that contains that component code. For example,

registerComponents("Standard",array("MyMenu"),"MyMenu/MyMenu.inc.php");

  • Choose

ComponentPathPDF.jpgPackages to open the "Installed Packages" dialog box.

  • Click the "Add" button, then navigate to the package file for your component and click "Open".
Tip:

To view the list of components in the package being installed to the "Tool Palette", select your new package then click the "Components" button. Click "OK" to return to the "Installed Packages" dialog box.

  • Click "OK" to close the "Installed Packages" dialog box.

Now expand the "Tool Palette" page on which you installed your custom components and you should see your custom components.

See also

Creating Custom Components

Adding an Image Icon to a Component

Setting Component Properties

Saving Custom Components

Personal tools