LineShape 類別

代表顯示為水平、垂直或對角線的控制項。

繼承階層架構

Object
  MarshalByRefObject
    Component
      Microsoft.VisualBasic.PowerPacks.Shape
        Microsoft.VisualBasic.PowerPacks.LineShape

命名空間：  Microsoft.VisualBasic.PowerPacks
組件：  Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

語法

'宣告
<ToolboxBitmapAttribute(GetType(LineShape), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")> _
Public Class LineShape _
    Inherits Shape

[ToolboxBitmapAttribute(typeof(LineShape), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")]
public class LineShape : Shape

[ToolboxBitmapAttribute(typeof(LineShape), L"Microsoft.VisualBasic.PowerPacks.LineShape.bmp")]
public ref class LineShape : public Shape

[<ToolboxBitmapAttribute(typeof(LineShape), "Microsoft.VisualBasic.PowerPacks.LineShape.bmp")>]
type LineShape =  
    class 
        inherit Shape 
    end

public class LineShape extends Shape

LineShape 類型會公開下列成員。

建構函式

	名稱	描述
	LineShape()	初始化 LineShape 類別的新執行個體。
	LineShape(ShapeContainer)	初始化的新執行個體LineShape類別中，指定ShapeContainer成為父系。
	LineShape(Int32, Int32, Int32, Int32)	初始化的新執行個體LineShape類別，指定線條座標。

回頁首

屬性

	名稱	描述
	AccessibilityObject	取得AccessibleObject，指派給控制項。 (繼承自 Shape)。
	AccessibleDefaultActionDescription	取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承自 Shape)。
	AccessibleDescription	取得或設定協助用戶端應用程式所使用之控制項的描述。 (繼承自 Shape)。
	AccessibleName	取得或設定協助工具用戶端應用程式所使用之控制項的名稱。 (繼承自 Shape)。
	AccessibleRole	取得或設定控制項的可存取角色。 (繼承自 Shape)。
	Anchor	取得或設定圖形繫結至的容器邊緣，並決定圖形隨其父代重新調整大小的方式。 (繼承自 Shape)。
	BorderColor	取得或設定圖形或線條控制項的框線色彩。 (繼承自 Shape)。
	BorderStyle	取得或設定形狀或線條控制項的框線樣式。 (繼承自 Shape)。
	BorderWidth	取得或設定線條或圖形控制項的框線寬度。 (繼承自 Shape)。
	CanFocus	取得表示線條或圖形控制項是否能收到焦點的值。 (繼承自 Shape)。
	CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承自 Component)。
	CanSelect	取得表示能否選取線條或圖形控制項的值。 (繼承自 Shape)。
	Container	取得包含 Component 的 IContainer。 (繼承自 Shape)。
	ContainsFocus	取得指出行或圖形控制項目前是否擁有輸入焦點的值。 (繼承自 Shape)。
	ContextMenu	取得或設定與線條或圖形控制項關聯的捷徑功能表。 (繼承自 Shape)。
	ContextMenuStrip	取得或設定ContextMenuStrip線條或圖形控制項相關聯。 (繼承自 Shape)。
	Created	取得表示是否已建立線條或圖形控制項的值。 (繼承自 Shape)。
	Cursor	取得或設定滑鼠指標位於線條或圖形控制項上時顯示的游標。 (繼承自 Shape)。
	DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承自 Component)。
	Disposing	取得值，指出是否基底Shape在處置類別。 (繼承自 Shape)。
	Enabled	取得或設定值，表示線條或圖形控制項是否可回應使用者互動。 (繼承自 Shape)。
	EndPoint	取得或設定繪製線條的結束座標LineShape控制項。
	Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承自 Component)。
	Focused	取得指出行或圖形控制項目前是否擁有輸入焦點的值。 (繼承自 Shape)。
	IsAccessible	取得或設定值，表示協助工具應用程式是否能使用線條或圖形控制項。 (繼承自 Shape)。
	IsDisposed	取得表示是否已處置線條或圖形控制項的值。 (繼承自 Shape)。
	Name	取得或設定線條或圖形控制項的名稱。 (繼承自 Shape)。
	Parent	取得或設定線條或圖形控制項的父容器。 (繼承自 Shape)。
	Region	取得或設定與線條或圖形控制項關聯的視窗區域。 (繼承自 Shape)。
	SelectionColor	取得或設定圖形的選取範圍色彩。 (繼承自 Shape)。
	Site	取得或設定 Component 的 ISite。 (繼承自 Component)。
	StartPoint	取得或設定由繪製一條線的起始座標LineShape控制項。
	Tag	取得或設定物件，其包含線條或圖形控制項的資料。 (繼承自 Shape)。
	UseWaitCursor	取得或設定值，表示是否將等待游標用於目前的線條或圖形控制項。 (繼承自 Shape)。
	Visible	取得或設定值，表示是否顯示線條或圖形控制項。 (繼承自 Shape)。
	X1	取得或設定由繪製一條線的起始點的 X 座標LineShape控制項。
	X2	取得或設定繪製線條的結束點的 X 座標LineShape控制項。
	Y1	取得或設定由繪製一條線的起始點的 Y 座標LineShape控制項。
	Y2	取得或設定繪製線條的結束點的 Y 座標LineShape控制項。

