QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
characterwidget.h
Go to the documentation of this file.
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This library/program is free software; you can redistribute it
8** and/or modify it under the terms of the GNU Library General Public
9** License as published by the Free Software Foundation; either
10** version 2 of the License, or ( at your option ) any later version.
11**
12** This file is part of the examples of the Qt Toolkit.
13**
14** $QT_BEGIN_LICENSE:LGPL$
15** Commercial Usage
16** Licensees holding valid Qt Commercial licenses may use this file in
17** accordance with the Qt Commercial License Agreement provided with the
18** Software or, alternatively, in accordance with the terms contained in
19** a written agreement between you and Nokia.
20**
21** GNU Lesser General Public License Usage
22** Alternatively, this file may be used under the terms of the GNU Lesser
23** General Public License version 2.1 as published by the Free Software
24** Foundation and appearing in the file LICENSE.LGPL included in the
25** packaging of this file. Please review the following information to
26** ensure the GNU Lesser General Public License version 2.1 requirements
27** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
28**
29** In addition, as a special exception, Nokia gives you certain additional
30** rights. These rights are described in the Nokia Qt LGPL Exception
31** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
32**
33** GNU General Public License Usage
34** Alternatively, this file may be used under the terms of the GNU
35** General Public License version 3.0 as published by the Free Software
36** Foundation and appearing in the file LICENSE.GPL included in the
37** packaging of this file. Please review the following information to
38** ensure the GNU General Public License version 3.0 requirements will be
39** met: http://www.gnu.org/copyleft/gpl.html.
40**
41** If you have questions regarding the use of this file, please contact
42** Nokia at [email protected].
43** $QT_END_LICENSE$
44**
45****************************************************************************/
46
47#ifndef CHARACTERWIDGET_H
48#define CHARACTERWIDGET_H
49
50#include "qgis_sip.h"
51#include "qgis_gui.h"
52
53#include <QFont>
54#include <QPoint>
55#include <QSize>
56#include <QString>
57#include <QWidget>
58
59
60class QMouseEvent;
61class QPaintEvent;
62
69class GUI_EXPORT CharacterWidget : public QWidget
70{
71 Q_OBJECT
72 Q_PROPERTY( QChar character READ character WRITE setCharacter NOTIFY characterSelected )
73 Q_PROPERTY( int columns READ columns WRITE setColumns )
74 Q_PROPERTY( QFont font READ font WRITE setFont )
75
76 public:
77
81 CharacterWidget( QWidget *parent SIP_TRANSFERTHIS = nullptr );
82
83 QSize sizeHint() const override;
84
88 int columns() const { return mColumns; }
89
93 int squareSize() const { return mSquareSize; }
94
99 QChar character() const { return QChar( mLastKey ); }
100
105 QFont font() const { return mDisplayFont; }
106
107 public slots:
108
113 void setFont( const QFont &font );
114
118 void setFontSize( double fontSize );
119
123 void setFontStyle( const QString &fontStyle );
124
125 void updateFontMerging( bool enable );
126
130 void setColumns( int columns );
131
137 void setCharacter( QChar character );
138
144 void clearCharacter();
145
146 signals:
147
151 void characterSelected( QChar character );
152
153 protected:
154 void keyPressEvent( QKeyEvent *event ) override;
155 void mouseMoveEvent( QMouseEvent *event ) override;
156 void mousePressEvent( QMouseEvent *event ) override;
157 void paintEvent( QPaintEvent *event ) override;
158 void resizeEvent( QResizeEvent *event ) override;
159
160 private:
161 QFont mDisplayFont;
162 int mColumns = 13;
163 int mLastKey = -1;
164 int mSquareSize = 24;
165};
166
167#endif
A widget for displaying characters available in a preset font, and allowing users to select an indivi...
QChar character() const
Returns the currently selected character in the widget.
QFont font() const
Returns the font shown in the widget.
void characterSelected(QChar character)
Emitted when a character is selected in the widget.
int columns() const
Returns the number of columns of characters shown in the widget.
int squareSize() const
Returns the size (in pixels) of the square used to render each character preview.
#define SIP_TRANSFERTHIS
Definition: qgis_sip.h:53