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 」に設定します。

ユーザーがこのラベルで指定されたショートカットキーを押すと、キーボードフォーカスがこのラベルのバディウィジェットに移ります。

バディ機能は、テキスト内の 1 文字の先頭にアンパサンド「&」が付いている QLabel でのみ利用可能です。この文字がショートカットキーとして設定されます。詳細については、QKeySequence::mnemonic() のドキュメントを参照してください（実際のアンパサンドを表示するには、「&&」を使用してください）。

ダイアログでは、2つのデータ入力ウィジェットと、それぞれに対応するラベルを作成し、各ラベルがそのデータ入力ウィジェット（「バディ」）のすぐ左側に配置されるようにジオメトリレイアウトを設定することができます。例えば、次のようにします。

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 を再実装します。