ComboBox.AutoCompleteSource プロパティ

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

ComboBox.AutoCompleteSource プロパティ

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

オート コンプリートに使用する補完文字列の参照先を指定する値を取得または設定します。

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

Visual Basic (宣言)

Public Property AutoCompleteSource As
 AutoCompleteSource

Visual Basic (使用法)

Dim instance As ComboBox
Dim value As AutoCompleteSource

value = instance.AutoCompleteSource

instance.AutoCompleteSource = value

C#

public AutoCompleteSource AutoCompleteSource { get;
 set; }

C++

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

J#

/** @property */
public AutoCompleteSource get_AutoCompleteSource ()

/** @property */
public void set_AutoCompleteSource (AutoCompleteSource
 value)

JScript

public function get AutoCompleteSource
 () : AutoCompleteSource

public function set AutoCompleteSource
 (value : AutoCompleteSource)

プロパティ値
AutoCompleteSource の値の 1 つ。オプションは、AllSystemSources、AllUrl、FileSystem、HistoryList、RecentlyUsedList、CustomSource、および None です。既定値は None です。

例外

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

解説

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

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 プロパティ
ComboBox.AutoCompleteMode プロパティ