ProgressBarRenderer.DrawVerticalChunks(Graphics, Rectangle) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ProgressBarRenderer.cs

Disegna un insieme di porzioni che riempiono un indicatore di stato verticale.

public:
 static void DrawVerticalChunks(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds);

public static void DrawVerticalChunks (System.Drawing.Graphics g, System.Drawing.Rectangle bounds);

static member DrawVerticalChunks : System.Drawing.Graphics * System.Drawing.Rectangle -> unit

Public Shared Sub DrawVerticalChunks (g As Graphics, bounds As Rectangle)

Parametri

g

Graphics

Oggetto Graphics utilizzato per disegnare l'indicatore di stato.

bounds

Rectangle

Oggetto Rectangle che specifica i limiti che devono essere riempiti dalle porzioni dell'indicatore di stato.

Eccezioni

InvalidOperationException

Il sistema operativo non supporta gli stili di visualizzazione.

-oppure-

Gli stili di visualizzazione sono stati disabilitati dall'utente nel sistema operativo.

-oppure-

Gli stili di visualizzazione non sono stati applicati all'area client delle finestre dell'applicazione.

Esempio

Nell'esempio di codice seguente viene usato il DrawVerticalChunks metodo in un gestore eventi per disegnare ogni incremento di una Timer.Tick barra di stato. Questo esempio di codice fa parte di un esempio più grande fornito per la ProgressBarRenderer classe.

    // Handle the timer tick; draw each progressively larger rectangle.
private:
    void progressTimer_Tick(Object^ myObject, EventArgs^ e)
    {
        if (ticks < NumberChunks)
        {
            Graphics^ g = this->CreateGraphics();
            ProgressBarRenderer::DrawVerticalChunks(g,
                progressBarRectangles[ticks]);
            ticks++;
        }
        else
        {
            progressTimer->Enabled = false;
        }
    }

// Handle the timer tick; draw each progressively larger rectangle.
private void progressTimer_Tick(Object myObject, EventArgs e)
{
    if (ticks < NumberChunks)
    {
        using (Graphics g = this.CreateGraphics())
        {
            ProgressBarRenderer.DrawVerticalChunks(g,
                progressBarRectangles[ticks]);
            ticks++;
        }
    }
    else
    {
        progressTimer.Enabled = false;
    }
}

' Handle the timer tick; draw each progressively larger rectangle.
Private Sub progressTimer_Tick(ByVal myObject As [Object], ByVal e As EventArgs) 
    If ticks < NumberChunks Then
        Dim g As Graphics = Me.CreateGraphics()
        Try
            ProgressBarRenderer.DrawVerticalChunks(g, progressBarRectangles(ticks))
            ticks += 1
        Finally
            g.Dispose()
        End Try
    Else
        progressTimer.Enabled = False
    End If

End Sub

Commenti

Ogni pezzo della barra di avanzamento disegnato da questo metodo si estende sulla larghezza del bounds parametro. Il numero di parti della barra di avanzamento disegnate è determinato dall'altezza di bounds e dai valori restituiti da ChunkSpaceThickness e ChunkThickness.

Prima di usare questo metodo, è necessario verificare che la IsSupported proprietà restituisca true.