TrackBarRenderer.GetTopPointingThumbSize メソッド

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

TrackBarRenderer.GetTopPointingThumbSize メソッド

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

上向きのトラック バーのスライダ (つまみとも呼ばれる) のサイズをピクセル単位で返します。

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

Visual Basic (宣言)

Public Shared Function GetTopPointingThumbSize
 ( _
    g As Graphics, _
    state As TrackBarThumbState _
) As Size

Visual Basic (使用法)

Dim g As Graphics
Dim state As TrackBarThumbState
Dim returnValue As Size

returnValue = TrackBarRenderer.GetTopPointingThumbSize(g, state)

C#

public static Size GetTopPointingThumbSize
 (
    Graphics g,
    TrackBarThumbState state
)

C++

public:
static Size GetTopPointingThumbSize (
    Graphics^ g, 
    TrackBarThumbState state
)

J#

public static Size GetTopPointingThumbSize
 (
    Graphics g, 
    TrackBarThumbState state
)

JScript

public static function GetTopPointingThumbSize
 (
    g : Graphics, 
    state : TrackBarThumbState
) : Size

パラメータ

g

この操作で使用される Graphics。

state

スライダの表示状態を指定する TrackBarThumbState 値の 1 つ。

戻り値
スライダのサイズをピクセル単位で指定する Size。

例外

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

解説

スライダのサイズは、オペレーティング システムの現在の visual スタイルによって決定されます。

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

使用例

GetTopPointingThumbSize メソッドを使用して、DrawTopPointingThumb メソッドがスライダを描画するときに使用する四角形のサイズを確認するコード例を、次に示します。このコード例は、TrackBarRenderer クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Calculate the sizes of the bar, thumb, and ticks rectangle.
Private Sub SetupTrackBar()
    If Not TrackBarRenderer.IsSupported Then
        Return
    End If
    Using g As Graphics = Me.CreateGraphics()
        ' Calculate the size of the track bar.
        trackRectangle.X = ClientRectangle.X + 2
        trackRectangle.Y = ClientRectangle.Y + 28
        trackRectangle.Width = ClientRectangle.Width - 4
        trackRectangle.Height = 4

        ' Calculate the size of the rectangle in which to 
        ' draw the ticks.
        ticksRectangle.X = trackRectangle.X + 4
        ticksRectangle.Y = trackRectangle.Y - 8
        ticksRectangle.Width = trackRectangle.Width - 8
        ticksRectangle.Height = 4

        tickSpace = (CSng(ticksRectangle.Width) - 1) / _
            (CSng(numberTicks) - 1)

        ' Calculate the size of the thumb.
        thumbRectangle.Size = _
            TrackBarRenderer.GetTopPointingThumbSize( _
            g, TrackBarThumbState.Normal)

        thumbRectangle.X = CurrentTickXCoordinate()
        thumbRectangle.Y = trackRectangle.Y - 8
    End Using
End Sub

C#

// Calculate the sizes of the bar, thumb, and ticks rectangle.
private void SetupTrackBar()
{
    if (!TrackBarRenderer.IsSupported)
        return;

    using (Graphics g = this.CreateGraphics())
    {
        // Calculate the size of the track bar.
        trackRectangle.X = ClientRectangle.X + 2;
        trackRectangle.Y = ClientRectangle.Y + 28;
        trackRectangle.Width = ClientRectangle.Width - 4;
        trackRectangle.Height = 4;

        // Calculate the size of the rectangle in which to 
        // draw the ticks.
        ticksRectangle.X = trackRectangle.X + 4;
        ticksRectangle.Y = trackRectangle.Y - 8;
        ticksRectangle.Width = trackRectangle.Width - 8;
        ticksRectangle.Height = 4;

        tickSpace = ((float)ticksRectangle.Width - 1) /
            ((float)numberTicks - 1);

        // Calculate the size of the thumb.
        thumbRectangle.Size =
            TrackBarRenderer.GetTopPointingThumbSize(g,
            TrackBarThumbState.Normal);

        thumbRectangle.X = CurrentTickXCoordinate();
        thumbRectangle.Y = trackRectangle.Y - 8;
    }
}

プラットフォーム

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 名前空間