Components
Components Area (Toolbox)

Content Layout of a Component Tab

18min
Applicable to
Added
CET 15.0 Major and above


Anatomy

Default

Document image


1 - Section header

  • Arrow
    • Icon: Chevron
    • Size: 16x16
    • State: Show
  • Title
    • Font size: 13
    • Text color: #000000
    • Text style: Heading 5
  • Function buttons (optional)
    • Maximum of 3 buttons
    • Size: 16x16
    • Icon color: Icon/Stroke Light (#545454)

2 - Subsection (optional)

  • Font size: 12
  • Text color: #000000
  • Text style: Normal

3 - Label (optional)

  • Font size: 11
  • Text color: Input/Label (#4D4D4D)
  • Text style: Label

4 - Preview

  • Width: 312
  • Height: 24
  • State: Close
  • Border color: Border/Border 1 (#B3B3B3)
  • Background color: #FFFFFF

Layout

General

Document image


Grid & Columns

As described in Spacing & Layout, the extension's component tab space is divided into columns according to a grid system, which can be used to size and place elements.

By default, the system will auto size your buttons such that the images will show at their native resolution. Odds are, your images are not sized exactly to result in a button size that fits the column grid, so explicit hints should be given to the system to override this behaviour. UIHint can be used for this purpose:

C++




Section

Sections are containers used to organize the content of a library. Nested sections are not allowed, please consider the use of Subsections instead.

Header

Title without top line

Document image


Section headers without a top line are only used when it is the first section within a toolbox.

Title with top line

Document image


Section headers with a top line are always used for every section that is not the first within a toolbox component tab.

Function buttons

Document image


Each section can optionally have up to 3 function buttons, and each button must be 24x24 pixels in size. These are recommended for placing help buttons and section specific settings.

Ceiling section with a custom settings button
Ceiling section with a custom settings button


Code Example

To use this feature, first create a section button:

CM


Then add it to the section's limb:

Standard Syntax
Library Syntax
CM


Content

With product and tool buttons

This applies to other components under section header titles as well such as toggles, dropdowns, checkboxes, etc.

Document image


Bottom

Document image


Note: The 16px space includes the top line of the next section.

Subsection

Subsections are introduced to provide an additional level of nesting to help organize the contents within a Section in a more logical manner. Nested sections are not allowed.

Code

To use these, just add a SubSectionLimb as a parent to your existing SnapperLimbs.

Header

Title

Document image


Content

With product and tool buttons

Document image


Multiple subsections within 1 section

Document image


Subsection Label

Subsection Labels are an additional level below Subsections for further organizing the contents.

Title

Document image


Content

With product and tool buttons

Document image


With input fields

Document image

Document image