ToolStripComboBox.AutoCompleteCustomSource プロパティ

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

ToolStripComboBox.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 ToolStripComboBox
Dim value As AutoCompleteStringCollection

value = instance.AutoCompleteCustomSource

instance.AutoCompleteCustomSource = value

C#

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

C++

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

J#

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

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

JScript

public function get AutoCompleteCustomSource
 () : AutoCompleteStringCollection

public function set AutoCompleteCustomSource
 (value : AutoCompleteStringCollection)

プロパティ値
文字列を格納している AutoCompleteStringCollection。

解説

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

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

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

使用例

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

Visual Basic

' The following code example demonstrates the syntax for setting
' various ToolStripComboBox properties.
' 
toolStripComboBox1.AutoCompleteCustomSource.AddRange(New String()
 {"aaa", "bbb", "ccc"})
toolStripComboBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.SuggestAppend
toolStripComboBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.CustomSource
toolStripComboBox1.DropDownHeight = 110
toolStripComboBox1.DropDownWidth = 122
toolStripComboBox1.FlatStyle = System.Windows.Forms.FlatStyle.Standard
toolStripComboBox1.IntegralHeight = False
toolStripComboBox1.Items.AddRange(New Object()
 {"xxx", "yyy", "zzz"})
toolStripComboBox1.MaxDropDownItems = 9
toolStripComboBox1.MergeAction = System.Windows.Forms.MergeAction.Insert
toolStripComboBox1.Name = "toolStripComboBox1"
toolStripComboBox1.Size = New System.Drawing.Size(121, 25)
toolStripComboBox1.Sorted = True

C#

// The following code example demonstrates the syntax for setting
// various ToolStripComboBox properties.
// 
toolStripComboBox1.AutoCompleteCustomSource.AddRange(new string[]
 {
"aaa",
"bbb",
"ccc"});
toolStripComboBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.SuggestAppend;
toolStripComboBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.CustomSource;
toolStripComboBox1.DropDownHeight = 110;
toolStripComboBox1.DropDownWidth = 122;
toolStripComboBox1.FlatStyle = System.Windows.Forms.FlatStyle.Standard;
toolStripComboBox1.IntegralHeight = false;
toolStripComboBox1.Items.AddRange(new object[] {
"xxx",
"yyy",
"zzz"});
toolStripComboBox1.MaxDropDownItems = 9;
toolStripComboBox1.MergeAction = System.Windows.Forms.MergeAction.Insert;
toolStripComboBox1.Name = "toolStripComboBox1";
toolStripComboBox1.Size = new System.Drawing.Size(121, 25);
toolStripComboBox1.Sorted = true;

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripComboBox クラス
ToolStripComboBox メンバ
System.Windows.Forms 名前空間
AutoCompleteMode
AutoCompleteSource