From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qfontdialog.html | 143 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 doc/html/qfontdialog.html (limited to 'doc/html/qfontdialog.html') diff --git a/doc/html/qfontdialog.html b/doc/html/qfontdialog.html new file mode 100644 index 00000000..990e6b5f --- /dev/null +++ b/doc/html/qfontdialog.html @@ -0,0 +1,143 @@ + + + + + +TQFontDialog Class + + + + + + + +

TQFontDialog Class Reference

+ +

The TQFontDialog class provides a dialog widget for selecting a font. +More... +

#include <qfontdialog.h> +

Inherits TQDialog. +

List of all member functions. +

Static Public Members

TQFont getFont ( bool * ok, const TQFont & initial, TQWidget * parent = 0, const char * name = 0 )
TQFont getFont ( bool * ok, TQWidget * parent = 0, const char * name = 0 )

Detailed Description

+ + + + +The TQFontDialog class provides a dialog widget for selecting a font. +

The usual way to use this class is to call one of the static convenience +functions, e.g. getFont(). +

Examples: +

+    bool ok;
+    TQFont font = TQFontDialog::getFont(
+                    &ok, TQFont( "Helvetica [Cronyx]", 10 ), this );
+    if ( ok ) {
+        // font is set to the font the user selected
+    } else {
+        // the user canceled the dialog; font is set to the initial
+        // value, in this case Helvetica [Cronyx], 10
+    }
+

+ +

The dialog can also be used to set a widget's font directly: +

+    myWidget.setFont( TQFontDialog::getFont( 0, myWidget.font() ) );
+

+ +If the user clicks OK the font they chose will be used for myWidget, +and if they click Cancel the original font is used. +

See also TQFont, TQFontInfo, TQFontMetrics, and Dialog Classes. + +

+ +

Member Function Documentation

TQFont TQFontDialog::getFont ( bool * ok, const TQFont & initial, TQWidget * parent = 0, const char * name = 0 ) `[static]` +

+Executes a modal font dialog and returns a font. +

If the user clicks OK, the selected font is returned. If the user +clicks Cancel, the initial font is returned. +

The dialog is called name, with the parent parent. +initial is the initially selected font. +If the ok parameter is not-null, *ok is set to TRUE if the +user clicked OK, and set to FALSE if the user clicked Cancel. +

This static function is less flexible than the full TQFontDialog +object, but is convenient and easy to use. +

Examples: +

+    bool ok;
+    TQFont font = TQFontDialog::getFont( &ok, TQFont( "Times", 12 ), this );
+    if ( ok ) {
+        // font is set to the font the user selected
+    } else {
+        // the user canceled the dialog; font is set to the initial
+        // value, in this case Times, 12.
+    }
+

+ +

The dialog can also be used to set a widget's font directly: +

+    myWidget.setFont( TQFontDialog::getFont( 0, myWidget.font() ) );
+

+ +In this example, if the user clicks OK the font they chose will be +used, and if they click Cancel the original font is used. + +

Examples: chart/chartform.cpp, chart/optionsform.cpp, qfd/fontdisplayer.cpp, qwerty/qwerty.cpp, and xform/xform.cpp. +

TQFont TQFontDialog::getFont ( bool * ok, TQWidget * parent = 0, const char * name = 0 ) `[static]` +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Executes a modal font dialog and returns a font. +

If the user clicks OK, the selected font is returned. If the user +clicks Cancel, the TQt default font is returned. +

The dialog is called name, with parent parent. +If the ok parameter is not-null, *ok is set to TRUE if the +user clicked OK, and FALSE if the user clicked Cancel. +

This static function is less functional than the full TQFontDialog +object, but is convenient and easy to use. +

Example: +

+    bool ok;
+    TQFont font = TQFontDialog::getFont( &ok, this );
+    if ( ok ) {
+        // font is set to the font the user selected
+    } else {
+        // the user canceled the dialog; font is set to the default
+        // application font, TQApplication::font()
+    }
+

+ +

Trademarks +

TQt 3.3.8

+ -- cgit v1.2.1