GrapeCity.Win.Pickers 名前空間 > GcFontPicker クラス : AutoCompleteMode プロパティ |
Public Property AutoCompleteMode As AutoCompleteMode
public AutoCompleteMode AutoCompleteMode {get; set;}
例外 | 解説 |
---|---|
System.ComponentModel.InvalidEnumArgumentException | 指定された値がSystem.Windows.Forms.AutoCompleteMode列挙値の1つではありません。 |
DropDownStyleがDropDownStyle.DropDownで、AutoCompleteModeがSystem.Windows.Forms.AutoCompleteMode.None以外の場合、GcFontPickerコントロールに文字列を入力すると、その文字列がドロップダウンリスト内のすべてのフォント名の先頭部分と比較され、一致した場合、次の動作が起こります。
DropDownStyleがDropDownListで、AutoCompleteModeがSystem.Windows.Forms.AutoCompleteMode.None以外の場合、GcFontPickerコントロールでユーザーが文字キーを押すと、その文字がドロップダウンリスト内のすべてのフォント名の先頭文字と比較され、一致した場合、Textが最初に一致したフォント名に変更されます。さらに、AutoCompleteModeがSystem.Windows.Forms.AutoCompleteMode.SuggestまたはSystem.Windows.Forms.AutoCompleteMode.SuggestAppendの場合には、ドロップダウンリストが表示されて最初に一致したフォント名が自動的に強調表示されます。
次のサンプルコードは、AutoCompleteModeプロパティを使用して入力文字列を自動的に補完する方法を示します。この例では、AutoCompleteModeをSystem.Windows.Forms.AutoCompleteMode.SuggestAppendに設定しています。つまり、ユーザーがgcFontPickerのテキストエディタに文字列を入力すると、Textが最初に一致したフォント名に補完され、さらにドロップダウンリストが表示されて最初に一致したフォント名が自動的に強調表示されます。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。
private void CreateGcFontPickerWithAutoCompleteMode() { // Create an instance of GcFontPicker control. GcFontPicker gcFontPicker = new GcFontPicker(); // Initialize the Name and Location of the gcFontPicker. gcFontPicker.Name = "gcFontPicker"; gcFontPicker.Location = new Point(10, 50); // Set the AutoCompleteMode. gcFontPicker.AutoCompleteMode = AutoCompleteMode.SuggestAppend; // adds gcFontPicker to the form. this.Controls.Add(gcFontPicker); }
Private Sub CreateGcFontPickerWithAutoCompleteMode() ' Create an instance of GcFontPicker control. Dim gcFontPicker As New GcFontPicker() ' Initialize the Name and Location of the gcFontPicker. gcFontPicker.Name = "gcFontPicker" gcFontPicker.Location = New Point(10, 50) ' Set the AutoCompleteMode. gcFontPicker.AutoCompleteMode = AutoCompleteMode.SuggestAppend ' adds gcFontPicker to the form. Me.Controls.Add(gcFontPicker) End Sub
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2