RectangleShape Class
Represents a control displayed as a square, rectangle, rounded square, or rounded rectangle.
MarshalByRefObject
Component
Microsoft.VisualBasic.PowerPacks.Shape
Microsoft.VisualBasic.PowerPacks.SimpleShape
Microsoft.VisualBasic.PowerPacks.RectangleShape
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
The RectangleShape type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | RectangleShape() | Initializes a new instance of the RectangleShape class. |
![]() | RectangleShape(ShapeContainer) | Initializes a new instance of the RectangleShape class, specifying the ShapeContainer that will contain it. |
![]() | RectangleShape(Int32, Int32, Int32, Int32) | Initializes a new instance of the RectangleShape class, specifying its location and size. |
| Name | Description | |
|---|---|---|
![]() | AccessibilityObject | Gets the AccessibleObject that is assigned to the control. (Inherited from Shape.) |
![]() | AccessibleDefaultActionDescription | Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from Shape.) |
![]() | AccessibleDescription | Gets or sets the description of the control that is used by accessibility client applications. (Inherited from Shape.) |
![]() | AccessibleName | Gets or sets the name of the control that is used by accessibility client applications. (Inherited from Shape.) |
![]() | AccessibleRole | Gets or sets the accessible role of the control. (Inherited from Shape.) |
![]() | Anchor | Gets or sets the edges of the container to which a shape is bound, and determines how a shape is resized when its parent is resized. (Inherited from Shape.) |
![]() | BackColor | Gets or sets the background color for the shape. (Inherited from SimpleShape.) |
![]() | BackgroundImage | Gets or sets the image displayed in the shape. (Inherited from SimpleShape.) |
![]() | BackgroundImageLayout | Gets or sets the background image layout as defined in the ImageLayout enumeration. (Inherited from SimpleShape.) |
![]() | BackStyle | Gets or sets the transparency of the shape. (Inherited from SimpleShape.) |
![]() | BorderColor | Gets or sets the color of the border of a shape or line control. (Inherited from Shape.) |
![]() | BorderStyle | Gets or sets the border style for a shape or line control. (Inherited from Shape.) |
![]() | BorderWidth | Gets or sets the width of the shape control's border. (Inherited from SimpleShape.) |
![]() | Bottom | Gets the distance, in pixels, between the bottom edge of the shape and the top edge of its container's client area. (Inherited from SimpleShape.) |
![]() | Bounds | Gets or sets the size and location of the shape in pixels, relative to the parent control. (Inherited from SimpleShape.) |
![]() | CanFocus | Gets a value indicating whether a line or shape control can receive focus. (Inherited from Shape.) |
![]() | CanRaiseEvents | Gets a value indicating whether the component can raise an event. (Inherited from Component.) |
![]() | CanSelect | Gets a value indicating whether a line or shape control can be selected. (Inherited from Shape.) |
![]() | ClientRectangle | Gets the rectangle that represents the client area of the shape. (Inherited from SimpleShape.) |
![]() | ClientSize | Gets or sets the height and width of the client area of the shape. (Inherited from SimpleShape.) |
![]() | Container | Gets the IContainer that contains the Component. (Inherited from Shape.) |
![]() | ContainsFocus | Gets a value indicating whether a line or shape control currently has the input focus. (Inherited from Shape.) |
![]() | ContextMenu | Gets or sets the shortcut menu associated with a line or shape control. (Inherited from Shape.) |
![]() | ContextMenuStrip | Gets or sets the ContextMenuStrip associated with a line or shape control. (Inherited from Shape.) |
![]() | CornerRadius | Gets or sets the radius for the corners of rounded rectangle and rounded square shapes. |
![]() | Created | Gets a value indicating whether a line or shape control has been created. (Inherited from Shape.) |
![]() | Cursor | Gets or sets the cursor that is displayed when the mouse pointer is resting on a line or shape control. (Inherited from Shape.) |
![]() | DesignMode | Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.) |
![]() | DisplayRectangle | Gets the rectangle that represents the display area of the shape. (Inherited from SimpleShape.) |
![]() | Disposing | Gets a value indicating whether the base Shape class is disposing. (Inherited from Shape.) |
![]() | Enabled | Gets or sets a value indicating whether a line or shape control can respond to user interaction. (Inherited from Shape.) |
![]() | Events | Gets the list of event handlers that are attached to this Component. (Inherited from Component.) |
![]() | FillColor | Gets or sets the color that is used to fill the shape. (Inherited from SimpleShape.) |
![]() | FillGradientColor | Gets or sets the gradient color that is used to fill the shape. (Inherited from SimpleShape.) |
![]() | FillGradientStyle | Gets or sets the gradient style that is used to fill the shape. (Inherited from SimpleShape.) |
![]() | FillStyle | Gets or sets the pattern used to fill the shape. (Inherited from SimpleShape.) |
![]() | Focused | Gets a value indicating whether a line or shape control currently has the input focus. (Inherited from Shape.) |
![]() | Height | Gets or sets the height of the shape. (Inherited from SimpleShape.) |
![]() | IsAccessible | Gets or sets a value indicating whether a line or shape control is available to accessibility applications. (Inherited from Shape.) |
![]() | IsDisposed | Gets a value indicating whether a line or shape control has been disposed of. (Inherited from Shape.) |
![]() | Left | Gets or sets the distance, in pixels, between the left edge of the shape and the left edge of its container's client area. (Inherited from SimpleShape.) |
![]() | Location | Gets or sets the coordinates of the upper-left corner of the shape relative to the upper-left corner of its container. (Inherited from SimpleShape.) |
![]() | Name | Gets or sets the name of a line or shape control. (Inherited from Shape.) |
![]() | Parent | Gets or sets the parent container of a line or shape control. (Inherited from Shape.) |
![]() | Region | Gets or sets the window region associated with a line or shape control. (Inherited from Shape.) |
![]() | Right | Gets the distance, in pixels, between the right edge of the shape and the left edge of its container's client area. (Inherited from SimpleShape.) |
![]() | SelectionColor | Gets or sets the selection color of a shape. (Inherited from Shape.) |
![]() | Site | Gets or sets the ISite of the Component. (Inherited from Component.) |
![]() | Size | Gets or sets the height and width of the shape. (Inherited from SimpleShape.) |
![]() | Tag | Gets or sets the object that contains data about a line or shape control. (Inherited from Shape.) |
![]() | Top | Gets or sets the distance, in pixels, between the top edge of the shape and the left edge of its container's client area. (Inherited from SimpleShape.) |
![]() | UseWaitCursor | Gets or sets a value indicating whether to use the wait cursor for the current line or shape control. (Inherited from Shape.) |
![]() | Visible | Gets or sets a value indicating whether a line or shape control is displayed. (Inherited from Shape.) |
![]() | Width | Gets or sets the width of the shape. (Inherited from SimpleShape.) |
| Name | Description | |
|---|---|---|
![]() | BringToFront | Brings a line or shape control to the front of the z-order. (Inherited from Shape.) |
![]() | CreateAccessibilityInstance | Creates a new accessibility object for the shape control. (Inherited from SimpleShape.) |
![]() | CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) |
![]() | Dispose | Releases all resources used by the Component. (Inherited from Component.) |
![]() | Dispose(Boolean) | Releases the unmanaged resources used by a line or shape control and optionally releases the managed resources. (Inherited from Shape.) |
![]() | DrawToBitmap | Supports rendering to the specified bitmap. (Inherited from SimpleShape.) |
![]() | Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.) |
![]() | FindForm | Retrieves the form that a line or shape control is on. (Inherited from Shape.) |
![]() | Focus | Sets input focus to a line or shape control. (Inherited from Shape.) |
![]() | GetContainerControl | Returns the next ContainerControl up in a line or shape control's chain of parent controls. (Inherited from Shape.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
![]() | GetService | Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | Hide | Conceals a line or shape control from the user. (Inherited from Shape.) |
![]() | HitTest | Determines whether a shape control is located at the specified point on the screen. (Inherited from SimpleShape.) |
![]() | InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
![]() | Invalidate | Invalidates a specific region of a line or shape control and causes a paint message to be sent to the control. (Inherited from Shape.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
![]() | OnBackColorChanged | Raises the BackColorChanged event. (Inherited from SimpleShape.) |
![]() | OnBackgroundImageChanged | Raises the BackgroundImageChanged event. (Inherited from SimpleShape.) |
![]() | OnBackgroundImageLayoutChanged | Raises the BackgroundImageLayoutChanged event. (Inherited from SimpleShape.) |
![]() | OnClick | Raises the Click event. (Inherited from Shape.) |
![]() | OnClientSizeChanged | Raises the ClientSizeChanged event. (Inherited from SimpleShape.) |
![]() | OnContextMenuChanged | Raises the ContextMenuChanged event. (Inherited from Shape.) |
![]() | OnContextMenuStripChanged | Raises the ContextMenuStripChanged event. (Inherited from Shape.) |
![]() | OnCursorChanged | Raises the CursorChanged event. (Inherited from Shape.) |
![]() | OnDoubleClick | Raises the DoubleClick event. (Inherited from Shape.) |
![]() | OnEnabledChanged | Raises the EnabledChanged event. (Inherited from Shape.) |
![]() | OnEnter | Raises the Enter event. (Inherited from Shape.) |
![]() | OnGotFocus | Raises the GotFocus event. (Inherited from Shape.) |
![]() | OnInvalidated | Raises the Invalidated event. (Inherited from Shape.) |
![]() | OnKeyDown | Raises the KeyDown event. (Inherited from Shape.) |
![]() | OnKeyPress | Raises the KeyPress event. (Inherited from Shape.) |
![]() | OnKeyUp | Raises the KeyUp event. (Inherited from Shape.) |
![]() | OnLeave | Raises the Leave event. (Inherited from Shape.) |
![]() | OnLocationChanged | Raises the LocationChanged event. (Inherited from SimpleShape.) |
![]() | OnLostFocus | Raises the LostFocus event. (Inherited from Shape.) |
![]() | OnMouseClick | Raises the MouseClick event. (Inherited from Shape.) |
![]() | OnMouseDoubleClick | Raises the MouseDoubleClick event. (Inherited from Shape.) |
![]() | OnMouseDown | Raises the MouseDown event. (Inherited from Shape.) |
![]() | OnMouseEnter | Raises the MouseEnter event. (Inherited from Shape.) |
![]() | OnMouseHover | Raises the MouseHover event. (Inherited from Shape.) |
![]() | OnMouseLeave | Raises the MouseLeave event. (Inherited from Shape.) |
![]() | OnMouseMove | Raises the MouseMove event. (Inherited from Shape.) |
![]() | OnMouseUp | Raises the MouseUp event. (Inherited from Shape.) |
![]() | OnMouseWheel | Raises the MouseWheel event. (Inherited from Shape.) |
![]() | OnMove | Raises the Move event. (Inherited from Shape.) |
![]() | OnPaint | Raises the Paint event. (Inherited from SimpleShape.) |
![]() | OnParentChanged | Raises the ParentChanged event. (Inherited from Shape.) |
![]() | OnPreviewKeyDown | Raises the PreviewKeyDown event. (Inherited from Shape.) |
![]() | OnQueryAccessibilityHelp | Raises the QueryAccessibilityHelp event. (Inherited from Shape.) |
![]() | OnRegionChanged | Raises the RegionChanged event. (Inherited from Shape.) |
![]() | OnResize | Raises the Resize event. (Inherited from SimpleShape.) |
![]() | OnSizeChanged | Raises the SizeChanged event. (Inherited from SimpleShape.) |
![]() | OnVisibleChanged | Raises the VisibleChanged event. (Inherited from Shape.) |
![]() | PointToClient | Computes the location of the specified screen point into client coordinates. (Inherited from Shape.) |
![]() | PointToScreen | Computes the location of the specified client point into screen coordinates. (Inherited from Shape.) |
![]() | RectangleToClient | Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Shape.) |
![]() | RectangleToScreen | Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Shape.) |
![]() | Refresh | Forces a control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Shape.) |
![]() | ResumePaint | Resumes usual painting logic, optionally forcing an immediate layout of pending paint requests. (Inherited from Shape.) |
![]() | Scale | Scales the shape by the specified scaling factor. (Inherited from SimpleShape.) |
![]() | Select | Enables a control. (Inherited from Shape.) |
![]() | SendToBack | Sends a line or shape control to the back of the z-order. (Inherited from Shape.) |
![]() | SetBounds | Sets the bounds of the shape to the specified location and size. (Inherited from SimpleShape.) |
![]() | Show | Displays a shape to the user. (Inherited from Shape.) |
![]() | SuspendPaint | Suspends the painting logic for a shape. (Inherited from Shape.) |
![]() | ToString | Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.) |
![]() | Update | Causes the control to redraw the invalidated regions within its client area. (Inherited from Shape.) |
| Name | Description | |
|---|---|---|
![]() | BackColorChanged | Occurs when the BackColor property of the shape is changed. (Inherited from SimpleShape.) |
![]() | BackgroundImageChanged | Occurs when the BackgroundImage property of a shape is changed. (Inherited from SimpleShape.) |
![]() | BackgroundImageLayoutChanged | Occurs when the BackgroundImageLayout property of a shape is changed. (Inherited from SimpleShape.) |
![]() | ChangeUICues | Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Shape.) |
![]() | Click | Occurs when the shape is clicked. (Inherited from Shape.) |
![]() | ClientSizeChanged | Occurs when the ClientSize property of a shape is changed. (Inherited from SimpleShape.) |
![]() | ContextMenuChanged | Occurs when the value of the ContextMenu property changes. (Inherited from Shape.) |
![]() | ContextMenuStripChanged | Occurs when the value of the ContextMenuStrip property changes. (Inherited from Shape.) |
![]() | CursorChanged | Occurs when the value of the Cursor property changes. (Inherited from Shape.) |
![]() | Disposed | Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.) |
![]() | DoubleClick | Occurs when the shape is double-clicked. (Inherited from Shape.) |
![]() | EnabledChanged | Occurs when the Enabled property value has changed. (Inherited from Shape.) |
![]() | Enter | Occurs when the shape is entered. (Inherited from Shape.) |
![]() | GotFocus | Occurs when the shape receives focus. (Inherited from Shape.) |
![]() | Invalidated | Occurs when a shape's display requires redrawing. (Inherited from Shape.) |
![]() | KeyDown | Occurs when a key is pressed and the shape has focus. (Inherited from Shape.) |
![]() | KeyPress | Occurs when a key is pressed and the shape has focus. (Inherited from Shape.) |
![]() | KeyUp | Occurs when a key is released and the shape has focus. (Inherited from Shape.) |
![]() | Leave | Occurs when the input focus leaves the shape. (Inherited from Shape.) |
![]() | LocationChanged | Occurs when the Location property of a shape is changed. (Inherited from SimpleShape.) |
![]() | LostFocus | Occurs when the shape loses focus. (Inherited from Shape.) |
![]() | MouseClick | Occurs when the shape is clicked by the mouse. (Inherited from Shape.) |
![]() | MouseDoubleClick | Occurs when the shape is double-clicked by the mouse. (Inherited from Shape.) |
![]() | MouseDown | Occurs when the mouse pointer is over the shape and a mouse button is pressed. (Inherited from Shape.) |
![]() | MouseEnter | Occurs when the mouse pointer enters the shape. (Inherited from Shape.) |
![]() | MouseHover | Occurs when the mouse pointer rests on the shape. (Inherited from Shape.) |
![]() | MouseLeave | Occurs when the mouse pointer leaves the shape. (Inherited from Shape.) |
![]() | MouseMove | Occurs when the mouse pointer is moved over the shape. (Inherited from Shape.) |
![]() | MouseUp | Occurs when the mouse pointer is over the shape and a mouse button is released. (Inherited from Shape.) |
![]() | MouseWheel | Occurs when the mouse wheel moves and the shape has focus. (Inherited from Shape.) |
![]() | Move | Occurs when the shape is moved. (Inherited from Shape.) |
![]() | Paint | Occurs when the shape is redrawn. (Inherited from Shape.) |
![]() | ParentChanged | Occurs when the Parent property value changes. (Inherited from Shape.) |
![]() | PreviewKeyDown | Occurs before the KeyDown event when a key is pressed and focus is on the shape. (Inherited from Shape.) |
![]() | QueryAccessibilityHelp | Occurs when an AccessibleObject is providing Help to accessibility applications. (Inherited from Shape.) |
![]() | RegionChanged | Occurs when the value of the Region property changes. (Inherited from Shape.) |
![]() | Resize | Occurs when the size of a shape is changed. (Inherited from SimpleShape.) |
![]() | SizeChanged | Occurs when the Size property of a shape is changed. (Inherited from SimpleShape.) |
![]() | VisibleChanged | Occurs when the Visible property value changes. (Inherited from Shape.) |
The RectangleShape control enables you to draw rectangles on a form or container at design time or run time.
When you add a Line or Shape control to a form or container, an invisible ShapeContainer object is created. The ShapeContainer acts as a drawing surface for the shapes within each container control. Each ShapeContainer has a corresponding ShapeCollection that enables you to iterate through the Line and Shape controls that are contained in the ShapeContainer.
When you create a RectangleShape control at run time, you must also create a ShapeContainer and set the Parent property of the RectangleShape to the ShapeContainer.
The following example creates a ShapeContainer and a RectangleShape, adds them to a form, and displays a rectangle.
private void DrawRectangle() { Microsoft.VisualBasic.PowerPacks.ShapeContainer canvas = new Microsoft.VisualBasic.PowerPacks.ShapeContainer(); Microsoft.VisualBasic.PowerPacks.RectangleShape rect1 = new Microsoft.VisualBasic.PowerPacks.RectangleShape(); // Set the form as the parent of the ShapeContainer. canvas.Parent = this; // Set the ShapeContainer as the parent of the RectangleShape. rect1.Parent = canvas; // Set the location and size of the rectangle. rect1.Left = 10; rect1.Top = 10; rect1.Width = 300; rect1.Height = 100; }
