QComboBox Class

メンバ関数のドキュメント

[explicit] QComboBox::QComboBox(QWidget *parent = nullptr)

指定されたparent を使用して、デフォルトのモデルQStandardItemModel を用いたコンボボックスを作成します。

[virtual noexcept] QComboBox::~QComboBox()

コンボボックスを破棄します。

[signal] void QComboBox::activated(int index)

このシグナルは、ユーザーがコンボボックス内の項目を選択したときに送信されます。項目のindex が渡されます。なお、選択内容が変更されなかった場合でも、このシグナルは送信されることに注意してください。選択内容が実際に変更されたタイミングを把握する必要がある場合は、currentIndexChanged() またはcurrentTextChanged() シグナルを使用してください。

void QComboBox::addItem(const QString &text, const QVariant &userData = QVariant())

指定されたtext を持つ項目をコンボボックスに追加します。この項目には、指定されたuserData （Qt::UserRole に格納されているもの）が含まれます。この項目は、既存の項目のリストの末尾に追加されます。

void QComboBox::addItem(const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

指定されたicon およびtext を持つ項目をコンボボックスに追加し、その項目には指定されたuserData （Qt::UserRole に格納されている）が含まれます。この項目は、既存の項目のリストの末尾に追加されます。

void QComboBox::addItems(const QStringList &texts)

指定されたtexts 内の各文字列をコンボボックスに追加します。各項目は、既存の項目リストの末尾に順番に追加されます。

[override virtual protected] void QComboBox::changeEvent(QEvent *e)

QWidget::changeEvent(QEvent *event) を再実装します。

[slot] void QComboBox::clear()

コンボボックスの内容をすべてクリアし、すべての項目を削除します。

注：コンボボックスに外部モデルが設定されている場合でも、この関数を呼び出すと、そのモデルはクリアされます。

[slot] void QComboBox::clearEditText()

コンボボックスでの編集に使用されるラインエディットの内容をクリアします。

QCompleter *QComboBox::completer() const

コンボボックスのテキスト入力を自動補完するために使用されるコンプリーターを返します。

setCompleter() およびeditableも参照してください 。

[override virtual protected] void QComboBox::contextMenuEvent(QContextMenuEvent *e)

QWidget::contextMenuEvent(QContextMenuEvent *event) を再実装します。

[signal] void QComboBox::currentIndexChanged(int index)

このシグナルは、コンボボックス内のcurrentIndex が、ユーザーの操作またはプログラムによって変更されるたびに送信されます。項目のindex が渡されます。コンボボックスが空になった場合や、currentIndex がリセットされた場合は-1が渡されます。

[signal] void QComboBox::currentTextChanged(const QString &text)

このシグナルは、currentText が変更されるたびに発火します。新しい値はtext として渡されます。

[signal] void QComboBox::editTextChanged(const QString &text)

このシグナルは、コンボボックスのラインエディットウィジェット内のテキストが変更されたときに発生します。新しいテキストは、text で指定されます。

[override virtual] bool QComboBox::event(QEvent *event)

QWidget::event(QEvent *event) を再実装します。

int QComboBox::findData(const QVariant &data, int role = Qt::UserRole, Qt::MatchFlags flags = static_cast<Qt::MatchFlags>(Qt::MatchExactly|Qt::MatchCaseSensitive)) const

指定されたrole に対して、指定されたdata を含む項目のインデックスを返します。それ以外の場合は-1を返します。

flags は、コンボボックス内の項目がどのように検索されるかを指定します。

int QComboBox::findText(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly|Qt::MatchCaseSensitive) const

指定されたtext を含む項目のインデックスを返します。それ以外の場合は-1を返します。

flags は、コンボボックス内の項目がどのように検索されるかを指定します。

[override virtual protected] void QComboBox::focusInEvent(QFocusEvent *e)

QWidget::focusInEvent(QFocusEvent *event) を再実装します。

[override virtual protected] void QComboBox::focusOutEvent(QFocusEvent *e)

QWidget::focusOutEvent(QFocusEvent *event) を再実装します。

[override virtual protected] void QComboBox::hideEvent(QHideEvent *e)

QWidget::hideEvent(QHideEvent *event) を再実装します。

[virtual] void QComboBox::hidePopup()

コンボボックス内の項目リストが現在表示されている場合はそれを非表示にし、内部状態をリセットします。これにより、再実装されたshowPopup()内でカスタムポップアップが表示された場合、 その場合は、カスタムポップアップを非表示にするために hidePopup() 関数も再実装し、カスタムポップアップウィジェットが非表示になるたびに、内部状態をリセットするために基底クラスの実装を呼び出す必要があります。

showPopup()も参照してください 。

[signal] void QComboBox::highlighted(int index)

このシグナルは、ユーザーがコンボボックスのポップアップリスト内の項目をハイライトしたときに送信されます。その項目のindex が引数として渡されます。

[virtual protected] void QComboBox::initStyleOption(QStyleOptionComboBox *option) const

option を、QComboBox の値を用いて初期化します。このメソッドは、QStyleOptionComboBox が必要であるものの、すべての情報を自分で入力したくないサブクラスにとって便利です。

QStyleOption::initFrom()も参照してください 。

[override virtual protected] void QComboBox::inputMethodEvent(QInputMethodEvent *e)

QWidget::inputMethodEvent(QInputMethodEvent *event) を再実装しています。

[override virtual] QVariant QComboBox::inputMethodQuery(Qt::InputMethodQuery query) const

QWidget::inputMethodQuery （Qt::InputMethodQuery query）const を再実装します。

void QComboBox::insertItem(int index, const QString &text, const QVariant &userData = QVariant())

`Qt::UserRole` に格納されている `text ` および `userData ` を、指定された `index` のコンボボックスに挿入します。

インデックスが項目の総数以上である場合、新しい項目は既存の項目のリストの末尾に追加されます。インデックスが 0 または負の数である場合、新しい項目は既存の項目のリストの先頭に追加されます。

insertItems()も参照してください 。

void QComboBox::insertItem(int index, const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

icon 、text 、およびuserData （Qt::UserRole に格納されている）を、指定されたindex にあるコンボボックスに挿入します。

インデックスが項目の総数以上である場合、新しい項目は既存の項目のリストの末尾に追加されます。インデックスが 0 または負の数である場合、新しい項目は既存の項目のリストの先頭に追加されます。

insertItems()も参照してください 。

void QComboBox::insertItems(int index, const QStringList &list)

list 内の文字列を、指定されたindex から開始して、コンボボックスに個別の項目として挿入します。

インデックスが項目の総数以上である場合、新しい項目は既存の項目のリストの末尾に追加されます。インデックスが 0 または負の数である場合、新しい項目は既存の項目のリストの先頭に追加されます。

insertItem()も参照してください 。

void QComboBox::insertSeparator(int index)

指定されたindex の位置に、区切り項目をコンボボックスに挿入します。

インデックスが項目の総数以上である場合、新しい項目は既存の項目のリストの末尾に追加されます。インデックスが 0 または負の数である場合、新しい項目は既存の項目のリストの先頭に追加されます。

insertItem()も参照してください 。

QVariant QComboBox::itemData(int index, int role = Qt::UserRole) const

指定されたrole に対応するデータを、指定されたindex としてコンボボックスに返します。このロールに対応するデータがない場合は、無効なQVariant を返します。

「setItemData()」も参照してください 。

QAbstractItemDelegate *QComboBox::itemDelegate() const

ポップアップリストビューで使用されているアイテムデリゲートを返します。

setItemDelegate()も参照してください 。

QIcon QComboBox::itemIcon(int index) const

コンボボックス内の指定されたindex に対応するアイコンを返します。

setItemIcon()も参照してください 。

QString QComboBox::itemText(int index) const

コンボボックス内の指定されたindex に対応するテキストを返します。

setItemText()も参照してください 。

[override virtual protected] void QComboBox::keyPressEvent(QKeyEvent *e)

QWidget::keyPressEvent(QKeyEvent *event) を再実装します。

[override virtual protected] void QComboBox::keyReleaseEvent(QKeyEvent *e)

QWidget::keyReleaseEvent(QKeyEvent *event) を再実装します。

QLineEdit *QComboBox::lineEdit() const

コンボボックス内の項目を編集するために使用されるラインエディットを返します。ラインエディットが存在しない場合は、nullptr を返します。

編集可能なコンボボックスのみがラインエディットを持っています。

setLineEdit()も参照してください 。

[override virtual] QSize QComboBox::minimumSizeHint() const

プロパティ「QWidget::minimumSizeHint 」のアクセス関数を再実装します。

QAbstractItemModel *QComboBox::model() const

コンボボックスで使用されているモデルを返します。

setModel()も参照してください 。

[override virtual protected] void QComboBox::mousePressEvent(QMouseEvent *e)

QWidget::mousePressEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QComboBox::mouseReleaseEvent(QMouseEvent *e)

QWidget::mouseReleaseEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QComboBox::paintEvent(QPaintEvent *e)

QWidget::paintEvent （QPaintEvent *event）を再実装します。

void QComboBox::removeItem(int index)

指定されたindex の項目をコンボボックスから削除します。インデックスが削除された場合、現在のインデックスが更新されます。

index が範囲外の場合、この関数は何も実行しません。

[override virtual protected] void QComboBox::resizeEvent(QResizeEvent *e)

QWidget::resizeEvent(QResizeEvent *event) を再実装します。

QModelIndex QComboBox::rootModelIndex() const

コンボボックス内の各項目のルートモデル項目のインデックスを返します。

setRootModelIndex()も参照してください 。

void QComboBox::setCompleter(QCompleter *completer)

現在のコンプリート機能の代わりに使用するcompleter を設定します。completer がnullptr の場合、自動補完は無効になります。

デフォルトでは、編集可能なコンボボックスの場合、大文字小文字を区別しないインライン補完を行うQCompleter が自動的に作成されます。

completer()も参照してください 。

[slot] void QComboBox::setEditText(const QString &text)

コンボボックスのテキスト編集欄に「text 」を設定します。

void QComboBox::setItemData(int index, const QVariant &value, int role = Qt::UserRole)

コンボボックス内の指定されたindex にある項目のデータrole を、指定されたvalue に設定します。

itemData()も参照してください 。

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

ポップアップリストビューのdelegate プロパティを設定します。コンボボックスは、このデリゲートの所有権を取得します。

既存のデリゲートは削除されますが、消去されることはありません。QComboBox はdelegate の所有権を取得しません。

itemDelegate()も参照してください 。

void QComboBox::setItemIcon(int index, const QIcon &icon)

コンボボックス内の指定されたindex にある項目のicon を設定します。

「itemIcon()」も参照してください 。

void QComboBox::setItemText(int index, const QString &text)

コンボボックス内の指定されたindex にある項目のtext を設定します。

「itemText()」も参照してください 。

void QComboBox::setLineEdit(QLineEdit *edit)

現在のラインエディットウィジェットの代わりに使用するedit を設定します。

コンボボックスがラインエディットの所有権を取得します。

lineEdit()も参照してください 。

[virtual] void QComboBox::setModel(QAbstractItemModel *model)

モデルをmodel に設定します。model はnullptr であってはなりません。モデルの内容をクリアしたい場合は、clear()を呼び出してください。

関連項目： model()、clear()、およびsetCompleter()。

void QComboBox::setRootModelIndex(const QModelIndex &index)

コンボボックス内の項目に対して、ルートモデル項目「index 」を設定します。

rootModelIndex()も参照してください 。

void QComboBox::setValidator(const QValidator *validator)

現在のバリデータに代えて使用するvalidator を設定します。

validator()も参照してください 。

void QComboBox::setView(QAbstractItemView *itemView)

コンボボックスのポップアップで使用するビューを、指定されたitemView に設定します。コンボボックスがこのビューの所有権を取得します。

注：便利ビュー（QListWidget 、QTableWidget 、QTreeWidget など）を使用する場合は、この関数を呼び出す前に、コンボボックスに対して、便利ウィジェットのモデルを引数としてsetModel()を呼び出すようにしてください。

view()も参照してください 。

[override virtual protected] void QComboBox::showEvent(QShowEvent *e)

QWidget::showEvent(QShowEvent *event) を再実装します。

[virtual] void QComboBox::showPopup()

コンボボックス内の項目のリストを表示します。リストが空の場合、項目は表示されません。

この関数を再実装してカスタムポップアップを表示する場合は、hidePopup() を呼び出して内部状態をリセットするようにしてください。

hidePopup()も参照してください 。

[override virtual] QSize QComboBox::sizeHint() const

プロパティ「QWidget::sizeHint 」のアクセス関数を再実装します。

この実装では、内容が動的に変化した際にサイズ変更が行われないよう、サイズヒントをキャッシュします。キャッシュされた値を無効にするには、sizeAdjustPolicy を変更してください。

[signal] void QComboBox::textActivated(const QString &text)

このシグナルは、ユーザーがコンボボックス内の項目を選択したときに送信されます。選択された項目のtext が渡されます。なお、このシグナルは、選択内容が変更されなかった場合でも送信されることに注意してください。選択内容が実際に変更されたタイミングを把握する必要がある場合は、currentIndexChanged() またはcurrentTextChanged() シグナルを使用してください。

[signal] void QComboBox::textHighlighted(const QString &text)

このシグナルは、コンボボックスのポップアップリスト内の項目がユーザーによって選択されたときに送信されます。その項目のtext が引数として渡されます。

const QValidator *QComboBox::validator() const

コンボボックスのテキスト入力に制約を課すために使用されるバリデータ返します。

setValidator() およびeditableも参照してください 。

QAbstractItemView *QComboBox::view() const

コンボボックスのポップアップに使用されるリストビューを返します。

setView()も参照してください 。

[override virtual protected] void QComboBox::wheelEvent(QWheelEvent *e)

QWidget::wheelEvent(QWheelEvent *event) を再実装します。