TrackBarRenderer.DrawTopPointingThumb メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TrackBarRenderer.DrawTopPointingThumb メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

visual スタイルを使用して、上向きのトラックバーのスライダ (つまみとも呼ばれる) を描画します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub DrawTopPointingThumb
 ( _
    g As Graphics, _
    bounds As Rectangle, _
    state As TrackBarThumbState _
)

Visual Basic (使用法)

Dim g As Graphics
Dim bounds As Rectangle
Dim state As TrackBarThumbState

TrackBarRenderer.DrawTopPointingThumb(g, bounds, state)

public static void DrawTopPointingThumb
 (
    Graphics g,
    Rectangle bounds,
    TrackBarThumbState state
)

C++

public:
static void DrawTopPointingThumb (
    Graphics^ g, 
    Rectangle bounds, 
    TrackBarThumbState state
)

public static void DrawTopPointingThumb
 (
    Graphics g, 
    Rectangle bounds, 
    TrackBarThumbState state
)

JScript

public static function DrawTopPointingThumb
 (
    g : Graphics, 
    bounds : Rectangle, 
    state : TrackBarThumbState
)

パラメータ

g: トラックバーのスライダの描画に使用する Graphics。

bounds: トラックバーのスライダの境界を指定する Rectangle。

state: トラックバーのスライダの表示状態を指定する TrackBarThumbState 値の 1 つ。

例外

例外の種類	条件
InvalidOperationException	オペレーティングシステムが visual スタイルをサポートしていません。または visual スタイルがオペレーティングシステムでユーザーにより無効にされています。または visual スタイルがアプリケーションウィンドウのクライアント領域に適用されていません。

例外の種類

条件

InvalidOperationException

オペレーティングシステムが visual スタイルをサポートしていません。

または

visual スタイルがオペレーティングシステムでユーザーにより無効にされています。

または

visual スタイルがアプリケーションウィンドウのクライアント領域に適用されていません。

解説

このメソッドを呼び出す前に、IsSupported プロパティの値が true であることを確認する必要があります。

使用例

カスタムコントロールの OnPaint メソッドで DrawTopPointingThumb メソッドを使用して、上向きのトラックバーのスライダを描画するコード例を次に示します。このコード例は、TrackBarRenderer クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' 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

// 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();
}