TrackBar クラス

[アーティクル]
03/28/2008

Windows 標準のトラックバーを表します。

この型のすべてのメンバの一覧については、TrackBar メンバを参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            System.Windows.Forms.TrackBar

Public Class TrackBar
   Inherits Control
   Implements ISupportInitialize
[C#]
public class TrackBar : Control, ISupportInitialize
[C++]
public __gc class TrackBar : public Control, ISupportInitialize
[JScript]
public class TrackBar extends Control implements ISupportInitialize

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

TrackBar は、 ScrollBar コントロールに類似した、スクロールできるコントロールです。 Minimum プロパティに範囲の下限値を指定し、 Maximum プロパティに範囲の上限値を指定することにより、トラックバーの Value プロパティの値がスクロールする範囲を設定できます。

LargeChange プロパティは、スライダの片側のトラックバーがクリックされたときに、 Value プロパティに対して加算または減算される値を定義します。トラックバーは、水平または垂直に表示できます。

このコントロールを使用すると、 Value プロパティを通じて取得された数値データを入力できます。この数値データは、コントロールで表示したり、コードで使用したりできます。

使用例

[Visual Basic, C#, C++] TrackBar コントロールと TextBox コントロールが配置されたフォームを表示する例を次に示します。この例では、 Maximum 、 TickFrequency 、 LargeChange 、 SmallChange の各プロパティを設定して、 Scroll イベントを処理しています。 TextBox の内容は、 Scroll イベントが発生したときに、 Value プロパティの値に更新されます。

 
Imports System
Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
    Inherits System.Windows.Forms.Form

    Private WithEvents trackBar1 As System.Windows.Forms.TrackBar
    Private textBox1 As System.Windows.Forms.TextBox

    <System.STAThread()> _
    Public Shared Sub Main()
        System.Windows.Forms.Application.Run(New Form1)
    End Sub 'Main

    Public Sub New()
        Me.textBox1 = New System.Windows.Forms.TextBox
        Me.trackBar1 = New System.Windows.Forms.TrackBar

        ' TextBox for TrackBar.Value update.
        Me.textBox1.Location = New System.Drawing.Point(240, 16)
        Me.textBox1.Size = New System.Drawing.Size(48, 20)

        ' Set up how the form should be displayed and add the controls to the form.
        Me.ClientSize = New System.Drawing.Size(296, 62)
        Me.Controls.AddRange(New System.Windows.Forms.Control() {Me.textBox1, Me.trackBar1})
        Me.Text = "TrackBar Example"

        ' Set up the TrackBar.
        Me.trackBar1.Location = New System.Drawing.Point(8, 8)
        Me.trackBar1.Size = New System.Drawing.Size(224, 45)

        ' The Maximum property sets the value of the track bar when
        ' the slider is all the way to the right.
        trackBar1.Maximum = 30

        ' The TickFrequency property establishes how many positions
        ' are between each tick-mark.
        trackBar1.TickFrequency = 5

        ' The LargeChange property sets how many positions to move
        ' if the bar is clicked on either side of the slider.
        trackBar1.LargeChange = 3

        ' The SmallChange property sets how many positions to move
        ' if the keyboard arrows are used to move the slider.
        trackBar1.SmallChange = 2
    End Sub 'New

    Private Sub trackBar1_Scroll(ByVal sender As Object, _
                    ByVal e As System.EventArgs) Handles trackBar1.Scroll

        ' Display the trackbar value in the text box.
        textBox1.Text = trackBar1.Value
    End Sub 

End Class 'Form1

[C#] 
using System;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private System.Windows.Forms.TrackBar trackBar1;
    private System.Windows.Forms.TextBox textBox1;

    [STAThread]
    static void Main() 
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        this.textBox1 = new System.Windows.Forms.TextBox();
        this.trackBar1 = new System.Windows.Forms.TrackBar();

        // TextBox for TrackBar.Value update.
        this.textBox1.Location = new System.Drawing.Point(240, 16);
        this.textBox1.Size = new System.Drawing.Size(48, 20);

        // Set up how the form should be displayed and add the controls to the form.
        this.ClientSize = new System.Drawing.Size(296, 62);
        this.Controls.AddRange(new System.Windows.Forms.Control[] {this.textBox1,this.trackBar1});
        this.Text = "TrackBar Example";

        // Set up the TrackBar.
        this.trackBar1.Location = new System.Drawing.Point(8, 8);
        this.trackBar1.Size = new System.Drawing.Size(224, 45);
        this.trackBar1.Scroll += new System.EventHandler(this.trackBar1_Scroll);

        // The Maximum property sets the value of the track bar when
        // the slider is all the way to the right.
        trackBar1.Maximum = 30;
        
        // The TickFrequency property establishes how many positions
        // are between each tick-mark.
        trackBar1.TickFrequency = 5;

        // The LargeChange property sets how many positions to move
        // if the bar is clicked on either side of the slider.
        trackBar1.LargeChange = 3;

        // The SmallChange property sets how many positions to move
        // if the keyboard arrows are used to move the slider.
        trackBar1.SmallChange = 2;
    }


    private void trackBar1_Scroll(object sender, System.EventArgs e)
    {
        // Display the trackbar value in the text box.
        textBox1.Text = "" + trackBar1.Value;
    }
}

[C++] 

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;

public __gc class Form1 : public System::Windows::Forms::Form {
private:
    System::Windows::Forms::TrackBar*  trackBar1;
    System::Windows::Forms::TextBox*  textBox1;

public:
    Form1() {
        this->textBox1 = new System::Windows::Forms::TextBox();
        this->trackBar1 = new System::Windows::Forms::TrackBar();

        // TextBox for TrackBar::Value update.
        this->textBox1->Location = System::Drawing::Point(240, 16);
        this->textBox1->Size = System::Drawing::Size(48, 20);

        // Set up how the form should be displayed and add the controls to the form.
        this->ClientSize = System::Drawing::Size(296, 62);
        System::Windows::Forms::Control* formControls[] = {
            this->textBox1, this->trackBar1};
        this->Controls->AddRange(formControls);
        this->Text = S"TrackBar Example";

        // Set up the TrackBar.
        this->trackBar1->Location = System::Drawing::Point(8, 8);
        this->trackBar1->Size = System::Drawing::Size(224, 45);
        this->trackBar1->Scroll += new 
            System::EventHandler(this, &Form1::trackBar1_Scroll);

        // The Maximum property sets the value of the track bar when
        // the slider is all the way to the right.
        trackBar1->Maximum = 30;

        // The TickFrequency property establishes how many positions
        // are between each tick-mark.
        trackBar1->TickFrequency = 5;

        // The LargeChange property sets how many positions to move
        // if the bar is clicked on either side of the slider.
        trackBar1->LargeChange = 3;

        // The SmallChange property sets how many positions to move
        // if the keyboard arrows are used to move the slider.
        trackBar1->SmallChange = 2;
    }

private:
    void trackBar1_Scroll(Object* /*sender*/, System::EventArgs* /*e*/) {
        // Display the trackbar value in the text box.
        textBox1->Text = String::Concat(S"", __box(trackBar1->Value));
    }
};

[STAThread]
int main() {
    Application::Run(new Form1());
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

TrackBar メンバ | System.Windows.Forms 名前空間

次の方法で共有

TrackBar クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース