|
|
/****************************************************************************
|
|
|
**
|
|
|
** Miscellaneous documentation that doesn't fit anywhere else
|
|
|
**
|
|
|
** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
|
|
|
**
|
|
|
** This file is part of the TQt GUI Toolkit.
|
|
|
**
|
|
|
** This file may be used under the terms of the GNU General
|
|
|
** Public License versions 2.0 or 3.0 as published by the Free
|
|
|
** Software Foundation and appearing in the files LICENSE.GPL2
|
|
|
** and LICENSE.GPL3 included in the packaging of this file.
|
|
|
** Alternatively you may (at your option) use any later version
|
|
|
** of the GNU General Public License if such license has been
|
|
|
** publicly approved by Trolltech ASA (or its successors, if any)
|
|
|
** and the KDE Free TQt Foundation.
|
|
|
**
|
|
|
** Please review the following information to ensure GNU General
|
|
|
** Public Licensing requirements will be met:
|
|
|
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
|
|
|
** If you are unsure which license is appropriate for your use, please
|
|
|
** review the following information:
|
|
|
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
|
|
|
** or contact the sales department at sales@trolltech.com.
|
|
|
**
|
|
|
** This file may be used under the terms of the Q Public License as
|
|
|
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
|
|
|
** included in the packaging of this file. Licensees holding valid Qt
|
|
|
** Commercial licenses may use this file in accordance with the Qt
|
|
|
** Commercial License Agreement provided with the Software.
|
|
|
**
|
|
|
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
|
|
|
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
|
|
|
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
|
|
|
** herein.
|
|
|
**
|
|
|
**********************************************************************/
|
|
|
|
|
|
|
|
|
/*! \page commonproblems.html
|
|
|
\title Brief Technical FAQ
|
|
|
|
|
|
|
|
|
This document describes how to use more than one TQt version on one
|
|
|
machine and how to use TQt on X11 without a window manager. In addition
|
|
|
it explains the most common source of link errors with Qt.
|
|
|
|
|
|
Other frequently asked questions can be found in the
|
|
|
\link http://www.trolltech.com/developer/faqs/ FAQ index\endlink and
|
|
|
in the \link http://www.trolltech.com/developer/faqs/technical.html Technical FAQ\endlink.
|
|
|
|
|
|
\list
|
|
|
\i \link #linkerror Link error, complaining about a lack of
|
|
|
<tt>vtbl</tt>, <tt>_vtbl</tt>, <tt>__vtbl</tt> or similar\endlink
|
|
|
\i \link #diffver Using different versions of TQt on the same
|
|
|
machine\endlink
|
|
|
\list
|
|
|
\i \link #qtbin Developers building for a single version of TQt on Unix - TQt binary packages\endlink
|
|
|
\i \link #qtsrc Developers building for two versions of TQt on Unix - TQt sources\endlink
|
|
|
\endlist
|
|
|
\i \link #nowinman Using TQt on X11 without a window manager\endlink
|
|
|
\i \link distributingntqt.html Distributing TQt Applications\endlink
|
|
|
\endlist
|
|
|
|
|
|
\target linkerror
|
|
|
\section1 Link error, complaining about a lack of \c vtbl, \c _vtbl, \c __vtbl or similar
|
|
|
|
|
|
This indicates that you've included the TQ_OBJECT macro in a class
|
|
|
declaration and probably also run the moc, but forgot to link the
|
|
|
moc-generated object code into your executable. See \link moc.html
|
|
|
Using the Meta Object Compiler\endlink for details on how to use moc.
|
|
|
|
|
|
\target diffver
|
|
|
\section1 Using different versions of TQt on the same machine
|
|
|
|
|
|
Qt programs need the following components of a TQt distribution:
|
|
|
|
|
|
<dl>
|
|
|
|
|
|
<dt>Header files - Compile time
|
|
|
|
|
|
<dd>Programmers need to include the TQt header files. The TQt header files
|
|
|
are usually located in the \c include subdirectory of TQt distributions.
|
|
|
Care must be taken to include the header files of the relevant release of
|
|
|
Qt. Those with a command-line compiler will typically use options such as
|
|
|
\c{/I%TQTDIR%\include} or \c{-I"$TQTDIR"/include} provided \c TQTDIR specifies
|
|
|
the relevant release of Qt.
|
|
|
|
|
|
<dt>Meta Object Compiler and other tools - Compile time
|
|
|
|
|
|
<dd>Programmers need to run \e moc and other tools such as \e uic. These
|
|
|
tools are usually located in the \c bin subdirectory of TQt distributions.
|
|
|
Either run \c "$TQTDIR"/bin/moc and \c "$TQTDIR"/bin/uic or add \c "$TQTDIR"/bin
|
|
|
to your \c PATH and run \c moc and \c uic. If you use \c qmake the
|
|
|
appropriate lines will be added to your Makefiles so that \e uic and
|
|
|
\e moc will be executed as required.
|
|
|
|
|
|
<dt>Static or shared libraries - Link time
|
|
|
|
|
|
<dd>Programmers need to link with the TQt static or shared libraries. The Qt
|
|
|
libraries are usually located in the \c lib subdirectory of TQt distributions.
|
|
|
Care must be taken to link with the libraries of the relevant release of
|
|
|
Qt. Those with a command-line compiler will typically use options such as
|
|
|
\c{/L%TQTDIR%\lib\qt.lib} or \c{-L"$TQTDIR"/lib} \c -lqt provided \c TQTDIR
|
|
|
specifies the relevant release of Qt.
|
|
|
|
|
|
<dt>Shared libraries - Run time
|
|
|
|
|
|
<dd>Users of programs linked with shared TQt libraries need these same
|
|
|
shared libraries to run these programs. The TQt libraries are usually
|
|
|
located in the \c lib subdirectory of TQt distributions. Shared libraries
|
|
|
are made available to programs in places such as \c{C:\windows\system} on
|
|
|
Windows platforms, directories listed in file \c /etc/ld.so.conf on Linux,
|
|
|
standard \c lib directories on Unix, or directories listed in environment
|
|
|
variables \c LD_LIBRARY_PATH, \c SHLIB_PATH, or \c LIBPATH on various Unix
|
|
|
flavours. Make the relevant TQt libraries available using one of these
|
|
|
mechanisms.
|
|
|
|
|
|
</dl>
|
|
|
|
|
|
Qt distributions consist of different files needed at compile time,
|
|
|
link time, or run time. Trolltech distributes TQt in the form of a
|
|
|
source package that contain all these files once they have been built.
|
|
|
|
|
|
Other vendors distribute TQt in the form of binary packages. Binary packages
|
|
|
usually consist of two parts:
|
|
|
|
|
|
\list
|
|
|
\i shared libraries in the run time package, usually called \c qt3.
|
|
|
|
|
|
\i header files, static libraries, the moc and other tools in the developers'
|
|
|
kit, usually called \c qt3-dev.
|
|
|
|
|
|
\endlist
|
|
|
|
|
|
Depending on how you are using Qt, you need to make specific parts of
|
|
|
the TQt distribution available to your programs. Typical situations are
|
|
|
described below.
|
|
|
|
|
|
\target qtbin
|
|
|
\section2 Developers building for a single version of TQt on Unix - TQt binary packages
|
|
|
|
|
|
You build programs with a single version of Qt, but you still need
|
|
|
to run programs linked with another version of Qt. You are typically
|
|
|
a Linux developer who builds programs for TQt 3.x on a KDE desktop based
|
|
|
on TQt 2.x. TQt packages are usually split into a shared library
|
|
|
package with a name like \c qt and a developer package with a name
|
|
|
like \c qt-dev. You will need the appropriate packages:
|
|
|
|
|
|
\list
|
|
|
|
|
|
\i To build programs you will need the header files, the libraries,
|
|
|
the moc and other tools from TQt 3.x. They are included in the developer
|
|
|
package of TQt 3.x (\c qt3-dev or similar).
|
|
|
|
|
|
\i To run programs you will need the shared libraries of TQt 3.x and
|
|
|
Qt 2.x. They are included in the regular packages of TQt 3.x (\c qt3
|
|
|
or similar) and TQt 2.x (\c qt2 or similar).
|
|
|
|
|
|
\endlist
|
|
|
|
|
|
Just install the packages, \c qt2, \c qt3, and \c qt3-dev. You may
|
|
|
need to set the environment variable \c TQTDIR to point to TQt 3.x.
|
|
|
|
|
|
\target qtsrc
|
|
|
\section2 Developers building for two versions of TQt on Unix - TQt sources
|
|
|
|
|
|
You build and run programs for TQt 2.x and TQt 3.x. You will need:
|
|
|
|
|
|
\list
|
|
|
|
|
|
\i the header files, the libraries, the moc and other tools from TQt 3.x
|
|
|
and TQt 2.x to build programs,
|
|
|
|
|
|
\i the shared libraries of TQt 3.x and TQt 2.x to run programs.
|
|
|
|
|
|
\endlist
|
|
|
|
|
|
Get the source distributions of both TQt 2.x and TQt 3.x.
|
|
|
|
|
|
\list 1
|
|
|
|
|
|
\i Install and build TQt 2.x and TQt 3.x, usually in \c /opt or
|
|
|
\c /usr/local. In the case of \c /opt:
|
|
|
|
|
|
\code
|
|
|
$ cd /opt
|
|
|
$ gunzip -c \c qt-x11-2.3.1.tar.gz | tar xf -
|
|
|
$ cd qt-2.3.1
|
|
|
$ setenv TQTDIR /opt/qt-2.3.1
|
|
|
$ configure [options]
|
|
|
$ make
|
|
|
|
|
|
$ cd /opt
|
|
|
$ gunzip -c qt-x11-free-3.0.0.tar.gz | tar xf -
|
|
|
$ cd qt-3.0.0
|
|
|
$ setenv TQTDIR /opt/qt-3.0.0
|
|
|
$ configure [options]
|
|
|
$ make
|
|
|
\endcode
|
|
|
|
|
|
\i Make shared libraries available to programs at run time. Either
|
|
|
add both \c /opt/qt-2.3.1/lib and \c /opt/qt-3.0.0/lib to your environment
|
|
|
variable \c LD_LIBRARY_PATH or file \c /etc/ld.so.conf or whataver mechanism
|
|
|
you're using, or make links to the libraries in a standard directory like
|
|
|
\c /usr/local/lib:
|
|
|
|
|
|
\code
|
|
|
cd /usr/local/lib
|
|
|
ln -s /opt/qt-2.3.1/lib/libtqt.so.2 .
|
|
|
ln -s /opt/qt-2.3.1/lib/libtqt-mt.so.2 .
|
|
|
ln -s /opt/qt-2.3.1/lib/libqutil.so.1 .
|
|
|
ln -s /opt/qt-3.0.0/lib/libtqt.so.3 .
|
|
|
ln -s /opt/qt-3.0.0/lib/libtqui.so.1 .
|
|
|
\endcode
|
|
|
|
|
|
\endlist
|
|
|
|
|
|
To develop with TQt 2.x use:
|
|
|
|
|
|
\code
|
|
|
setenv TQTDIR /opt/qt-2.3.1
|
|
|
setenv PATH ${TQTDIR}/bin:${PATH}
|
|
|
\endcode
|
|
|
|
|
|
To develop with TQt 3.x use:
|
|
|
|
|
|
\code
|
|
|
setenv TQTDIR /opt/qt-3.0.0
|
|
|
setenv PATH ${TQTDIR}/bin:${PATH}
|
|
|
\endcode
|
|
|
|
|
|
Setting \c TQTDIR ensures that the proper resources are used, such as the
|
|
|
documentation appropriate to the version of TQt you're using. Also
|
|
|
your Makfiles may refer to \c "$TQTDIR"/include and \c "$TQTDIR"/lib to
|
|
|
include the proper header files and link with the proper libraries.
|
|
|
Setting the \c PATH ensures that the proper version of moc and other
|
|
|
tools is being used.
|
|
|
|
|
|
\target nowinman
|
|
|
\section1 Using TQt on X11 without a window manager
|
|
|
|
|
|
When using TQt without a window manager on Unix/X11, you will most
|
|
|
likely experience focus problems. Without a window manager, there is
|
|
|
no focus handling on X11, and no concept of an active window
|
|
|
either. If you want your application to work in such an environment,
|
|
|
you have to explicitly mark a window as active \e after showing it:
|
|
|
|
|
|
\code
|
|
|
yourWindow->show();
|
|
|
yourWindow->setActiveWindow();
|
|
|
\endcode
|
|
|
|
|
|
Note that setActiveWindow() won't work if the widget does not become
|
|
|
physically visible during this event cycle. However, without a window
|
|
|
manager running, this is guaranteed to happen. For the curious reader:
|
|
|
setActiveWindow() emulates a window manager by explicitly setting the
|
|
|
X Input Focus to a widget's top level window.
|
|
|
|
|
|
*/
|
|
|
|
|
|
/*! \page bughowto.html
|
|
|
\title How to Report A Bug
|
|
|
|
|
|
If you think you have found a bug in Qt, we would like to hear
|
|
|
about it so that we can fix it.
|
|
|
|
|
|
Before reporting a bug, please check the
|
|
|
\link commonproblems.html Brief Technical FAQ\endlink, the
|
|
|
\link http://www.trolltech.com/developer/faqs/ FAQs\endlink, and the
|
|
|
\link http://www.trolltech.com/platforms/ Platform Notes\endlink
|
|
|
on our web site to see if the issue is already known.
|
|
|
|
|
|
Always include the following information in your bug report:
|
|
|
|
|
|
\list 1
|
|
|
\i The name and version number of your compiler
|
|
|
\i The name and version number of your operating system
|
|
|
\i The version of TQt you are using, and what configure options it was
|
|
|
compiled with.
|
|
|
\endlist
|
|
|
|
|
|
If the problem you are reporting is only at visible run-time, try to
|
|
|
create a small test program that shows the problem when run. Often,
|
|
|
such a program can be created with some minor changes to one
|
|
|
of the many example programs in the \c{qt/examples} directory.
|
|
|
|
|
|
Please send the bug report to
|
|
|
\link mailto:qt-bugs@trolltech.com qt-bugs@trolltech.com\endlink.
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*! \page license.html
|
|
|
|
|
|
\title TQt Open Source Edition License Agreement
|
|
|
|
|
|
The TQt Open Source Edition is distributed under the Q Public License (QPL).
|
|
|
It allows free use of TQt Open Source Edition for running software developed by
|
|
|
others, and free use of TQt Open Source Edition for development of free and open source
|
|
|
software. There is \link http://www.trolltech.com/qpl/ more information
|
|
|
about the QPL\endlink at the Trolltech web site.
|
|
|
|
|
|
Note that the Qt/Embedded Open Source Edition is <b>not</b> distributed
|
|
|
under the QPL, but under the \link gpl.html GNU General Public
|
|
|
License (GPL)\endlink.
|
|
|
|
|
|
For development non-free/proprietary software, the TQt Professional
|
|
|
Edition is available. It has a normal commercial library license, with
|
|
|
none of the special restrictions of the QPL or the GPL.
|
|
|
|
|
|
<hr>
|
|
|
|
|
|
<center>
|
|
|
<h2>
|
|
|
THE Q PUBLIC LICENSE
|
|
|
version 1.0
|
|
|
</h2>
|
|
|
<b>
|
|
|
Copyright (C) 1999-2008 Trolltech ASA, Norway.<br>
|
|
|
Everyone is permitted to copy and distribute this license document.
|
|
|
</b>
|
|
|
</center>
|
|
|
|
|
|
The intent of this license is to establish freedom to share and change the
|
|
|
software regulated by this license under the open source model.
|
|
|
|
|
|
This license applies to any software containing a notice placed by the
|
|
|
copyright holder saying that it may be distributed under the terms of
|
|
|
the Q Public License version 1.0. Such software is herein referred to as
|
|
|
the Software. This license covers modification and distribution of the
|
|
|
Software, use of third-party application programs based on the Software,
|
|
|
and development of free software which uses the Software.
|
|
|
|
|
|
|
|
|
<h3 align="center">
|
|
|
Granted Rights
|
|
|
</h3>
|
|
|
|
|
|
1. You are granted the non-exclusive rights set forth in this license
|
|
|
provided you agree to and comply with any and all conditions in this
|
|
|
license. Whole or partial distribution of the Software, or software
|
|
|
items that link with the Software, in any form signifies acceptance of
|
|
|
this license.
|
|
|
|
|
|
2. You may copy and distribute the Software in unmodified form provided
|
|
|
that the entire package, including - but not restricted to - copyright,
|
|
|
trademark notices and disclaimers, as released by the initial developer
|
|
|
of the Software, is distributed.
|
|
|
|
|
|
3. You may make modifications to the Software and distribute your
|
|
|
modifications, in a form that is separate from the Software, such as
|
|
|
patches. The following restrictions apply to modifications:
|
|
|
|
|
|
<blockquote>
|
|
|
a. Modifications must not alter or remove any copyright notices in
|
|
|
the Software.
|
|
|
|
|
|
b. When modifications to the Software are released under this
|
|
|
license, a non-exclusive royalty-free right is granted to the
|
|
|
initial developer of the Software to distribute your modification
|
|
|
in future versions of the Software provided such versions remain
|
|
|
available under these terms in addition to any other license(s) of
|
|
|
the initial developer.
|
|
|
</blockquote>
|
|
|
|
|
|
4. You may distribute machine-executable forms of the Software or
|
|
|
machine-executable forms of modified versions of the Software, provided
|
|
|
that you meet these restrictions:
|
|
|
|
|
|
<blockquote>
|
|
|
a. You must include this license document in the distribution.
|
|
|
|
|
|
b. You must ensure that all recipients of the machine-executable forms
|
|
|
are also able to receive the complete machine-readable source code
|
|
|
to the distributed Software, including all modifications, without
|
|
|
any charge beyond the costs of data transfer, and place prominent
|
|
|
notices in the distribution explaining this.
|
|
|
|
|
|
c. You must ensure that all modifications included in the
|
|
|
machine-executable forms are available under the terms of this
|
|
|
license.
|
|
|
|
|
|
</blockquote>
|
|
|
|
|
|
5. You may use the original or modified versions of the Software to
|
|
|
compile, link and run application programs legally developed by you
|
|
|
or by others.
|
|
|
|
|
|
6. You may develop application programs, reusable components and other
|
|
|
software items that link with the original or modified versions of the
|
|
|
Software. These items, when distributed, are subject to the following
|
|
|
requirements:
|
|
|
|
|
|
<blockquote>
|
|
|
a. You must ensure that all recipients of machine-executable forms of
|
|
|
these items are also able to receive and use the complete
|
|
|
machine-readable source code to the items without any charge
|
|
|
beyond the costs of data transfer.
|
|
|
|
|
|
b. You must explicitly license all recipients of your items to use
|
|
|
and re-distribute original and modified versions of the items in
|
|
|
both machine-executable and source code forms. The recipients must
|
|
|
be able to do so without any charges whatsoever, and they must be
|
|
|
able to re-distribute to anyone they choose.
|
|
|
|
|
|
c. If the items are not available to the general public, and the
|
|
|
initial developer of the Software requests a copy of the items,
|
|
|
then you must supply one.
|
|
|
</blockquote>
|
|
|
|
|
|
|
|
|
<h3 align="center">
|
|
|
Limitations of Liability
|
|
|
</h3>
|
|
|
|
|
|
In no event shall the initial developers or copyright holders be liable
|
|
|
for any damages whatsoever, including - but not restricted to - lost
|
|
|
revenue or profits or other direct, indirect, special, incidental or
|
|
|
consequential damages, even if they have been advised of the possibility
|
|
|
of such damages, except to the extent invariable law, if any, provides
|
|
|
otherwise.
|
|
|
|
|
|
|
|
|
<h3 align="center">
|
|
|
No Warranty
|
|
|
</h3>
|
|
|
|
|
|
The Software and this license document are provided AS IS with NO WARRANTY
|
|
|
OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS
|
|
|
FOR A PARTICULAR PURPOSE.
|
|
|
|
|
|
<h3 align="center">
|
|
|
Choice of Law
|
|
|
</h3>
|
|
|
|
|
|
This license is governed by the Laws of Norway. Disputes shall be settled
|
|
|
by Oslo City Court.
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
/*! \page gpl.html
|
|
|
\title GNU General Public License
|
|
|
|
|
|
The TQt GUI Toolkit is Copyright (C) 1994-2008 Trolltech ASA.
|
|
|
|
|
|
The TQt Open Source Edition and the Qt/Embedded Open Source Edition are available
|
|
|
under the GPL. The TQt Open Source Edition (for Unix/X11) is also available
|
|
|
under the \link license.html QPL\endlink.
|
|
|
|
|
|
\code
|
|
|
You may use, distribute and copy the TQt GUI Toolkit under the terms of
|
|
|
GNU General Public License version 2, which is displayed below.
|
|
|
|
|
|
GNU GENERAL PUBLIC LICENSE
|
|
|
Version 2, June 1991
|
|
|
|
|
|
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
|
|
|
51 Franklin Steet, Fifth Floor, Boston, MA 02110-1301, USA
|
|
|
Everyone is permitted to copy and distribute verbatim copies
|
|
|
of this license document, but changing it is not allowed.
|
|
|
|
|
|
Preamble
|
|
|
|
|
|
The licenses for most software are designed to take away your
|
|
|
freedom to share and change it. By contrast, the GNU General Public
|
|
|
License is intended to guarantee your freedom to share and change free
|
|
|
software--to make sure the software is free for all its users. This
|
|
|
General Public License applies to most of the Free Software
|
|
|
Foundation's software and to any other program whose authors commit to
|
|
|
using it. (Some other Free Software Foundation software is covered by
|
|
|
the GNU Library General Public License instead.) You can apply it to
|
|
|
your programs, too.
|
|
|
|
|
|
When we speak of free software, we are referring to freedom, not
|
|
|
price. Our General Public Licenses are designed to make sure that you
|
|
|
have the freedom to distribute copies of free software (and charge for
|
|
|
this service if you wish), that you receive source code or can get it
|
|
|
if you want it, that you can change the software or use pieces of it
|
|
|
in new free programs; and that you know you can do these things.
|
|
|
|
|
|
To protect your rights, we need to make restrictions that forbid
|
|
|
anyone to deny you these rights or to ask you to surrender the rights.
|
|
|
These restrictions translate to certain responsibilities for you if you
|
|
|
distribute copies of the software, or if you modify it.
|
|
|
|
|
|
For example, if you distribute copies of such a program, whether
|
|
|
gratis or for a fee, you must give the recipients all the rights that
|
|
|
you have. You must make sure that they, too, receive or can get the
|
|
|
source code. And you must show them these terms so they know their
|
|
|
rights.
|
|
|
|
|
|
We protect your rights with two steps: (1) copyright the software, and
|
|
|
(2) offer you this license which gives you legal permission to copy,
|
|
|
distribute and/or modify the software.
|
|
|
|
|
|
Also, for each author's protection and ours, we want to make certain
|
|
|
that everyone understands that there is no warranty for this free
|
|
|
software. If the software is modified by someone else and passed on, we
|
|
|
want its recipients to know that what they have is not the original, so
|
|
|
that any problems introduced by others will not reflect on the original
|
|
|
authors' reputations.
|
|
|
|
|
|
Finally, any free program is threatened constantly by software
|
|
|
patents. We wish to avoid the danger that redistributors of a free
|
|
|
program will individually obtain patent licenses, in effect making the
|
|
|
program proprietary. To prevent this, we have made it clear that any
|
|
|
patent must be licensed for everyone's free use or not licensed at all.
|
|
|
|
|
|
The precise terms and conditions for copying, distribution and
|
|
|
modification follow.
|
|
|
|
|
|
GNU GENERAL PUBLIC LICENSE
|
|
|
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
|
|
|
|
|
0. This License applies to any program or other work which contains
|
|
|
a notice placed by the copyright holder saying it may be distributed
|
|
|
under the terms of this General Public License. The "Program", below,
|
|
|
refers to any such program or work, and a "work based on the Program"
|
|
|
means either the Program or any derivative work under copyright law:
|
|
|
that is to say, a work containing the Program or a portion of it,
|
|
|
either verbatim or with modifications and/or translated into another
|
|
|
language. (Hereinafter, translation is included without limitation in
|
|
|
the term "modification".) Each licensee is addressed as "you".
|
|
|
|
|
|
Activities other than copying, distribution and modification are not
|
|
|
covered by this License; they are outside its scope. The act of
|
|
|
running the Program is not restricted, and the output from the Program
|
|
|
is covered only if its contents constitute a work based on the
|
|
|
Program (independent of having been made by running the Program).
|
|
|
Whether that is true depends on what the Program does.
|
|
|
|
|
|
1. You may copy and distribute verbatim copies of the Program's
|
|
|
source code as you receive it, in any medium, provided that you
|
|
|
conspicuously and appropriately publish on each copy an appropriate
|
|
|
copyright notice and disclaimer of warranty; keep intact all the
|
|
|
notices that refer to this License and to the absence of any warranty;
|
|
|
and give any other recipients of the Program a copy of this License
|
|
|
along with the Program.
|
|
|
|
|
|
You may charge a fee for the physical act of transferring a copy, and
|
|
|
you may at your option offer warranty protection in exchange for a fee.
|
|
|
|
|
|
2. You may modify your copy or copies of the Program or any portion
|
|
|
of it, thus forming a work based on the Program, and copy and
|
|
|
distribute such modifications or work under the terms of Section 1
|
|
|
above, provided that you also meet all of these conditions:
|
|
|
|
|
|
a) You must cause the modified files to carry prominent notices
|
|
|
stating that you changed the files and the date of any change.
|
|
|
|
|
|
b) You must cause any work that you distribute or publish, that in
|
|
|
whole or in part contains or is derived from the Program or any
|
|
|
part thereof, to be licensed as a whole at no charge to all third
|
|
|
parties under the terms of this License.
|
|
|
|
|
|
c) If the modified program normally reads commands interactively
|
|
|
when run, you must cause it, when started running for such
|
|
|
interactive use in the most ordinary way, to print or display an
|
|
|
announcement including an appropriate copyright notice and a
|
|
|
notice that there is no warranty (or else, saying that you provide
|
|
|
a warranty) and that users may redistribute the program under
|
|
|
these conditions, and telling the user how to view a copy of this
|
|
|
License. (Exception: if the Program itself is interactive but
|
|
|
does not normally print such an announcement, your work based on
|
|
|
the Program is not required to print an announcement.)
|
|
|
|
|
|
These requirements apply to the modified work as a whole. If
|
|
|
identifiable sections of that work are not derived from the Program,
|
|
|
and can be reasonably considered independent and separate works in
|
|
|
themselves, then this License, and its terms, do not apply to those
|
|
|
sections when you distribute them as separate works. But when you
|
|
|
distribute the same sections as part of a whole which is a work based
|
|
|
on the Program, the distribution of the whole must be on the terms of
|
|
|
this License, whose permissions for other licensees extend to the
|
|
|
entire whole, and thus to each and every part regardless of who wrote it.
|
|
|
|
|
|
Thus, it is not the intent of this section to claim rights or contest
|
|
|
your rights to work written entirely by you; rather, the intent is to
|
|
|
exercise the right to control the distribution of derivative or
|
|
|
collective works based on the Program.
|
|
|
|
|
|
In addition, mere aggregation of another work not based on the Program
|
|
|
with the Program (or with a work based on the Program) on a volume of
|
|
|
a storage or distribution medium does not bring the other work under
|
|
|
the scope of this License.
|
|
|
|
|
|
3. You may copy and distribute the Program (or a work based on it,
|
|
|
under Section 2) in object code or executable form under the terms of
|
|
|
Sections 1 and 2 above provided that you also do one of the following:
|
|
|
|
|
|
a) Accompany it with the complete corresponding machine-readable
|
|
|
source code, which must be distributed under the terms of Sections
|
|
|
1 and 2 above on a medium customarily used for software interchange; or,
|
|
|
|
|
|
b) Accompany it with a written offer, valid for at least three
|
|
|
years, to give any third party, for a charge no more than your
|
|
|
cost of physically performing source distribution, a complete
|
|
|
machine-readable copy of the corresponding source code, to be
|
|
|
distributed under the terms of Sections 1 and 2 above on a medium
|
|
|
customarily used for software interchange; or,
|
|
|
|
|
|
c) Accompany it with the information you received as to the offer
|
|
|
to distribute corresponding source code. (This alternative is
|
|
|
allowed only for noncommercial distribution and only if you
|
|
|
received the program in object code or executable form with such
|
|
|
an offer, in accord with Subsection b above.)
|
|
|
|
|
|
The source code for a work means the preferred form of the work for
|
|
|
making modifications to it. For an executable work, complete source
|
|
|
code means all the source code for all modules it contains, plus any
|
|
|
associated interface definition files, plus the scripts used to
|
|
|
control compilation and installation of the executable. However, as a
|
|
|
special exception, the source code distributed need not include
|
|
|
anything that is normally distributed (in either source or binary
|
|
|
form) with the major components (compiler, kernel, and so on) of the
|
|
|
operating system on which the executable runs, unless that component
|
|
|
itself accompanies the executable.
|
|
|
|
|
|
If distribution of executable or object code is made by offering
|
|
|
access to copy from a designated place, then offering equivalent
|
|
|
access to copy the source code from the same place counts as
|
|
|
distribution of the source code, even though third parties are not
|
|
|
compelled to copy the source along with the object code.
|
|
|
|
|
|
4. You may not copy, modify, sublicense, or distribute the Program
|
|
|
except as expressly provided under this License. Any attempt
|
|
|
otherwise to copy, modify, sublicense or distribute the Program is
|
|
|
void, and will automatically terminate your rights under this License.
|
|
|
However, parties who have received copies, or rights, from you under
|
|
|
this License will not have their licenses terminated so long as such
|
|
|
parties remain in full compliance.
|
|
|
|
|
|
5. You are not required to accept this License, since you have not
|
|
|
signed it. However, nothing else grants you permission to modify or
|
|
|
distribute the Program or its derivative works. These actions are
|
|
|
prohibited by law if you do not accept this License. Therefore, by
|
|
|
modifying or distributing the Program (or any work based on the
|
|
|
Program), you indicate your acceptance of this License to do so, and
|
|
|
all its terms and conditions for copying, distributing or modifying
|
|
|
the Program or works based on it.
|
|
|
|
|
|
6. Each time you redistribute the Program (or any work based on the
|
|
|
Program), the recipient automatically receives a license from the
|
|
|
original licensor to copy, distribute or modify the Program subject to
|
|
|
these terms and conditions. You may not impose any further
|
|
|
restrictions on the recipients' exercise of the rights granted herein.
|
|
|
You are not responsible for enforcing compliance by third parties to
|
|
|
this License.
|
|
|
|
|
|
7. If, as a consequence of a court judgment or allegation of patent
|
|
|
infringement or for any other reason (not limited to patent issues),
|
|
|
conditions are imposed on you (whether by court order, agreement or
|
|
|
otherwise) that contradict the conditions of this License, they do not
|
|
|
excuse you from the conditions of this License. If you cannot
|
|
|
distribute so as to satisfy simultaneously your obligations under this
|
|
|
License and any other pertinent obligations, then as a consequence you
|
|
|
may not distribute the Program at all. For example, if a patent
|
|
|
license would not permit royalty-free redistribution of the Program by
|
|
|
all those who receive copies directly or indirectly through you, then
|
|
|
the only way you could satisfy both it and this License would be to
|
|
|
refrain entirely from distribution of the Program.
|
|
|
|
|
|
If any portion of this section is held invalid or unenforceable under
|
|
|
any particular circumstance, the balance of the section is intended to
|
|
|
apply and the section as a whole is intended to apply in other
|
|
|
circumstances.
|
|
|
|
|
|
It is not the purpose of this section to induce you to infringe any
|
|
|
patents or other property right claims or to contest validity of any
|
|
|
such claims; this section has the sole purpose of protecting the
|
|
|
integrity of the free software distribution system, which is
|
|
|
implemented by public license practices. Many people have made
|
|
|
generous contributions to the wide range of software distributed
|
|
|
through that system in reliance on consistent application of that
|
|
|
system; it is up to the author/donor to decide if he or she is willing
|
|
|
to distribute software through any other system and a licensee cannot
|
|
|
impose that choice.
|
|
|
|
|
|
This section is intended to make thoroughly clear what is believed to
|
|
|
be a consequence of the rest of this License.
|
|
|
|
|
|
8. If the distribution and/or use of the Program is restricted in
|
|
|
certain countries either by patents or by copyrighted interfaces, the
|
|
|
original copyright holder who places the Program under this License
|
|
|
may add an explicit geographical distribution limitation excluding
|
|
|
those countries, so that distribution is permitted only in or among
|
|
|
countries not thus excluded. In such case, this License incorporates
|
|
|
the limitation as if written in the body of this License.
|
|
|
|
|
|
9. The Free Software Foundation may publish revised and/or new versions
|
|
|
of the General Public License from time to time. Such new versions will
|
|
|
be similar in spirit to the present version, but may differ in detail to
|
|
|
address new problems or concerns.
|
|
|
|
|
|
Each version is given a distinguishing version number. If the Program
|
|
|
specifies a version number of this License which applies to it and "any
|
|
|
later version", you have the option of following the terms and conditions
|
|
|
either of that version or of any later version published by the Free
|
|
|
Software Foundation. If the Program does not specify a version number of
|
|
|
this License, you may choose any version ever published by the Free Software
|
|
|
Foundation.
|
|
|
|
|
|
10. If you wish to incorporate parts of the Program into other free
|
|
|
programs whose distribution conditions are different, write to the author
|
|
|
to ask for permission. For software which is copyrighted by the Free
|
|
|
Software Foundation, write to the Free Software Foundation; we sometimes
|
|
|
make exceptions for this. Our decision will be guided by the two goals
|
|
|
of preserving the free status of all derivatives of our free software and
|
|
|
of promoting the sharing and reuse of software generally.
|
|
|
|
|
|
NO WARRANTY
|
|
|
|
|
|
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
|
|
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
|
|
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
|
|
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
|
|
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
|
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
|
|
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
|
|
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
|
|
REPAIR OR CORRECTION.
|
|
|
|
|
|
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
|
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
|
|
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
|
|
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
|
|
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
|
|
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
|
|
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
|
|
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
|
|
POSSIBILITY OF SUCH DAMAGES.
|
|
|
|
|
|
END OF TERMS AND CONDITIONS
|
|
|
|
|
|
Appendix: How to Apply These Terms to Your New Programs
|
|
|
|
|
|
If you develop a new program, and you want it to be of the greatest
|
|
|
possible use to the public, the best way to achieve this is to make it
|
|
|
free software which everyone can redistribute and change under these terms.
|
|
|
|
|
|
To do so, attach the following notices to the program. It is safest
|
|
|
to attach them to the start of each source file to most effectively
|
|
|
convey the exclusion of warranty; and each file should have at least
|
|
|
the "copyright" line and a pointer to where the full notice is found.
|
|
|
|
|
|
<one line to give the program's name and a brief idea of what it does.>
|
|
|
Copyright (C) 19yy <name of author>
|
|
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
|
(at your option) any later version.
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
along with this program; if not, write to the Free Software
|
|
|
Foundation, Inc., 51 Franklin Steet, Fifth Floor,
|
|
|
Boston, MA 02110-1301, USA.
|
|
|
|
|
|
Also add information on how to contact you by electronic and paper mail.
|
|
|
|
|
|
If the program is interactive, make it output a short notice like this
|
|
|
when it starts in an interactive mode:
|
|
|
|
|
|
Gnomovision version 69, Copyright (C) 19yy name of author
|
|
|
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
|
|
This is free software, and you are welcome to redistribute it
|
|
|
under certain conditions; type `show c' for details.
|
|
|
|
|
|
The hypothetical commands `show w' and `show c' should show the appropriate
|
|
|
parts of the General Public License. Of course, the commands you use may
|
|
|
be called something other than `show w' and `show c'; they could even be
|
|
|
mouse-clicks or menu items--whatever suits your program.
|
|
|
|
|
|
You should also get your employer (if you work as a programmer) or your
|
|
|
school, if any, to sign a "copyright disclaimer" for the program, if
|
|
|
necessary. Here is a sample; alter the names:
|
|
|
|
|
|
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
|
|
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
|
|
|
|
|
<signature of Ty Coon>, 1 April 1989
|
|
|
Ty Coon, President of Vice
|
|
|
|
|
|
This General Public License does not permit incorporating your program into
|
|
|
proprietary programs. If your program is a subroutine library, you may
|
|
|
consider it more useful to permit linking proprietary applications with the
|
|
|
library. If this is what you want to do, use the GNU Library General
|
|
|
Public License instead of this License.
|
|
|
\endcode
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
/*! \page troll.html
|
|
|
|
|
|
\title Company Information
|
|
|
|
|
|
Trolltech is an international software company with
|
|
|
headquarters in Oslo, the capital of Norway, and with offices
|
|
|
in Brisbane, Australia, and Redwood City, California.
|
|
|
|
|
|
Our flagship product is \link
|
|
|
http://www.trolltech.com/products/ntqt.html Qt\endlink, the
|
|
|
multi-platform C++ GUI toolkit. TQt enables you to build professional,
|
|
|
efficient, portable and maintainable GUI applications quickly and
|
|
|
easily.
|
|
|
|
|
|
\link http://www.trolltech.com/products/embedded/index.html
|
|
|
Qt/Embedded\endlink, the embedded version of Qt, is designed to power
|
|
|
todays new generation of embedded computers and electronic consumer
|
|
|
devices. On top of that, \link
|
|
|
http://www.trolltech.com/products/qtopia/index.html Qtopia\endlink
|
|
|
provides a window system and application suite for handheld devices.
|
|
|
|
|
|
\section1 Software that makes Sense
|
|
|
|
|
|
Our motto expresses the vision behind our products. We design our
|
|
|
products to give our customers the feeling of "this is the way
|
|
|
that things were always meant to be".
|
|
|
|
|
|
We know that it is crucial for our customers to have good tools for
|
|
|
making good software. Therefore, we do not compromise our demands for
|
|
|
superior design and technical quality when we develop our
|
|
|
products.
|
|
|
|
|
|
Trolltech is also known for providing top quality technical support
|
|
|
to our customers. At Trolltech, support inquiries are handled by the
|
|
|
most qualified developers and designers themselves.
|
|
|
|
|
|
\section1 History
|
|
|
|
|
|
Trolltech was founded in 1994. The core team of designers at Trolltech
|
|
|
started developing TQt in 1992, and the first commercial version of TQt was
|
|
|
released in 1995. Since then, Trolltech has experienced rapid growth, and
|
|
|
Qt is currently used in thousands of successful commercial software
|
|
|
development projects world wide. At Trolltech, we continously work to
|
|
|
improve and expand TQt to ensure that it always represents the state of the
|
|
|
art in usability, look and feel, performance, and stability.
|
|
|
|
|
|
For more information, please visit the \link http://www.trolltech.com
|
|
|
Trolltech website\endlink.
|
|
|
|
|
|
\section1 Contact Information
|
|
|
|
|
|
<br clear="all">
|
|
|
|
|
|
<table cellpadding=3 cellspacing=0 border="0" bgcolor="#E5E5E5">
|
|
|
<tr><th colspan=6 valign="top" bgcolor="#a2c511">Email</th></tr>
|
|
|
<tr>
|
|
|
<td rowspan=4><br></td>
|
|
|
<td colspan=2>\link mailto:info@trolltech.com <strong>info@trolltech.com</strong>\endlink
|
|
|
|
|
|
<td colspan=2>\link mailto:sales@trolltech.com <strong>sales@trolltech.com</strong>\endlink
|
|
|
<td rowspan=4><br></td>
|
|
|
<tr>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> General inquiries and questions. Please check the
|
|
|
\link http://www.trolltech.com/faq/ FAQ\endlink to see if your question is already answered there.</td>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> Inquires related to purchasing, pricing and availability of
|
|
|
Trolltech products</td></tr>
|
|
|
<tr>
|
|
|
<td colspan=2>\link mailto:www@trolltech.com <strong>www@trolltech.com</strong>\endlink
|
|
|
<td colspan=2>\link mailto:qt-bugs@trolltech.com <strong>qt-bugs@trolltech.com</strong>\endlink
|
|
|
<tr>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> Comments about our web pages</td>
|
|
|
<td ><br></td>
|
|
|
<td valign="top">
|
|
|
Use this address for bug reports; \e please read (the very short)
|
|
|
\link bughowto.html How to Report a Bug\endlink page \e first.
|
|
|
</td></tr>
|
|
|
<tr><td ><br></td>
|
|
|
<td colspan=4 valign="top">Note that Trolltech uses the
|
|
|
\link http://mail-abuse.org/rbl/ RBL\endlink and
|
|
|
\link http://work-rss.mail-abuse.org/rss/ RSS\endlink databases to cut down on
|
|
|
spam. If your mail server is listed, you will regrettably not be able to
|
|
|
send us mail. The \link http://www.mail-abuse.org/tsi/ MAPS TSI\endlink
|
|
|
pages provide information about how to secure your server.
|
|
|
</td><td ><br></td></tr>
|
|
|
<tr bgcolor="#ffffff"><td bgcolor="#ffffff" colspan="6"><3E><br><3E></td></tr>
|
|
|
<tr><th colspan=6 valign="top" bgcolor="#a2c511">Norway Office</th></tr>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<td rowspan=4><br></td>
|
|
|
<td colspan=2><strong>Telephone</strong>
|
|
|
<td colspan=2><strong>Street/Mail Address</strong>
|
|
|
<td rowspan=4><br></td>
|
|
|
<tr>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> General inquiries: +47 21 60 48 00</td>
|
|
|
<td rowspan=3><br></td>
|
|
|
<td valign="top" rowspan=3> Sandakerveien 116<br> PO Box 4332 Nydalen<br> NO-0402 Oslo<br> Norway</td></tr>
|
|
|
<tr>
|
|
|
<td colspan=2><strong>Telefax</strong></td>
|
|
|
<tr>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> All inquiries: +47 21 60 48 01</td>
|
|
|
<tr bgcolor="#ffffff"><td bgcolor="#ffffff" colspan="6"><3E><br><3E></td></tr>
|
|
|
<tr><th colspan=6 valign="top" bgcolor="#a2c511">USA Office</th></tr>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<td rowspan=4><br></td>
|
|
|
<td colspan=2><strong>Telephone</strong>
|
|
|
<td colspan=2><strong>Street/Mail Address</strong>
|
|
|
<td rowspan=4><br></td>
|
|
|
<tr>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> General inquiries: (+1) 650-551-1676</td>
|
|
|
<td rowspan=3><br></td>
|
|
|
<td valign="top" rowspan=3> 555 Twin Dolphin Drive<br> Suite 280<br> Redwood City, CA 94065<br> USA</td></tr>
|
|
|
<tr>
|
|
|
<td colspan=2><strong>Telefax</strong></td>
|
|
|
<tr>
|
|
|
<td ><br></td>
|
|
|
<td valign="top"> All inquiries: (+1) 650-551-1851</td>
|
|
|
</table>
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
/*! \page guibooks.html
|
|
|
|
|
|
\title Books about GUI
|
|
|
|
|
|
This is not a comprehensive list of books, there are many other
|
|
|
books worth buying. Here we mention just a few GUI/UI books that don't
|
|
|
gather dust in our shelves.
|
|
|
|
|
|
<b>C++ GUI Programming with TQt 3</b> by Jasmin Blanchette and Mark
|
|
|
Summerfield, ISBN 0-13-124072-2. This is the Official TQt book written
|
|
|
by two veteran Trolls.
|
|
|
\link http://www.amazon.com/exec/obidos/ASIN/0131240722/trolltech/
|
|
|
(Read more about it or buy it.)\endlink
|
|
|
|
|
|
<b>The Design of Everyday Things</b> by Donald Norman,
|
|
|
ISBN 0-38526774-6, is one of the classics of human interface design.
|
|
|
Norman shows how badly something as simple as a kitchen stove can be
|
|
|
designed, and everyone should read it who will design a dialog box,
|
|
|
write an error message, or design just about anything else humans are
|
|
|
supposed to use.
|
|
|
\link http://www.amazon.com/exec/obidos/ASIN/0385267746/trolltech/t
|
|
|
(Read more or buy it.)\endlink
|
|
|
|
|
|
\target fowler
|
|
|
<b>GUI Design Handbook</b> by Susan Fowler, ISBN 0-07-059274-8, is an
|
|
|
alphabetical dictionary of widgets and other user interface elements,
|
|
|
with comprehensive coverage of each. Each chapter covers one widget
|
|
|
or other element, contains the most important recommendation from the
|
|
|
Macintosh, Windows and Motif style guides, notes about common
|
|
|
problems, comparison with other widgets that can serve some of the
|
|
|
same roles as this one, etc.
|
|
|
|
|
|
\link http://www.amazon.com/exec/obidos/ASIN/0070592748/trolltech/t
|
|
|
(Read more or buy it.)\endlink
|
|
|
|
|
|
<b>Macintosh Human Interface Guidelines</b>, second edition, ISBN
|
|
|
0-201-62216-5, is worth buying for the \e {don't}s alone. Even
|
|
|
though you're not writing Macintosh software, avoiding most of what it
|
|
|
advises against will produce more easily comprehensible software.
|
|
|
Doing what it tells you to \e do helps, too.
|
|
|
\link http://www.amazon.com/exec/obidos/ASIN/0201622165/trolltech/t
|
|
|
(Read more or buy it.)\endlink
|
|
|
|
|
|
This book is now available
|
|
|
\link http://developer.apple.com/techpubs/mac/HIGuidelines/HIGuidelines-2.html
|
|
|
on the web\endlink and there is a
|
|
|
\link http://developer.apple.com/techpubs/mac/HIGOS8Guide/thig-2.html Mac
|
|
|
OS 8 addendum.\endlink
|
|
|
|
|
|
<b>The Microsoft Windows User Experience</b>, ISBN 1-55615-679-0,
|
|
|
is Microsoft's look and feel Bible. Indispensable for everyone who
|
|
|
has customers that worship Microsoft, and it's quite good, too.
|
|
|
\link http://www.amazon.com/exec/obidos/ASIN/0735605661/trolltech/t
|
|
|
(Read more or buy it.)\endlink
|
|
|
|
|
|
Microsoft's guidelines are often available on the web, but have
|
|
|
occasionally been hidden in an impenetrable maze of javascript.
|
|
|
\link http://msdn.microsoft.com/library/en-us/dnwue/html/welcome.asp Try and see.\endlink
|
|
|
|
|
|
<b>The Icon Book</b> by William Horton, ISBN 0-471-59900-X, is a
|
|
|
perhaps the only thorough coverage of icons and icon use in software.
|
|
|
In order for icons to be successful, people must be able to do four
|
|
|
things with them: decode, recognize, find and activate them. This
|
|
|
book explains these goals from scratch and how to reach them, both
|
|
|
with single icons and icon families. Some 500 examples are scattered
|
|
|
throughout the text, generally in groups of four or five.
|
|
|
\link http://www.amazon.com/exec/obidos/ASIN/047159900X/trolltech/t
|
|
|
(Read more or buy it.)\endlink
|
|
|
|
|
|
\section1 <nobr>Buying these books from</nobr>
|
|
|
\link http://www.amazon.com/text/ Amazon.com.\endlink
|
|
|
|
|
|
These books are made available in association with Amazon.com, our
|
|
|
favorite on-line bookstore. Here is more information about
|
|
|
\link http://www.amazon.com/exec/obidos/subst/help/shipping-policy.html/t
|
|
|
Amazon.com's shipping options\endlink and its
|
|
|
\link http://www.amazon.com/exec/obidos/subst/help/desk.html/t
|
|
|
customer service.\endlink When you buy a book by following one of these
|
|
|
links, Amazon.com gives about 15% of the purchase price to
|
|
|
\link http://www.amnesty.org Amnesty International.\endlink
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
/*! \page licenses.html
|
|
|
\title Licenses for Code Used in Qt
|
|
|
|
|
|
Qt contains a little code that is not under the \link license.html
|
|
|
QPL\endlink, the \link gpl.html GPL\endlink, or the TQt Commercial
|
|
|
License Agreement, but rather under specific highly permissive
|
|
|
licenses from the original authors. This page lists the licenses used
|
|
|
for that code, names the authors, and links to the points where it is
|
|
|
used.
|
|
|
|
|
|
Trolltech gratefully acknowledges these and others contribution to
|
|
|
Qt. We recommend that all programs that use TQt also acknowledge these
|
|
|
contributions, and quote all these license statements in an appendix
|
|
|
to the documentation.
|
|
|
|
|
|
\legaleselist
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
/*! \page geometry.html
|
|
|
\title Window Geometry
|
|
|
|
|
|
\section1 Overview
|
|
|
|
|
|
QWidget provides several functions that deal with a widget's
|
|
|
geometry. Some of these functions operate on the pure client area
|
|
|
(i.e. the window excluding the window frame), others include the
|
|
|
window frame. The differentiation is done in a way that covers the
|
|
|
most common usage transparently.
|
|
|
|
|
|
\table
|
|
|
\row
|
|
|
\i <strong>Including the window frame:
|
|
|
\i x(), y(), frameGeometry(), pos() and move()
|
|
|
\row
|
|
|
\i <strong>Excluding the window frame:</strong>
|
|
|
\i geometry(), width(), height(), rect() and size()
|
|
|
\endtable
|
|
|
|
|
|
Note that the distinction only matters for decorated top-level
|
|
|
widgets. For all child widgets, the frame geometry is equal to the
|
|
|
widget's client geometry.
|
|
|
|
|
|
This diagram shows most of the functions in use:
|
|
|
\img geometry.png Geometry diagram
|
|
|
|
|
|
\section1 Unix/X11 peculiarities
|
|
|
|
|
|
On Unix/X11, a window does not have a frame until the window manager
|
|
|
decorates it. This happens asynchronously at some point in time after
|
|
|
calling show() and the first paint event the window receives: or it
|
|
|
does not happen at all. Bear in mind that X11 is policy-free (others
|
|
|
call it flexible). Thus you cannot make any safe assumption about the
|
|
|
decoration frame your window will get. Basic rule: there's always one
|
|
|
user who uses a window manager that breaks your assumption, and who
|
|
|
will complain to you.
|
|
|
|
|
|
Furthermore, a toolkit cannot simply place windows on the screen. All
|
|
|
Qt can do is to send certain hints to the window manager. The window
|
|
|
manager, a separate process, may either obey, ignore or misunderstand
|
|
|
them. Due to the partially unclear Inter-Client Communication
|
|
|
Conventions Manual (ICCCM), window placement is handled quite
|
|
|
differently in existing window managers.
|
|
|
|
|
|
X11 provides no standard or easy way to get the frame geometry once
|
|
|
the window is decorated. TQt solves this problem with nifty heuristics
|
|
|
and clever code that works on a wide range of window managers that
|
|
|
exist today. Don't be surprised if you find one where frameGeometry()
|
|
|
returns bogus results though.
|
|
|
|
|
|
Nor does X11 provide a way to maximize a window. The showMaximized()
|
|
|
function in TQt therefore has to emulate the feature. Its result
|
|
|
depends on the result of frameGeometry() and the capability of the
|
|
|
window manager to do proper window placement, neither of which can be
|
|
|
guaranteed.
|
|
|
|
|
|
\section1 Restoring a Window's Geometry
|
|
|
|
|
|
A common task in modern applications is to restore a window's geometry
|
|
|
in a later session. On Windows, this is basically storing the result
|
|
|
of geometry() and calling setGeometry() in the next session before
|
|
|
calling show(). On X11, this won't work because an invisible window
|
|
|
doesn't have a frame yet. The window manager would decorate the window
|
|
|
later. When this happens, the window shifts towards the bottom/right
|
|
|
corner of the screen depending on the size of the decoration frame. X
|
|
|
theoretically provides a way to avoid this shift. Our tests have
|
|
|
shown, though, that almost all window managers fail to implement this
|
|
|
feature.
|
|
|
|
|
|
A workaround is to call setGeometry() after show(). This has the
|
|
|
two disadvantages that the widget appears at a wrong place for a
|
|
|
millisecond (results in flashing) and that currently only every
|
|
|
second window manager gets it right. A safer solution is to store
|
|
|
both pos() and size() and to restore the geometry using resize() and
|
|
|
move() before calling show(), as demonstrated in the following
|
|
|
example:
|
|
|
|
|
|
\code
|
|
|
MyWidget* widget = new MyWidget
|
|
|
...
|
|
|
QPoint p = widget->pos(); // store position
|
|
|
QSize s = widget->size(); // store size
|
|
|
...
|
|
|
widget = new MyWidget;
|
|
|
widget->resize( s ); // restore size
|
|
|
widget->move( p ); // restore position
|
|
|
widget->show(); // show widget
|
|
|
\endcode
|
|
|
|
|
|
This method works on both MS-Windows and most existing X11 window
|
|
|
managers.
|
|
|
|
|
|
*/
|