LineShape Class
Represents a control displayed as a horizontal, vertical, or diagonal line.
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
Microsoft.VisualBasic.PowerPacks.Shape
Microsoft.VisualBasic.PowerPacks.LineShape
Syntax
[ToolboxBitmapAttribute(typeof(LineShape), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")]
public class LineShape : Shape
[ToolboxBitmapAttribute((LineShape^::typeid), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")]
public ref class LineShape : Shape
[<ToolboxBitmapAttribute(typeof(LineShape), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")>]
type LineShape =
class
inherit Shape
end
<ToolboxBitmapAttribute(GetType(LineShape), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")>
Public Class LineShape
Inherits Shape
Constructors
| Name | Description | |
|---|---|---|
.gif "System_CAPS_pubmethod") |
LineShape() | Initializes a new instance of the LineShape class. |
|
LineShape(Int32, Int32, Int32, Int32) | Initializes a new instance of the LineShape class, specifying the coordinates for the line. |
|
LineShape(ShapeContainer) | Initializes a new instance of the LineShape class, specifying the ShapeContainer where it will be parented. |
Properties
| Name | Description | |
|---|---|---|
.jpeg "System_CAPS_pubproperty") |
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.) |
|
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 a line or shape control's border.(Inherited from Shape.) |
|
CanFocus | Gets a value indicating whether a line or shape control can receive focus.(Inherited from Shape.) |
.jpeg "System_CAPS_protproperty") |
CanRaiseEvents | (Inherited from Component.) |
|
CanSelect | Gets a value indicating whether a line or shape control can be selected.(Inherited from Shape.) |
|
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.) |
|
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 | (Inherited from Component.) |
|
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.) |
|
EndPoint | Gets or sets the ending coordinates of a line drawn by a LineShape control. |
|
Events | (Inherited from Component.) |
|
Focused | Gets a value indicating whether a line or shape control currently has the input focus.(Inherited from Shape.) |
|
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.) |
|
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.) |
|
SelectionColor | Gets or sets the selection color of a shape.(Inherited from Shape.) |
|
Site | (Inherited from Component.) |
|
StartPoint | Gets or sets the starting coordinates of a line drawn by a LineShape control. |
|
Tag | Gets or sets the object that contains data about a line or shape control.(Inherited from Shape.) |
|
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.) |
|
X1 | Gets or sets the X coordinate of the starting point of a line drawn by a LineShape control. |
|
X2 | Gets or sets the X coordinate of the ending point of a line drawn by a LineShape control. |
|
Y1 | Gets or sets the Y coordinate of the starting point of a line drawn by a LineShape control. |
|
Y2 | Gets or sets the Y coordinate of the ending point of a line drawn by a LineShape control. |
Methods
| Name | Description | |
|---|---|---|
|
BringToFront() | Brings a line or shape control to the front of the z-order.(Inherited from Shape.) |
.gif "System_CAPS_protmethod") |
CreateAccessibilityInstance() | Creates an object to provide information that accessibility applications use to adjust an application's user interface (UI) for users who have disabilities.(Overrides Shape.CreateAccessibilityInstance().) |
|
CreateObjRef(Type) | (Inherited from MarshalByRefObject.) |
|
Dispose() | (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(Bitmap, Rectangle) | Supports drawing to the specified bitmap.(Overrides Shape.DrawToBitmap(Bitmap, Rectangle).) |
|
Equals(Object) | (Inherited from Object.) |
|
Finalize() | (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() | (Inherited from Object.) |
|
GetLifetimeService() | (Inherited from MarshalByRefObject.) |
|
GetService(Type) | (Inherited from Component.) |
|
GetType() | (Inherited from Object.) |
|
Hide() | Conceals a line or shape control from the user.(Inherited from Shape.) |
|
HitTest(Int32, Int32) | Gets information about the LineShape control at the specified point on the screen.(Overrides Shape.HitTest(Int32, Int32).) |
|
InitializeLifetimeService() | (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() | (Inherited from Object.) |
|
MemberwiseClone(Boolean) | (Inherited from MarshalByRefObject.) |
|
OnClick(EventArgs) | |
|
OnContextMenuChanged(EventArgs) | Raises the ContextMenuChanged event.(Inherited from Shape.) |
|
OnContextMenuStripChanged(EventArgs) | Raises the ContextMenuStripChanged event.(Inherited from Shape.) |
|
OnCursorChanged(EventArgs) | Raises the CursorChanged event.(Inherited from Shape.) |
|
OnDoubleClick(EventArgs) | Raises the DoubleClick event.(Inherited from Shape.) |
|
OnEnabledChanged(EventArgs) | Raises the EnabledChanged event.(Inherited from Shape.) |
|
OnEndPointChanged(EventArgs) | Raises the EndPointChanged event. |
|
OnEnter(EventArgs) | |
|
OnGotFocus(EventArgs) | |
|
OnInvalidated(InvalidateEventArgs) | Raises the Invalidated event.(Inherited from Shape.) |
|
OnKeyDown(KeyEventArgs) | |
|
OnKeyPress(KeyPressEventArgs) | |
|
OnKeyUp(KeyEventArgs) | |
|
OnLeave(EventArgs) | |
|
OnLostFocus(EventArgs) | |
|
OnMouseClick(MouseEventArgs) | Raises the MouseClick event.(Inherited from Shape.) |
|
OnMouseDoubleClick(MouseEventArgs) | Raises the MouseDoubleClick event.(Inherited from Shape.) |
|
OnMouseDown(MouseEventArgs) | |
|
OnMouseEnter(EventArgs) | Raises the MouseEnter event.(Inherited from Shape.) |
|
OnMouseHover(EventArgs) | Raises the MouseHover event.(Inherited from Shape.) |
|
OnMouseLeave(EventArgs) | Raises the MouseLeave event.(Inherited from Shape.) |
|
OnMouseMove(MouseEventArgs) | |
|
OnMouseUp(MouseEventArgs) | |
|
OnMouseWheel(MouseEventArgs) | Raises the MouseWheel event.(Inherited from Shape.) |
|
OnMove(EventArgs) | |
|
OnPaint(PaintEventArgs) | Raises the Paint event.(Overrides Shape.OnPaint(PaintEventArgs).) |
|
OnParentChanged(EventArgs) | Raises the ParentChanged event.(Inherited from Shape.) |
|
OnPreviewKeyDown(PreviewKeyDownEventArgs) | Raises the PreviewKeyDown event.(Inherited from Shape.) |
|
OnQueryAccessibilityHelp(QueryAccessibilityHelpEventArgs) | Raises the QueryAccessibilityHelp event.(Inherited from Shape.) |
|
OnRegionChanged(EventArgs) | Raises the RegionChanged event.(Inherited from Shape.) |
|
OnStartPointChanged(EventArgs) | Raises the StartPointChanged event. |
|
OnVisibleChanged(EventArgs) | Raises the VisibleChanged event.(Inherited from Shape.) |
|
PointToClient(Point) | Computes the location of the specified screen point into client coordinates.(Inherited from Shape.) |
|
PointToScreen(Point) | Computes the location of the specified client point into screen coordinates.(Inherited from Shape.) |
|
RectangleToClient(Rectangle) | Computes the size and location of the specified screen rectangle in client coordinates.(Inherited from Shape.) |
|
RectangleToScreen(Rectangle) | 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(Boolean) | Resumes usual painting logic, optionally forcing an immediate layout of pending paint requests.(Inherited from Shape.) |
|
Scale(SizeF) | Resizes the LineShape control by the specified scaling factor.(Overrides Shape.Scale(SizeF).) |
|
Select() | Enables a control.(Inherited from Shape.) |
|
SendToBack() | Sends a line or shape control to the back of the z-order.(Inherited from Shape.) |
|
Show() | Displays a shape to the user.(Inherited from Shape.) |
|
SuspendPaint() | Suspends the painting logic for a shape.(Inherited from Shape.) |
|
ToString() | (Inherited from Component.) |
|
Update() | Causes the control to redraw the invalidated regions within its client area.(Inherited from Shape.) |
Events
| Name | Description | |
|---|---|---|
.jpeg "System_CAPS_pubevent") |
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.) |
|
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 | (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.) |
|
EndPointChanged | Occurs when the EndPoint property value changes. |
|
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.) |
|
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.) |
|
StartPointChanged | Occurs when the StartPoint property value changes. |
|
VisibleChanged | Occurs when the Visible property value changes.(Inherited from Shape.) |
Remarks
The LineShape control enables you to draw lines 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.
When you create a LineShape control at run time, you must also create a ShapeContainer and set the Parent property of the LineShape to the ShapeContainer.
Examples
The following example creates a ShapeContainer and a LineShape, adds them to a form, and displays a vertical line from the top to the bottom of the form.
Microsoft.VisualBasic.PowerPacks.ShapeContainer canvas =
new Microsoft.VisualBasic.PowerPacks.ShapeContainer();
Microsoft.VisualBasic.PowerPacks.LineShape line1 =
new Microsoft.VisualBasic.PowerPacks.LineShape();
// Set the form as the parent of the ShapeContainer.
canvas.Parent = this;
// Set the ShapeContainer as the parent of the LineShape.
line1.Parent = canvas;
// Set the starting and ending coordinates for the line.
line1.StartPoint = new System.Drawing.Point(this.Width / 2, 0);
line1.EndPoint = new System.Drawing.Point(this.Width / 2, this.Height);
Dim canvas As New Microsoft.VisualBasic.PowerPacks.ShapeContainer
Dim line1 As New Microsoft.VisualBasic.PowerPacks.LineShape
' Set the form as the parent of the ShapeContainer.
canvas.Parent = Me
' Set the ShapeContainer as the parent of the LineShape.
line1.Parent = canvas
' Set the starting and ending coordinates for the line.
line1.StartPoint = New System.Drawing.Point(Me.Width / 2, 0)
line1.EndPoint = New System.Drawing.Point(Me.Width / 2, Me.Height)
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
ShapeContainer
Shape
Microsoft.VisualBasic.PowerPacks Namespace
How to: Draw Shapes with the OvalShape and RectangleShape Controls (Visual Studio)
How to: Draw Lines with the LineShape Control (Visual Studio)
Introduction to the Line and Shape Controls (Visual Studio)
Return to top