回頁首

方法

	名稱	描述
	BringToFront	將線條或圖形控制項帶到疊置順序的前面。 (繼承自 Shape)。
	CreateAccessibilityInstance	建立提供資訊的物件，讓協助工具應用程式能用於為殘障使用者調整應用程式的使用者介面 (UI)。 (覆寫 Shape.CreateAccessibilityInstance()。)
	CreateObjRef	安全性關鍵。 建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承自 MarshalByRefObject)。
	Dispose	釋放 Component 所使用的所有資源。 (繼承自 Component)。
	Dispose(Boolean)	釋放線條或圖形控制項所使用的 Unmanaged 資源，並選擇是否要釋放 Managed 資源。 (繼承自 Shape)。
	DrawToBitmap	支援繪製為指定的點陣圖。 (覆寫 Shape.DrawToBitmap(Bitmap, Rectangle)。)
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	釋出 Unmanaged 資源並執行其他清除作業後，記憶體回收才能重新回收 Component。 (繼承自 Component)。
	FindForm	擷取線條或圖形控制項所在的表單。 (繼承自 Shape)。
	Focus	設定線條或圖形控制項的輸入焦點。 (繼承自 Shape)。
	GetContainerControl	傳回下ContainerControl的列或圖形控制項的父控制項的鏈結。 (繼承自 Shape)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetLifetimeService	安全性關鍵。 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承自 MarshalByRefObject)。
	GetService	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承自 Component)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	Hide	對使用者隱藏線條或圖形控制項。 (繼承自 Shape)。
	HitTest	取得的資訊LineShape在螢幕上指定點上的控制項。 (覆寫 Shape.HitTest(Int32, Int32)。)
	InitializeLifetimeService	安全性關鍵。 取得存留期服務物件來控制這個執行個體的存留期原則。 (繼承自 MarshalByRefObject)。
	Invalidate	使線條或圖形控制項的特定區域失效，並且傳送繪製訊息至控制項。 (繼承自 Shape)。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承自 MarshalByRefObject)。
	OnClick	引發 Click 事件。 (繼承自 Shape)。
	OnContextMenuChanged	引發 ContextMenuChanged 事件。 (繼承自 Shape)。
	OnContextMenuStripChanged	引發 ContextMenuStripChanged 事件。 (繼承自 Shape)。
	OnCursorChanged	引發 CursorChanged 事件。 (繼承自 Shape)。
	OnDoubleClick	引發 DoubleClick 事件。 (繼承自 Shape)。
	OnEnabledChanged	引發 EnabledChanged 事件。 (繼承自 Shape)。
	OnEndPointChanged	引發 EndPointChanged 事件。
	OnEnter	引發 Enter 事件。 (繼承自 Shape)。
	OnGotFocus	引發 GotFocus 事件。 (繼承自 Shape)。
	OnInvalidated	引發 Invalidated 事件。 (繼承自 Shape)。
	OnKeyDown	引發 KeyDown 事件。 (繼承自 Shape)。
	OnKeyPress	引發 KeyPress 事件。 (繼承自 Shape)。
	OnKeyUp	引發 KeyUp 事件。 (繼承自 Shape)。
	OnLeave	引發 Leave 事件。 (繼承自 Shape)。
	OnLostFocus	引發 LostFocus 事件。 (繼承自 Shape)。
	OnMouseClick	引發 MouseClick 事件。 (繼承自 Shape)。
	OnMouseDoubleClick	引發 MouseDoubleClick 事件。 (繼承自 Shape)。
	OnMouseDown	引發 MouseDown 事件。 (繼承自 Shape)。
	OnMouseEnter	引發 MouseEnter 事件。 (繼承自 Shape)。
	OnMouseHover	引發 MouseHover 事件。 (繼承自 Shape)。
	OnMouseLeave	引發 MouseLeave 事件。 (繼承自 Shape)。
	OnMouseMove	引發 MouseMove 事件。 (繼承自 Shape)。
	OnMouseUp	引發 MouseUp 事件。 (繼承自 Shape)。
	OnMouseWheel	引發 MouseWheel 事件。 (繼承自 Shape)。
	OnMove	引發 Move 事件。 (繼承自 Shape)。
	OnPaint	引發 Paint 事件。 (覆寫 Shape.OnPaint(PaintEventArgs)。)
	OnParentChanged	引發 ParentChanged 事件。 (繼承自 Shape)。
	OnPreviewKeyDown	引發 PreviewKeyDown 事件。 (繼承自 Shape)。
	OnQueryAccessibilityHelp	引發 QueryAccessibilityHelp 事件。 (繼承自 Shape)。
	OnRegionChanged	引發 RegionChanged 事件。 (繼承自 Shape)。
	OnStartPointChanged	引發 StartPointChanged 事件。
	OnVisibleChanged	引發 VisibleChanged 事件。 (繼承自 Shape)。
	PointToClient	將指定的螢幕點的位置計算為工作區座標 (Client Coordinate)。 (繼承自 Shape)。
	PointToScreen	將指定的工作區點的位置計算為螢幕座標。 (繼承自 Shape)。
	RectangleToClient	以工作區座標計算指定的螢幕矩形大小和位置。 (繼承自 Shape)。
	RectangleToScreen	以螢幕座標計算指定的工作區矩形大小和位置。 (繼承自 Shape)。
	Refresh	強制控制項使其工作區失效，並且立即重繪其本身和任何子控制項。 (繼承自 Shape)。
	ResumePaint	繼續平常的繪製邏輯，選擇是否強制暫止中的繪製要求進行立即配置。 (繼承自 Shape)。
	Scale	調整LineShape所指定的縮放比例的控制項。 (覆寫 Shape.Scale(SizeF)。)
	Select	啟用控制項。 (繼承自 Shape)。
	SendToBack	將線條或圖形控制項傳到疊置順序的後面。 (繼承自 Shape)。
	Show	對使用者顯示圖形。 (繼承自 Shape)。
	SuspendPaint	暫停圖形的繪製邏輯。 (繼承自 Shape)。
	ToString	傳回 String，其中可能含有 Component 的名稱。這個方法不應該被覆寫。 (繼承自 Component)。
	Update	使控制項重繪其工作區內的失效區域。 (繼承自 Shape)。

