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 を含むアイテムのインデックスを返す。

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)

再リンプルメント: (QFocusEvent *event)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)

再リンプルメント: (QMouseEvent *event)：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 を設定します。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)。