ToolStripTextBox.AutoCompleteCustomSource プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ToolStripTextBox.AutoCompleteCustomSource プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

AutoCompleteSource プロパティが CustomSource に設定されている場合に使用するカスタムの文字列コレクションを取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property AutoCompleteCustomSource As
 AutoCompleteStringCollection

Visual Basic (使用法)

Dim instance As ToolStripTextBox
Dim value As AutoCompleteStringCollection

value = instance.AutoCompleteCustomSource

instance.AutoCompleteCustomSource = value

[LocalizableAttribute(true)] 
public AutoCompleteStringCollection AutoCompleteCustomSource {
 get; set; }

C++

[LocalizableAttribute(true)] 
public:
property AutoCompleteStringCollection^ AutoCompleteCustomSource {
    AutoCompleteStringCollection^ get ();
    void set (AutoCompleteStringCollection^
 value);
}

/** @property */
public AutoCompleteStringCollection get_AutoCompleteCustomSource
 ()

/** @property */
public void set_AutoCompleteCustomSource (AutoCompleteStringCollection
 value)

JScript

public function get AutoCompleteCustomSource
 () : AutoCompleteStringCollection

public function set AutoCompleteCustomSource
 (value : AutoCompleteStringCollection)

プロパティ値
AutoCompleteSource に使用する AutoCompleteStringCollection。

解説

入力されたプレフィックスを、あらかじめ用意されたすべての文字列のプレフィックスと比較することによって、入力文字列を自動的に補完する ToolStripTextBox を作成するには、AutoCompleteCustomSource、AutoCompleteMode、AutoCompleteSource の各プロパティを使用します。これは、URL、アドレス、ファイル名、コマンドの入力などによく使用される ToolStripTextBox コントロールで有用です。

AutoCompleteCustomSource プロパティの使用はオプションですが、AutoCompleteCustomSource を使用するためには、AutoCompleteSource プロパティを CustomSource に設定する必要があります。

AutoCompleteMode プロパティと AutoCompleteSource プロパティは一緒に使用する必要があります。

使用例

ToolStripTextBox に対し、AutoCompleteCustomSource プロパティなど、各種の共通プロパティを設定するための構文を次のコード例に示します。

Visual Basic

' This code example demonstrates the syntax for setting
' various ToolStripTextBox properties.
' 
toolStripTextBox1.AcceptsReturn = True
toolStripTextBox1.AcceptsTab = True
toolStripTextBox1.AutoCompleteCustomSource.AddRange(New String()
 {"This is line one.", "Second
 line.", "Another line."})
toolStripTextBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.SuggestAppend
toolStripTextBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.CustomSource
toolStripTextBox1.BorderStyle = System.Windows.Forms.BorderStyle.FixedSingle
toolStripTextBox1.CharacterCasing = System.Windows.Forms.CharacterCasing.Upper
toolStripTextBox1.HideSelection = False
toolStripTextBox1.MaxLength = 32000
toolStripTextBox1.Name = "toolStripTextBox1"
toolStripTextBox1.ShortcutsEnabled = False
toolStripTextBox1.Size = New System.Drawing.Size(100, 25)
toolStripTextBox1.Text = "STRING1" + ControlChars.Cr
 + ControlChars.Lf + "STRING2" + ControlChars.Cr
 + ControlChars.Lf + "STRING3" + ControlChars.Cr + ControlChars.Lf + "STRING4"
toolStripTextBox1.TextBoxTextAlign = System.Windows.Forms.HorizontalAlignment.Center

// This code example demonstrates the syntax for setting
// various ToolStripTextBox properties.
// 
toolStripTextBox1.AcceptsReturn = true;
toolStripTextBox1.AcceptsTab = true;
toolStripTextBox1.AutoCompleteCustomSource.AddRange(new string[]
 {
"This is line one.",
"Second line.",
"Another line."});
toolStripTextBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.SuggestAppend;
toolStripTextBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.CustomSource;
toolStripTextBox1.BorderStyle = System.Windows.Forms.BorderStyle.FixedSingle;
toolStripTextBox1.CharacterCasing = System.Windows.Forms.CharacterCasing.Upper;
toolStripTextBox1.HideSelection = false;
toolStripTextBox1.MaxLength = 32000;
toolStripTextBox1.Name = "toolStripTextBox1";
toolStripTextBox1.ShortcutsEnabled = false;
toolStripTextBox1.Size = new System.Drawing.Size(100, 25);
toolStripTextBox1.Text = "STRING1\r\nSTRING2\r\nSTRING3\r\nSTRING4";
toolStripTextBox1.TextBoxTextAlign = System.Windows.Forms.HorizontalAlignment.Center;