diff options
Diffstat (limited to 'doc/man/man3/tqwhatsthis.3qt')
| -rw-r--r-- | doc/man/man3/tqwhatsthis.3qt | 62 |
1 files changed, 31 insertions, 31 deletions
diff --git a/doc/man/man3/tqwhatsthis.3qt b/doc/man/man3/tqwhatsthis.3qt index 0912cee25..40de1c1ab 100644 --- a/doc/man/man3/tqwhatsthis.3qt +++ b/doc/man/man3/tqwhatsthis.3qt @@ -1,5 +1,5 @@ '\" t -.TH QWhatsThis 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQWhatsThis 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,19 +7,19 @@ .ad l .nh .SH NAME -QWhatsThis \- Simple description of any widget, i.e. answering the question "What's this?" +TQWhatsThis \- Simple description of any widget, i.e. answering the question "What's this?" .SH SYNOPSIS -\fC#include <ntqwhatsthis.h>\fR +\fC#include <tqwhatsthis.h>\fR .PP Inherits Qt. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQWhatsThis\fR ( TQWidget * widget )" +.BI "\fBTQWhatsThis\fR ( TQWidget * widget )" .br .ti -1c -.BI "virtual \fB~QWhatsThis\fR ()" +.BI "virtual \fB~TQWhatsThis\fR ()" .br .ti -1c .BI "virtual TQString \fBtext\fR ( const TQPoint & )" @@ -59,16 +59,16 @@ Inherits Qt. .br .in -1c .SH DESCRIPTION -The QWhatsThis class provides a simple description of any widget, i.e. answering the question "What's this?". +The TQWhatsThis class provides a simple description of any widget, i.e. answering the question "What's this?". .PP .PP" What's this?" help is part of an application's online help system that provides users with information about functionality, usage, background etc., in various levels of detail from short tool tips to full text browsing help windows. .PP -QWhatsThis provides a single window with an explanatory text that pops up when the user asks "What's this?". The default way to do this is to focus the relevant widget and press Shift+F1. The help text appears immediately; it goes away as soon as the user does something else. +TQWhatsThis provides a single window with an explanatory text that pops up when the user asks "What's this?". The default way to do this is to focus the relevant widget and press Shift+F1. The help text appears immediately; it goes away as soon as the user does something else. .PP (Note that if there is an accelerator for Shift+F1, this mechanism will not work.) .PP -To add "What's this?" text to a widget you simply call QWhatsThis::add() for the widget. For example, to assign text to a menu item, call TQMenuData::setWhatsThis(); for a global accelerator key, call QAccel::setWhatsThis() and If you're using actions, use TQAction::setWhatsThis(). +To add "What's this?" text to a widget you simply call TQWhatsThis::add() for the widget. For example, to assign text to a menu item, call TQMenuData::setWhatsThis(); for a global accelerator key, call QAccel::setWhatsThis() and If you're using actions, use TQAction::setWhatsThis(). .PP The text can be either rich text or plain text. If you specify a rich text formatted string, it will be rendered using the default stylesheet. This makes it possible to embed images. See TQStyleSheet::defaultSheet() for details. .PP @@ -89,7 +89,7 @@ The text can be either rich text or plain text. If you specify a rich text forma fileOpenAction->setWhatsThis( fileOpenText ); .fi .PP -An alternative way to enter "What's this?" mode is to use the ready-made tool bar tool button from QWhatsThis::whatsThisButton(). By invoking this context help button (in the picture below the first one from the right) the user switches into "What's this?" mode. If they now click on a widget the appropriate help text is shown. The mode is left when help is given or when the user presses Esc. +An alternative way to enter "What's this?" mode is to use the ready-made tool bar tool button from TQWhatsThis::whatsThisButton(). By invoking this context help button (in the picture below the first one from the right) the user switches into "What's this?" mode. If they now click on a widget the appropriate help text is shown. The mode is left when help is given or when the user presses Esc. .PP <center> .ce 1 @@ -99,21 +99,21 @@ An alternative way to enter "What's this?" mode is to use the ready-made tool ba .PP If you are using TQMainWindow you can also use the TQMainWindow::whatsThis() slot to invoke the mode from a menu item. .PP -For more control you can create a dedicated QWhatsThis object for a special widget. By subclassing and reimplementing QWhatsThis::text() it is possible to have different help texts, depending on the position of the mouse click. By reimplementing QWhatsThis::clicked() it is possible to have hyperlinks inside the help texts. +For more control you can create a dedicated TQWhatsThis object for a special widget. By subclassing and reimplementing TQWhatsThis::text() it is possible to have different help texts, depending on the position of the mouse click. By reimplementing TQWhatsThis::clicked() it is possible to have hyperlinks inside the help texts. .PP If you wish to control the "What's this?" behavior of a widget manually see TQWidget::customWhatsThis(). .PP -The What's This object can be removed using QWhatsThis::remove(), although this is rarely necessary because it is automatically removed when the widget is destroyed. +The What's This object can be removed using TQWhatsThis::remove(), although this is rarely necessary because it is automatically removed when the widget is destroyed. .PP See also TQToolTip and Help System. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QWhatsThis::QWhatsThis ( TQWidget * widget )" +.SH "TQWhatsThis::TQWhatsThis ( TQWidget * widget )" Constructs a dynamic "What's this?" object for \fIwidget\fR. The object is deleted when the \fIwidget\fR is destroyed. .PP -When the widget is queried by the user the text() function of this QWhatsThis will be called to provide the appropriate text, rather than using the text assigned by add(). -.SH "QWhatsThis::~QWhatsThis ()\fC [virtual]\fR" +When the widget is queried by the user the text() function of this TQWhatsThis will be called to provide the appropriate text, rather than using the text assigned by add(). +.SH "TQWhatsThis::~TQWhatsThis ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "void QWhatsThis::add ( TQWidget * widget, const TQString & text )\fC [static]\fR" +.SH "void TQWhatsThis::add ( TQWidget * widget, const TQString & text )\fC [static]\fR" Adds \fItext\fR as "What's this" help for \fIwidget\fR. If the text is rich text formatted (i.e. it contains markup) it will be rendered with the default stylesheet TQStyleSheet::defaultSheet(). .PP The text is destroyed if the widget is later destroyed, so it need not be explicitly removed. @@ -122,19 +122,19 @@ See also remove(). .PP Examples: .)l application/application.cpp, helpsystem/mainwindow.cpp, and mdi/application.cpp. -.SH "bool QWhatsThis::clicked ( const TQString & href )\fC [virtual]\fR" +.SH "bool TQWhatsThis::clicked ( const TQString & href )\fC [virtual]\fR" This virtual function is called when the user clicks inside the" What's this?" window. \fIhref\fR is the link the user clicked on, or TQString::null if there was no link. .PP If the function returns TRUE (the default), the "What's this?" window is closed, otherwise it remains visible. .PP The default implementation ignores \fIhref\fR and returns TRUE. -.SH "void QWhatsThis::display ( const TQString & text, const TQPoint & pos = QCursor::pos ( ), TQWidget * w = 0 )\fC [static]\fR" +.SH "void TQWhatsThis::display ( const TQString & text, const TQPoint & pos = QCursor::pos ( ), TQWidget * w = 0 )\fC [static]\fR" Display \fItext\fR in a help window at the global screen position \fIpos\fR. .PP -If widget \fIw\fR is not 0 and has its own dedicated QWhatsThis object, this object will receive clicked() messages when the user clicks on hyperlinks inside the help text. +If widget \fIw\fR is not 0 and has its own dedicated TQWhatsThis object, this object will receive clicked() messages when the user clicks on hyperlinks inside the help text. .PP -See also QWhatsThis::clicked(). -.SH "void QWhatsThis::enterWhatsThisMode ()\fC [static]\fR" +See also TQWhatsThis::clicked(). +.SH "void TQWhatsThis::enterWhatsThisMode ()\fC [static]\fR" Enters "What's this?" mode and returns immediately. .PP Qt will install a special cursor and take over mouse input until the user clicks somewhere. It then shows any help available and ends "What's this?" mode. Finally, TQt removes the special cursor and help window and then restores ordinary event processing, at which point the left mouse button is no longer pressed. @@ -142,47 +142,47 @@ Qt will install a special cursor and take over mouse input until the user clicks The user can also use the Esc key to leave "What's this?" mode. .PP See also inWhatsThisMode() and leaveWhatsThisMode(). -.SH "bool QWhatsThis::inWhatsThisMode ()\fC [static]\fR" +.SH "bool TQWhatsThis::inWhatsThisMode ()\fC [static]\fR" Returns TRUE if the application is in "What's this?" mode; otherwise returns FALSE. .PP See also enterWhatsThisMode() and leaveWhatsThisMode(). -.SH "void QWhatsThis::leaveWhatsThisMode ( const TQString & text = TQString::null, const TQPoint & pos = QCursor::pos ( ), TQWidget * w = 0 )\fC [static]\fR" +.SH "void TQWhatsThis::leaveWhatsThisMode ( const TQString & text = TQString::null, const TQPoint & pos = QCursor::pos ( ), TQWidget * w = 0 )\fC [static]\fR" Leaves "What's this?" question mode. .PP This function is used internally by widgets that support TQWidget::customWhatsThis(); applications do not usually call it. An example of such a widget is TQPopupMenu: menus still work normally in "What's this?" mode but also provide help texts for individual menu items. .PP -If \fItext\fR is not TQString::null, a "What's this?" help window is displayed at the global screen position \fIpos\fR. If widget \fIw\fR is not 0 and has its own dedicated QWhatsThis object, this object will receive clicked() messages when the user clicks on hyperlinks inside the help text. +If \fItext\fR is not TQString::null, a "What's this?" help window is displayed at the global screen position \fIpos\fR. If widget \fIw\fR is not 0 and has its own dedicated TQWhatsThis object, this object will receive clicked() messages when the user clicks on hyperlinks inside the help text. .PP -See also inWhatsThisMode(), enterWhatsThisMode(), and QWhatsThis::clicked(). -.SH "void QWhatsThis::remove ( TQWidget * widget )\fC [static]\fR" +See also inWhatsThisMode(), enterWhatsThisMode(), and TQWhatsThis::clicked(). +.SH "void TQWhatsThis::remove ( TQWidget * widget )\fC [static]\fR" Removes the "What's this?" help associated with the \fIwidget\fR. This happens automatically if the widget is destroyed. .PP See also add(). -.SH "void QWhatsThis::setFont ( const TQFont & font )\fC [static]\fR" +.SH "void TQWhatsThis::setFont ( const TQFont & font )\fC [static]\fR" Sets the font for all "What's this?" helps to \fIfont\fR. -.SH "TQString QWhatsThis::text ( const TQPoint & )\fC [virtual]\fR" +.SH "TQString TQWhatsThis::text ( const TQPoint & )\fC [virtual]\fR" This virtual function returns the text for position \fIp\fR in the widget that this "What's this?" object documents. If there is no" What's this?" text for the position, TQString::null is returned. .PP The default implementation returns TQString::null. -.SH "TQString QWhatsThis::textFor ( TQWidget * w, const TQPoint & pos = TQPoint ( ), bool includeParents = FALSE )\fC [static]\fR" +.SH "TQString TQWhatsThis::textFor ( TQWidget * w, const TQPoint & pos = TQPoint ( ), bool includeParents = FALSE )\fC [static]\fR" Returns the what's this text for widget \fIw\fR or TQString::null if there is no "What's this?" help for the widget. \fIpos\fR contains the mouse position; this is useful, for example, if you've subclassed to make the text that is displayed position dependent. .PP If \fIincludeParents\fR is TRUE, parent widgets are taken into consideration as well when looking for what's this help text. .PP See also add(). -.SH "TQToolButton * QWhatsThis::whatsThisButton ( TQWidget * parent )\fC [static]\fR" +.SH "TQToolButton * TQWhatsThis::whatsThisButton ( TQWidget * parent )\fC [static]\fR" Creates a TQToolButton preconfigured to enter "What's this?" mode when clicked. You will often use this with a tool bar as \fIparent\fR: .PP .nf .br - (void) QWhatsThis::whatsThisButton( my_help_tool_bar ); + (void) TQWhatsThis::whatsThisButton( my_help_tool_bar ); .br .fi .PP Example: helpsystem/mainwindow.cpp. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqwhatsthis.html +.BR http://doc.trolltech.com/tqwhatsthis.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the |