ShapeContainer Class
Provides a container for LineShape, OvalShape, RectangleShape controls, and for any other control that derives from Shape.
Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.ContainerControl
System.Windows.Forms.UserControl
Microsoft.VisualBasic.PowerPacks.ShapeContainer
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
Syntax
'Declaration
<BrowsableAttribute(False)> _
Public NotInheritable Class ShapeContainer _
Inherits UserControl
[BrowsableAttribute(false)]
public sealed class ShapeContainer : UserControl
[BrowsableAttribute(false)]
public ref class ShapeContainer sealed : public UserControl
[<Sealed>]
[<BrowsableAttribute(false)>]
type ShapeContainer =
class
inherit UserControl
end
public final class ShapeContainer extends UserControl
The ShapeContainer type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
ShapeContainer | Initializes a new instance of the ShapeContainer class. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
AccessibilityObject | Gets the AccessibleObject assigned to the control. (Inherited from Control.) |
|
AccessibleDefaultActionDescription | Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.) |
|
AccessibleDescription | Gets or sets the description of the control used by accessibility client applications. (Inherited from Control.) |
|
AccessibleName | Gets or sets the name of the control used by accessibility client applications. (Inherited from Control.) |
|
AccessibleRole | Gets or sets the accessible role of the ShapeContainer. |
|
ActiveControl | Gets or sets the active control on the container control. (Inherited from ContainerControl.) |
|
AllowDrop | Gets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control.) |
|
Anchor | Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. (Inherited from Control.) |
|
AutoScaleDimensions | Gets or sets the dimensions that the control was designed to. (Inherited from ContainerControl.) |
|
AutoScaleMode | Gets or sets the automatic scaling mode of the control. (Inherited from ContainerControl.) |
|
AutoScroll | Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. (Inherited from ScrollableControl.) |
|
AutoScrollMargin | Gets or sets the size of the auto-scroll margin. (Inherited from ScrollableControl.) |
|
AutoScrollMinSize | Gets or sets the minimum size of the auto-scroll. (Inherited from ScrollableControl.) |
|
AutoScrollOffset | Gets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.) |
|
AutoScrollPosition | Gets or sets the location of the auto-scroll position. (Inherited from ScrollableControl.) |
|
AutoSize | This property is not relevant for this class. (Inherited from UserControl.) |
|
AutoSizeMode | Gets or sets how the control will resize itself. (Inherited from UserControl.) |
|
AutoValidate | Gets or sets how the control performs validation when the user changes focus to another control. (Inherited from UserControl.) |
|
BackColor | Gets or sets the background color for the control. (Inherited from Control.) |
|
BackgroundImage | Gets or sets the background image displayed in the control. (Inherited from Control.) |
|
BackgroundImageLayout | Gets or sets the background image layout as defined in the ImageLayout enumeration. (Inherited from Control.) |
|
BindingContext | Gets or sets the BindingContext for the control. (Inherited from ContainerControl.) |
|
BorderStyle | Gets or sets the border style of the user control. (Inherited from UserControl.) |
|
Bottom | Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. (Inherited from Control.) |
|
Bounds | Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control.) |
|
CanFocus | Gets a value indicating whether the control can receive focus. (Inherited from Control.) |
|
CanSelect | Gets a value indicating whether the control can be selected. (Inherited from Control.) |
|
Capture | Gets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.) |
|
CausesValidation | Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. (Inherited from Control.) |
|
ClientRectangle | Gets the rectangle that represents the client area of the control. (Inherited from Control.) |
|
ClientSize | Gets or sets the height and width of the client area of the control. (Inherited from Control.) |
|
CompanyName | Gets the name of the company or creator of the application containing the control. (Inherited from Control.) |
|
Container | Gets the IContainer that contains the Component. (Inherited from Component.) |
|
ContainsFocus | Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.) |
|
ContextMenu | Gets or sets the shortcut menu associated with the control. (Inherited from Control.) |
|
ContextMenuStrip | Gets or sets the ContextMenuStrip associated with this control. (Inherited from Control.) |
|
Controls | Gets the collection of controls contained within the control. (Inherited from Control.) |
|
Created | Gets a value indicating whether the control has been created. (Inherited from Control.) |
|
CurrentAutoScaleDimensions | Gets the current run-time dimensions of the screen. (Inherited from ContainerControl.) |
|
Cursor | Gets or sets the cursor that is displayed when the mouse pointer is over a ShapeContainer. (Overrides Control.Cursor.) |
|
DataBindings | Gets the data bindings for the control. (Inherited from Control.) |
|
DisplayRectangle | Gets the rectangle that represents the virtual display area of the control. (Inherited from ScrollableControl.) |
|
Disposing | Gets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.) |
|
Dock | Gets or sets which control borders are docked to the parent control and determines how a control is resized when its parent is resized. (Overrides Control.Dock.) |
|
DockPadding | Gets the dock padding settings for all edges of the control. (Inherited from ScrollableControl.) |
|
Enabled | Gets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control.) |
|
Focused | Gets a value indicating whether the control has input focus. (Inherited from Control.) |
|
Font | Gets or sets the font of the text displayed by the control. (Inherited from Control.) |
|
ForeColor | Gets or sets the foreground color of the control. (Inherited from Control.) |
|
Handle | Gets the window handle that the control is bound to. (Inherited from Control.) |
|
HasChildren | Gets a value indicating whether the control contains one or more child controls. (Inherited from Control.) |
|
Height | Gets or sets the height of the control. (Inherited from Control.) |
|
HorizontalScroll | Gets the characteristics associated with the horizontal scroll bar. (Inherited from ScrollableControl.) |
|
ImeMode | Gets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control.) |
|
InvokeRequired | Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. (Inherited from Control.) |
|
IsAccessible | Gets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.) |
|
IsDisposed | Gets a value indicating whether the control has been disposed of. (Inherited from Control.) |
|
IsHandleCreated | Gets a value indicating whether the control has a handle associated with it. (Inherited from Control.) |
|
IsMirrored | Gets a value indicating whether the control is mirrored. (Inherited from Control.) |
|
LayoutEngine | Gets a cached instance of the control's layout engine. (Inherited from Control.) |
|
Left | Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. (Inherited from Control.) |
|
Location | Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. (Inherited from Control.) |
|
Margin | Gets or sets the space between controls. (Inherited from Control.) |
|
MaximumSize | Gets or sets the size that is the upper limit that GetPreferredSize can specify. (Inherited from Control.) |
|
MinimumSize | Gets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.) |
|
Name | Gets or sets the name of the control. (Inherited from Control.) |
|
Padding | Gets or sets padding within the control. (Inherited from Control.) |
|
Parent | Gets or sets the parent container of the control. (Inherited from Control.) |
|
ParentForm | Gets the form that the container control is assigned to. (Inherited from ContainerControl.) |
|
PreferredSize | Gets the size of a rectangular area into which the control can fit. (Inherited from Control.) |
|
ProductName | Gets the product name of the assembly containing the control. (Inherited from Control.) |
|
ProductVersion | Gets the version of the assembly containing the control. (Inherited from Control.) |
|
RecreatingHandle | Gets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.) |
|
Region | Gets or sets the window region associated with the control. (Inherited from Control.) |
.gif "Protected property") |
RenderRightToLeft | Obsolete. This property is now obsolete. (Inherited from Control.) |
|
Right | Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. (Inherited from Control.) |
|
RightToLeft | Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from Control.) |
|
Shapes | Gets the collection of shapes that are contained in the ShapeContainer. |
|
ShowFocusCues | Gets a value indicating whether the control should display focus rectangles. (Inherited from Control.) |
|
ShowKeyboardCues | Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control.) |
|
Site | Gets or sets the site of the control. (Inherited from Control.) |
|
Size | Gets or sets the height and width of the control. (Inherited from Control.) |
|
TabIndex | Gets or sets the tab order of the control within its container. (Inherited from Control.) |
|
TabStop | Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.) |
|
Tag | Gets or sets the object that contains data about the control. (Inherited from Control.) |
|
Text | Gets or sets the text associated with this control. (Inherited from UserControl.) |
|
Top | Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area. (Inherited from Control.) |
|
TopLevelControl | Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. (Inherited from Control.) |
|
UseWaitCursor | Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control.) |
|
VerticalScroll | Gets the characteristics associated with the vertical scroll bar. (Inherited from ScrollableControl.) |
|
Visible | Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.) |
|
Width | Gets or sets the width of the control. (Inherited from Control.) |
|
WindowTarget | Infrastructure. This property is not relevant for this class. (Inherited from Control.) |
Top
Methods
| Name | Description | |
|---|---|---|
.gif "Protected method") |
AccessibilityNotifyClients | Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.) |
|
BeginInvoke(Delegate) | Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.) |
|
BeginInvoke(Delegate, array<Object[]) | Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control.) |
|
BringToFront | Brings the control to the front of the z-order. (Inherited from Control.) |
|
Contains | Retrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.) |
|
CreateControl | Forces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.) |
|
CreateGraphics | Creates the Graphics for the control. (Inherited from Control.) |
|
CreateObjRef | Security Critical. 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.) |
|
DoDragDrop | Begins a drag-and-drop operation. (Inherited from Control.) |
|
DrawToBitmap | Supports rendering to the specified bitmap. (Inherited from Control.) |
|
EndInvoke | Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.) |
|
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
|
FindForm | Retrieves the form that the control is on. (Inherited from Control.) |
|
Focus | Sets input focus to the control. (Inherited from Control.) |
|
GetChildAtPoint(Point) | Gets the shape that is located at the specified coordinates. |
|
GetChildAtPoint(Point, GetChildAtPointSkip) | Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control.) |
|
GetContainerControl | Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.) |
|
GetHashCode | Serves as the default hash function. (Inherited from Object.) |
|
GetLifetimeService | Security Critical. Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
|
GetNextControl | Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control.) |
|
GetNextShape | Retrieves the next or previous shape in the order of the ShapeCollection. |
|
GetPreferredSize | Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.) |
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
Hide | Conceals the control from the user. (Inherited from Control.) |
|
InitializeLifetimeService | Security Critical. Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
|
Invalidate() | Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control.) |
|
Invalidate(Region) | Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.) |
|
Invalidate(Boolean) | Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.) |
|
Invalidate(Rectangle) | Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.) |
|
Invalidate(Region, Boolean) | Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.) |
|
Invalidate(Rectangle, Boolean) | Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.) |
|
Invoke(Delegate) | Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.) |
|
Invoke(Delegate, array<Object[]) | Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control.) |
|
PerformAutoScale | Performs scaling of the container control and its children. (Inherited from ContainerControl.) |
|
PerformLayout() | Forces the control to apply layout logic to all its child controls. (Inherited from Control.) |
|
PerformLayout(Control, String) | Forces the control to apply layout logic to all its child controls. (Inherited from Control.) |
|
PointToClient | Computes the location of the specified screen point into client coordinates. (Inherited from Control.) |
|
PointToScreen | Computes the location of the specified client point into screen coordinates. (Inherited from Control.) |
|
PreProcessControlMessage | Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.) |
|
PreProcessMessage | Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.) |
|
ProcessKeyMessage | Processes a keyboard message. (Inherited from Control.) |
|
ProcessMnemonic | Infrastructure. Processes a mnemonic character. (Inherited from ContainerControl.) |
|
RectangleToClient | Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.) |
|
RectangleToScreen | Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.) |
|
Refresh | Forces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Control.) |
|
ResetBackColor | Resets the BackColor property to its default value. (Inherited from Control.) |
|
ResetBindings | Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.) |
|
ResetCursor | Resets the Cursor property to its default value. (Inherited from Control.) |
|
ResetFont | Resets the Font property to its default value. (Inherited from Control.) |
|
ResetForeColor | Resets the ForeColor property to its default value. (Inherited from Control.) |
|
ResetImeMode | Resets the ImeMode property to its default value. (Inherited from Control.) |
|
ResetRightToLeft | Resets the RightToLeft property to its default value. (Inherited from Control.) |
|
ResetText | Resets the Text property to its default value. (Inherited from Control.) |
|
ResumeLayout() | Resumes usual layout logic. (Inherited from Control.) |
|
ResumeLayout(Boolean) | Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.) |
|
RtlTranslateContent | Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.) |
|
Scale(Single) | Obsolete. Scales the control and any child controls. (Inherited from Control.) |
|
Scale(SizeF) | Scales the control and all child controls by the specified scaling factor. (Inherited from Control.) |
|
Scale(Single, Single) | Obsolete. Scales the entire control and any child controls. (Inherited from Control.) |
|
ScrollControlIntoView | Scrolls the specified child control into view on an auto-scroll enabled control. (Inherited from ScrollableControl.) |
|
Select | Activates the control. (Inherited from Control.) |
|
SelectNextControl | Activates the next control. (Inherited from Control.) |
|
SelectNextShape | Selects the next or previous shape in the order of the ShapeCollection. |
|
SendToBack | Sends the control to the back of the z-order. (Inherited from Control.) |
|
SetAutoScrollMargin | Sets the size of the auto-scroll margins. (Inherited from ScrollableControl.) |
|
SetBounds(Int32, Int32, Int32, Int32) | Sets the bounds of the control to the specified location and size. (Inherited from Control.) |
|
SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified) | Sets the specified bounds of the control to the specified location and size. (Inherited from Control.) |
|
Show | Displays the control to the user. (Inherited from Control.) |
|
SuspendLayout | Temporarily suspends the layout logic for the control. (Inherited from Control.) |
|
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 Control.) |
|
UpdateBounds | Updates the bounds of the control with the current size and location. (Inherited from Control.) |
|
Validate() | Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order. (Inherited from ContainerControl.) |
|
Validate(Boolean) | Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on. (Inherited from ContainerControl.) |
|
ValidateChildren() | Causes all of the child controls within a control that support validation to validate their data. (Inherited from UserControl.) |
|
ValidateChildren(ValidationConstraints) | Causes all of the child controls within a control that support validation to validate their data. (Inherited from UserControl.) |
Top
Events
| Name | Description | |
|---|---|---|
.gif "Public event") |
AutoSizeChanged | Occurs when the AutoSize property changes. (Inherited from UserControl.) |
|
AutoValidateChanged | Occurs when the AutoValidate property changes. (Inherited from UserControl.) |
|
BackColorChanged | Occurs when the value of the BackColor property changes. (Inherited from Control.) |
|
BackgroundImageChanged | Occurs when the value of the BackgroundImage property changes. (Inherited from Control.) |
|
BackgroundImageLayoutChanged | Occurs when the BackgroundImageLayout property changes. (Inherited from Control.) |
|
BindingContextChanged | Occurs when the value of the BindingContext property changes. (Inherited from Control.) |
|
CausesValidationChanged | Occurs when the value of the CausesValidation property changes. (Inherited from Control.) |
|
ChangeUICues | Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control.) |
|
Click | Occurs when the control is clicked. (Inherited from Control.) |
|
ClientSizeChanged | Occurs when the value of the ClientSize property changes. (Inherited from Control.) |
|
ContextMenuChanged | Occurs when the value of the ContextMenu property changes. (Inherited from Control.) |
|
ContextMenuStripChanged | Occurs when the value of the ContextMenuStrip property changes. (Inherited from Control.) |
|
ControlAdded | Occurs when a new control is added to the Control.ControlCollection. (Inherited from Control.) |
|
ControlRemoved | Occurs when a control is removed from the Control.ControlCollection. (Inherited from Control.) |
|
CursorChanged | Occurs when the value of the Cursor property changes. (Inherited from Control.) |
|
Disposed | Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.) |
|
DockChanged | Occurs when the value of the Dock property changes. (Inherited from Control.) |
|
DoubleClick | Occurs when the control is double-clicked. (Inherited from Control.) |
|
DragDrop | Occurs when a drag-and-drop operation is completed. (Inherited from Control.) |
|
DragEnter | Occurs when an object is dragged into the control's bounds. (Inherited from Control.) |
|
DragLeave | Occurs when an object is dragged out of the control's bounds. (Inherited from Control.) |
|
DragOver | Occurs when an object is dragged over the control's bounds. (Inherited from Control.) |
|
EnabledChanged | Occurs when the Enabled property value has changed. (Inherited from Control.) |
|
Enter | Occurs when the control is entered. (Inherited from Control.) |
|
FontChanged | Occurs when the Font property value changes. (Inherited from Control.) |
|
ForeColorChanged | Occurs when the ForeColor property value changes. (Inherited from Control.) |
|
GiveFeedback | Occurs during a drag operation. (Inherited from Control.) |
|
GotFocus | Occurs when the control receives focus. (Inherited from Control.) |
|
HandleCreated | Occurs when a handle is created for the control. (Inherited from Control.) |
|
HandleDestroyed | Occurs when the control's handle is in the process of being destroyed. (Inherited from Control.) |
|
HelpRequested | Occurs when the user requests help for a control. (Inherited from Control.) |
|
ImeModeChanged | Occurs when the ImeMode property has changed. (Inherited from Control.) |
|
Invalidated | Occurs when a control's display requires redrawing. (Inherited from Control.) |
|
KeyDown | Occurs when a key is pressed while the control has focus. (Inherited from Control.) |
|
KeyPress | Occurs when a key is pressed while the control has focus. (Inherited from Control.) |
|
KeyUp | Occurs when a key is released while the control has focus. (Inherited from Control.) |
|
Layout | Occurs when a control should reposition its child controls. (Inherited from Control.) |
|
Leave | Occurs when the input focus leaves the control. (Inherited from Control.) |
|
Load | Occurs before the control becomes visible for the first time. (Inherited from UserControl.) |
|
LocationChanged | Occurs when the Location property value has changed. (Inherited from Control.) |
|
LostFocus | Occurs when the control loses focus. (Inherited from Control.) |
|
MarginChanged | Occurs when the control's margin changes. (Inherited from Control.) |
|
MouseCaptureChanged | Occurs when the control loses mouse capture. (Inherited from Control.) |
|
MouseClick | Occurs when the control is clicked by the mouse. (Inherited from Control.) |
|
MouseDoubleClick | Occurs when the control is double clicked by the mouse. (Inherited from Control.) |
|
MouseDown | Occurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control.) |
|
MouseEnter | Occurs when the mouse pointer enters the control. (Inherited from Control.) |
|
MouseHover | Occurs when the mouse pointer rests on the control. (Inherited from Control.) |
|
MouseLeave | Occurs when the mouse pointer leaves the control. (Inherited from Control.) |
|
MouseMove | Occurs when the mouse pointer is moved over the control. (Inherited from Control.) |
|
MouseUp | Occurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control.) |
|
MouseWheel | Occurs when the mouse wheel moves while the control has focus. (Inherited from Control.) |
|
Move | Occurs when the control is moved. (Inherited from Control.) |
|
PaddingChanged | Occurs when the control's padding changes. (Inherited from Control.) |
|
Paint | Occurs when the control is redrawn. (Inherited from Control.) |
|
ParentChanged | Occurs when the Parent property value changes. (Inherited from Control.) |
|
PreviewKeyDown | Occurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.) |
|
QueryAccessibilityHelp | Occurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control.) |
|
QueryContinueDrag | Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from Control.) |
|
RegionChanged | Occurs when the value of the Region property changes. (Inherited from Control.) |
|
Resize | Occurs when the control is resized. (Inherited from Control.) |
|
RightToLeftChanged | Occurs when the RightToLeft property value changes. (Inherited from Control.) |
|
Scroll | Occurs when the user or code scrolls through the client area. (Inherited from ScrollableControl.) |
|
SizeChanged | Occurs when the Size property value changes. (Inherited from Control.) |
|
StyleChanged | Occurs when the control style changes. (Inherited from Control.) |
|
SystemColorsChanged | Occurs when the system colors change. (Inherited from Control.) |
|
TabIndexChanged | Occurs when the TabIndex property value changes. (Inherited from Control.) |
|
TabStopChanged | Occurs when the TabStop property value changes. (Inherited from Control.) |
|
TextChanged | Infrastructure. Raises the TextChanged event. (Inherited from UserControl.) |
|
Validated | Occurs when the control is finished validating. (Inherited from Control.) |
|
Validating | Occurs when the control is validating. (Inherited from Control.) |
|
VisibleChanged | Occurs when the Visible property value changes. (Inherited from Control.) |
Top
Explicit Interface Implementations
| Name | Description | |
|---|---|---|
.gif "Explicit interface implemetation") .gif "Private method") |
IContainerControl.ActivateControl | Activates the specified control. (Inherited from ContainerControl.) |
|
IDropTarget.OnDragDrop | Infrastructure. Raises the DragDrop event. (Inherited from Control.) |
|
IDropTarget.OnDragEnter | Infrastructure. Raises the DragEnter event. (Inherited from Control.) |
|
IDropTarget.OnDragLeave | Infrastructure. Raises the DragLeave event. (Inherited from Control.) |
|
IDropTarget.OnDragOver | Infrastructure. Raises the DragOver event. (Inherited from Control.) |
Top
Remarks
A LineShape, OvalShape, or RectangleShape control can be contained only in a ShapeContainer object, which acts as a canvas for line and shape controls.
When you add a line or shape to a form or container at design time, a ShapeContainer is automatically created if one does not already exist. The Parent property of the line or shape is set to that ShapeContainer. The Parent property of the ShapeContainer is set to the form or container control to which the line or shape was added.
When you create a line or shape at run time by using the New method, the control's Parent property must be set to a ShapeContainer. If a ShapeContainer already exists for the form or container, you should set the Parent property to that ShapeContainer. If no ShapeContainer exists, you can create a ShapeContainer by using the New method and set its Parent property to the form or container.
Note
Be careful that you do not create more than one ShapeContainer for each form or container; doing this may introduce unexpected behavior. If you add a design-time line or shape control to a form or container after you write code to create one programmatically, you should modify that code to use the ShapeContainer created by the designer.
Examples
The following example checks for an existing ShapeContainer and sets the Parent property of an OvalShape control created at run time by using the New method.
Private Sub Form1_Load() Handles MyBase.Load
Dim NewOval As New OvalShape
Dim i As Integer
Dim found As Boolean
' Loop through the Controls collection.
For i = 0 To Me.Controls.Count - 1
' If a ShapeContainer is found, make it the parent.
If TypeOf Controls.Item(i) Is ShapeContainer Then
NewOval.Parent = Controls.Item(i)
found = True
Exit For
End If
Next
' If no ShapeContainer is found, create one and set the parents.
If found = False Then
Dim sc As New ShapeContainer
sc.Parent = Me
NewOval.Parent = sc
End If
NewOval.Size = New Size(200, 300)
End Sub
private void form1_Load(System.Object sender, System.EventArgs e)
{
OvalShape NewOval = new OvalShape();
int i;
bool found = false;
// Loop through the Controls collection.
for (i = 0; i < this.Controls.Count; i++)
{
// If a ShapeContainer is found, make it the parent.
if (this.Controls[i] is ShapeContainer)
{
NewOval.Parent = ((ShapeContainer)this.Controls[i]);
found = true;
break;
}
}
// If no ShapeContainer is found, create one and set the parents.
if (found == false)
{
ShapeContainer sc = new ShapeContainer();
sc.Parent = this;
NewOval.Parent = sc;
}
NewOval.Size = new Size(200, 300);
}
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
Reference
Microsoft.VisualBasic.PowerPacks Namespace
Other Resources
Introduction to the Line and Shape Controls (Visual Studio)
How to: Draw Lines with the LineShape Control (Visual Studio)
How to: Draw Shapes with the OvalShape and RectangleShape Controls (Visual Studio)