ComboBox QML Type

このプロパティは、コンボボックスが編集可能なテキストフィールドに許容可能なテキストを含むかどうかを保持する。

バリデータが設定されている場合、現在のテキストが最終的な文字列として(中間文字列としてではなく)バリデータに受け入れられる場合にのみ、この値はtrue になります。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

validator およびacceptedも参照してください 。

このプロパティは、コンボボックス内の項目数を保持します。

このプロパティは、コンボボックス内の現在の項目のインデックスを保持します。

デフォルト値は、count が0 の場合は-1 で、それ以外の場合は0 です。

activated()、currentText 、およびhighlightedIndexも参照してください 。

このプロパティは、コンボボックスの現在の項目のテキストを保持します。

currentIndex 、displayText 、textRole 、およびeditTextも参照して ください。

このプロパティは、コンボボックスの現在の項目の値を保持します。

このプロパティの使用例については、ComboBox Model Roles を参照してください。

このプロパティは、QtQuick.Controls 2.14（Qt 5.14）で導入されました。

currentIndex 、currentText 、valueRoleも参照してください 。

このプロパティは、コンボボックスのポップアップで項目を提示するデリゲートを保持します。

デリゲートとしてItemDelegate （または他のAbstractButton 派生物）を使用することをお勧めします。これにより、インタラクションが期待通りに動作し、適切なときにポップアップが自動的に閉じます。他の型をデリゲートとして使用する場合、ポップアップは手動で閉じなければなりません。例えば、MouseArea ：

delegate: Rectangle {
    // ...
    MouseArea {
        // ...
        onClicked: comboBox.popup.close()
    }
}

ItemDelegate とComboBox のカスタマイズも参照してください 。

このプロパティは、コンボボックスのデリゲート・インスタンスを提供するモデルを保持します。

通常、popup のcontentItem のListView に割り当てられます。

コンボボックスのカスタマイズ」も参照してください 。

このプロパティは、コンボボックスのボタンに表示されるテキストを保持します。

デフォルトでは、表示テキストは現在の選択内容を示します。つまり、現在の項目のテキストに従います。しかし、デフォルトの表示テキストはカスタム値で上書きすることができます。

ComboBox {
    currentIndex: 1
    displayText: "Size: " + currentText
    model: ["S", "M", "L"]
}

currentText およびtextRoleも参照してください 。

このプロパティは、コンボボックスボタンが視覚的にダウンしているかどうかを保持します。

明示的に設定されない限り、このプロパティはpressed またはpopup.visible のいずれかがtrue のとき、true になります。デフォルト値に戻すには、このプロパティをundefined に設定します。

このプロパティは、QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

pressed およびpopupも参照してください 。

このプロパティは、編集可能なコンボボックスのテキストフィールドのテキストを保持します。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

editable 、currentText 、displayTextも参照してください 。

このプロパティは、コンボボックスが編集可能かどうかを保持します。

デフォルト値はfalse です。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

validatorも参照してください 。

このプロパティは、コンボボックスボタンがフラットであるかどうかを保持します。

フラットなコンボボックスボタンは、操作されない限り背景を描画しません。通常のコンボボックスと比較して、フラットなコンボボックスは、UIの他の部分から目立たなくする外観を提供します。例えば、コンボボックスをツールバーに配置する場合、コンボボックスをフラットにすることで、ツールボタンのフラットなルックスとマッチしやすくなります。

デフォルト値はfalse です。

このプロパティは、QtQuick.Controls 2.1（Qt 5.8）で導入されました。

このプロパティは、コンボボックスのポップアップリストでハイライトされた項目のインデックスを保持します。

ハイライトされた項目がアクティブになると、ポップアップが閉じられ、currentIndex がhighlightedIndex に設定され、ハイライトされた項目がなくなるので、このプロパティの値は-1 にリセットされます。

highlighted() およびcurrentIndexも参照のこと 。

このプロパティは、ComboBox のimplicitContentWidth の計算方法を制御する。

ComboBox の幅がテキストを表示するのに十分でない場合、そのテキストは消去される。テキストのどの部分が省略されるかによって、エンドユーザが項目を選択するのが難しくなる可能性があります。ComboBox 、テキストが消えないように十分な幅を確保する効率的な方法は、十分大きいとわかっている幅を設定することです：

width: 300
implicitContentWidthPolicy: ComboBox.ContentItemImplicitWidth

しかし、テキストの大きさは、フォントファミリ、フォントサイズ、翻訳など、多くの要因に依存するため、ハードコードされた値が十分な大きさになるかどうかを知ることは、しばしば不可能です。

implicitContentWidthPolicyは、implicitContentWidthの計算方法を制御する簡単な方法を提供し、その結果ComboBox のimplicitWidth に影響を与え、テキストがエリッドされないことを保証します。

