doc/src/getting-started/how-to-learn-qt.qdoc
branchRCL_3
changeset 7 3f74d0d4af4c
equal deleted inserted replaced
6:dee5afe5301f 7:3f74d0d4af4c
       
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
       
     4 ** All rights reserved.
       
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
       
     6 **
       
     7 ** This file is part of the documentation of the Qt Toolkit.
       
     8 **
       
     9 ** $QT_BEGIN_LICENSE:LGPL$
       
    10 ** No Commercial Usage
       
    11 ** This file contains pre-release code and may not be distributed.
       
    12 ** You may use this file in accordance with the terms and conditions
       
    13 ** contained in the Technology Preview License Agreement accompanying
       
    14 ** this package.
       
    15 **
       
    16 ** GNU Lesser General Public License Usage
       
    17 ** Alternatively, this file may be used under the terms of the GNU Lesser
       
    18 ** General Public License version 2.1 as published by the Free Software
       
    19 ** Foundation and appearing in the file LICENSE.LGPL included in the
       
    20 ** packaging of this file.  Please review the following information to
       
    21 ** ensure the GNU Lesser General Public License version 2.1 requirements
       
    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
       
    23 **
       
    24 ** In addition, as a special exception, Nokia gives you certain additional
       
    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
       
    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
       
    27 **
       
    28 ** If you have questions regarding the use of this file, please contact
       
    29 ** Nokia at qt-info@nokia.com.
       
    30 **
       
    31 **
       
    32 **
       
    33 **
       
    34 **
       
    35 **
       
    36 **
       
    37 **
       
    38 ** $QT_END_LICENSE$
       
    39 **
       
    40 ****************************************************************************/
       
    41 
       
    42 /*!
       
    43     \page how-to-learn-qt.html
       
    44     \title How to Learn Qt
       
    45     \brief Links to guides and resources for learning Qt.
       
    46     \nextpage Tutorials
       
    47 
       
    48     \section1 Getting Started
       
    49 
       
    50     We assume that you already know C++ and will be using it for Qt
       
    51     development. See the \l{Qt website} for more information about
       
    52     using other programming languages with Qt.
       
    53 
       
    54     If you want to program purely in C++, designing your interfaces
       
    55     in code without the aid of any design tools, take a look at the
       
    56     \l{Tutorials}. These are designed to get you into Qt programming,
       
    57     with an emphasis on working code rather than being a tour of features.
       
    58 
       
    59     If you want to design your user interfaces using a design tool, then
       
    60     read at least the first few chapters of the \l{Qt Designer manual}.
       
    61 
       
    62     By now you'll have produced some small working applications and have a
       
    63     broad feel for Qt programming. You could start work on your own
       
    64     projects straight away, but we recommend reading a couple of key
       
    65     overviews to deepen your understanding of Qt: \l{Qt Object Model}
       
    66     and \l{Signals and Slots}.
       
    67 
       
    68     \beginfloatleft
       
    69     \inlineimage qtdemo-small.png
       
    70     \endfloat
       
    71 
       
    72     \section1 Getting an Overview
       
    73 
       
    74     At this point, we recommend looking at the
       
    75     \l{All Overviews and HOWTOs}{overviews} and reading those that are
       
    76     relevant to your projects. You may also find it useful to browse the
       
    77     source code of the \l{Qt Examples}{examples} that have things in
       
    78     common with your projects. You can also read Qt's source code since
       
    79     this is supplied.
       
    80 
       
    81     If you run the \l{Examples and Demos Launcher}, you'll see many of Qt's
       
    82     widgets in action.
       
    83 
       
    84     The \l{Qt Widget Gallery} also provides overviews of selected Qt
       
    85     widgets in each of the styles used on various supported platforms.
       
    86     \clearfloat
       
    87 
       
    88     \section1 Books and Learning Materials
       
    89 
       
    90     Qt comes with extensive documentation, with hypertext
       
    91     cross-references throughout, so you can easily click your way to
       
    92     whatever interests you. The part of the documentation that you'll
       
    93     probably use the most is the \link index.html API
       
    94     Reference\endlink. Each link provides a different way of
       
    95     navigating the API Reference; try them all to see which work best
       
    96     for you. You might also like to try \l{Qt Assistant}:
       
    97     this tool is supplied with Qt and provides access to the entire
       
    98     Qt API, and it provides a full text search facility.
       
    99 
       
   100     There are also a growing number of books about Qt programming.
       
   101     We recommend the official Qt book,
       
   102     \l{http://www.amazon.com/gp/product/0132354160/ref=ase_trolltech/}{C++
       
   103     GUI Programming with Qt 4, Second Edition} (ISBN 0-13-235416-0). This book
       
   104     provides comprehensive coverage of Qt programming all the way
       
   105     from "Hello Qt" to advanced features such as multithreading, 2D and
       
   106     3D graphics, networking, item view classes, and XML. (The first edition,
       
   107     which is based on Qt 4.1, is available
       
   108     \l{http://www.qtrac.eu/C++-GUI-Programming-with-Qt-4-1st-ed.zip}{online}.)
       
   109 
       
   110     See \l{Books about Qt Programming} for a complete list of Qt books,
       
   111     including translations to various languages.
       
   112 
       
   113     Another valuable source of example code and explanations of Qt
       
   114     features is the archive of articles from \l{Qt Quarterly}, a quarterly newsletter for users of Qt.
       
   115 
       
   116     For documentation on specific Qt modules and other guides, refer to
       
   117     \l{All Overviews and HOWTOs}.
       
   118 
       
   119     \section1 Further Reading
       
   120 
       
   121     Qt has an active and helpful user community who communicate using
       
   122     the \l{Qt Mailing Lists}{qt-interest} mailing list, the \l{Qt Centre}
       
   123     Web site, and a number of other community Web sites and Weblogs.
       
   124     In addition, many Qt developers are active members of the
       
   125     \l{KDE}{KDE community}.
       
   126 
       
   127     Good luck, and have fun!
       
   128 */