Advanced Grid Labels

Last updated July 17, 2018 by Sascha Hamanke

Software version: 
Not version-specific
Not environment-specific

Advanced Grid Labels

Purpose and description

This plug-in gives the user more possibilities to define the gridmodeling aid that represents a three-dimensional complex of horizontal and vertical planes

In Tekla Structures, grids are used as an aid in locating objects in a model. The grid is shown on the view plane by dash-and-dot lines. It is also possible to show grids and grid line labels in drawings, and to modify grid properties in the drawings.

It is possible to have more than one grid in a model. For example, a large-scale grid for the entire structure, and smaller grids for some detailed sections.

labels. Grid labels can be defined with an extra text. This text can be freely defined in the model and shown on the drawing.

System requirements

Tekla Structures version: 18 onwards
.Net Framwork version: 4.0 or higher
Environment: Non-imperial
Language: German, English 

Installing Advanced Grid Labels

To install the plugincomponent that is developed using Tekla Open API

Plugin is a .dll file and loaded inside Tekla Structures process.

Plugins can be started from the applications and components catalog.

  1. Download from Warehouse…
  2. Extract...
  3. Close Tekla Structures
  4. Install the applicationpart of Tekla Structures functionality that is developed in order to extend the capability of Tekla Structures but that is not included in the Tekla Structures installation

    using the 32bit (x86) or 64bit installation package

User toolbar

If the toobar with the Advanced Grid Labels icon doesn´t appear automatically in the drawing environment you have to add it manually.
To manually add an extension to a user toolbar in Tekla Structures:

  1. Click Tools > Customize to open the Customize dialog box.
  2. On the Toolbars tab, click New... A new toolbar with the name User Toolbar 1 appears in the toolbar tree. You can enter a new name for the toolbar.
  3. Search for the extension on the list on the left, click on it and then click the right arrow to add it to the toolbar. Some extensions are started from a macrosaved series of actions that includes instructions for a program

    Macros are located in the applications and components catalog. They are recorded or created manually and stored as .cs file in a folder defined with the advanced option XS_MACRO_DIRECTORY.

    Macros can, for example, be used for creating drawings or reports.

    Macros are sometimes used to run an application.

    , entering macro: in the Filter input box will list those extensions.
  4. Repeat step 3 if you would like to add more extensions to the toolbar.
  5. Click Close.

If you want to create a user-defined toolbar for drawing extensions, create it in the modeling modemode that is used for creating and analyzing a model, and initiating the creation of a drawing and a report

Custom component editor and sketch editor can be accessed in modeling mode.

, otherwise the toolbar is not saved.

Using Advanced Grid Labels

To use the extension:

  1. With a double click on the Advanced Grid Labelname of a grid line

    icon, you open the dialog box.

With a asimple click on it you start the command.,
  1. You are prompted to pick a grid in the status bar.
  2. The defined settings will be applied to the picked grid.

Defining a grid label text

  1. You can define a text for the complete grid or for every single grid linesingle line that visualizes a single grid plane on a view plane

    . To do this you have to enter the text to the user defined attribute “Grid label text”.
  2. If your environment doesn´t have this user defined attribute you have to add it first to the objects.inp file. Please add follwoing rows to it:
/* Grid attributes                                                         */
     unique_attribute("GRID_TEXT", "albl_Labels", string, "%s", no, none, "0.0", "0.0")
         value("", 0)
/* Grid planesingle horizontal or vertical plane of a grid

attributes                                                   */
     unique_attribute("GRID_TEXT", "albl_Labels", string, "%s", no, none, "0.0", "0.0")
         value("", 0)


Modifying an existing grid label

  1. To modify the advanced grid labels, you have to select the grid labels itself and NOT the grid.

Size of the Grid label frame

  1. You can define a fixed size for the grid label frameframe of a grid line label in a drawing

    by setting the advanced option XS_DRAWING_GRID_LABEL_FRAME_FIXED_WIDTH to a defined value. You can define this variable by going to the menu Tools > Options > Advanced Optionssettings used to customize Tekla Structures for specific companies, standards, users, or user groups

    In Tekla Structures, advanced options are settings that are used, for example, in a specific project or geographical area, or by a specific company.

    In Tekla Structures, advanced options usually begin with the initials XS and are followed by the name of the function, for example XS_BACKGROUND_COLOR.

    > Drawing Properties.
  2. Íf you want that the size of the Grid label frame is calculate automatically, you leave this field empty.

Advanced Grid Labels settings

Property Description
Use settings from Here you can define where the settings are taking from. You have the option to inherit the settings from the grid or you define the settings yourself inside the User Interface.
Frame type Here you can select the type of the frame. You can select out of 4 options.
Option 1: Circle and grid label at the bottom

Option 2: Circle and grid label at the top

Option 3: Oval and grid label at the bottom

Option 4: Oval and grid label at the top
Grid label placing Here you can define which grid labels will be shown and in which distance to the grid.
Frame Here you can define the color and the line type of the frame.
Text Here you can define the looks of the grid labels (Color, Height and Font).

Additional information

  • There is no check if the user is trying to create the same grid labels twice for the same grid.
  • Grid labels cannot be changed if following situation comes true
    • One of the grid labels on this grid has the height „0“.
    • If a view is placed inside another view which has a modified grid already.

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
Average page rating: 2.5 (2 votes)
Refresh page after voting to show updated result.


by tran minh thu

Version 19 has this extension included but text are automatically set with underline and there is no option to turn it off. I prefer the one in version 21.