[Integration Kit Contents] [Integration Kit What's New] [Integration Kit Function Index] [More Documentation] [PTC]

User Interface Construction Toolkit - Common UI Control Properties

Common UI Control Properties

Property Data Type Description
:alignment KEYWORD Title or item alignment of a control. This can be one of the following keywords:
  • :left
  • :center
  • :right
:cellSize GPNT2D Describes the size of a single cell of a grid area measured in pixels. The x value of this 2D vector is the width of the cell and the y value is the height of the cell (size always in pixels). See this picture for a visual explanation.
Use sd-get-default-grid-size to retrieve the default grid size which depends on your Windows properties like used font etc.
:disabledImage STRING Image to appear on the control in case the control is disabled.
Note: To see the image, you must specify an :image too, otherwise you would see only the control title. In case you specify an :image but no :disabledImage, :image will be shown on the disabled control as well.
:frame BOOLEAN Flag to indicate whether the (grid) area should have a border frame or not
:height FIXNUM Height of the control measured in grid units.
Example: If you would specify 2 as height in case of the default :cellSize of 10,10, your control would be 20 pixels high.
See this picture for a visual explanation.
:image STRING Name of a valid image to be displayed on the control instead of a string title. The image has to be created before using the function sd-create-image.
:margin FIXNUM Margin between the border of a (grid) area and its child controls. The top-left cell with grid coordinates 0,0 is actually located at margin,margin (default: 3,3) pixels within the parent area.
See this picture for a visual explanation.
:spacing FIXNUM Spacing between single controls within a grid area (measured in pixels).
See this picture for a visual explanation.
:title STRING Title to be shown on the control
:width FIXNUM Width of the control measured in grid units.
Example: If you would specify 10 as width in case of the default :cellSize of 10,10, your control would be 100 pixels wide.
See this picture for a visual explanation.
:x FIXNUM X coordinate of the control within the parent grid area measured in grid units.
See this picture for a visual explanation.
:y FIXNUM Y coordinate of the control within the parent grid area measured in grid units.
See this picture for a visual explanation.

[Integration Kit Contents] [Integration Kit What's New] [Integration Kit Function Index] [More Documentation] [PTC]
© 2023 Parametric Technology GmbH
(a subsidiary of PTC Inc.), All Rights Reserved