Printer.Circle 方法 (Boolean, Single, Single, Single, Int32, Single, Single, Single)

發行項
05/16/2015

在頁面列印圓形、橢圓形或弧形，並指定中心點是否相對於目前位置。

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

語法

'宣告
Public Sub Circle ( _
    relativeStart As Boolean, _
    x As Single, _
    y As Single, _
    radius As Single, _
    color As Integer, _
    startAngle As Single, _
    endAngle As Single, _
    aspect As Single _
)

public void Circle(
    bool relativeStart,
    float x,
    float y,
    float radius,
    int color,
    float startAngle,
    float endAngle,
    float aspect
)

public:
void Circle(
    bool relativeStart, 
    float x, 
    float y, 
    float radius, 
    int color, 
    float startAngle, 
    float endAngle, 
    float aspect
)

member Circle : 
        relativeStart:bool * 
        x:float32 * 
        y:float32 * 
        radius:float32 * 
        color:int * 
        startAngle:float32 * 
        endAngle:float32 * 
        aspect:float32 -> unit

public function Circle(
    relativeStart : boolean, 
    x : float, 
    y : float, 
    radius : float, 
    color : int, 
    startAngle : float, 
    endAngle : float, 
    aspect : float
)

參數

relativeStart
類型：Boolean

Boolean. 如果這個參數設定為 true，則會列印圓形、橢圓形或弧形的中心，相對於物件的 CurrentX 和 CurrentY 屬性所指定的座標。

x
類型：Single

Single 值，代表圓形、橢圓形或弧形中心點的垂直座標。 ScaleMode 屬性會判斷所使用的量值單位。

y
類型：Single

Single值，代表圓形或橢圓形的半徑。 ScaleMode 屬性會判斷所使用的量值單位。

radius
類型：Single

Single值，代表圓形或橢圓形的半徑。 ScaleMode 屬性會判斷所使用的量值單位。

color
類型：Int32

選擇項。 Integer 值，表示圓形外框的 RGB (紅-綠-藍) 色彩。如果省略這個參數，則會使用 Black 的值。

startAngle
類型：Single

選擇項。 Single-整數位數值。當列印弧形或部分圓形或橢圓時，startangle 和 endAngle (以弧度為單位) 指定弧形的開始和結束位置。兩者的範圍是 2 * pi 弧度到 2 * pi 弧度。 startAngle 的預設值為 0 弧度，endAngle 的預設值為 2 * pi 弧度。

endAngle
類型：Single

選擇項。 Single-整數位數值。當列印弧形或部分圓形或橢圓時，startAngle 和 endAngle (以弧度為單位) 指定弧形的開始和結束位置。兩者的範圍是 2 * pi 弧度到 2 * pi 弧度。 startAngle 的預設值為 0 弧度，endAngle 的預設值為 2 * pi 弧度。

aspect
類型：Single

選擇項。 Single 整數位數值，代表圓形或橢圓形的長寬比。預設值為 1.0，會在任何螢幕上產生完美的圓形 (非橢圓形)。

備註

若要填滿圓形，請設定為 FillColor ，且 Printer 的 FillStyle 屬性。只有封閉圖形來填滿。封閉圖形包括圓形、橢圓形或扇形 (與半徑線條弧線在兩端)。

當列印部分圓形或橢圓形，否則，如果 startAngle 為負數時， Circle 列印每一個半徑為 startAngle 並且將角度視為正數。如果 endAngle 是負值， Circle 則會將半徑指向 endAngle 並且將角度視為正數。 Circle 方法會以逆時針 (正值) 方向永遠繪製。

寬度 (或粗細) 所使用的行，列印圓形，代表圓形、橢圓形或弧形取決於 DrawWidth 屬性的設定。這個圓形在背景列印的方式取決於 DrawStyle 屬性的設定。

當列印扇形，列印角度 0 的半徑 (建立水平線段右邊) 時，為 startAngle 中指定非常小的負數值而不是零。

您可以在設計階段邏輯省略引數，不過，您必須包含引數的逗號，在包含下引數之前。如果您省略選擇性引數，請省略遵循前指定引數的逗號。

當 Circle 執行時， CurrentX 和 CurrentY 屬性設定為這些引數指定的中心點。

注意事項
Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 命名空間中的函式和物件都是供這些工具使用，以便從 Visual Basic 6.0 升級至 Visual Basic。在大多數情況下，這些函式和物件會複製在 .NET Framework 的其他命名空間中可以找到的功能。只有當 Visual Basic 6.0 程式碼模型與 .NET Framework 實作有顯著差異時，才需要這些項目。

Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 命名空間中的函式和物件都是供這些工具使用，以便從 Visual Basic 6.0 升級至 Visual Basic。在大多數情況下，這些函式和物件會複製在 .NET Framework 的其他命名空間中可以找到的功能。只有當 Visual Basic 6.0 程式碼模型與 .NET Framework 實作有顯著差異時，才需要這些項目。

範例

下列範例示範如何繪製圓形。

Dim pr As New Printer
pr.DrawStyle = vbSolid
pr.DrawWidth = 1
pr.FillStyle = vbCross
pr.FillColor = vbRed
pr.Circle(True, 2000, 2000, 1000, vbBlue, -2, 1.5, 1)
pr.EndDoc()