QGIS API Documentation  3.2.0-Bonn (bc43194)
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 <QFont>
51 #include <QPoint>
52 #include <QSize>
53 #include <QString>
54 #include <QWidget>
55 #include "qgis.h"
56 #include "qgis_gui.h"
57 
58 class QMouseEvent;
59 class QPaintEvent;
60 
67 class GUI_EXPORT CharacterWidget : public QWidget
68 {
69  Q_OBJECT
70  Q_PROPERTY( QChar character READ character WRITE setCharacter NOTIFY characterSelected )
71  Q_PROPERTY( int columns READ columns WRITE setColumns )
72  Q_PROPERTY( QFont font READ font WRITE setFont )
73 
74  public:
75 
79  CharacterWidget( QWidget *parent SIP_TRANSFERTHIS = nullptr );
80 
81  QSize sizeHint() const override;
82 
86  int columns() const { return mColumns; }
87 
91  int squareSize() const { return mSquareSize; }
92 
98  QChar character() const { return QChar( mLastKey ); }
99 
105  QFont font() const { return mDisplayFont; }
106 
107  public slots:
108 
114  void setFont( const QFont &font );
115 
120  void setFontSize( double fontSize );
121 
126  void setFontStyle( const QString &fontStyle );
127 
128  void updateFontMerging( bool enable );
129 
134  void setColumns( int columns );
135 
141  void setCharacter( QChar character );
142 
143  signals:
144 
148  void characterSelected( QChar character );
149 
150  protected:
151  void mouseMoveEvent( QMouseEvent *event ) override;
152  void mousePressEvent( QMouseEvent *event ) override;
153  void paintEvent( QPaintEvent *event ) override;
154 
155  private:
156  QFont mDisplayFont;
157  int mColumns = 16;
158  int mLastKey = -1;
159  int mSquareSize = 24;
160 };
161 
162 #endif
#define SIP_TRANSFERTHIS
Definition: qgis_sip.h:46
A widget for displaying characters available in a preset font, and allowing users to select an indivi...
QFont font() const
Returns the font shown in the widget.
int squareSize() const
Returns the size (in pixels) of the square used to render each character preview. ...
QChar character() const
Returns the currently selected character in the widget.