ProgressBarRenderer.DrawVerticalChunks メソッド

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

ProgressBarRenderer.DrawVerticalChunks メソッド

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

垂直プログレス バーに表示される一連のプログレス バーの要素を描画します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim g As Graphics
Dim bounds As Rectangle

ProgressBarRenderer.DrawVerticalChunks(g, bounds)

C#

public static void DrawVerticalChunks
 (
    Graphics g,
    Rectangle bounds
)

C++

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

J#

public static void DrawVerticalChunks
 (
    Graphics g, 
    Rectangle bounds
)

JScript

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

パラメータ

g

プログレス バーの描画に使用する Graphics。

bounds

プログレス バーの要素によって埋められる境界を指定する Rectangle。

例外

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

解説

このメソッドにより描画されるプログレス バーの各要素は、bounds パラメータの幅に表示されます。プログレス バーの要素の数は、bounds の高さ、および ChunkSpaceThickness と ChunkThickness によって返される値に応じて決定されます。

このメソッドを使用する前に、IsSupported プロパティが true を返すことを確認する必要があります。

使用例

Timer.Tick イベント ハンドラで DrawVerticalChunks メソッドを使用して、プログレス バーの各増分を描画するコード例を次に示します。このコード例は、ProgressBarRenderer クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Handle the timer tick; draw each progressively larger rectangle.
Private Sub progressTimer_Tick(ByVal
 myObject As [Object], ByVal e As
 EventArgs) 
    If ticks < NumberChunks Then
        Dim g As Graphics = Me.CreateGraphics()
        Try
            ProgressBarRenderer.DrawVerticalChunks(g, progressBarRectangles(ticks))
            ticks += 1
        Finally
            g.Dispose()
        End Try
    Else
        progressTimer.Enabled = False
    End If

End Sub 'progressTimer_Tick

C#

// Handle the timer tick; draw each progressively larger rectangle.
private void progressTimer_Tick(Object myObject,
 EventArgs e)
{
    if (ticks < NumberChunks)
    {
        using (Graphics g = this.CreateGraphics())
        {
            ProgressBarRenderer.DrawVerticalChunks(g,
                progressBarRectangles[ticks]);
            ticks++;
        }
    }
    else
    {
        progressTimer.Enabled = false;
    }
}

C++

    // Handle the timer tick; draw each progressively larger rectangle.
private:
    void progressTimer_Tick(Object^ myObject, EventArgs^ e)
    {
        if (ticks < NumberChunks)
        {
            Graphics^ g = this->CreateGraphics();
            ProgressBarRenderer::DrawVerticalChunks(g,
                progressBarRectangles[ticks]);
            ticks++;
        }
        else
        {
            progressTimer->Enabled = false;
        }
    }

プラットフォーム

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

参照

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