TrackBarRenderer.DrawTopPointingThumb メソッド

.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)

C#

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

C++

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

J#

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 スタイルがアプリケーション ウィンドウのクライアント領域に適用されていません。

解説

このメソッドを呼び出す前に、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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TrackBarRenderer クラス
TrackBarRenderer メンバ
System.Windows.Forms 名前空間