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() は、ラベル内で最初に選択された文字のインデックスを返します。

注意:ラベルに設定されているtextInteractionFlags は、 TextSelectableByMouse か TextSelectableByKeyboard のどちらかを含んでいる必要があります。

selectedText()も参照してください 。

void QLabel::setBuddy(QWidget *buddy)

このラベルのバディをbuddy に設定します。

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

バディ機構は、アンパサンド '&' を先頭に持つテキストを含む QLabels でのみ使用できます。この文字はショートカットキーとして設定されます。詳細は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 のテキスト表現を含むプレーンテキストに設定する。以前の内容はすべてクリアされる。整数の文字列表現が現在のラベルの内容と同じ場合は何もしません。

バディショートカットがあれば、それを無効にします。

setText()、QString::setNum()、setBuddy()も参照 。

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

これはオーバーロードされた関数である。

ラベルの内容を、num のテキスト表現を含むプレーンテキストに設定します。以前の内容はすべてクリアされます。double の文字列表現が現在のラベルの内容と同じ場合は何もしません。

バディショートカットがあれば、それを無効にする。

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.