2.10. Property palette

<< Prev   Next >>

When you edit a configuration object, you change its properties to create the desired behavior.

Property palette is a window containing a set of properties that can be defined for a configuration object. The list of properties may vary depending on the type of object you are editing.

In this section, you can read about the general methods for using the property palette.

To call the property palette, select a configuration object and click Edit ‑ Properties in Designer menu.

In the property palette, object properties are grouped by category. The number of categories and the list of properties in each category may vary depending on the object type. For example, the property palette for a document attribute contains only the General, Use, and Presentation categories. The list of category properties also varies depending on the object type. Even for objects of the same kind, available properties are determined by individual object settings. For example, for a hierarchical catalog, the tabular field properties of the Use category include the Presentation, Show root, and other properties.

The list of properties also depends on the selected values of other properties. For example, if you select the primitive Number type in the Type property, the following properties that characterize the selected type are added: Length, Precision, and Nonnegative.

To quickly find a property in the property palette, use the search field. To open the field, press Ctrl + Alt + I. The search is performed by the properties presentation in the property palette (see fig. 11). To start searching, enter two or more non-space characters in the field. To clear the search field, click the clear button or press ESC in the search field.

The property palette tools panel contains five buttons (see fig. 12). The first three buttons control how the properties are displayed.

The buttons are:

• Sort alphabetically. If the button is enabled, it displays object properties sorted alphabetically. The property categories are hidden. If the property name display is enabled, properties are sorted by name. Otherwise, properties are sorted by the presentation. If the property does not have a name, properties are always sorted by the presentation. The property name display is controlled by the Display property names item in the property window context menu.
• Sort by categories. If the button is enabled, it displays object properties sorted by categories.
• Show only important elements. If the button is enabled, it displays only important object properties. If the button is disabled, it displays all properties.
• Cancel editing. Cancels all changes made to the property text field.
• Save. Saves changes made to the property text field.

Property categories can be displayed as tabs or as a list. When you choose to view properties as a list, the properties can be displayed by category or alphabetically (category names are not shown).

To select a category display method, open the context menu in the property palette window and select a display method: Tabs or List. You can select a display method only when the category display is enabled, that is the Sort by categories button is enabled. If you select the Tabs display mode, the Sort alphabetically and Sort by categories buttons become unavailable.

To switch to properties of another category in the Tabs display mode, click the respective tab.

To return to the List display mode, open the context menu property window and click List.

If you select the List display mode, object properties are arranged by categories or alphabetically. To arrange properties alphabetically, click Sort alphabetically in the property palette tools panel. All properties are displayed in the alphabetical order.

To sort properties by categories, click Sort by categories in the property palette tools panel. All properties will be grouped by categories into a vertical list. Category names are highlighted in bold. To the left of each category name, you can find a button to expand or collapse the category. The button hides or shows all properties in the category.

Double-click a property category name to expand the given category properties and collapse all the other categories.

If you click Show only important elements, only important (main) object properties are displayed regardless of the display mode: a list or tabs, by category or alphabetically. To view all properties, click Show only important elements again.

Depending on the object kind, its properties can or cannot be editable. For example, object properties of a text document are used only to display the number of lines and characters and the document status but they are not editable.

Each property in the property palette has a name and a detailed description. To set the detailed description mode, right-click the property palette (outside the input fields) and select Note. If this mode is enabled, a detailed description is displayed at the bottom of the property palette when a property is selected. Besides the description, a property name used to access the value from the module can be displayed.

Properties that you can access using 1C:Enterprise language tools can be displayed as property names or descriptions. For example, a property can have the Value type description and the ValueType name. To change the display mode, click Display property names in the context menu. Property names are displayed according to the selected 1C:Enterprise language option.

A method to enter values in the property palette depends on the type of the property you are editing.

To enter values for text attributes, type a text or copy it from the clipboard. To enter values for "check box" properties, simply click them. Some property values are selected from lists. The fields of these properties have a selection list button (see fig. 13). If a property field has a selection button (see fig. 13), you can click it to open a window to select a property value or to view it when an object is not editable. For example, when an object is not stored in the configuration repository or supported with no editing features. These properties include picture file selection, color definition, and so on.

For text data, the View button (see fig. 13) opens the line editing dialog box in different languages. For events, it opens the form module procedure that handles the event. For properties from the Presentation category, it opens the existing data object form. The Clear button (see fig. 13) clears the value of the specified property. The Adjustment button (see fig. 13) increases or decreases the numeric value of the field by 1.

A field can have multiple buttons.

When you start editing a text field in the property palette, the Cancel editing (see fig. 12) and Save (see fig. 12) buttons of the property palette tools panel become available. To cancel the changes, click "Cancel editing". To save the changes, click "Save".

The property palette can contain references that open forms related to the selected object. For example, you can open the help (description) for a configuration object, forms, and procedures of the form module. These references are underlined. To open a window related to the reference, click the reference.

If you view the properties of a read-only object (for example, an object that is not stored in the repository, the type editing dialog box is opened in view-only mode.

<< Prev   Next >>