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

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

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

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

QWidget::focusInEvent(QFocusEvent *event)를 재구현합니다.

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

QWidget::focusNextPrevChild(bool next)를 재구현합니다.

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

QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.

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

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

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

QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.

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

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

QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.

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

QWidget::mouseReleaseEvent(QMouseEvent *event)을 재구현합니다.

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 로 설정합니다.

사용자가 이 레이블에 지정된 단축키를 누르면, 키보드 포커스가 해당 레이블의 버디 위젯으로 이동합니다.

버디 메커니즘은 텍스트 중 한 글자 앞에 앰퍼샌드('&')가 붙은 QLabel에서만 사용할 수 있습니다. 이 문자가 단축키로 설정됩니다. 자세한 내용은 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을 누르면 Name 필드로, Alt+P를 누르면 Phone 필드로 포커스가 이동합니다.

이전에 설정된 버디를 해제하려면 ` buddy `을 `nullptr`으로 설정하여 이 함수를 호출하십시오.

buddy(), setText(), QShortcut 및 setAlignment()도 참조하십시오 .

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

라벨의 내용을 ‘ movie ’로 설정합니다. 기존 내용은 모두 지워집니다. 라벨은 영화의 소유권을 가져오지 않습니다.

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

movie() 및 setBuddy()도 참조하십시오 .

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

라벨의 내용을 정수 num 의 문자열 표현을 포함한 일반 텍스트로 설정합니다. 기존 내용은 모두 지워집니다. 정수의 문자열 표현이 라벨의 현재 내용과 동일한 경우에는 아무런 작업도 수행하지 않습니다.

버디 단축키가 있는 경우 비활성화됩니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        label, qOverload(&QLabel::setNum));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        label, [receiver = label](int num) { receiver->setNum(num); });

setText(), QString::setNum(), setBuddy()도 참조하십시오 .

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

라벨의 내용을 double num 의 문자열 표현을 포함하는 일반 텍스트로 설정합니다. 기존 내용은 모두 지워집니다. double의 문자열 표현이 라벨의 현재 내용과 동일한 경우 아무 작업도 수행하지 않습니다.

버디 단축키가 있는 경우 비활성화됩니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        label, qOverload(&QLabel::setNum));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        label, [receiver = label](double num) { receiver->setNum(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를 재구현합니다.