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)

再リンプルメント: (QContextMenuEvent *event)：QFrame::event(QEvent *e)。

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

再リンプルメント: (QEvent *e)：QWidget::focusInEvent(QFocusEvent *event)。

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

再リンプルメント: (QFocusEvent *event)：QWidget::focusNextPrevChild(bool next)。

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

再リンプルメント: (bool next)：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)

再リプルメント: (int w) const：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)

再リンプルメント: (QMouseEvent *event)：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)

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

ラベルの内容を、doublenum のテキスト表現を含むプレーンテキストに設定する。以前の内容はすべてクリアされます。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.