View source for PrF UG meta customize editor

__NOTOC__
== Customizing the Class or Slot Editor ==

<noinclude>{{PrF_UG_TOC_meta}}<div id='prf_ug'></noinclude>

Using metaclasses, you can customize the layout
of the [[PrF_UG_classes_class_editor|Class Editor]]
or the [[PrF_UG_slots_slot_editor|Slot Editor]]
at the [[PrF_UG_forms_forms_tab|Forms tab]].
You can hide entry fields and resize and reposition fields.
Normally you do <b><i>not</i></b> want to change widgets,
as the Class Editor and Slot Editor use special widgets for the standard fields.

To customize the standard
[[PrF_UG_classes_class_editor|Class Editor]],
select <b>:STANDARD-CLASS</b> at the Forms tab and then make your desired edits.
Since any new class is (by default) created using <b>:STANDARD-CLASS</b>,
the Class Editor itself reflects the structure and layout specified for <b>:STANDARD-CLASS</b>
at the [[PrF_UG_forms_forms_tab|Forms tab]].
Your modifications will show up for every class, whether existing or new.
Similarly, to customize the standard [[PrF_UG_slots_slot_editor|Slot Editor]],
select <b>:STANDARD-SLOT</b> at the Forms tab and make your desired edits.

If you have non-standard metaclasses or slot metaclasses in your project,
you can create custom editors for classes or slots that use these.
For example, when you add a field,
you may want to reposition it or resize it in the editor.

=== Example ===

For example, you could customize the Class Editor for classes
that used the <b>Wine template</b> to an InstanceTableWidget
that shows the location and the name of the best wineries:

<ol class='a'>
  <li><p>
    At the Forms tab, select the <b>Wine template</b>.
    </p>
    <div>[[Image:PrF_UG_meta_meta_at_forms_tab.png|frame|none|
           Forms tab, "Wine template" selected]]</div>

  <li><p>
    Select the <b>Best Wineries</b> widget.
    </p>
    <div>[[Image:PrF_UG_meta_best_wineries_widget.png|frame|none|
           Best Wineries widget]]</div>

  <li><p>
    Select <b>InstanceTableWidget</b> from the <b>Select Widget Type</b> menu
    at the top right of the Form Editor.
    </p>
    <div>[[Image:PrF_UG_meta_menu_directinstanceswidget.png|frame|none|
          InstanceTableWidget selected in menu]]</div>
    <p>
    This will change the widget display, adding field headings.
    </p>
    <div>[[Image:PrF_UG_meta_widget_instancetable.png|frame|none|
           Best Wineries widget, with field headings]]</div>

  <li><p>
    You can further configure the widget by double-clicking on it
    to open the <b>Configure widget</b> dialog.
    To delete the <i>produces</i> column,
    select the <b>Define columns of instance table</b> tab,
    click on the slot name <i>produces</i>,
    click the <b>Remove the currently selected column</b>
    ([[Image:PrF_UG_all_object.remove.gif|all_object.remove]]) button
    and click <b>OK</b>.
    </p>
    <div>[[Image:PrF_UG_meta_configure_widget.png|frame|none|
           Configure Best Wineries dialog]]</div>

  <li><p>
    You can also resize the widget by dragging.
    </p>
    <div>[[Image:PrF_UG_meta_widget_resized.png|frame|none|
           Best Wineries widget, resized]]</div>
</ol>

See the [[PrF_UG_forms|Forms Table of Contents]]
for more information about customizing forms.


<noinclude></div></noinclude>