共用方式為

RectangleShape 類別

  • 發行項

代表控制項，顯示成正方形、 矩形、 圓角的正方形或圓角的矩形。

繼承階層架構

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.VisualBasic.PowerPacks.Shape
        Microsoft.VisualBasic.PowerPacks.SimpleShape
          Microsoft.VisualBasic.PowerPacks.RectangleShape

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

語法

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

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

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

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

public class RectangleShape extends SimpleShape

RectangleShape 型別會公開下列成員。

建構函式

  名稱 說明
公用方法 RectangleShape() 初始化 RectangleShape 類別的新執行個體。
公用方法 RectangleShape(ShapeContainer) 初始化新的執行個體的RectangleShape類別，指定ShapeContainer ，當中會包含它。
公用方法 RectangleShape(Int32, Int32, Int32, Int32) 初始化新的執行個體的RectangleShape類別中，指定其位置和大小。

回頁首

屬性

  名稱 說明
公用屬性 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 取得像素為單位，在圖形的下邊緣與上的邊緣與其容器工作區之間的距離。 (繼承自 SimpleShape)。
公用屬性 Bounds 取得或設定像素為單位，相對於父控制項的大小和圖案的位置。 (繼承自 SimpleShape)。
公用屬性 CanFocus 取得值，指出線條或圖案控制項是否可以接收焦點。 (繼承自 Shape)。
受保護的屬性 CanRaiseEvents 取得值，指出元件是否能引發事件。 (繼承自 Component)。
公用屬性 CanSelect 取得值，指出是否可以選取線條或圖案控制項。 (繼承自 Shape)。
公用屬性 ClientRectangle 取得表示形狀工作區的矩形。 (繼承自 SimpleShape)。
公用屬性 ClientSize 取得或設定 [高度] 和 [寬度] 圖形的工作區。 (繼承自 SimpleShape)。
公用屬性 Container 取得包含 Component 的 IContainer。 (繼承自 Shape)。
公用屬性 ContainsFocus 取得值，這個值表示線條或圖案控制項目前是否有輸入的焦點。 (繼承自 Shape)。
公用屬性 ContextMenu 取得或設定與線條或圖案控制項關聯的快顯功能表。 (繼承自 Shape)。
公用屬性 ContextMenuStrip 取得或設定ContextMenuStrip與線條或圖案控制項關聯。 (繼承自 Shape)。
公用屬性 CornerRadius 取得或設定圓角的矩形和圓角正方形的圓角半徑。
公用屬性 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 的資源，並選擇性地釋放受管理的資源。 (繼承自 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)。

回頁首

備註

RectangleShape控制項可讓您在表單或容器上繪製矩形，在設計階段或執行階段。

當您新增的線條或圖案控制項加入表單或容器時，隱藏ShapeContainer在建立物件。ShapeContainer做為繪圖的每個容器控制項中的圖形介面。每個ShapeContainer已對應ShapeCollection ，可用來逐一查看 Line 和 Shape 控制項中所包含的ShapeContainer。

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

範例

下列範例會建立ShapeContainer和RectangleShape、 將它們加入至表單，並會顯示一個矩形。

Private Sub DrawRectangle()
    Dim canvas As New Microsoft.VisualBasic.PowerPacks.ShapeContainer
    Dim rect1 As New Microsoft.VisualBasic.PowerPacks.RectangleShape
    ' Set the form as the parent of the ShapeContainer.
    canvas.Parent = Me
    ' 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
End Sub

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

執行緒安全

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

請參閱

參考

Microsoft.VisualBasic.PowerPacks 命名空間

其他資源

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

HOW TO：使用 LineShape 控制項繪製線條 (Visual Studio)

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