Metodo Printer.Circle (Boolean, Single, Single, Single, Int32, Single, Single, Single)

Articolo
05/16/2015

Stampa un cerchio, un'ellisse o un arco in una pagina, specificando se il punto centrale è relativo alla posizione corrente.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
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
)

Parametri

relativeStart
Tipo: Boolean

Boolean. Se questo parametro è impostato su true, viene stampato il centro del cerchio, dell'ellisse o dell'arco in base alle coordinate specificate nelle proprietà CurrentY e CurrentX dell'oggetto.

x
Tipo: Single

Valore Single che indica la coordinata verticale per il punto centrale del cerchio, dell'ellisse o dell'arco. La proprietà ScaleMode determina le unità di misura utilizzate.

y
Tipo: Single

Valore Single che indica il raggio del cerchio o dell'ellisse. La proprietà ScaleMode determina le unità di misura utilizzate.

radius
Tipo: Single

Valore Single che indica il raggio del cerchio o dell'ellisse. La proprietà ScaleMode determina le unità di misura utilizzate.

color
Tipo: Int32

Facoltativa. Valore Integer che indica il colore RGB (rosso-verde-blu) nel contorno del cerchio. Se questo parametro viene omesso, viene utilizzato il valore di Black.

startAngle
Tipo: Single

Facoltativa. Valore di precisione Single. Quando un arco o un cerchio o un'ellisse parziale viene stampata, startangle e endAngle specificano (in radianti) la posizione iniziale e finale dell'arco. L'intervallo per entrambi è di 2 * pi greco radianti a 2 * pi greco radianti. Il valore predefinito per startAngle è 0 radianti; il valore predefinito per endAngle è 2* pi greco radianti.

endAngle
Tipo: Single

Facoltativa. Valore di precisione Single. Quando un arco o un cerchio o un'ellisse parziale viene stampata, startAngle e endAngle specificano (in radianti) la posizione iniziale e finale dell'arco. L'intervallo per entrambi è di 2 * pi greco radianti a 2 * pi greco radianti. Il valore predefinito per startAngle è 0 radianti; il valore predefinito per endAngle è 2* pi greco radianti.

aspect
Tipo: Single

Facoltativa. Valore di precisione Single che indica le proporzioni del cerchio o dell'ellisse. Il valore predefinito è 1,0, che produce un cerchio (non ellittico) perfetto sullo schermo.

Note

Per riempire un cerchio, impostare FillColor e le proprietà di FillStyle di Printer oggetto. Solo una figura chiusa può essere compilata. Le cifre chiuse includono cerchi, ellissi, o le sezioni del grafico a torta (archi con righe del raggio tracciate entrambe le estremità).

Per stampare un cerchio o un'ellisse parziale, se startAngle è negativo, la pressione di un Circle il raggio a startAngle e si tratta l'angolo come positivo. Se endAngle è negativo, Circle stampa un raggio a endAngle e considera l'angolo come positivo. Il metodo di Circle disegno sempre la direzione (positiva) in senso antiorario a.

La larghezza, o lo spessore, della linea utilizzata per stampare il cerchio, ellipse, o arco dipende dall'impostazione della proprietà di DrawWidth. Il modo in cui il controllo circle viene visualizzato su precedenti dipende dall'impostazione della proprietà di DrawStyle.

Per stampare le sezioni del grafico a torta, per stampare un raggio per inclinare 0 (creando un segmento di linea orizzontale verso destra), specificare un valore negativo molto basso per startAngle anziché zero.

È possibile omettere un argomento al centro della sintassi, ma è necessario includere la virgola dell'argomento prima di includere l'argomento seguente. Se si omette un argomento facoltativo, omettere la virgola dopo aver determinato argomento precedente.

Quando Circle esecuzione, le proprietà di CurrentY e di CurrentX vengono impostate sul punto centrale specificato dagli argomenti.

Nota

Le funzioni e gli oggetti nello spazio dei nomi Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 vengono forniti per essere utilizzati dagli strumenti per l'aggiornamento da Visual Basic 6.0 a Visual Basic.Nella maggior parte dei casi, tali funzioni e oggetti duplicano le funzionalità disponibili in altri spazi dei nomi in .NET Framework.Sono necessari, pertanto, solo quando il modello di codice di Visual Basic 6.0 differisce in modo significativo dall'implementazione di .NET Framework.

Esempi

Nell'esempio seguente viene illustrato come disegnare un cerchio.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.