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.
- Actions: Align to Grid, Size to Grid, Center Horizontally, Center Vertically, Bring to Front, Send to Back, Fit Bounds to Container
- Styles: Even Style, Odd Style, Style
- Appearance: Background Color, Border Color, Border Dash Style, Border Width, Borders, Font Name, Font Size, Font Unit, Font Effects, Foreground Color, Padding
- Behavior: Can Publish, Keep Together, Visible
- Data: Tag
- Design: Name
- Layout: Location, Size
- Navigation: Bookmark, Parent Bookmark, Navigation URL
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: