OvalShape 類別

表示顯示為圓形或橢圓形的控制項。

繼承階層架構

Object
  MarshalByRefObject
    Component
      Microsoft.VisualBasic.PowerPacks.Shape
        Microsoft.VisualBasic.PowerPacks.SimpleShape
          Microsoft.VisualBasic.PowerPacks.OvalShape

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

語法

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

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

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

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

public class OvalShape extends SimpleShape

OvalShape 類型會公開下列成員。

建構函式

	名稱	描述
	OvalShape()	初始化 OvalShape 類別的新執行個體。
	OvalShape(ShapeContainer)	初始化 OvalShape 類別的新執行個體，並指定將包含它的 ShapeContainer。
	OvalShape(Int32, Int32, Int32, Int32)	初始化 OvalShape 類別的新執行個體，並指定其位置和大小。

回頁首

屬性

	名稱	描述
	AccessibilityObject	取得AccessibleObject，指派給控制項。 (繼承自 Shape)。
	AccessibleDefaultActionDescription	取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承自 Shape)。
	AccessibleDescription	取得或設定協助用戶端應用程式所使用之控制項的描述。 (繼承自 Shape)。
	AccessibleName	取得或設定協助工具用戶端應用程式所使用之控制項的名稱。 (繼承自 Shape)。
	AccessibleRole	取得或設定控制項的可存取角色。 (繼承自 Shape)。
	Anchor	取得或設定圖形繫結至的容器邊緣，並決定圖形隨其父代重新調整大小的方式。 (繼承自 Shape)。
	BackColor	取得或設定圖形的背景色彩。 (繼承自 SimpleShape)。
	BackgroundImage	取得或設定顯示在圖形中的影像。 (繼承自 SimpleShape)。
	BackgroundImageLayout	取得或設定在 ImageLayout 列舉型別中定義的背景影像配置。 (繼承自 SimpleShape)。
	BackStyle	取得或設定圖形的透明度。 (繼承自 SimpleShape)。
	BorderColor	取得或設定圖形或線條控制項的框線色彩。 (繼承自 Shape)。
	BorderStyle	取得或設定形狀或線條控制項的框線樣式。 (繼承自 Shape)。
	BorderWidth	取得或設定圖形控制項的框線寬度。 (繼承自 SimpleShape)。
	Bottom	取得圖形的下邊緣和其容器的工作區 (Client Area) 上邊緣之間的距離 (以像素為單位)。 (繼承自 SimpleShape)。
	Bounds	取得或設定相對於父控制項的圖形大小和位置 (以像素為單位)。 (繼承自 SimpleShape)。
	CanFocus	取得表示線條或圖形控制項是否能收到焦點的值。 (繼承自 Shape)。
	CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承自 Component)。
	CanSelect	取得表示能否選取線條或圖形控制項的值。 (繼承自 Shape)。
	ClientRectangle	取得代表圖形工作區的矩形。 (繼承自 SimpleShape)。
	ClientSize	取得或設定圖形工作區的高度和寬度。 (繼承自 SimpleShape)。
	Container	取得包含 Component 的 IContainer。 (繼承自 Shape)。
	ContainsFocus	取得指出行或圖形控制項目前是否擁有輸入焦點的值。 (繼承自 Shape)。
	ContextMenu	取得或設定與線條或圖形控制項關聯的捷徑功能表。 (繼承自 Shape)。
	ContextMenuStrip	取得或設定ContextMenuStrip線條或圖形控制項相關聯。 (繼承自 Shape)。
	Created	取得表示是否已建立線條或圖形控制項的值。 (繼承自 Shape)。
	Cursor	取得或設定滑鼠指標位於線條或圖形控制項上時顯示的游標。 (繼承自 Shape)。
	DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承自 Component)。
	DisplayRectangle	取得代表圖形的顯示區域的矩形。 (繼承自 SimpleShape)。
	Disposing	取得值，指出是否基底Shape在處置類別。 (繼承自 Shape)。
	Enabled	取得或設定值，表示線條或圖形控制項是否可回應使用者互動。 (繼承自 Shape)。
	Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承自 Component)。
	FillColor	取得或設定用於填滿圖形的色彩。 (繼承自 SimpleShape)。
	FillGradientColor	取得或設定用於填滿圖形的漸層色彩。 (繼承自 SimpleShape)。
	FillGradientStyle	取得或設定用於填滿圖形的漸層樣式。 (繼承自 SimpleShape)。
	FillStyle	取得或設定用於填滿圖形的圖樣。 (繼承自 SimpleShape)。
	Focused	取得指出行或圖形控制項目前是否擁有輸入焦點的值。 (繼承自 Shape)。
	Height	取得或設定圖形的高度。 (繼承自 SimpleShape)。
	IsAccessible	取得或設定值，表示協助工具應用程式是否能使用線條或圖形控制項。 (繼承自 Shape)。
	IsDisposed	取得表示是否已處置線條或圖形控制項的值。 (繼承自 Shape)。
	Left	取得或設定圖形的左邊緣和其容器的工作區左邊緣之間的距離 (以像素為單位)。 (繼承自 SimpleShape)。
	Location	取得或設定相對於圖形的容器左上角之圖形左上角的座標。 (繼承自 SimpleShape)。
	Name	取得或設定線條或圖形控制項的名稱。 (繼承自 Shape)。
	Parent	取得或設定線條或圖形控制項的父容器。 (繼承自 Shape)。
	Region	取得或設定與線條或圖形控制項關聯的視窗區域。 (繼承自 Shape)。
	Right	取得圖形的右邊緣和其容器的工作區左邊緣之間的距離 (以像素為單位)。 (繼承自 SimpleShape)。
	SelectionColor	取得或設定圖形的選取範圍色彩。 (繼承自 Shape)。
	Site	取得或設定 Component 的 ISite。 (繼承自 Component)。
	Size	取得或設定圖形的高度和寬度。 (繼承自 SimpleShape)。
	Tag	取得或設定物件，其包含線條或圖形控制項的資料。 (繼承自 Shape)。
	Top	取得或設定圖形的上邊緣和其容器的工作區左邊緣之間的距離 (以像素為單位)。 (繼承自 SimpleShape)。
	UseWaitCursor	取得或設定值，表示是否將等待游標用於目前的線條或圖形控制項。 (繼承自 Shape)。
	Visible	取得或設定值，表示是否顯示線條或圖形控制項。 (繼承自 Shape)。
	Width	取得或設定圖形的寬度。 (繼承自 SimpleShape)。

回頁首

方法

	名稱	描述
	BringToFront	將線條或圖形控制項帶到疊置順序的前面。 (繼承自 Shape)。
	CreateAccessibilityInstance	為圖形控制項建立新的協助工具物件。 (繼承自 SimpleShape)。
	CreateObjRef	安全性關鍵。 建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承自 MarshalByRefObject)。
	Dispose	釋放 Component 所使用的所有資源。 (繼承自 Component)。
	Dispose(Boolean)	釋放線條或圖形控制項所使用的 Unmanaged 資源，並選擇是否要釋放 Managed 資源。 (繼承自 Shape)。
	DrawToBitmap	支援呈現為指定的點陣圖。 (繼承自 SimpleShape)。
	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	判斷圖形控制項是否位於螢幕上的指定點。 (繼承自 SimpleShape)。
	InitializeLifetimeService	安全性關鍵。 取得存留期服務物件來控制這個執行個體的存留期原則。 (繼承自 MarshalByRefObject)。
	Invalidate	使線條或圖形控制項的特定區域失效，並且傳送繪製訊息至控制項。 (繼承自 Shape)。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承自 MarshalByRefObject)。
	OnBackColorChanged	引發 BackColorChanged 事件。 (繼承自 SimpleShape)。
	OnBackgroundImageChanged	引發 BackgroundImageChanged 事件。 (繼承自 SimpleShape)。
	OnBackgroundImageLayoutChanged	引發 BackgroundImageLayoutChanged 事件。 (繼承自 SimpleShape)。
	OnClick	引發 Click 事件。 (繼承自 Shape)。
	OnClientSizeChanged	引發 ClientSizeChanged 事件。 (繼承自 SimpleShape)。
	OnContextMenuChanged	引發 ContextMenuChanged 事件。 (繼承自 Shape)。
	OnContextMenuStripChanged	引發 ContextMenuStripChanged 事件。 (繼承自 Shape)。
	OnCursorChanged	引發 CursorChanged 事件。 (繼承自 Shape)。
	OnDoubleClick	引發 DoubleClick 事件。 (繼承自 Shape)。
	OnEnabledChanged	引發 EnabledChanged 事件。 (繼承自 Shape)。
	OnEnter	引發 Enter 事件。 (繼承自 Shape)。
	OnGotFocus	引發 GotFocus 事件。 (繼承自 Shape)。
	OnInvalidated	引發 Invalidated 事件。 (繼承自 Shape)。
	OnKeyDown	引發 KeyDown 事件。 (繼承自 Shape)。
	OnKeyPress	引發 KeyPress 事件。 (繼承自 Shape)。
	OnKeyUp	引發 KeyUp 事件。 (繼承自 Shape)。
	OnLeave	引發 Leave 事件。 (繼承自 Shape)。
	OnLocationChanged	引發 LocationChanged 事件。 (繼承自 SimpleShape)。
	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 事件。 (繼承自 SimpleShape)。
	OnParentChanged	引發 ParentChanged 事件。 (繼承自 Shape)。
	OnPreviewKeyDown	引發 PreviewKeyDown 事件。 (繼承自 Shape)。
	OnQueryAccessibilityHelp	引發 QueryAccessibilityHelp 事件。 (繼承自 Shape)。
	OnRegionChanged	引發 RegionChanged 事件。 (繼承自 Shape)。
	OnResize	引發 Resize 事件。 (繼承自 SimpleShape)。
	OnSizeChanged	引發 SizeChanged 事件。 (繼承自 SimpleShape)。
	OnVisibleChanged	引發 VisibleChanged 事件。 (繼承自 Shape)。
	PointToClient	將指定的螢幕點的位置計算為工作區座標 (Client Coordinate)。 (繼承自 Shape)。
	PointToScreen	將指定的工作區點的位置計算為螢幕座標。 (繼承自 Shape)。
	RectangleToClient	以工作區座標計算指定的螢幕矩形大小和位置。 (繼承自 Shape)。
	RectangleToScreen	以螢幕座標計算指定的工作區矩形大小和位置。 (繼承自 Shape)。
	Refresh	強制控制項使其工作區失效，並且立即重繪其本身和任何子控制項。 (繼承自 Shape)。
	ResumePaint	繼續平常的繪製邏輯，選擇是否強制暫止中的繪製要求進行立即配置。 (繼承自 Shape)。
	Scale	依指定的縮放比例縮放圖形。 (繼承自 SimpleShape)。
	Select	啟用控制項。 (繼承自 Shape)。
	SendToBack	將線條或圖形控制項傳到疊置順序的後面。 (繼承自 Shape)。
	SetBounds	將圖形的邊界設定為指定的位置和大小。 (繼承自 SimpleShape)。
	Show	對使用者顯示圖形。 (繼承自 Shape)。
	SuspendPaint	暫停圖形的繪製邏輯。 (繼承自 Shape)。
	ToString	傳回 String，其中可能含有 Component 的名稱。這個方法不應該被覆寫。 (繼承自 Component)。
	Update	使控制項重繪其工作區內的失效區域。 (繼承自 Shape)。

回頁首

事件

	名稱	描述
	BackColorChanged	發生時BackColor圖案的屬性變更。 (繼承自 SimpleShape)。
	BackgroundImageChanged	發生時BackgroundImage圖形的屬性變更。 (繼承自 SimpleShape)。
	BackgroundImageLayoutChanged	發生時BackgroundImageLayout圖形的屬性變更。 (繼承自 SimpleShape)。
	ChangeUICues	發生於焦點或鍵盤使用者介面 (UI) 提示變更時。 (繼承自 Shape)。
	Click	發生於按下圖形時。 (繼承自 Shape)。
	ClientSizeChanged	發生時ClientSize圖形的屬性變更。 (繼承自 SimpleShape)。
	ContextMenuChanged	會在 ContextMenu 屬性的值變更時發生。 (繼承自 Shape)。
	ContextMenuStripChanged	會在 ContextMenuStrip 屬性的值變更時發生。 (繼承自 Shape)。
	CursorChanged	會在 Cursor 屬性的值變更時發生。 (繼承自 Shape)。
	Disposed	當此元件由 Dispose 方法的呼叫處置時發生。 (繼承自 Component)。
	DoubleClick	發生於按兩下圖形時。 (繼承自 Shape)。
	EnabledChanged	當 Enabled 屬性值變更時發生。 (繼承自 Shape)。
	Enter	發生於進入圖形時。 (繼承自 Shape)。
	GotFocus	發生於圖形取得焦點時。 (繼承自 Shape)。
	Invalidated	發生於圖形的顯示要求重繪時。 (繼承自 Shape)。
	KeyDown	發生於按下按鍵且焦點在圖形時。 (繼承自 Shape)。
	KeyPress	發生於按下按鍵且焦點在圖形時。 (繼承自 Shape)。
	KeyUp	發生於放開按鍵且焦點在圖形時。 (繼承自 Shape)。
	Leave	發生於輸入焦點離開圖形時。 (繼承自 Shape)。
	LocationChanged	發生時Location圖形的屬性變更。 (繼承自 SimpleShape)。
	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)。
	Resize	發生於圖形的大小變更時。 (繼承自 SimpleShape)。
	SizeChanged	發生時Size圖形的屬性變更。 (繼承自 SimpleShape)。
	VisibleChanged	發生在 Visible 屬性值變更時。 (繼承自 Shape)。

回頁首

備註

OvalShape 控制項可讓您繪製圓形和橢圓形在表單或容器在設計階段或執行階段。

當您將 Line 或 Shape 控制項加入至表單或容器時，將不可見的 ShapeContainer 物件建立。 ShapeContainer 為形狀的繪圖介面在每個容器控制項內。 每個 ShapeContainer 有可讓您逐一查看 Line 和 Shape 控制項在 ShapeContainer中的對應 ShapeCollection 。

當您建立 OvalShape 控制項在執行階段時，您也必須建立其 ShapeContainer 屬性等於 OvalShape 的 Parent 屬性為 ShapeContainer。

範例

下列範例建立 ShapeContainer 和 OvalShape，將它們加入至表單，再顯示圓形。

Private Sub DrawCircle()
    Dim canvas As New Microsoft.VisualBasic.PowerPacks.ShapeContainer
    Dim oval1 As New Microsoft.VisualBasic.PowerPacks.OvalShape
    ' Set the form as the parent of the ShapeContainer.
    canvas.Parent = Me 
    ' Set the ShapeContainer as the parent of the OvalShape.
    oval1.Parent = canvas
    ' Set the location and size of the circle.
    oval1.Left = 10
    oval1.Top = 10
    oval1.Width = 100
    oval1.Height = 100
End Sub

private void DrawCircle1()
{
    Microsoft.VisualBasic.PowerPacks.ShapeContainer canvas = 
        new Microsoft.VisualBasic.PowerPacks.ShapeContainer();
    Microsoft.VisualBasic.PowerPacks.OvalShape oval1 = 
        new Microsoft.VisualBasic.PowerPacks.OvalShape();
    // Set the form as the parent of the ShapeContainer.
    canvas.Parent = this;
    // Set the ShapeContainer as the parent of the OvalShape.
    oval1.Parent = canvas;
    // Set the location and size of the circle.
    oval1.Left = 10;
    oval1.Top = 10;
    oval1.Width = 100;
    oval1.Height = 100;
}

執行緒安全

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

請參閱

參考

Microsoft.VisualBasic.PowerPacks 命名空間

其他資源

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

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

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