QLabel Class

멤버 함수 문서

[explicit] QLabel::QLabel(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

빈 레이블을 생성합니다.

parent 및 위젯 플래그 f, 인수는 QFrame 생성자에게 전달됩니다.

setAlignment(), setFrameStyle() 및 setIndent()도 참조하세요 .

[explicit] QLabel::QLabel(const QString &text, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

텍스트 text 를 표시하는 레이블을 생성합니다.

parent 및 위젯 플래그 f, 인수는 QFrame 생성자에게 전달됩니다.

setText(), setAlignment(), setFrameStyle() 및 setIndent()도 참조하세요 .

[virtual noexcept] QLabel::~QLabel()

레이블을 삭제합니다.

QWidget *QLabel::buddy() const

이 레이블의 버디를 반환하거나 현재 설정된 버디가 없는 경우 nullptr을 반환합니다.

setBuddy()도 참조하세요 .

[override virtual protected] void QLabel::changeEvent(QEvent *ev)

다시 구현합니다: QFrame::changeEvent(QEvent *ev).

[slot] void QLabel::clear()

모든 레이블 콘텐츠를 지웁니다.

[override virtual protected] void QLabel::contextMenuEvent(QContextMenuEvent *ev)

다시 구현합니다: QWidget::contextMenuEvent(QContextMenuEvent * 이벤트).

[override virtual protected] bool QLabel::event(QEvent *e)

다시 구현합니다: QFrame::event(QEvent *e).

[override virtual protected] void QLabel::focusInEvent(QFocusEvent *ev)

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

[override virtual protected] bool QLabel::focusNextPrevChild(bool next)

다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).

[override virtual protected] void QLabel::focusOutEvent(QFocusEvent *ev)

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

[override virtual] int QLabel::heightForWidth(int w) const

재구현합니다: QWidget::heightForWidth(int w) const.

[override virtual protected] void QLabel::keyPressEvent(QKeyEvent *ev)

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

[signal] void QLabel::linkActivated(const QString &link)

이 신호는 사용자가 링크를 클릭할 때 발생합니다. 앵커가 참조하는 URL은 link 으로 전달됩니다.

linkHovered()도 참조하세요 .

[signal] void QLabel::linkHovered(const QString &link)

이 신호는 사용자가 링크 위로 마우스를 가져가면 발산됩니다. 앵커가 참조하는 URL은 link 으로 전달됩니다.

linkActivated()도 참조하세요 .

[override virtual] QSize QLabel::minimumSizeHint() const

속성에 대한 액세스 함수를 다시 구현합니다: QWidget::minimumSizeHint.

[override virtual protected] void QLabel::mouseMoveEvent(QMouseEvent *ev)

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

[override virtual protected] void QLabel::mousePressEvent(QMouseEvent *ev)

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

[override virtual protected] void QLabel::mouseReleaseEvent(QMouseEvent *ev)

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

QMovie *QLabel::movie() const

레이블의 동영상에 대한 포인터를 반환하거나 동영상이 설정되지 않은 경우 nullptr을 반환합니다.

setMovie()도 참조하세요 .

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

다시 구현합니다: QFrame::paintEvent(QPaintEvent *).

[since 6.0] QPicture QLabel::picture() const

라벨의 사진을 반환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

setPicture()도 참조하세요 .

[since 6.1] QTextDocument::ResourceProvider QLabel::resourceProvider() const

이 레이블의 서식 있는 텍스트에 대한 리소스 공급자를 반환합니다.

이 함수는 Qt 6.1에 도입되었습니다.

setResourceProvider()도 참조하십시오 .

int QLabel::selectionStart() const

selectionStart()는 레이블에서 처음 선택된 문자의 인덱스를 반환하거나 텍스트가 선택되지 않은 경우 -1을 반환합니다.

참고: 레이블에 설정된 textInteractionFlags 에는 TextSelectableByMouse 또는 TextSelectableByKeyboard 중 하나가 포함되어야 합니다.

selectedText()도 참조하세요 .

void QLabel::setBuddy(QWidget *buddy)

이 레이블의 버디를 buddy 로 설정합니다.

사용자가 이 레이블로 표시된 단축키를 누르면 키보드 초점이 레이블의 버디 위젯으로 이동합니다.

버디 메커니즘은 한 문자 앞에 앰퍼샌드인 '&'가 붙은 텍스트가 포함된 Q레이블에만 사용할 수 있습니다. 이 문자는 바로 가기 키로 설정됩니다. 자세한 내용은 QKeySequence::mnemonic() 문서를 참조하세요(실제 앰퍼샌드를 표시하려면 '&&'를 사용하세요).

예를 들어 대화 상자에서 두 개의 데이터 입력 위젯과 각각에 대한 레이블을 만들고 각 레이블이 데이터 입력 위젯('버디')의 왼쪽에 위치하도록 지오메트리 레이아웃을 설정할 수 있습니다:

QLineEdit *nameEdit  = new QLineEdit(this);
QLabel    *nameLabel = new QLabel("&Name:", this);
nameLabel->setBuddy(nameEdit);
QLineEdit *phoneEdit  = new QLineEdit(this);
QLabel    *phoneLabel = new QLabel("&Phone:", this);
phoneLabel->setBuddy(phoneEdit);
// (layout setup not shown)

위의 코드를 사용하면 사용자가 Alt+N을 누르면 초점이 이름 필드로 이동하고, 사용자가 Alt+P를 누르면 전화 필드로 이동합니다.

이전에 설정된 버디를 해제하려면 buddy 을 nullptr로 설정하여 이 함수를 호출합니다.

buddy(), setText(), QShortcut, 및 setAlignment()도 참조하세요 .

[slot] void QLabel::setMovie(QMovie *movie)

레이블 콘텐츠를 movie 로 설정합니다. 이전 콘텐츠는 모두 지워집니다. 레이블은 동영상의 소유권을 갖지 않습니다.

버디 바로가기가 있는 경우 비활성화됩니다.

movie() 및 setBuddy()도 참조하세요 .

[slot] void QLabel::setNum(int num)

레이블 콘텐츠를 정수의 텍스트 표현이 포함된 일반 텍스트 num 로 설정합니다. 이전 콘텐츠는 모두 지워집니다. 정수의 문자열 표현이 레이블의 현재 내용과 같으면 아무 작업도 수행하지 않습니다.

버디 바로가기가 있는 경우 비활성화됩니다.

setText(), QString::setNum() 및 setBuddy()도 참조하세요 .

[slot] void QLabel::setNum(double num)

이 함수는 과부하된 함수입니다.

레이블 콘텐츠를 이중 num 의 텍스트 표현이 포함된 일반 텍스트로 설정합니다. 이전 콘텐츠는 모두 지워집니다. 이중의 문자열 표현이 레이블의 현재 내용과 같으면 아무 작업도 수행하지 않습니다.

버디 바로가기가 있는 경우 비활성화됩니다.

setText(), QString::setNum() 및 setBuddy()도 참조하세요 .

[slot] void QLabel::setPicture(const QPicture &picture)

레이블 콘텐츠를 picture 로 설정합니다. 이전 콘텐츠는 모두 지워집니다.

친구 바로 가기가 있는 경우 비활성화됩니다.

picture() 및 setBuddy()도 참조하세요 .

[since 6.1] void QLabel::setResourceProvider(const QTextDocument::ResourceProvider &provider)

이 레이블의 서식 있는 텍스트에 대한 리소스의 provider 을 설정합니다.

이 함수는 Qt 6.1에 도입되었습니다.

resourceProvider()도 참조하세요 .

void QLabel::setSelection(int start, int length)

start 위치 및 length 문자에 대한 텍스트를 선택합니다.

참고: 레이블에 설정된 textInteractionFlags 에는 TextSelectableByMouse 또는 TextSelectableByKeyboard 중 하나가 포함되어야 합니다.

selectedText()도 참조하세요 .

[override virtual] QSize QLabel::sizeHint() const

재구현합니다: QFrame::sizeHint() const.