QLabel Class

Documentación de las funciones miembro

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

Construye una etiqueta vacía.

Los argumentos parent y widget flag f, se pasan al constructor QFrame.

Véase también setAlignment(), setFrameStyle() y setIndent().

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

Construye una etiqueta que muestra el texto text.

Los argumentos parent y widget flag f, se pasan al constructor QFrame.

Véase también setText(), setAlignment(), setFrameStyle() y setIndent().

[virtual noexcept] QLabel::~QLabel()

Destruye la etiqueta.

QWidget *QLabel::buddy() const

Devuelve el compañero de esta etiqueta, o nullptr si no hay ningún compañero.

Véase también setBuddy().

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

Reimplementa: QFrame::changeEvent(QEvent *ev).

[slot] void QLabel::clear()

Borra cualquier contenido de la etiqueta.

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

Reimplementa: QWidget::contextMenuEvent(QContextMenuEvent *event).

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

Reimplementa: QFrame::event(QEvent *e).

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

Reimplementa: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplementa: QWidget::focusNextPrevChild(bool next).

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

Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).

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

Reimplementa: QWidget::heightForWidth(int w) const.

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

Reimplementa: QWidget::keyPressEvent(QKeyEvent *event).

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

Esta señal se emite cuando el usuario hace clic en un enlace. La URL a la que hace referencia el ancla se pasa en link.

Véase también linkHovered().

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

Esta señal se emite cuando el usuario pasa el ratón por encima de un enlace. La URL a la que hace referencia el ancla se pasa en link.

Véase también linkActivated().

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

Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.

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

Reimplementa: QWidget::mouseMoveEvent(QMouseEvent *event).

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

Reimplementa: QWidget::mousePressEvent(QMouseEvent *event).

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

Reimplementa: QWidget::mouseReleaseEvent(QMouseEvent *event).

QMovie *QLabel::movie() const

Devuelve un puntero a la película de la etiqueta, o nullptr si no se ha establecido ninguna película.

Véase también setMovie().

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

Reimplementa: QFrame::paintEvent(QPaintEvent *).

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

Devuelve la imagen de la etiqueta.

Esta función se introdujo en Qt 6.0.

Véase también setPicture().

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

Devuelve el proveedor de recursos para el texto enriquecido de esta etiqueta.

Esta función se introdujo en Qt 6.1.

Véase también setResourceProvider().

int QLabel::selectionStart() const

selectionStart() devuelve el índice del primer carácter seleccionado en la etiqueta o -1 si no hay texto seleccionado.

Nota: El conjunto textInteractionFlags de la etiqueta debe incluir TextSelectableByMouse o TextSelectableByKeyboard.

Véase también selectedText().

void QLabel::setBuddy(QWidget *buddy)

Establece el amigo de esta etiqueta en buddy.

Cuando el usuario pulsa la tecla de acceso directo indicada por esta etiqueta, el foco del teclado se transfiere al widget amigo de la etiqueta.

El mecanismo de amigo sólo está disponible para QLabels que contengan texto en el que un carácter vaya precedido de un ampersand, '&'. Este carácter se establece como la tecla de acceso directo. Consulte la documentación de QKeySequence::mnemonic() para más detalles (para mostrar un ampersand real, utilice '&&').

En un diálogo, puedes crear dos widgets de entrada de datos y una etiqueta para cada uno, y configurar el diseño geométrico para que cada etiqueta esté justo a la izquierda de su widget de entrada de datos (su "amigo"), por ejemplo:

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)

Con el código anterior, el foco salta al campo Nombre cuando el usuario pulsa Alt+N, y al campo Teléfono cuando el usuario pulsa Alt+P.

Para anular la selección de un amigo, llame a esta función con buddy a nullptr.

Véase también buddy(), setText(), QShortcut, y setAlignment().

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

Establece el contenido de la etiqueta en movie. Se borra cualquier contenido anterior. La etiqueta NO se apropia de la película.

El acceso directo de amigo, si existe, se desactiva.

Véase también movie() y setBuddy().

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

Establece el contenido de la etiqueta en texto sin formato que contiene la representación textual del número entero num. Se borra cualquier contenido anterior. No hace nada si la representación textual del entero es la misma que el contenido actual de la etiqueta.

El acceso directo de amigo, si existe, se desactiva.

// 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); });

Véase también setText(), QString::setNum() y setBuddy().

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

Establece el contenido de la etiqueta en texto sin formato que contiene la representación textual del doble num. Se borra cualquier contenido anterior. No hace nada si la representación textual del double es la misma que el contenido actual de la etiqueta.

El acceso directo de amigo, si existe, se desactiva.

// 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); });

Véase también setText(), QString::setNum() y setBuddy().

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

Establece el contenido de la etiqueta en picture. Se borra cualquier contenido anterior.

El acceso directo a amigos, si existe, se desactiva.

Véase también picture() y setBuddy().

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

Establece el provider de recursos para texto enriquecido de esta etiqueta.

Esta función se introdujo en Qt 6.1.

Véase también resourceProvider().

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

Selecciona texto a partir de la posición start y para caracteres length.

Nota: El conjunto textInteractionFlags de la etiqueta debe incluir TextSelectableByMouse o TextSelectableByKeyboard.

Véase también selectedText().

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

Reimplementa: QFrame::sizeHint() const.