Freigeben über

TrackBarRenderer.DrawTopPointingThumb Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
TrackBarRenderer.cs
Quelle:
TrackBarRenderer.cs
Quelle:
TrackBarRenderer.cs
Quelle:
TrackBarRenderer.cs
Quelle:
TrackBarRenderer.cs

Zeichnet einen Schieberegler für nach oben zeigende Balken (auch als Daumen bezeichnet) mit visuellen Formatvorlagen.

public:
 static void DrawTopPointingThumb(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::Windows::Forms::VisualStyles::TrackBarThumbState state);
public static void DrawTopPointingThumb(System.Drawing.Graphics g, System.Drawing.Rectangle bounds, System.Windows.Forms.VisualStyles.TrackBarThumbState state);
static member DrawTopPointingThumb : System.Drawing.Graphics * System.Drawing.Rectangle * System.Windows.Forms.VisualStyles.TrackBarThumbState -> unit
Public Shared Sub DrawTopPointingThumb (g As Graphics, bounds As Rectangle, state As TrackBarThumbState)

Parameter

g
Graphics

Der Graphics zum Zeichnen des Schiebereglers der Titelleiste verwendete Schieberegler.

bounds
Rectangle

Dies Rectangle gibt die Grenzen des Schiebereglers der Spurleiste an.

state
TrackBarThumbState

Einer der TrackBarThumbState Werte, der den visuellen Zustand des Schiebereglers der Titelleiste angibt.

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 Methode in der DrawTopPointingThumb Methode eines benutzerdefinierten Steuerelements OnPaint verwendet, um einen Schieberegler für die Nachverfolgungsleiste nach oben zu zeichnen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TrackBarRenderer Klasse bereitgestellt wird.

    // Draw the track bar.
protected:
    virtual void OnPaint(PaintEventArgs^ e) override
    {
        if (!TrackBarRenderer::IsSupported)
        {
            this->Parent->Text = "CustomTrackBar Disabled";
            return;
        }

        this->Parent->Text = "CustomTrackBar Enabled";
        TrackBarRenderer::DrawHorizontalTrack(e->Graphics,
            trackRectangle);
        TrackBarRenderer::DrawTopPointingThumb(e->Graphics,
            thumbRectangle, thumbState);
        TrackBarRenderer::DrawHorizontalTicks(e->Graphics,
            ticksRectangle, numberTicks, EdgeStyle::Raised);
    }

    // Determine whether the user has clicked the track bar thumb.
protected:
    virtual void OnMouseDown(MouseEventArgs^ e) override
    {
        if (!TrackBarRenderer::IsSupported)
        {
            return;
        }
        if (this->thumbRectangle.Contains(e->Location))
        {
            thumbClicked = true;
            thumbState = TrackBarThumbState::Pressed;
        }

        this->Invalidate();
    }

// Draw the track bar.
protected override void OnPaint(PaintEventArgs e)
{
    if (!TrackBarRenderer.IsSupported)
    {
        this.Parent.Text = "CustomTrackBar Disabled";
        return;
    }

    this.Parent.Text = "CustomTrackBar Enabled";
    TrackBarRenderer.DrawHorizontalTrack(e.Graphics,
        trackRectangle);
    TrackBarRenderer.DrawTopPointingThumb(e.Graphics,
        thumbRectangle, thumbState);
    TrackBarRenderer.DrawHorizontalTicks(e.Graphics,
        ticksRectangle, numberTicks, EdgeStyle.Raised);
}

// Determine whether the user has clicked the track bar thumb.
protected override void OnMouseDown(MouseEventArgs e)
{
    if (!TrackBarRenderer.IsSupported)
        return;

    if (this.thumbRectangle.Contains(e.Location))
    {
        thumbClicked = true;
        thumbState = TrackBarThumbState.Pressed;
    }

    this.Invalidate();
}

' Draw the track bar.
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
    If Not TrackBarRenderer.IsSupported Then
        Me.Parent.Text = "CustomTrackBar Disabled"
        Return
    End If

    Me.Parent.Text = "CustomTrackBar Enabled"
    TrackBarRenderer.DrawHorizontalTrack(e.Graphics, _
        trackRectangle)
    TrackBarRenderer.DrawTopPointingThumb(e.Graphics, _
        thumbRectangle, thumbState)
    TrackBarRenderer.DrawHorizontalTicks(e.Graphics, _
        ticksRectangle, numberTicks, EdgeStyle.Raised)
End Sub

' Determine whether the user has clicked the track bar thumb.
Protected Overrides Sub OnMouseDown(ByVal e As MouseEventArgs)
    If Not TrackBarRenderer.IsSupported Then
        Return
    End If
    If Me.thumbRectangle.Contains(e.Location) Then
        thumbClicked = True
        thumbState = TrackBarThumbState.Pressed
    End If

    Me.Invalidate()
End Sub

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob der Wert der IsSupported Eigenschaft lautet true.

Gilt für: