Skip to main content

Command: Properties

Function: The command opens the Properties dialog for the library selected in the Library Manager.

. Call
  • Libraries Menu

  • Context menu of the selected library

  • _cds_icon_properties_library.png symbol in the toolbar of the Library Manager

Requirement: A library is selected.

Important

This dialog is intended for library developers. Use it only if you have profound knowledge of library referencing, and follow the guidelines for library developers.

For more information, see: Information for Library Developers

Dialog: Properties

Table 123. General

Namespace

Namespace of the selected library

By default, this is identical to the library name, unless it was defined explicitly in the project information when the library was created. You can change the namespace for the open project.

Example: LA

Default

Library which triggers the placeholder when no other trigger is defined or possible

Requirement: The selected library is a library placeholder, and therefore the setting is available.

Note: For compiler version 3.5.8.0 and higher, the following applies in the case of library placeholders with a resolution in the device description which are located in the Library Manager of the POUs view: This placeholder is always resolved automatically according to the description of the device which compiles the application.



Tip

If the selected library is developed in compliance with the "Guidelines for Developing Libraries", then we do not recommend that you change the following settings.

Table 124. Version

Selection of the version constraint

Requirement: The settings are available only if the selected library is not a library placeholder.

Note: Container and interface libraries are automatically created with library references with version constraint. Whenever possible, do not create libraries which include library references with a version constraint. Instead, you use placeholders to reference the libraries. Edit a placeholder resolution in the Placeholders dialog.

Exact version

_visu_radio_button_activated.png: The version which was selected from list box is integrated into the project.

Note: This option is strongly recommended for container libraries, and it is usually preset for this library type.

Always newest version

_visu_radio_button_activated.png: The library repository is scanned and the newest detected version is integrated.

Note: If a newer library version is available, then the library POUs which are actually used can change. This option is strongly recommended for interface libraries, and it is usually preset for this library type.



Table 125. Visibility

Allow only qualified access to all identifiers

_cds_icon_checked.png: Library POUs (and variables) are called in the project only with prepended namespace paths.

When the current project is referenced as a library in another project

Note: Changing the following settings makes sense only if you have created a library with your project and therefore opened a library project. As a result, the selected library is referenced in the new library.

Make visible all IEC symbols in the project if is this reference were directly integrated here.

_cds_icon_checked.png: As a container library, the selected library makes the contents of the referenced library visible at the top level (later in a project).

Requirement: A container project is created with a library project. A container library does not implement its own POUs, but exclusively references other libraries. It bundles libraries. A container library can be reasonably used to bundle multiple libraries (in a reference) in a project. This option has to be enabled for each library reference.

Symbolic access to library POUs: <namespace of container library>.<POU name>

_cds_icon_option_deactivated.png: The contents of the referenced library are uniquely accessed by means of the namespace. The path name consists of the library name and the unique name (library reference), and it is prepended to the POU name.

Requirement: No container project is created with a library project.

Do not show this reference in the dependency tree.

_cds_icon_checked.png: The selected library is not displayed (later in a project) in the Library Manager as a library reference. The library is a hidden reference.

Warning: If there are compile errors resulting from hidden library errors, then it may be difficult to detect the errors.

_cds_icon_option_deactivated.png: The selected library is displayed (later in a project) as a library reference.



Optional (if the library is missing, no error will be reported).

_cds_icon_checked.png: The selected library is handled as optional. When downloading the project which references the library, no error is reported, even if the library is not available in the library repository.

For more information, see: Placeholders