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`을 가지며, ` Qt::UserRole`에 저장된 ` userData `을 포함하는 항목을 콤보박스에 추가합니다. 이 항목은 기존 항목 목록의 끝에 추가됩니다.

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)를 재구현합니다.