ProgressBarRenderer.DrawVerticalChunks(Graphics, Rectangle) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ProgressBarRenderer.cs

Dessine un ensemble de morceaux de barre de progression qui remplissent une barre de progression 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)

Paramètres

g

Graphics

Utilisé Graphics pour dessiner la barre de progression.

bounds

Rectangle

Qui Rectangle spécifie les limites à remplir par des éléments de barre de progression.

Exceptions

InvalidOperationException

Le système d’exploitation ne prend pas en charge les styles visuels.

- ou -

Les styles visuels sont désactivés par l’utilisateur dans le système d’exploitation.

- ou -

Les styles visuels ne sont pas appliqués à la zone cliente des fenêtres d’application.

Exemples

L’exemple de code suivant utilise la DrawVerticalChunks méthode dans un gestionnaire d’événements Timer.Tick pour dessiner chaque incrément d’une barre de progression. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

Chaque élément de barre de progression dessiné par cette méthode couvre la largeur du bounds paramètre. Le nombre d’éléments de barre de progression dessinés est déterminé par la hauteur et bounds les valeurs retournées par ChunkSpaceThickness et ChunkThickness.

Avant d’utiliser cette méthode, vous devez vérifier que la IsSupported propriété retourne true.