Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qquickmaterialtextcontainer_p.h
Go to the documentation of this file.
1// Copyright (C) 2023 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4
5#ifndef QQUICKMATERIALTEXTCONTAINER_P_H
6#define QQUICKMATERIALTEXTCONTAINER_P_H
7
8//
9// W A R N I N G
10// -------------
11//
12// This file is not part of the Qt API. It exists purely as an
13// implementation detail. This header file may change from version to
14// version without notice, or even be removed.
15//
16// We mean it.
17//
18
19#include <QtCore/qpointer.h>
20#include <QtCore/qpropertyanimation.h>
21#include <QtCore/private/qglobal_p.h>
22#include <QtGui/qcolor.h>
23#include <QtQuick/qquickpainteditem.h>
24
25QT_BEGIN_NAMESPACE
26
27class QQuickMaterialTextContainer : public QQuickPaintedItem
28{
29 Q_OBJECT
30 Q_PROPERTY(bool filled READ isFilled WRITE setFilled FINAL)
31 Q_PROPERTY(bool controlHasActiveFocus READ controlHasActiveFocus
32 WRITE setControlHasActiveFocus NOTIFY controlHasActiveFocusChanged FINAL)
33 Q_PROPERTY(QColor fillColor READ fillColor WRITE setFillColor FINAL)
34 Q_PROPERTY(QColor outlineColor READ outlineColor WRITE setOutlineColor FINAL)
35 Q_PROPERTY(QColor focusedOutlineColor READ focusedOutlineColor WRITE setFocusedOutlineColor FINAL)
36 Q_PROPERTY(qreal focusAnimationProgress READ focusAnimationProgress WRITE setFocusAnimationProgress FINAL)
37 Q_PROPERTY(qreal placeholderTextWidth READ placeholderTextWidth WRITE setPlaceholderTextWidth FINAL)
38 Q_PROPERTY(PlaceHolderHAlignment placeholderTextHAlign READ placeholderTextHAlign WRITE setPlaceholderTextHAlign FINAL)
39 Q_PROPERTY(bool controlHasText READ controlHasText WRITE setControlHasText NOTIFY controlHasTextChanged FINAL)
40 Q_PROPERTY(bool placeholderHasText READ placeholderHasText WRITE setPlaceholderHasText NOTIFY placeholderHasTextChanged FINAL)
41 Q_PROPERTY(int horizontalPadding READ horizontalPadding WRITE setHorizontalPadding NOTIFY horizontalPaddingChanged FINAL)
42 QML_NAMED_ELEMENT(MaterialTextContainer)
43 QML_ADDED_IN_VERSION(6, 5)
44
45public:
46 explicit QQuickMaterialTextContainer(QQuickItem *parent = nullptr);
47
48 enum PlaceHolderHAlignment {
49 AlignLeft = Qt::AlignLeft,
50 AlignRight = Qt::AlignRight,
51 AlignHCenter = Qt::AlignHCenter,
52 AlignJustify = Qt::AlignJustify
53 };
54 Q_ENUM(PlaceHolderHAlignment)
55
56 bool isFilled() const;
57 void setFilled(bool filled);
58
59 QColor fillColor() const;
60 void setFillColor(const QColor &fillColor);
61
62 QColor outlineColor() const;
63 void setOutlineColor(const QColor &outlineColor);
64
65 QColor focusedOutlineColor() const;
66 void setFocusedOutlineColor(const QColor &focusedOutlineColor);
67
68 qreal focusAnimationProgress() const;
69 void setFocusAnimationProgress(qreal progress);
70
71 qreal placeholderTextWidth() const;
72 void setPlaceholderTextWidth(qreal placeholderTextWidth);
73
74 bool controlHasActiveFocus() const;
75 void setControlHasActiveFocus(bool controlHasActiveFocus);
76
77 bool controlHasText() const;
78 void setControlHasText(bool controlHasText);
79
80 bool placeholderHasText() const;
81 void setPlaceholderHasText(bool placeholderHasText);
82
83 int horizontalPadding() const;
84 void setHorizontalPadding(int horizontalPadding);
85
86 void paint(QPainter *painter) override;
87
88 PlaceHolderHAlignment placeholderTextHAlign() const;
89 void setPlaceholderTextHAlign(PlaceHolderHAlignment placeHolderTextHAlign);
90
91signals:
92 void animateChanged();
93 void controlHasActiveFocusChanged();
94 void controlHasTextChanged();
95 void placeholderHasTextChanged();
96 void horizontalPaddingChanged();
97
98private:
99 bool shouldAnimateOutline() const;
100
101 QQuickItem *textControl() const;
102 void controlGotActiveFocus();
103 void controlLostActiveFocus();
104
105 void updateFocusAnimation(bool createIfNeeded = false);
106
107 void componentComplete() override;
108
109 QColor m_fillColor;
110 QColor m_outlineColor;
111 QColor m_focusedOutlineColor;
112 qreal m_focusAnimationProgress = 0;
113 qreal m_placeholderTextWidth = 0;
114 bool m_filled = false;
115 bool m_controlHasActiveFocus = false;
116 bool m_controlHasText = false;
117 bool m_placeholderHasText = false;
118 int m_horizontalPadding = 0;
119 PlaceHolderHAlignment m_placeholderTextHAlign;
120 QPointer<QPropertyAnimation> m_focusAnimation;
121};
122
123QT_END_NAMESPACE
124
125#endif // QQUICKMATERIALTEXTCONTAINER_P_H
QObjectData::parent
QObject * parent
Definition qobject.h:73
QQuickItem
The QQuickItem class provides the most basic of all visual items in \l {Qt Quick}.
Definition qquickitem.h:64