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

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

public static void DrawVerticalChunks
 (
    Graphics g,
    Rectangle bounds
)

C++

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

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

例外の種類

条件

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

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