QComboBox Class

メンバ関数ドキュメント

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

デフォルトモデルQStandardItemModel を用いて、与えられたparent でコンボボックスを構築します。

[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

このQComboBox の値でoption を初期化する。このメソッドは、サブクラスが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())

与えられたindex のコンボボックスにtext とuserData (Qt::UserRole に格納) を挿入する。

インデックスがアイテムの総数と同じかそれ以上の場合、新しいアイテムは既存のアイテムのリストに追加されます。インデックスがゼロか負の場合、新しい項目は既存の項目のリストに追加されます。

insertItems()も参照 。

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

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

インデックスがアイテムの総数と同じかそれ以上の場合、新しいアイテムは既存のアイテムのリストに追加されます。インデックスがゼロか負の場合、新しい項目は既存の項目のリストに追加されます。

insertItems()も参照 。

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

list 、指定されたindex からコンボボックスに文字列を挿入する。

インデックスがアイテムの総数と同じかそれ以上の場合、新しいアイテムは既存のアイテムのリストに追加されます。インデックスがゼロか負の場合、新しい項目は既存の項目のリストに追加されます。

insertItem()も参照 。

void QComboBox::insertSeparator(int index)

指定されたindex にあるコンボボックスにセパレータ項目を挿入する。

インデックスがアイテムの総数と同じかそれ以上の場合、新しいアイテムは既存のアイテムのリストに追加されます。インデックスがゼロか負の場合、新しい項目は既存の項目のリストに追加されます。

insertItem()も参照 。

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

コンボボックスの指定されたindex の指定されたrole のデータを返すか、この役割のデータがない場合は無効な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 orQTreeWidget)を使用したい場合、この関数を呼び出す前に、コンビニエンス・ウィジェット・モデルを持つコンボボックスで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)。