ProgressBarRenderer.DrawVerticalChunks(Graphics, Rectangle) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Zeichnet eine Reihe von Teilen der Statusanzeige, die eine vertikale Statusanzeige füllen.

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)

Parameter

g

Graphics

Die zum Zeichnen der Statusanzeige verwendete Graphics.

bounds

Rectangle

Das Rectangle, das die von Statusanzeigenteilen zu füllenden Begrenzungen angibt.

Ausnahmen

InvalidOperationException

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Beispiele

Im folgenden Codebeispiel wird die DrawVerticalChunks -Methode in einem Timer.Tick Ereignishandler verwendet, um jeden Inkrement einer Statusleiste zu zeichnen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ProgressBarRenderer-Klasse bereitgestellt wird.

    // 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

Hinweise

Jedes von dieser Methode gezeichnete Fortschrittsbalkenstück überspannt die Breite des bounds Parameters. Die Anzahl der gezeichneten Fortschrittsbalkenteile wird durch die Höhe von bounds und die von ChunkSpaceThicknessChunkThicknesszurückgegebenen Werte bestimmt.

Bevor Sie diese Methode verwenden, sollten Sie überprüfen, ob die IsSupported -Eigenschaft zurückgibt true.