DomainUpDown クラス

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

文字列値を表示する Windows アップダウンコントロールを表します。

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

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            System.Windows.Forms.ScrollableControl
               System.Windows.Forms.ContainerControl
                  System.Windows.Forms.UpDownBase
                     System.Windows.Forms.DomainUpDown

Public Class DomainUpDown
   Inherits UpDownBase
[C#]
public class DomainUpDown : UpDownBase
[C++]
public __gc class DomainUpDown : public UpDownBase
[JScript]
public class DomainUpDown extends UpDownBase

スレッドセーフ

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

解説

DomainUpDown コントロールは、コントロールの上向き矢印ボタンまたは下向き矢印ボタンをクリックして、 Object コレクションから選択される 1 つの文字列値を表示します。 ReadOnly プロパティが true に設定されている場合を除き、ユーザーはコントロールにテキストを入力することもできます (入力する文字列が、受け入れられるようにするには、コレクション内の項目と一致する必要があります)。項目を選択すると、オブジェクトは文字列値に変換され、アップダウンコントロールに表示されます。

DomainUpDown コントロールに表示するオブジェクトのコレクションを作成するには、 Add メソッドおよび Remove メソッドを使用して、項目を個別に追加または削除します。これは、ボタンの Click などのイベントハンドラで呼び出すことができます。 Sorted プロパティを true に設定すると、オブジェクトのコレクションをアルファベット順に並べ替えることができます。 Wrap が true に設定されると、コレクションの最初または最後のオブジェクトを超えてスクロールする場合、リストは最初または最後のオブジェクトに戻り、継続的に表示されます。

コードを使用するか、または上向き矢印ボタンと下向き矢印ボタンのどちらかをクリックして、 UpButton メソッドまたは DownButton メソッドを呼び出すと、 UpdateEditText が呼び出され、新しい文字列でコントロールを更新します。 UserEdit が true に設定されている場合、コントロールのテキスト表示が更新される前に、文字列がコレクション内の値の 1 つに一致します。

使用例

[Visual Basic, C#, C++] DomainUpDown コントロールを作成し、初期化する例を次に示します。この例では、プロパティの一部を設定して、アップダウンコントロールに表示する文字列のコレクションを作成できます。このコードは、 TextBox 、 CheckBox 、および Button がフォーム上でインスタンス化されていることを前提にしています。この例は、 myCounter という名前の 32 ビット符号付き整数として宣言されたクラスレベルのメンバ変数があることも前提にしています。テキストボックスに文字列を入力すると、ボタンがクリックされたときにその文字列を Items コレクションに追加できます。チェックボックスをクリックすると、 Sorted プロパティを切り替えて、アップダウンコントロール内の項目のコレクションの違いを確認できます。

 
Protected domainUpDown1 As DomainUpDown


Private Sub MySub()
    ' Create and initialize the DomainUpDown control.
    domainUpDown1 = New System.Windows.Forms.DomainUpDown()
    
    ' Add the DomainUpDown control to the form.
    Controls.Add(domainUpDown1)
End Sub 'MySub


Private Sub button1_Click(sender As System.Object, e As System.EventArgs)
    ' Add the text box contents and initial location in the collection
    ' to the DomainUpDown control.
    domainUpDown1.Items.Add((textBox1.Text.Trim() & " - " & myCounter))
    
    ' Increment the counter variable.
    myCounter = myCounter + 1
    
    ' Clear the TextBox.
    textBox1.Text = ""
End Sub 'button1_Click


Private Sub checkBox1_Click(sender As System.Object, e As System.EventArgs)
    ' If Sorted is set to true, set it to false; 
    ' otherwise set it to true.
    If domainUpDown1.Sorted Then
        domainUpDown1.Sorted = False
    Else
        domainUpDown1.Sorted = True
    End If
End Sub 'checkBox1_Click


Private Sub domainUpDown1_SelectedItemChanged _
    (sender As System.Object, e As System.EventArgs)
    
    ' Display the SelectedIndex and SelectedItem property values in a MessageBox.
    MessageBox.Show(("SelectedIndex: " & domainUpDown1.SelectedIndex.ToString() & _
        ControlChars.Cr & "SelectedItem: " & domainUpDown1.SelectedItem.ToString()))
End Sub 'domainUpDown1_SelectedItemChanged

[C#] 
protected DomainUpDown domainUpDown1;

private void MySub()
 {
    // Create and initialize the DomainUpDown control.
    domainUpDown1 = new System.Windows.Forms.DomainUpDown();
    
    // Add the DomainUpDown control to the form.
    Controls.Add(domainUpDown1);
 }
 
 private void button1_Click(System.Object sender, 
                           System.EventArgs e)
 {   
    // Add the text box contents and initial location in the collection
    // to the DomainUpDown control.
    domainUpDown1.Items.Add((textBox1.Text.Trim()) + " - " + myCounter);
    
    // Increment the counter variable.
    myCounter = myCounter + 1;
 
    // Clear the TextBox.
    textBox1.Text = "";
 }
 
 private void checkBox1_Click(System.Object sender, 
                             System.EventArgs e)
 {
    // If Sorted is set to true, set it to false; 
    // otherwise set it to true.
    if (domainUpDown1.Sorted)
    {
       domainUpDown1.Sorted = false;
    }
    else
    {
       domainUpDown1.Sorted = true;
    }
 }
 
 private void domainUpDown1_SelectedItemChanged(System.Object sender, 
                                               System.EventArgs e)
 {
    // Display the SelectedIndex and SelectedItem property values in a MessageBox.
    MessageBox.Show("SelectedIndex: " + domainUpDown1.SelectedIndex.ToString() 
       + "\n" + "SelectedItem: " + domainUpDown1.SelectedItem.ToString());
 }


[C++] 
protected:
    DomainUpDown __gc *domainUpDown1;

private:
    void MySub() {
        // Create and initialize the DomainUpDown control.
        domainUpDown1 = new System::Windows::Forms::DomainUpDown();
    
        // Add the DomainUpDown control to the form.
        Controls->Add(domainUpDown1);
    };
 
    void button1_Click(Object *sender, EventArgs *e) {   
        // Add the text box contents and initial location in the collection
        // to the DomainUpDown control.
        domainUpDown1->Items->Add(String::Concat((textBox1->Text->Trim()), S" - ", __box(myCounter)->ToString()));
    
        // Increment the counter variable.
        myCounter = myCounter + 1;
 
        // Clear the TextBox.
        textBox1->Text = S"";
    };
 
    void checkBox1_Click(Object *sender, EventArgs *e) {
        // If Sorted is set to true, set it to false; 
        // otherwise set it to true.
        if (domainUpDown1->Sorted) {
            domainUpDown1->Sorted = false;
        } else {
            domainUpDown1->Sorted = true;
        }
    };
 
    void domainUpDown1_SelectedItemChanged(Object *sender, EventArgs *e) {
        // Display the SelectedIndex and SelectedItem property values in a MessageBox.
        MessageBox::Show(String::Concat(S"SelectedIndex: ", __box(domainUpDown1->SelectedIndex)->ToString(), 
        S"\n", S"SelectedItem: ", domainUpDown1->SelectedItem->ToString()));
    };

[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 内)

参照

DomainUpDown メンバ | System.Windows.Forms 名前空間 | UpDownBase | NumericUpDown

次の方法で共有

DomainUpDown クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース