QLabel Class Reference


The QLabel widget displays a static text or pixmap. More...

#include <qlabel.h>

Inherits QFrame.

List of all member functions.

Public Members

Public Slots

Protected Members


Detailed Description

The QLabel widget displays a static text or pixmap.

A label is a text or pixmap field that can have an optional frame (since QLabel inherits QFrame).

The contents of a label can be specified as a normal text, as a numeric value (which is internally converted to a text) or, as a pixmap.

A label can be aligned in many different ways. The alignment setting specifies where to position the contents relative to the frame rectangle. See setAlignment() for a description of the alignment flags.

Enabling auto-resizing will make a label resize itself whenever the contents change. The top left corner is kept unchanged.

Example of use:

    QLabel *label = new QLabel;
    label->setFrameStyle( QFrame::Panel | QFrame::Sunken );
    label->setText( "first line\nsecond line" );
    label->setAlignment( AlignBottom | AlignRight );

Examples: tictac/tictac.cpp forever/forever.cpp menu/menu.cpp qmag/qmag.cpp cursor/cursor.cpp widgets/widgets.cpp


Member Function Documentation

QLabel::QLabel ( QWidget *parent=0, const char *name=0, WFlags f=0)

Constructs an empty label which is left-aligned, vertically centered, has an automatic margin and with manual resizing.

The parent, name and f arguments are passed to the QFrame constructor.

See also: setAlignment(), setFrameStyle(), setMargin() and setAutoResize().

QLabel::QLabel ( const char *text, QWidget *parent=0, const char *name=0, WFlags f=0)

Constructs a label with a text. The label is left-aligned, vertically centered, has an automatic margin and with manual resizing.

The parent, name and f arguments are passed to the QFrame constructor.

See also: setAlignment(), setFrameStyle(), setMargin() and setAutoResize().

QLabel::~QLabel ()

Destroys the label.

int QLabel::alignment () const

Returns the alignment setting.

The default alignment is AlignLeft | AlignVCenter | ExpandTabs.

See also: setAlignment().

bool QLabel::autoResize () const

Returns TRUE if auto-resizing is enabled, or FALSE if auto-resizing is disabled.

Auto-resizing is disabled by default.

See also: setAutoResize().

void QLabel::drawContents ( QPainter *p) [virtual protected]

Draws the label contents using the painter p.

Reimplemented from QFrame.

int QLabel::margin () const

Returns the margin of the label.

See also: setMargin().

QPixmap * QLabel::pixmap () const

Returns the label pixmap.

See also: setPixmap().

void QLabel::setAlignment ( int alignment)

Sets the alignment of the label contents and redraws itself.

The alignment is the bitwise OR of the following flags:

See also: alignment().

Examples: qmag/qmag.cpp cursor/cursor.cpp widgets/widgets.cpp

void QLabel::setAutoResize ( bool enable)

Enables auto-resizing if enable is TRUE, or disables it if enable is FALSE.

When auto-resizing is enabled, the label will resize itself whenever the contents change. The top left corner is not moved.

See also: autoResize() and adjustSize().

Examples: forever/forever.cpp

void QLabel::setMargin ( int margin)

Sets the margin of the label to margin pixels.

The margin applies to the left edge if alignment() is AlignLeft, to the right edge if alignment() is AlignRight, to the top edge if alignment() is AlignTop, and to to the bottom edge if alignment() is AlignBottom.

If margin is negative (as it is by default), the label computes the margin as follows: If the frame width is zero, the effective margin becomes 0. If the frame style is greater than zero, the effective margin becomes half the width of the "x" character (of the widget's current font.

Setting a non-negative margin gives the specified margin in pixels.

See also: margin(), frameWidth() and font().

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

Sets the label contents to num (converts it to text) and redraws the contents.

The label resizes itself if auto-resizing is enabled.

See also: setAutoResize().

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

Sets the label contents to num (converts it to text) and redraws the contents.

The label resizes itself if auto-resizing is enabled. Nothing happens if num reads the same as the current label.

See also: setAutoResize().

void QLabel::setPixmap ( const QPixmap &pixmap) [slot]

Sets the label contents to pixmap and redraws the contents.

The label resizes itself if auto-resizing is enabled. Nothing happens if pixmap is the same as the current label.

See also: pixmap(), setText() and setAutoResize().

void QLabel::setText ( const char *text) [slot]

Sets the label contents to text and redraws the contents.

The label resizes itself if auto-resizing is enabled. Nothing happens if text is the same as the current label.

See also: text(), setPixmap() and setAutoResize().

Examples: forever/forever.cpp qmag/qmag.cpp cursor/cursor.cpp widgets/widgets.cpp

QSize QLabel::sizeHint () const [virtual]

Returns a size which fits the contents of the label.

Bugs and limitations:

Reimplemented from QWidget.

const char * QLabel::text () const

Returns the label text.

See also: setText().


This file is part of the Qt toolkit, copyright © 1995-96 Troll Tech, all rights reserved.

It was generated from the following files:


Generated at 16:51, 1996/09/24 for Qt version 1.0 by the webmaster at Troll Tech