ComboBox.AutoCompleteMode プロパティ

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

ComboBox.AutoCompleteMode プロパティ

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

ComboBox におけるオート コンプリートの動作を制御するオプションを取得または設定します。

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

Visual Basic (宣言)

Public Property AutoCompleteMode As
 AutoCompleteMode

Visual Basic (使用法)

Dim instance As ComboBox
Dim value As AutoCompleteMode

value = instance.AutoCompleteMode

instance.AutoCompleteMode = value

C#

public AutoCompleteMode AutoCompleteMode { get;
 set; }

C++

public:
property AutoCompleteMode AutoCompleteMode {
    AutoCompleteMode get ();
    void set (AutoCompleteMode value);
}

J#

/** @property */
public AutoCompleteMode get_AutoCompleteMode ()

/** @property */
public void set_AutoCompleteMode (AutoCompleteMode
 value)

JScript

public function get AutoCompleteMode
 () : AutoCompleteMode

public function set AutoCompleteMode
 (value : AutoCompleteMode)

プロパティ値
AutoCompleteMode の値の 1 つ。値は、AutoAppend、AutoSuggest、AutoSuggestAppend、および None です。既定値は None です。

例外

例外の種類	条件
InvalidEnumArgumentException	指定された値が AutoCompleteMode の値の 1 つではありません。

解説

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

ComboBoxStyle を DropDownList に設定すると、AutoCompleteMode が Suggest または SuggestAppend の場合にのみリストが表示されます。

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

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

AutoCompleteMode を SuggestAppend に、AutoCompleteSource を ListItems に設定した場合の動作を次に示します。

• 文字列のリストが空の場合、BackSpace キーまたは Del キーを押しても何も実行されません。

• BackSpace キーを押し、その時間が 1 秒以下であった場合、前の項目が選択されます。ただし、文字列のリストが空の場合は何も選択されません。

• BackSpace キーを押し、その時間が 1 秒以上であった場合、最初の項目が選択されます。

• Del キーを押した場合、最初の項目が選択されます。

メモ
一度に表示できるカスタム文字列の数がオペレーティング システムで制限されている場合もあります。文字列にスラッシュ (/) または円記号 (\) が含まれている場合は、オート コンプリートによってこれらの記号以前のすべての文字が追加されます。

プラットフォーム

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

参照

関連項目
ComboBox クラス
ComboBox メンバ
System.Windows.Forms 名前空間
ComboBox.AutoCompleteCustomSource プロパティ
AutoCompleteSource