You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/integration.doc

166 lines
6.5 KiB

/****************************************************************************
**
** Documentation of Visual Studio Integration Plugin
**
** Copyright (C) 2005-2008 Trolltech ASA. All rights reserved.
**
** This file is part of the Qt 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 Qt 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 integration.html
\title About the Visual Studio Integration Plugin
The Visual Studio Integration Plugin is currently available only to users of
Visual Studio 6, it offers simple ways of doing common tasks when writing a
Qt application.
\tableofcontents
\section1 How to install the Visual Studio Integration Plugin
When you install Qt, the integration plugin should be installed for you,
and ready for use. However, sometimes this does not happen properly, so
you need to manually carry out the following steps.
\list
\i Ensure that the file '%MSDevDir%\\addins\\qmsdev.dll' exists.
\i Start Visual Studio, if it isn't already running.
\i Select Tools|Customize|Add-ins and Macro Files.
\i Ensure the checkbox to the left of the "QMsDev Developer Studio-Add-In" add-in is checked.
\i Click Close.
\endlist
Now the integration plugin should be properly installed. If this doesn't
work, then contact Trolltech technical support giving details of
what went wrong.
\section1 How to uninstall the Visual Studio Integration Plugin
When you want to uninstall the integration plugin, just carry out the
following steps.
\list
\i Close down any instances of Visual Studio.
\i Delete the file '%MSDevDir%\\addins\\qmsdev.dll'
\endlist
\section1 What can the Visual Studio Integration Plugin do?
The integration plugin adds the following options to Visual Studio:
\list
\i New Qt Project
\i New Qt Dialog
\i Qt Designer
\i Open Qt Project
\i Write Qt Project
\i Use Qt In Current Project
\i Add MOC
\endlist
\section2 Using the 'New Qt Project' button
The 'New Qt Project' button allows you to create a simple Qt project
ready for development. Simply fill in the form and if you select
'Dialog' or 'Main Window' without MDI support then it will
automatically start up \e{Qt Designer}. When you have finished with
the form in \e{Qt Designer} just save it and it will appear in a
ready made Qt project.
If you select 'Main Window' with 'MDI Support' then it will simply
give you a code skeleton in a project ready for you to populate with
your own code.
\section2 Using the 'New Qt Dialog' button
The 'New Qt Dialog' button works in two ways: You can use it to create a new
dialog for your project; or you can use it to insert an existing
dialog into your project.
If you want to create a new dialog then all you need to do is specify where
the dialog file should be saved and give it a name. This will start up
\e{Qt Designer} to allow you to design your new dialog, and will add it to
the existing project.
If you want to add an existing dialog to your project, then just select the
relevant \c .ui file. This will then add it to your existing project and add
the relevant steps to create the generated code.
\section2 Using the 'Qt Designer' button
The 'Qt Designer' button simply starts up \e{Qt Designer}, it has no ties to
your existing project so whatever you do with it will not affect your
existing projects. It can also be started up by using the Ctrl+Shift+D key
combination in Visual Studio.
\section2 Using the 'Open Qt Project' button
The 'Open Qt Project' button allows you to convert an existing \c
qmake project file into a \c .dsp file which you can insert into
your existing workspace. When you click the 'Open Qt Project'
button, just select an existing \c qmake project file (a \c .pro
file) and then click OK. You will get a message box at the end
which asks you to insert the newly created \c .dsp file into your
existing workspace.
\section2 Using the 'Write Qt Project' button
The 'Write Qt Project' button creates a \c qmake project (\c .pro)
file for your current project so that you can easily copy the files
onto another platform and be able to use \c qmake to create a Makefile
on that other platform. All you need to do is make the project you
want to create a \c .pro file for, and click on the button. Just
name your \c qmake project file and click Save.
\section2 Using the 'Use Qt In Current Project' button
The 'Use Qt In Current Project' button simply adds in the necessary
information for the current project so that it links against Qt and
sets any other settings needed to use Qt in that project.
\section2 Using the 'Add MOC' button
The 'Add MOC' button will add in the custom build step for the selected file
so that it creates any needed MOC files and it will add these generated
files to the project. All you need to do to use it is click on a file that
has \c Q_OBJECT and click the button.
You only need to use this button if you added a file that has \c
Q_OBJECT in it by hand, you don't need to use this if you used any
of the previously mentioned buttons. It can also be invoked by using
the Ctrl+Shift+M key combination in Visual Studio.
*/