利用可能な値は

デフォルト値はContentItemImplicitWidth です。

こ のプ ロ パテ ィ はComboBox のimplicitWidth に対 し てのみ効力を持つので、 明示的なwidth を設定 し て も エ ラ イ ド が発生す る 可能性があ り ます。

このプロパティは、QtQuick.Controls 6.0（Qt 6.0）で導入されました。

このプロパティは、暗黙のインジケータの高さを保持します。

値はindicator ? indicator.implicitHeight : 0 に等しい。

これは通常、implicitContentHeight とimplicitBackgroundHeight とともに、implicitHeight を計算するために使用されます。

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

implicitIndicatorWidthも参照してください 。

このプロパティは、暗黙のインジケータの幅を保持します。

値はindicator ? indicator.implicitWidth : 0 と等しくなります。

これは通常、implicitContentWidth およびimplicitBackgroundWidth とともに、implicitWidth を計算するために使用されます。

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

implicitIndicatorHeightも参照してください 。

このプロパティは、ドロップインジケータ項目を保持します。

コンボボックスのカスタマイズ」も参照してください 。

このプロパティは、編集可能なコンボボックスが入力メソッドからの部分的なテキスト入力を持つかどうかを保持します。

入力メソッドは、コンボボックスからのマウスイベントまたはキーイベントに依存して、部分テキストを編集またはコミットすることができます。このプロパティは、入力メソッドの正しい動作を妨げる可能性のあるイベントハンドラを無効にするタイミングを決定するために使用できます。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

入力メソッドに、コンボボックスの予想される内容と、その操作方法についてのヒントを提供します。

デフォルト値はQt.ImhNoPredictiveText です。

値はフラグのビット単位の組み合わせか、ヒントが設定されていない場合はQt.ImhNone です。

動作を変更するフラグは以下の通りです：

• Qt.ImhHiddenText - パスワードを入力するときによく使われるように、文字を隠します。
• Qt.ImhSensitiveData - 入力されたテキストは、Active Inputメソッドによって、予測辞書のような永続的なストレージに保存されません。
• Qt.ImhNoAutoUppercase - 入力メソッドは、文の終了時に自動的に大文字に切り替えようとしません。
• Qt.ImhPreferNumbers - 数字が優先されます（必須ではありません）。
• Qt.ImhPreferUppercase - 大文字を優先する（必須ではない）。
• Qt.ImhPreferLowercase - 小文字が優先されます（必須ではありません）。
• Qt.ImhNoPredictiveText - 入力中に予測入力（辞書検索など）を使用しない。
• Qt.ImhDate - テキストエディタが日付フィールドとして機能します。
• Qt.ImhTime - テキスト・エディタは時間フィールドとして機能します。

入力を制限するフラグ（排他フラグ）は以下の通りです：

• Qt.ImhDigitsOnly - 数字のみ入力可能。
• Qt.ImhFormattedNumbersOnly - 数値入力のみが許可されます。小数点やマイナス記号も含まれます。
• Qt.ImhUppercaseOnly - 大文字の入力のみが許可されます。
• Qt.ImhLowercaseOnly - 小文字の入力のみが許可されます。
• Qt.ImhDialableCharactersOnly - 電話ダイヤルに適した文字のみが許可されます。
• Qt.ImhEmailCharactersOnly - メールアドレスに適した文字のみが許可されます。
• Qt.ImhUrlCharactersOnly - URL に適した文字のみが許可されます。

マスク：

• Qt.ImhExclusiveInputMask - このマスクは、排他フラグのいずれかが使用されている場合に非ゼロを返します。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

このプロパティは、コンボボックスのデータを提供するモデルを保持します。

ComboBox {
    textRole: "key"
    model: ListModel {
        ListElement { key: "First"; value: 123 }
        ListElement { key: "Second"; value: 456 }
        ListElement { key: "Third"; value: 789 }
    }
}

textRole とデータモデルも参照してください 。

このプロパティはポップアップを保持します。

ポップアップは、必要に応じて、手動で開いたり閉じたりすることができます：

onSpecialEvent: comboBox.popup.close()

コンボボックスのカスタマイズ」も参照して ください。

このプロパティは、コンボボックスのボタンが物理的に押されたかどうかを保持します。ボタンはタッチまたはキーイベントによって押されます。

downも参照 。

このプロパティは、編集可能なComboBox のテキストフィールドをマウスで選択できるかどうかを保持します。

デフォルト値はfalse です。

このプロパティは、QtQuick.Controls 2.15（Qt 5.15）で導入されました。

このプロパティは、コンボボックスへの入力に使用されるモデルのロールを保持します。

モデルに複数のロールがある場合、textRole 、どのロールを表示するかを設定することができます。

model 、currentText 、displayText 、ComboBox Model Rolesも参照してください 。

