Shape Control

Description

The Shape Control draws a specified shape.

Properties Common to Most Controls

For more information about the properties listed below, see Properties Common to Most Controls.

For more information regarding each of the property groups, see the Control Reference.

Actions

Line Width

Specifies the line width in pixels, as a floating value.

Stretch

Type: Boolean

Specifies whether a shape may be stretched when rotated.

Fill Color

Type: Color

Specifies the color that fills the shape.

Angle

Type: Single

The degree by which the text is rotated. Text is rotated counterclockwise from the vertical.

The Can Grow and Can Shrink properties are ignored when Angle is set to a non-zero value.

Shape

Specifies the type of shape used.

The types of shapes available for this property include:

  • Rectangle
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Ellipse
  • Top Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Right Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Bottom Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Left Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Triangle
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Square
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Pentagon
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Hexagon
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Octagon
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • 3-point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 4-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 5-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 6-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 8-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • Vertical Line
  • Horizontal Line
  • Slant Line
  • Backslant Line
  • Cross
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Horizontal Line Width: Specifies the width of the horizontal lines using a percentage.
    • Vertical Line Width: Specifies the width of the vertical lines using a percentage.
  • Bracket
    • Tip's Length: Specifies the length of the bracket's tip.
  • Brace
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Tip's Length: Specifies the length of the brace's tip.
    • Tail Length: Specifies the length of the brace's tail.

 

Behavior

Anchor Vertically

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for vertically anchoring include:

  • None: The control's size and location are not affected when the container size changes.
  • Top: The distance between the top of the control and the top of the container remains fixed when the container size changes.
  • Bottom: The distance between the bottom of the control and the bottom of the container remains fixed when the container size changes.
  • Both: The distance from the top and bottom of the control from the top and bottom of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

If this property is enabled along with Can Shrink, the number of cells corresponds to the number of characters in the control's text. Otherwise, the number of cells corresponds to the specified cell size and control size.

Anchor Horizontally

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for horizontally anchoring include:

  • None: When the parent container changes size, the control's size and location are not affected when the container size changes.
  • Left: The distance between the left edge of the control and the left side of the container remains fixed when the container size changes.
  • Right: The distance between the right edge of the control and the right side of the container remains fixed when the container size changes.
  • Both: The distance from the left and right edges of the control from the left and right sides of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

Angle

Type: Single

The degree by which the text is rotated. Text is rotated counterclockwise from the vertical.

The Can Grow and Can Shrink properties are ignored when Angle is set to a non-zero value.

Shape

Specifies the type of shape used.

The types of shapes available for this property include:

  • Rectangle
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Ellipse
  • Top Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Right Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Bottom Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Left Arrow
    • Arrow Height: Specifies the relative height of the arrow using a percentage.
    • Arrow Width: Specifies the relative width of the arrow using a percentage.
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
  • Triangle
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Square
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Pentagon
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Hexagon
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • Octagon
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Number of Sides: Sets the number of sides the polygon has.
  • 3-point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 4-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 5-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 6-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • 8-Point Star
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Concavity: Specifies the concavity level between two neighboring star points using a percentage.
    • Count of Star Points: The number of points in the star.
  • Vertical Line
  • Horizontal Line
  • Slant Line
  • Backslant Line
  • Cross
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Horizontal Line Width: Specifies the width of the horizontal lines using a percentage.
    • Vertical Line Width: Specifies the width of the vertical lines using a percentage.
  • Bracket
    • Tip's Length: Specifies the length of the bracket's tip.
  • Brace
    • Fillet: Specifies the relative roundness of the shape corners using a percentage.
    • Tip's Length: Specifies the length of the brace's tip.
    • Tail Length: Specifies the length of the brace's tail.

Stretch

Type: Boolean

Specifies whether a shape may be stretched when rotated.

Related Tutorials

Refer to the following resources for additional help on implementing this control: