ktext.h

Go to the documentation of this file.

/****************************************************************************
**
** This file is part of KDWinutils, KDAB's MFC to Qt migration tool.
**
** Copyright (C) 2023 Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>
** All rights reserved.
**
** This file is intended solely for use by the migration tools and services
** provided by Klarälvdalens Datakonsult AB.
**
**  Any other use or distribution of this software that is not otherwise agreed
**  upon in writing and signed by an authorized representative of Klarälvdalens
**  Datakonsult AB, KDAB (USA) LLC, KDAB (Deutschland) GmbH & Co. K.G.,
**  KDAB (France) SAS, KDAB (UK), Ltd., or any future subsidiary of Klarälvdalens
**  Datakonsult AB is hereby prohibited.
**
**  Contact info@kdab.com if any conditions stated above are unclear to you.
**
****************************************************************************/
 
#pragma once
 
#include "../corelib/kstring.h"
 
class QWidget;
class QValidator;
 
KDWINUTILS_BEGIN_NAMESPACE
 
class KDWINUTILS_EXPORT KText
{
public:
    KText();
    explicit KText(const wchar_t *text);
    explicit KText(const char *text);
    explicit KText(QString text);
    KText(const KText &other) = delete;
    ~KText();
 
    QWidget *widget() const;
 
    void setWidget(QWidget *label);
 
    void setValidator(QValidator *validator);
 
    // Explicit conversion methods
    QString toQString() const;
    std::string toStdString() const;
    std::wstring toStdWString() const;
 
    // Implicit conversion methods
    operator QString() const;
    operator std::string() const;
    operator std::wstring() const;
 
    // Assignment operators
    KText &operator=(const wchar_t *text);
    KText &operator=(const char *text);
    KText &operator=(const QString &text);
    KText &operator=(const KText &other) = delete;
 
#ifdef KDWINUTILS_WITHMFC
    // CString specific methods, available only on Windows with MFC set
    explicit KText(const CString &text);
    CString toCString() const;
    operator CString() const;
    KText &operator=(const CString &text);
#endif // KDWINUTILS_WITHMFC
 
    [[deprecated("Use explicit conversion methods")]] const char *constData() const;
 
    // MFC API from here on
 
    template <typename T, typename... Ts>
    KText &Format(T &&format, Ts... args)
    {
        setValue(KString::FormatString(format, args...));
        return *this;
    }
 
    int Compare(const QString &other) const;
 
private:
    QString value() const;
    void setValue(const QString &text);
 
private:
    QString m_string; // used only for the initialization, then move to the widget
    QWidget *m_widget = nullptr;
};
 
KDWINUTILS_END_NAMESPACE