![]() |
digiKam Developer Documentation
Professional Photo Management with the Power of Open Source
|
Public Types | |
enum | DisplayFlag { NoDisplayFlags = 0 , FixedFontsOnly = 1 , DisplayFrame = 2 , ShowDifferences = 4 } |
typedef QFlags< DisplayFlag > | DisplayFlags |
enum | FontColumn { FamilyList = 0x01 , StyleList = 0x02 , SizeList = 0x04 } |
enum | FontDiff { NoFontDiffFlags = 0 , FontDiffFamily = 1 , FontDiffStyle = 2 , FontDiffSize = 4 , AllFontDiffs = FontDiffFamily | FontDiffStyle | FontDiffSize } |
typedef QFlags< FontDiff > | FontDiffFlags |
enum | FontListCriteria { FixedWidthFonts = 0x01 , ScalableFonts = 0x02 , SmoothScalableFonts = 0x04 } |
The selection criteria for the font families shown in the dialog. More... | |
Signals | |
void | fontSelected (const QFont &font) |
Emitted whenever the selected font changes. | |
Public Member Functions | |
DFontProperties (QWidget *const parent=nullptr, const DisplayFlags &flags=DisplayFrame, const QStringList &fontList=QStringList(), int visibleListSize=8, Qt::CheckState *const sizeIsRelativeState=nullptr) | |
Constructs a font picker widget. | |
~DFontProperties () override | |
Destructs the font chooser. | |
QColor | backgroundColor () const |
QColor | color () const |
void | enableColumn (int column, bool state) |
Enables or disable a font column in the chooser. | |
QFont | font () const |
FontDiffFlags | fontDiffFlags () const |
void | makeColumnVisible (int column, bool state) |
Makes a font column in the chooser visible or invisible. | |
QString | sampleText () const |
void | setBackgroundColor (const QColor &col) |
Sets the background color to use in the preview. | |
void | setColor (const QColor &col) |
Sets the color to use in the preview. | |
void | setFont (const QFont &font, bool onlyFixed=false) |
Sets the currently selected font in the chooser. | |
void | setSampleBoxVisible (bool visible) |
Shows or hides the sample text box. | |
void | setSampleText (const QString &text) |
Sets the sample text. | |
void | setSizeIsRelative (Qt::CheckState relative) |
Sets the state of the checkbox indicating whether the font size is to be interpreted as relative size. | |
QSize | sizeHint (void) const override |
Reimplemented for internal reasons. | |
Qt::CheckState | sizeIsRelative () const |
Static Public Member Functions | |
static void | getFontList (QStringList &list, uint fontListCriteria) |
Creates a list of font strings. | |
Properties | |
QColor | backgroundColor |
QColor | color |
QFont | font |
QString | sampleText |
Qt::CheckState | sizeIsRelative |
FixedFontsOnly
only show fixed fonts, excluding proportional fonts DisplayFrame
show a visual frame around the chooser ShowDifferences
display the font differences interfaces FamilyList
- Identifies the family (leftmost) list. StyleList
- Identifies the style (center) list. SizeList
- Identifies the size (rightmost) list. FontDiffFamily
- Identifies a requested change in the font family. FontDiffStyle
- Identifies a requested change in the font style. FontDiffSize
- Identifies a requested change in the font size. FixedWidthFont
when included only fixed-width fonts are returned. The fonts where the width of every character is equal. ScalableFont
when included only scalable fonts are returned; certain configurations allow bitmap fonts to remain unscaled and thus these fonts have limited number of sizes. SmoothScalableFont
when included only return smooth scalable fonts. this will return only non-bitmap fonts which are scalable to any size requested. Setting this option to true will mean the "scalable" flag is irrelevant.
|
explicit |
It normally comes up with all font families present on the system; the getFont method below does allow some more fine-tuning of the selection of fonts that will be displayed in the dialog.
parent | The parent widget. |
flags | Defines how the font chooser is displayed. |
fontList | A list of fonts to display, in XLFD format. |
visibleListSize | The minimum number of visible entries in the fontlists. |
sizeIsRelativeState | If not zero the widget will show a checkbox where the user may choose whether the font size is to be interpreted as relative size. Initial state of this checkbox will be set according to *sizeIsRelativeState, user choice may be retrieved by calling sizeIsRelative(). |
QColor Digikam::DFontProperties::backgroundColor | ( | ) | const |
QColor Digikam::DFontProperties::color | ( | ) | const |
void Digikam::DFontProperties::enableColumn | ( | int | column, |
bool | state | ||
) |
Use this function if your application does not need or supports all font properties.
column | Specify the columns. An or'ed combination of FamilyList , StyleList and SizeList is possible. |
state | If false the columns are disabled. |
QFont Digikam::DFontProperties::font | ( | ) | const |
DFontProperties::FontDiffFlags Digikam::DFontProperties::fontDiffFlags | ( | ) | const |
|
static |
list | The list is returned here. |
fontListCriteria | should contain all the restrictions for font selection as OR-ed values |
void Digikam::DFontProperties::makeColumnVisible | ( | int | column, |
bool | state | ||
) |
Use this function if your application does not need to show all font properties.
column | Specify the columns. An or'ed combination of FamilyList , StyleList and SizeList is possible. |
state | If false the columns are made invisible. |
QString Digikam::DFontProperties::sampleText | ( | ) | const |
void Digikam::DFontProperties::setFont | ( | const QFont & | font, |
bool | onlyFixed = false |
||
) |
font | The font to select. |
onlyFixed | Readjust the font list to display only fixed width fonts if true , or vice-versa. |
void Digikam::DFontProperties::setSampleBoxVisible | ( | bool | visible | ) |
visible | Set it to true to show the box, to false to hide it. |
void Digikam::DFontProperties::setSampleText | ( | const QString & | text | ) |
Normally you should not change this text, but it can be better to do this if the default text is too large for the edit area when using the default font of your application.
text | The new sample text. The current will be removed. |
void Digikam::DFontProperties::setSizeIsRelative | ( | Qt::CheckState | relative | ) |
Qt::CheckState Digikam::DFontProperties::sizeIsRelative | ( | ) | const |