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

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

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

TrackBarRenderer.DrawHorizontalTrack メソッド

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

visual スタイルを使用して、水平トラックバーのトラックを描画します。

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

Visual Basic (宣言)

Public Shared Sub DrawHorizontalTrack
 ( _
    g As Graphics, _
    bounds As Rectangle _
)

Visual Basic (使用法)

Dim g As Graphics
Dim bounds As Rectangle

TrackBarRenderer.DrawHorizontalTrack(g, bounds)

public static void DrawHorizontalTrack
 (
    Graphics g,
    Rectangle bounds
)

C++

public:
static void DrawHorizontalTrack (
    Graphics^ g, 
    Rectangle bounds
)

public static void DrawHorizontalTrack
 (
    Graphics g, 
    Rectangle bounds
)

JScript

public static function DrawHorizontalTrack
 (
    g : Graphics, 
    bounds : Rectangle
)

パラメータ

g: トラックの描画に使用する Graphics。

bounds: トラックの境界を指定する Rectangle。

例外

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

例外の種類

条件

InvalidOperationException

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

または

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

または

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

解説

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

使用例

カスタムコントロールの OnPaint メソッドで DrawHorizontalTrack メソッドを使用して、トラックバーを描画するコード例を次に示します。このコード例は、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();
}