kwordwrap.h

Go to the documentation of this file.

/* This file is part of the KDE libraries
   Copyright (C) 2001 David Faure <faure@kde.org>

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/

#ifndef kwordwrap_h
#define kwordwrap_h

#include <kdeui_export.h>
#include <QtCore/Qt>

class QFontMetrics;
class QRect;
class QString;
class QPainter;

class KDEUI_EXPORT KWordWrap
{
public:
    enum { FadeOut = 0x10000000, Truncate = 0x20000000 };

    static KWordWrap* formatText( QFontMetrics &fm, const QRect & r, int flags, const QString & str, int len = -1 ); // KDE5 TODO: return a value, not a pointer, and use QSharedDataPointer.

    QRect boundingRect() const;

    QString wrappedString() const; // gift for Dirk :)

    QString truncatedString( bool dots = true ) const;

    void drawText( QPainter *painter, int x, int y, int flags = Qt::AlignLeft ) const;

    ~KWordWrap();

    static void drawFadeoutText( QPainter *p, int x, int y, int maxW,
                                 const QString &t );

    static void drawTruncateText( QPainter *p, int x, int y, int maxW,
                                  const QString &t );

private:
    Q_DISABLE_COPY( KWordWrap )
    KWordWrap( const QRect & r );
    class KWordWrapPrivate* const d;
};

#endif