ProgressBarRenderer.DrawVerticalChunks(Graphics, Rectangle) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

ProgressBarRenderer.cs

Zeichnet eine Reihe von Statusanzeigenteilen, die eine vertikale Statusanzeige ausfü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

Wird Graphics zum Zeichnen der Statusanzeige verwendet.

bounds

Rectangle

Der Rectangle Wert, der die Grenzen angibt, die durch Statusbalkenelemente gefüllt werden sollen.

Ausnahmen

InvalidOperationException

Das Betriebssystem unterstützt keine visuellen Formatvorlagen.

- oder -

Visuelle Formatvorlagen werden vom Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Formatvorlagen werden nicht auf den Clientbereich von Anwendungsfenstern angewendet.

Beispiele

Im folgenden Codebeispiel wird die DrawVerticalChunks Methode in einem Timer.Tick Ereignishandler verwendet, um jedes 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 Statusleistenelement erstreckt sich über die Breite des bounds Parameters. Die Anzahl der gezeichneten Statusbalkenteile wird durch die Höhe bounds und die von ChunkSpaceThickness und .ChunkThickness

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