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 * 이벤트).

[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 * 이벤트).

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

이 신호는 사용자 상호작용 또는 프로그래밍 방식으로 콤보박스의 currentIndex 가 변경될 때마다 전송됩니다. 콤보 박스가 비어 있거나 currentIndex 이 재설정된 경우 항목의 index 이 전달되거나 -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 * 이벤트).

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 * 이벤트).

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

다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).

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

다시 구현합니다: QWidget::hideEvent(QHideEvent * 이벤트).

[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(Q입력메소드이벤트 *이벤트).

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

재구현합니다: QWidget::inputMethodQuery(Qt::InputMethodQuery 쿼리) const.

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

지정된 index 의 콤보박스에 text 및 userData ( Qt::UserRole 에 저장됨)을 삽입합니다.

인덱스가 총 항목 수보다 크거나 같으면 새 항목이 기존 항목 목록에 추가됩니다. 인덱스가 0이거나 음수이면 새 항목이 기존 항목 목록에 앞에 추가됩니다.

insertItems()도 참조하세요 .

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

지정된 index 의 콤보박스에 icon, text 및 userData ( Qt::UserRole 에 저장됨)을 삽입합니다.

인덱스가 총 항목 수보다 크거나 같으면 새 항목이 기존 항목 목록에 추가됩니다. 인덱스가 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

콤보 상자의 지정된 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 * 이벤트).

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

다시 구현합니다: QWidget::keyReleaseEvent(QKeyEvent * 이벤트).

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 * 이벤트).

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

다시 구현합니다: QWidget::mouseReleaseEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).

void QComboBox::removeItem(int index)

콤보 상자에서 지정된 index 에 있는 항목을 제거합니다. 인덱스가 제거되면 현재 인덱스가 업데이트됩니다.

index 이 범위를 벗어나면 이 함수는 아무 작업도 수행하지 않습니다.

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

다시 구현합니다: QWidget::resizeEvent(QResizeEvent * 이벤트).

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 * 이벤트).

[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 * 이벤트).