このプロパティは、編集可能なコンボボックスの入力テキストバリデータを保持します。

バリデータが設定されると、テキストフィールドはtextプロパティを中間状態にする入力のみを受け付ける。accepted シグナルは、Return またはEnter キーが押されたときにテキストが許容可能な状態にある場合にのみ発せられます。

現在サポートしているバリデータはIntValidator 、DoubleValidator 、RegularExpressionValidator です。バリデータの使用例を以下に示します。0 から10 までの整数をテキストフィールドに入力することができます：

ComboBox {
    model: 10
    editable: true
    validator: IntValidator {
        top: 9
        bottom: 0
    }
}

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

acceptableInput,accepted,editableも参照してください 。

このプロパティは、モデル内の各項目に関連付けられた値を格納するために使用されるモデル・ロールを保持します。

このプロパティの使用方法の例については、ComboBox Model Roles を参照してください。

このプロパティは、QtQuick.Controls 2.14（Qt 5.14）で導入されました。

model およびcurrentValueも参照して ください。

このシグナルは、editable コンボボックスでReturn またはEnter キーが押されたときに発せられます。

例えば、新しく入力された項目をモデルに追加するために、このシグナルを処理することができます：

ComboBox {
    editable: true
    model: ListModel {
        id: model
        ListElement { text: "Banana" }
        ListElement { text: "Apple" }
        ListElement { text: "Coconut" }
    }
    onAccepted: {
        if (find(editText) === -1)
            model.append({text: editText})
    }
}

シグナルが発せられる前に、その文字列がモデルに存在するかどうかがチェックされます。存在する場合、currentIndex にそのインデックスが、currentText に文字列そのものが設定されます。

シグナルが発信された後、最初のチェックが失敗した場合（つまり、アイテムが存在しなかった場合）、シグナルハンドラによってアイテムが追加されたかどうか、別のチェックが行われます。追加されていれば、currentIndex とcurrentText がそれに応じて更新される。そうでなければ、それぞれ-1 と"" に設定される。

このシグナルはQtQuick.Controls 2.2 (Qt 5.9)で導入されました。

このシグナルは、index のアイテムがユーザーによってアクティベートされた時に発せられます。

アイテムがアクティブになるのは、ポップアップが開いている間にそのアイテムが選択され、ポップアップが閉じられる（そして、currentIndex が変更される）場合、またはポップアップが閉じられ、コンボボックスがキーボードでナビゲートされ、currentIndex が変更される場合です。currentIndex プロパティはindex に設定されます。

currentIndexも参照 。

このシグナルは、ポップアップ・リストのindex の項目がユーザーによってハイライトされたときに発せられます。

highlighted シグナルは、ポップアップが開いていて、アイテムがハイライトされているときにのみ発せられますが、必ずしもactivated である必要はありません。

highlightedIndexも参照してください 。

コンボボックスの現在のインデックス、またはポップアップリストが表示されている場合はハイライトされたインデックスをデクリメントします。

currentIndex およびhighlightedIndexも参照して ください。

指定されたtext のインデックスを返し、マッチしない場合は-1 を返します。

検索の実行方法は、指定されたマッチflags によって定義されます。デフォルトでは、コンボボックスは大文字小文字を区別して完全一致を行います (Qt.MatchExactly)。その他のマッチタイプは、Qt.MatchCaseSensitive フラグが指定されていない限り、大文字小文字を区別しません。

例えば

ComboBox {
    model: ListModel {
        ListElement { text: "Banana" }
        ListElement { text: "Apple" }
        ListElement { text: "Coconut" }
    }
    Component.onCompleted: currentIndex = find("Coconut")
}

textRoleも参照 。

コンボボックスの現在のインデックス、またはポップアップリストが表示されている場合はハイライトされたインデックスをインクリメントします。

currentIndex およびhighlightedIndex も参照して ください。

指定されたvalue のインデックスを返し、マッチしない場合は-1 を返す。

このメソッドの使用例については、ComboBox Model Roles を参照。

このメソッドは QtQuick.Controls 2.14 (Qt 5.14) で導入されました。

find()、currentValue 、currentIndex 、valueRole 、valueAtも参照してください 。

コンボボックスの編集可能なテキストフィールドのテキストをすべて選択します。

このメソッドは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

editTextも参照してください 。

指定されたindex のテキスト、またはインデックスが範囲外の場合は空の文字列を返します。

例えば

ComboBox {
    model: ListModel {
        ListElement { text: "Banana" }
        ListElement { text: "Apple" }
        ListElement { text: "Coconut" }
    }
    onActivated: (index) => { print(textAt(index)) }
}

textRoleも参照。

コンボボックスの位置index にある値を返します。

このメソッドは QtQuick.Controls 2.14 (Qt 5.14) で導入されました。

indexOfValueも参照してください 。