How Do I: Specify IDE Characteristics for a Java Control?

When you create a Java control, you can set JCS file properties that determine how the control will be represented in the IDE. These properties include the control's icon, its name on menus, its description in the Property Editor, and so on.

To Set IDE Characteristics for a Java Control

  1. Open your Java control source (JCS) file in Design View.
  2. Ensure that the control's design is selected.

    The control's name should be visible just beneath the Property Editor tab.

  3. In the Property Editor, locate the JCS file's jc-jar property.
  4. Set jc-jar attributes as follows:
  5.  
    jc-jar Attribute Description
    label The name used for the control on menus and palettes.
    insert-wizard-class A class that implements a custom insert dialog box.
    description The text that will appear in the Description pane when the control is selected in Design View.
    version The control's version number.
    icon-16 A path (relative to the JCS file) to a .gif file that should be used as the control's icon on menus, palettes, in Design View, and so on.
    icon-32 A path (relative to the JCS file) to a .gif file that should be used as the control's large icon.
    group-name The name of the submenu under which this control should appear.
    palette-priority A number that suggests a priority for this control when the IDE is ordering controls in the palette.
    display-in-palette Defines whether this control should be shown in the palette.
    resource-file Name of the resource to use in loading localization strings.
    requires-extension Defines whether this control must be customized. Usually set to false.

Samples

For sample Java controls, see the ControlProject and WebServices/localControls samples provided in the SamplesApp installed with WebLogic Workshop.

Related Topics

Tutorials: Your First Java Control

@jcs:jc-jar Annotation