QCompleter Class

멤버 함수 문서

QCompleter::QCompleter(QObject *parent = nullptr)

주어진 parent 로 컴플리터 객체를 생성합니다.

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

지정된 parent 으로 지정된 model 에서 완성을 제공하는 완성자 객체를 생성합니다.

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

지정된 list 을 가능한 완성 소스로 사용하는 지정된 parent 으로 QCompleter 객체를 구축합니다.

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

완성 객체를 파괴합니다.

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

이 신호는 사용자가 popup()의 항목을 활성화할 때 전송됩니다. (클릭하거나 Return 키를 눌러). completionModel ()에 있는 항목은 index 입니다.

참고: 이 클래스에서는 활성화된 신호에 과부하가 걸립니다. 함수 포인터 구문을 사용하여 이 신호에 연결하려면 이 예제와 같이 함수 포인터를 얻기 위한 편리한 헬퍼를 Qt에서 제공합니다:

connect(completer, QOverload<const QModelIndex &>::of(&QCompleter::activated),
    [=](const QModelIndex &index){ /* ... */ });

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

이 신호는 사용자가 popup()의 항목을 활성화할 때(클릭하거나 Return 키를 눌러) 전송됩니다. 항목의 text 이 주어집니다.

참고: 이 클래스에서는 활성화된 신호가 오버로드됩니다. 함수 포인터 구문을 사용하여 이 신호에 연결하려면 이 예제와 같이 함수 포인터를 얻기 위한 편리한 도우미를 Qt에서 제공합니다:

connect(completer, QOverload<const QString &>::of(&QCompleter::activated),
    [=](const QString &text){ /* ... */ });

[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 이 주어집니다.

참고: 강조 표시된 신호는 이 클래스에서 오버로드됩니다. 함수 포인터 구문을 사용하여 이 신호에 연결하려면 이 예제와 같이 함수 포인터를 얻기 위한 편리한 헬퍼를 Qt에서 제공합니다:

connect(completer, QOverload<const QModelIndex &>::of(&QCompleter::highlighted),
    [=](const QModelIndex &index){ /* ... */ });

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

이 신호는 사용자가 popup()의 항목을 강조 표시할 때 전송됩니다. completionMode ()가 QCompleter::InlineCompletion 로 설정된 상태에서 complete()가 호출되는 경우에도 전송됩니다. 항목의 text 이 주어집니다.

참고: 강조 표시된 신호는 이 클래스에서 오버로드됩니다. 함수 포인터 구문을 사용하여 이 신호에 연결하려면 이 예제와 같이 함수 포인터를 얻기 위한 편리한 헬퍼를 Qt에서 제공합니다:

connect(completer, QOverload<const QString &>::of(&QCompleter::highlighted),
    [=](const QString &text){ /* ... */ });

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()도 참조하세요 .