QCompleter Class

멤버 함수 설명서

QCompleter::QCompleter(QObject *parent = nullptr)

주어진 ` parent`를 사용하여 `completer` 객체를 생성합니다.

QCompleter::QCompleter(QAbstractItemModel *model, QObject *parent = nullptr)

주어진 ` parent `을 사용하여, 지정된 ` model`에서 자동 완성 항목을 제공하는 `completer` 객체를 생성합니다.

QCompleter::QCompleter(const QStringList &list, QObject *parent = nullptr)

주어진 ` parent `를 사용하여 `QCompleter` 객체를 생성하며, 이 객체는 지정된 ` list `를 가능한 완성 항목의 소스로 사용합니다.

[override virtual noexcept] QCompleter::~QCompleter()

완료자 객체를 삭제합니다.

[signal] void QCompleter::activated(const QModelIndex &index)

이 신호는 사용자가 ` popup()` 내의 항목을 활성화할 때(클릭하거나 리턴 키를 누를 때) 전송됩니다. ` completionModel()` 내의 해당 항목의 ` index `가 전달됩니다.

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::activated),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::activated),
        this, [](const QModelIndex &index) { /* handle activated */ });

[signal] void QCompleter::activated(const QString &text)

이 신호는 사용자가 popup() 내의 항목을 활성화(클릭하거나 리턴 키를 누름)했을 때 전송됩니다. 해당 항목의 text 가 제공됩니다.

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::activated),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::activated),
        this, [](const QString &text) { /* handle activated */ });

[slot] void QCompleter::complete(const QRect &rect = QRect())

QCompleter::PopupCompletion 및 QCompletion::UnfilteredPopupCompletion 모드의 경우, 이 함수를 호출하면 현재 완성 후보를 표시하는 팝업이 나타납니다. 기본적으로 rect 가 지정되지 않은 경우, 팝업은 widget()의 하단에 표시됩니다. rect 가 지정된 경우, 팝업은 사각형의 왼쪽 가장자리에 표시됩니다.

QCompleter::InlineCompletion 모드에서는 highlighted() 신호가 현재 완성 후보와 함께 발동됩니다.

int QCompleter::completionCount() const

현재 접두사에 대한 완성 결과의 개수를 반환합니다. 항목 수가 많은 정렬되지 않은 모델의 경우 이 작업에 많은 시간이 소요될 수 있습니다. 모든 완성 결과를 순차적으로 확인하려면 setCurrentRow() 및 currentCompletion()을 사용하십시오.

QAbstractItemModel *QCompleter::completionModel() const

완성 모델을 반환합니다. 완성 모델은 현재 완성 접두사에 대한 모든 가능한 일치 항목을 포함하는 읽기 전용 목록 모델입니다. 완성 모델은 현재 완성 결과를 반영하도록 자동으로 업데이트됩니다.

completionPrefix 및 model()도 참조하십시오 .

QString QCompleter::currentCompletion() const

현재 완성 문자열을 반환합니다. 여기에는 ` completionPrefix`도 포함됩니다. ` setCurrentRow()`와 함께 사용하면 모든 일치 항목을 순회하는 데 활용할 수 있습니다.

setCurrentRow() 및 currentIndex()도 참조하십시오 .

QModelIndex QCompleter::currentIndex() const

completionModel()에서 현재 자동 완성 항목의 모델 인덱스를 반환합니다.

setCurrentRow(), currentCompletion() 및 model()도 참조하십시오 .

int QCompleter::currentRow() const

현재 행을 반환합니다.

setCurrentRow()도 참조하십시오 .

[override virtual protected] bool QCompleter::event(QEvent *ev)

QObject::event(QEvent *e)를 재구현합니다.

[override virtual protected] bool QCompleter::eventFilter(QObject *o, QEvent *e)

QObject::eventFilter(QObject *watched, QEvent *event)를 재구현합니다.

[signal] void QCompleter::highlighted(const QModelIndex &index)

이 신호는 popup() 내의 항목이 사용자에 의해 선택되었을 때 전송됩니다. 또한 completionMode()이 QCompleter::InlineCompletion 로 설정된 상태에서 complete()이 호출될 때도 전송됩니다. completionModel() 내의 해당 항목의 index 가 제공됩니다.

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::highlighted),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::highlighted),
        this, [](const QModelIndex &index) { /* handle highlighted */ });

[signal] void QCompleter::highlighted(const QString &text)

이 신호는 popup()의 항목이 사용자에 의해 강조 표시될 때 전송됩니다. 또한 completionMode()가 QCompleter::InlineCompletion 로 설정된 상태에서 complete()가 호출될 때도 전송됩니다. 해당 항목의 text 가 전달됩니다.

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::highlighted),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::highlighted),
        this, [](const QString &text) { /* handle highlighted */ });

QAbstractItemModel *QCompleter::model() const

완성 문자열을 제공하는 모델을 반환합니다.

setModel() 및 completionModel()도 참조하십시오 .

[virtual] QString QCompleter::pathFromIndex(const QModelIndex &index) const

지정된 index 의 경로를 반환합니다. 컴플리터 객체는 이를 사용하여 기본 모델에서 완성 텍스트를 가져옵니다.

기본 구현은 목록 모델의 경우 해당 항목의 ` edit role `를 반환합니다. 모델이 ` QFileSystemModel`인 경우 절대 파일 경로를 반환합니다.

splitPath()도 참조하십시오 .

QAbstractItemView *QCompleter::popup() const

완성 항목을 표시하는 데 사용되는 팝업을 반환합니다.

setPopup()도 참조하십시오 .

bool QCompleter::setCurrentRow(int row)

현재 행을 지정된 row 로 설정합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

이 함수는 currentCompletion()와 함께 사용하여 가능한 모든 완성 후보를 순회할 수 있습니다.

currentRow(), currentCompletion() 및 completionCount()도 참조하십시오 .

void QCompleter::setModel(QAbstractItemModel *model)

model 에 자동 완성 기능을 제공하는 모델을 설정합니다. model 는 목록 모델이거나 트리 모델일 수 있습니다. 이전에 이미 모델이 설정되어 있고 해당 모델의 부모가 QCompleter 인 경우, 해당 모델은 삭제됩니다.

편의상, model 가 QFileSystemModel 인 경우, QCompleter 는 Windows에서는 caseSensitivity 를 Qt::CaseInsensitive 로, 다른 플랫폼에서는 Qt::CaseSensitive 로 변경합니다.

completionModel(), modelSorting 및 Handling Tree Models도 참조하십시오 .

void QCompleter::setPopup(QAbstractItemView *popup)

완성 항목을 표시하는 데 사용되는 팝업을 ` popup`로 설정합니다. ` QCompleter `가 뷰의 소유권을 가져갑니다.

completionMode()가 QCompleter::PopupCompletion 또는 QCompleter::UnfilteredPopupCompletion 로 설정되면 QListView 가 자동으로 생성됩니다. 기본 팝업은 completionColumn()를 표시합니다.

뷰 설정을 수정하기 전에 이 함수가 호출되도록 해야 합니다. 뷰의 속성 중 일부는 뷰에 모델이 설정되어 있어야만 작동할 수 있기 때문입니다(예를 들어, 뷰에서 열을 숨기려면 뷰에 모델이 설정되어 있어야 합니다).

popup()도 참조하십시오 .

void QCompleter::setWidget(QWidget *widget)

완성 기능을 제공할 위젯을 ` widget`로 설정합니다. 이 함수는 ` QLineEdit::setCompleter()`를 사용하여 ` QLineEdit `에 ` QCompleter `를 설정하거나, ` QComboBox::setCompleter()`를 사용하여 ` QComboBox `에 ` `를 설정할 때 자동으로 호출됩니다. 사용자 정의 위젯에 대해 완성 기능을 제공하려면 위젯을 명시적으로 설정해야 합니다.

widget(), setModel() 및 setPopup()도 참조하십시오 .

[virtual] QStringList QCompleter::splitPath(const QString &path) const

주어진 ` path `을 ` model()`의 각 수준에서 일치시키는 데 사용되는 문자열로 분할합니다.

splitPath()의 기본 구현은 sourceModel()이 QFileSystemModel 일 때, QDir::separator()을 기반으로 파일 시스템 경로를 분할합니다.

리스트 모델과 함께 사용될 경우, 반환된 리스트의 첫 번째 항목이 일치 확인에 사용됩니다.

pathFromIndex() 및 Handling Tree Models도 참조하십시오 .

QWidget *QCompleter::widget() const

완성기 객체가 자동 완성 기능을 제공하는 위젯을 반환합니다.

setWidget()도 참조하십시오 .