Shapes
Shapes, such as the rectangle, ellipse, line, and path, are an important foundation for creating drawings and graphic designs. Shapes are normally used on a canvas, but can be used in other containers as well.
You can rotate and skew rectangle, ellipse, and path shapes, but not line, polyline, or polygon shapes.
Shapes Controls Property Usage
The following table shows the properties used by each control:
| Property | Ellipse | Line | Path | Polygon | Polygon Pencil | Polyline | Polyline Pencil | Rectangle |
|---|---|---|---|---|---|---|---|---|
| AllowDrop | X | X | X | X | X | X | X | X |
| ClipToBounds | X | X | X | X | X | X | X | X |
| Column | X | X | X | X | X | X | X | X |
| ColumnSpan | X | X | X | X | X | X | X | X |
| Effect | X | X | X | X | X | X | X | X |
| Fill | X | X | X | X | X | X | X | X |
| FlowDirection | X | X | X | X | X | X | X | X |
| Focusable | X | X | X | X | X | X | X | X |
| FocusVisualStyle | X | X | X | X | X | X | X | X |
| ForceCursor | X | X | X | X | X | X | X | X |
| Height | X | X | X | X | X | X | X | X |
| HorizontalAlignment | X | X | X | X | X | X | X | X |
| IsEnabled | X | X | X | X | X | X | X | X |
| IsHitTestVisible | X | X | X | X | X | X | X | X |
| IsManipulationEnabled | X | X | X | X | X | X | X | X |
| IsSharedSizeScope | X | X | X | X | X | X | X | X |
| Localization | X | X | X | X | X | X | X | X |
| Margin | X | X | X | X | X | X | X | X |
| MaxHeight | X | X | X | X | X | X | X | X |
| MaxWidth | X | X | X | X | X | X | X | X |
| MinHeight | X | X | X | X | X | X | X | X |
| MinWidth | X | X | X | X | X | X | X | X |
| Name | X | X | X | X | X | X | X | X |
| Opacity | X | X | X | X | X | X | X | X |
| OpacityMask | X | X | X | X | X | X | X | X |
| OverridesDefaultStyle | X | X | X | X | X | X | X | X |
| RadiusX | X | X | ||||||
| RadiusY | X | X | ||||||
| ReloadableForm | X | X | ||||||
| Render Transform | X | |||||||
| RenderTransformOrigin | X | X | X | X | X | X | X | X |
| Row | X | X | X | X | X | X | X | X |
| RowSpan | X | X | X | X | X | X | X | X |
| SnapsToDevicePixels | X | X | X | X | X | X | X | X |
| Stretch | X | X | X | X | ||||
| Stroke | X | X | X | X | X | X | X | X |
| StrokeDashArray | X | X | X | X | X | X | X | X |
| StrokeDashCap | X | X | X | X | X | X | X | X |
| StrokDashOffset | X | X | X | X | X | X | X | X |
| StrokeEndLineCap | X | X | X | X | X | X | X | X |
| StrokeLineJoin | X | X | X | X | X | X | X | X |
| StrokeMiterLimit | X | X | X | X | X | X | X | X |
| StrokeStartLineCap | X | X | X | X | X | X | X | X |
| StrokeThickness | X | X | X | X | X | X | X | X |
| Style | X | X | X | X | X | X | X | |
| Tag | X | X | X | X | X | X | X | |
| ToolTip | X | X | X | X | X | X | X | |
| Uid | X | X | X | X | X | X | X | |
| UseLayoutRounding | X | X | X | X | X | X | X | |
| VerticalAlignment | X | X | X | X | X | X | X | |
| Visibility | X | X | X | X | X | X | X | |
| Width | X | X | X | X | X | X | X | |
| X1 | X | X | ||||||
| X2 | X | X | ||||||
| Y1 | X | X | ||||||
| Y2 | X | X |
Shapes Controls Property Descriptions
The following table shows the properties descriptions used by all control:
| Property | Description |
|---|---|
| AllowDrop | Select this check box to indicate that the control can accept data that is dragged onto it. |
| ClipToBounds | Select this check box to clip the content of this control (or content coming from the child elements of this control) to fit into the size of the containing control. |
| Column | Specifies the column within the grid where the control is located. |
| ColumnSpan | Specifies the total number of columns that child content spans within a grid. |
| Effect | Click the arrow to expand the property, select the effect you want to apply to the control, and then configure the specific values for the effect. Valid values to select are:
|
| Fill | Expand this field to select the color for the inside of the thumb control or for the interior of the shape. |
| FlowDirection | Specifies the direction that text and other user interface (UI) elements flow within any parent control. Selections are:
|
| Focusable | Select this check box to indicate that the control can receive focus. |
| FocusVisualStyle | Specifies a property that enables customization of appearance, effects, or other style characteristics that apply to this control when it has focus. |
| ForceCursor | Select this check box to indicate that the user interface (UI) renders the cursor as declared by the Cursor property. |
| Height | Specifies the height of the control, in pixels. |
| HorizontalAlignment | Specifies the horizontal alignment characteristics applied to this control. Selections are:
|
| IsEnabled | Select this check box to indicate that this control is enabled in the user interface (UI). |
| IsHitTestVisible | Select this check box to indicate that the control can possibly be returned as a hit test result from some portion of its rendered content. |
| IsManipulationEnabled | Select this check box to indicate that the manipulation events for the control are enabled. |
| IsSharedSizeScope | Select this check box to indicate that controls are sharing size information. |
| Localization | Click the ellipsis button to open the Localization Configuration dialog box where you can configure the property to localize, the language to use for localization, and the text to localize. |
| Margin | Specifies the outer margin of a control. |
| MaxHeight | Specifies the maximum height of a control. |
| MaxWidth | Specifies the maximum width of a control. |
| MinHeight | Specifies the minimum height of a control. |
| MinWidth | Specifies the minimum width of a control. |
| Name | Specifies the identifying name of the control. The name provides a reference so that code behind, such as event handler code, can refer to a markup element during processing by a XAML processor. |
| Opacity | Specifies the opacity factor applied to the entire control. Valid values are 0 through 1, with up to 15 decimal places. |
| OpacityMask | Expand this field to select a color for the opacity mask, which is applied to any alpha-channel masking for the rendered content of this control. |
| OverridesDefaultStyle | Select this check box to indicate that this control incorporates style properties from theme styles. |
| RadiusX | Specifies the x-axis radius of the ellipse that is used to round the corners of the rectangle. |
| RadiusY | Specifies the y-axis radius of the ellipse that is used to round the corners of the rectangle. |
| ReloadableForm | Select this check box to enable viewing of this form in a completed or acquired state in the Task List. This property works in conjunction with workflow Tracking Configuration, which must be enabled to view completed forms. Note: If you enable this setting, you must configure your form to handle viewing in a completed or acquired (reloaded) state by using the IsReloaded expression variable. For example, if the form is in a reloaded state, you can disable certain user interface elements and show read-only data. |
| Render Transform | Specifies the transform information that affects the rendering position of an object. |
| RenderTransformOrigin | Specifies the center point of any possible render transform, relative to the bounds of the element.
|
| Row | RowBackground |
| RowSpan | Specifies the total number of rows that child content spans within a grid. |
| SnapsToDevicePixels | Select this check box to indicate that rendering for this control uses device-specific pixel settings. |
| Stretch | Specifies how an Image stretches to fill the destination rectangle. Selections are:
|
| Stroke | Expand this field to select the color for the shape's outline. |
| StrokeDashArray | Click the ellipsis button to open the StrokeDashArray Property Editor dialog box to indicate the pattern of dashes and gaps that is used to outline shapes. |
| StrokeDashCap | Specifies how the ends of a dash are drawn. Selections are:
|
| StrokeDashOffset | Specifies the distance within the dash pattern where a dash begins |
| StrokeEndLineCap | Specifies the shape at the end of a line. Selections are:
|
| StrokeLineJoin | Specifies the type of join that is used at the vertices of a shape. Selection are:
|
| StrokeMiterLimit | Specifies a limit on the ratio of the miter length to half the StrokeThickness of a shape. |
| StrokeStartLineCap | Specifies the shape at the start of a line. Selections are:
|
| StrokeThickness | Specifies the width of the control's outline. |
| Style | Specifies the style used by this control when it is rendered. |
| Tag | Specifies an arbitrary object value that can be used to store custom information about this control. |
| ToolTip | Specifies the tool-tip that displays for this control in the user interface (UI). |
| Uid | Specifies the unique identifier (for localization) for this control. |
| UseLayoutRounding | Specifies a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels. |
| VerticalAlignment | Specifies the vertical alignment characteristics applied to this control. Selections are:
|
| Visiblility | Specifies the visibility of this control. Selections are:
|
| Width | Specifies the width of the control, in pixels. |
| X1 | Specifies the position of the line's starting point on the X axis. |
| X2 | Specifies the position of the line's ending point on the X axis. |
| Y1 | Specifies the position of the line's starting point on the Y axis. |
| Y2 | Specifies the position of the line's ending point on the Y axis. |