回頁首

事件

	名稱	描述
	ChangeUICues	發生於焦點或鍵盤使用者介面 (UI) 提示變更時。 (繼承自 Shape)。
	Click	發生於按下圖形時。 (繼承自 Shape)。
	ContextMenuChanged	會在 ContextMenu 屬性的值變更時發生。 (繼承自 Shape)。
	ContextMenuStripChanged	會在 ContextMenuStrip 屬性的值變更時發生。 (繼承自 Shape)。
	CursorChanged	會在 Cursor 屬性的值變更時發生。 (繼承自 Shape)。
	Disposed	當此元件由 Dispose 方法的呼叫處置時發生。 (繼承自 Component)。
	DoubleClick	發生於按兩下圖形時。 (繼承自 Shape)。
	EnabledChanged	當 Enabled 屬性值變更時發生。 (繼承自 Shape)。
	EndPointChanged	發生在 EndPoint 屬性值變更時。
	Enter	發生於進入圖形時。 (繼承自 Shape)。
	GotFocus	發生於圖形取得焦點時。 (繼承自 Shape)。
	Invalidated	發生於圖形的顯示要求重繪時。 (繼承自 Shape)。
	KeyDown	發生於按下按鍵且焦點在圖形時。 (繼承自 Shape)。
	KeyPress	發生於按下按鍵且焦點在圖形時。 (繼承自 Shape)。
	KeyUp	發生於放開按鍵且焦點在圖形時。 (繼承自 Shape)。
	Leave	發生於輸入焦點離開圖形時。 (繼承自 Shape)。
	LostFocus	發生於圖形失去焦點時發生。 (繼承自 Shape)。
	MouseClick	發生於使用滑鼠按下圖形時。 (繼承自 Shape)。
	MouseDoubleClick	發生於使用滑鼠按兩下圖形時。 (繼承自 Shape)。
	MouseDown	發生於滑鼠指標位於圖形上並按下滑鼠按鈕時。 (繼承自 Shape)。
	MouseEnter	發生於滑鼠指標進入圖形時。 (繼承自 Shape)。
	MouseHover	發生於滑鼠指標停留在圖形上時。 (繼承自 Shape)。
	MouseLeave	發生於滑鼠指標離開圖案。 (繼承自 Shape)。
	MouseMove	發生於滑鼠指標移至圖形上時。 (繼承自 Shape)。
	MouseUp	發生於滑鼠指標位於圖形上並放開滑鼠按鈕時。 (繼承自 Shape)。
	MouseWheel	發生於滑鼠滾輪移動且焦點在圖形時。 (繼承自 Shape)。
	Move	發生於圖形移動時。 (繼承自 Shape)。
	Paint	發生於圖形重繪時。 (繼承自 Shape)。
	ParentChanged	發生在 Parent 屬性值變更時。 (繼承自 Shape)。
	PreviewKeyDown	發生於之前KeyDown事件時按下按鍵和焦點是在圖形上。 (繼承自 Shape)。
	QueryAccessibilityHelp	發生於 AccessibleObject 為協助工具應用程式提供說明時。 (繼承自 Shape)。
	RegionChanged	會在 Region 屬性的值變更時發生。 (繼承自 Shape)。
	StartPointChanged	發生在 StartPoint 屬性值變更時。
	VisibleChanged	發生在 Visible 屬性值變更時。 (繼承自 Shape)。

回頁首

備註

LineShape控制項可讓您在表單或容器上繪製線條，在設計階段或執行階段。

當您將線條或圖形控制項加入表單或容器時，不會顯示ShapeContainer建立物件。 ShapeContainer做為圖形內的每個容器控制項 ； 繪圖介面每個ShapeContainer都有對應ShapeCollection，可讓您逐一查看 Line 和 Shape 控制項。

當您建立LineShape控制項在執行階段，您還必須建立ShapeContainer並設定Parent屬性LineShape至ShapeContainer。

範例

下列範例會建立ShapeContainer和LineShape、 將它們加入至表單，並顯示一條垂直線從上至表單底部。

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)

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);

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualBasic.PowerPacks 命名空間

ShapeContainer

Shape

其他資源

如何：使用 OvalShape 和 RectangleShape 控制項繪製圖案 (Visual Studio)

如何：使用 LineShape 控制項繪製線條 (Visual Studio)

Line 和 Shape 控制項簡介 (Visual Studio)