MESCIUS InputMan for Windows Forms 12.0J - GcTextBox DropDownEditor

https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html
Admin
This documentation explains how to use the DropDownEditor feature of GcTextBox in MESCIUS InputMan...
Tokens:2,856
Snippets:7
Trust Score:5.8
Update:1 year ago
Show doc for...
Tokens:
Raw
### Handle Dropdown Editor Events

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Explains how to handle events from the dropdown edit window, such as InvalidInput. Note that Visual Studio's IDE does not automatically generate event procedures for these events, requiring manual setup.

```APIDOC
GrapeCity.Win.Editors.DropDownEditor.InvalidInput
  - Event that is raised when the input in the dropdown editor is invalid.
  - Requires manual subscription to an event handler.

Example:
  - Visual Basic: Me.MyEditor = Me.GcTextBox1.DropDownEditor; Private Sub MyEditor_InvalidInput(ByVal sender As Object, ByVal e As EventArgs) Handles MyEditor.InvalidInput ... End Sub
  - C#: gcTextBox1.DropDownEditor.InvalidInput += new EventHandler(this.myEditor_InvalidInput); private void myEditor_InvalidInput(object sender, EventArgs e) ... 
```

--------------------------------

### Configure Dropdown Edit Window

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Sample code to configure the dropdown edit window for GcTextBox in C#.

```C#
private GrapeCity.Win.Editors.DropDownButton MyDropDownButton = new GrapeCity.Win.Editors.DropDownButton();

private void Form1_Load(object sender, EventArgs e)
{
    // テキストコントロールにドロップダウンボタンを追加し
    // エディットウィンドウを表示可能にします。
    MyDropDownButton.IsDefaultBehavior = true;
    gcTextBox1.SideButtons.Add(MyDropDownButton);

    // エディットウィンドウの表示位置を設定します。
    gcTextBox1.DropDown.Direction = GrapeCity.Win.Editors.DropDownDirection.Right;
    // エディットウィンドウのアニメーションを設定します。
    gcTextBox1.DropDown.OpeningAnimation = GrapeCity.Win.Editors.DropDownAnimation.Slide;
    gcTextBox1.DropDown.ClosingAnimation = GrapeCity.Win.Editors.DropDownAnimation.Fade;

    // エディットウィンドウの外観を変更します。
    gcTextBox1.DropDownEditor.BackColor = Color.DarkGray;
    gcTextBox1.DropDownEditor.ForeColor = Color.White;
}

private void gcTextBox1_Enter(object sender, EventArgs e)
{
    // フォーカス取得時にエディットウィンドウを自動で表示します。
    gcTextBox1.Drop();
}
```

--------------------------------

### Configure Dropdown Edit Window

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Demonstrates how to add a dropdown button to a GcTextBox, enable the edit window, set its display position and animation, and customize its appearance (background and foreground colors).

```APIDOC
GrapeCity.Win.Editors.GcTextBox.SideButtons.Add(DropDownButton)
  - Adds a side button to the text box.

GrapeCity.Win.Editors.DropDownButton.IsDefaultBehavior
  - Property to enable the default behavior of showing the edit window when the dropdown button is clicked.
  - Required to be True for the edit window to display.

GrapeCity.Win.Editors.GcTextBox.DropDown.Direction
  - Sets the display direction of the dropdown window relative to the text box.
  - Possible values include GrapeCity.Win.Editors.DropDownDirection.Right.

GrapeCity.Win.Editors.GcTextBox.DropDown.OpeningAnimation
  - Sets the animation for when the dropdown window opens.
  - Possible values include GrapeCity.Win.Editors.DropDownAnimation.Slide.

GrapeCity.Win.Editors.GcTextBox.DropDown.ClosingAnimation
  - Sets the animation for when the dropdown window closes.
  - Possible values include GrapeCity.Win.Editors.DropDownAnimation.Fade.

GrapeCity.Win.Editors.GcTextBox.DropDownEditor.BackColor
  - Sets the background color of the dropdown edit window.

GrapeCity.Win.Editors.GcTextBox.DropDownEditor.ForeColor
  - Sets the foreground (text) color of the dropdown edit window.
```

--------------------------------

### Configure Dropdown Edit Window

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Sample code to configure the dropdown edit window for GcTextBox in Visual Basic.

```Visual Basic
Private MyDropDownButton As New DropDownButton()

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    ' テキストコントロールにドロップダウンボタンを追加し
    ' エディットウィンドウを表示可能にします。
    MyDropDownButton.IsDefaultBehavior = True
    GcTextBox1.SideButtons.Add(MyDropDownButton)

    ' エディットウィンドウの表示位置を設定します。
    GcTextBox1.DropDown.Direction = GrapeCity.Win.Editors.DropDownDirection.Right
    ' エディットウィンドウのアニメーションを設定します。
    GcTextBox1.DropDown.OpeningAnimation = GrapeCity.Win.Editors.DropDownAnimation.Slide
    GcTextBox1.DropDown.ClosingAnimation = GrapeCity.Win.Editors.DropDownAnimation.Fade

    ' エディットウィンドウの外観を変更します。
    GcTextBox1.DropDownEditor.BackColor = Color.DarkGray
    GcTextBox1.DropDownEditor.ForeColor = Color.White
End Sub

Private Sub GcTextBox1_Enter(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles GcTextBox1.Enter
    ' フォーカス取得時にエディットウィンドウを自動で表示します。
    GcTextBox1.Drop()
End Sub
```

--------------------------------

### Automatically Show Edit Window on Focus

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Shows how to make the dropdown edit window appear automatically when the GcTextBox control receives focus by calling the Drop() method.

```APIDOC
GrapeCity.Win.Editors.GcTextBox.Drop()
  - Method to programmatically display the dropdown edit window.
  - Typically called when the control gains focus.
```

--------------------------------

### Handle Dropdown Editor Events

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Sample code for handling the InvalidInput event of the DropDownEditor in C#.

```C#
// イベントプロシージャに関連づけます。
gcTextBox1.DropDownEditor.InvalidInput += new EventHandler(this.myEditor_InvalidInput);

// イベントプロシージャ
private void myEditor_InvalidInput(object sender, EventArgs e)
{
    ・・・
}
```

--------------------------------

### Handle Dropdown Editor Events

Source: https://docs.mescius.jp/help/inputman-winforms-12/GcTextBox_DropDownEditor.html/index

Sample code for handling the InvalidInput event of the DropDownEditor in Visual Basic.

```Visual Basic
' イベントを使用するクラスのインスタンスを設定します。
Friend WithEvents MyEditor As GrapeCity.Win.Editors.DropDownEditor

' DropDownEditorオブジェクトをテキストコントロールに関連づけます。
Me.MyEditor = Me.GcTextBox1.DropDownEditor

' イベントプロシージャ
Private Sub MyEditor_InvalidInput(ByVal sender As Object, ByVal e As EventArgs) Handles MyEditor.InvalidInput
    ・・・
End Sub
```
Tokens:
Raw