diff options
Diffstat (limited to 'doc/src/qtcocoa-known-issues.qdoc')
-rw-r--r-- | doc/src/qtcocoa-known-issues.qdoc | 168 |
1 files changed, 168 insertions, 0 deletions
diff --git a/doc/src/qtcocoa-known-issues.qdoc b/doc/src/qtcocoa-known-issues.qdoc new file mode 100644 index 0000000..eedbd68 --- /dev/null +++ b/doc/src/qtcocoa-known-issues.qdoc @@ -0,0 +1,168 @@ +/**************************************************************************** +** +** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** Contact: Qt Software Information (qt-info@nokia.com) +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** No Commercial Usage +** This file contains pre-release code and may not be distributed. +** You may use this file in accordance with the terms and conditions +** contained in the either Technology Preview License Agreement or the +** Beta Release License Agreement. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain +** additional rights. These rights are described in the Nokia Qt LGPL +** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this +** package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU +** General Public License version 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU General Public License version 3.0 requirements will be +** met: http://www.gnu.org/copyleft/gpl.html. +** +** If you are unsure which license is appropriate for your use, please +** contact the sales department at qt-sales@nokia.com. +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! + \page qtcocoa-known-issues.html + \title Known Issues with the Qt/Mac Cocoa Port + + This document explains the current list of features in the Qt/Mac Cocoa port + that are currently not working. Most of the issues will be addressed in + upcoming snapshots and beta releases. We hope that all the issues should be + addressed by the time the of the final 4.5.0 release. + + \tableofcontents + + \section1 What Works + + Here are the things that we can say about the current state of the Qt/Mac Cocoa port. + + \list + \i \e{64-bit Support}: + The Qt libraries currently do build and link as 64-bit frameworks and it is + possible to build and run many of the Qt examples as 64-bit. + + \i \e{HIViews are now NSViews}: + Every QWidget is now backed by an NSView pointer instead of an HIViewRef. + QWidget::winId() will return an NSView pointer that can be used in other + Cocoa technologies (e.g., Core Animation). + + \i \e{Some Native Dialogs Work}: + QFileDialog and QColorDialog have been ported to use NSOpen-/NSSavePanel and + NSColorPanel respectively. QPrintDialog and QPageSetupDialog are not in + this release, but are on their way. Currently, none of these dialogs show + up as sheets pending the creation of an asynchronous API. + + \i \e{Painting, Printing, and Styles}: + Since printing and painting used Quartz 2D and styling used HITheme, these + sub-systems work without any changes. + + \i \e {OpenGL}: + OpenGL is fully supported,including pixel buffers and framebuffer objects. + + \i \e{Clipboard}: + Using QClipboard to copy and paste data works as expected. + + \i \e{Mouse, Keyboard, and Wheel events}: + Mouse, keyboard, and wheel events are dispatched to the proper + widget. The Qt/Mac Cocoa port respects Cocoa's idea of a "First + Responder." + + \endlist + + \section1 Current Known Issues + + The following are items that don't currently work, but that we plan to have + resolved before the final release of the Qt/Mac Cocoa port. Please do not + file bugs on these. + + \list + \i \e{Carbon Support}: + The current source tree for the Qt/Mac Cocoa port contains source for + building Qt/Mac with Cocoa. It contains some of the source code that is + used for the Carbon port, but it is currently not set up to build the + Carbon Qt/Mac libraries. Please use a normal release or snapshot if you + want to use Carbon. + + \i \e{Drag and Drop Support}: + Drag and Drop is currently not implemented and needs to be ported to Cocoa, + but using the clipboard does work at this time. + + \i \e {Accessibility}: + Accessibility support is not implemented and needs to be ported to Cocoa. + + \i \e {Text}: + Most text rendering works fine for Latin-1 characters. However, rendering + non-Latin-1 characters has not been tested. + + \i \e {Input Methods}: + Input methods also need to be ported to Cocoa. + + \i \e {Shortcuts}: + Shortcuts that exist outside of the menu bar may not be dispatched. + + \i \e {Tablet Support}: + The tablet support has not been ported from Carbon yet. However, it should + still be possible to use the tablet as a mouse. + + \i \e {Phonon}: + Phonon uses the QuickTime backend that is only available on 32-bit. Using + Phonon in 64-bit requires a QTKit-based backend and has not been done. + + \i \e {Unified Toolbar}: + The QMainWindow::setUnifiedTitleAndToolBarOnMac() method currently does nothing. + + \i \e {Dialogs, Tool Windows, Sheets, and Drawers}: + At the moment, all windows are subclasses of NSWindow. This means that + window types like drawers and sheets do not work and tool windows do not + get the right decorations. Modal dialogs do show up at the correct window + level, but are not yet considered "panels." Many window flags are not + recognized. + + \endlist + + \section1 Things We Don't Expect to Support + + The following items that we do not plan on spending any resources on unless + there is monumental outcry for their inclusion. + + \list + \i \e{Qt3Support}: + At this time we have no plans for making the Qt3Support module work with + the Qt/Mac Cocoa port in 64-bit mode. Following in footsteps of Apple, we + would like to encourage you to consider the time of going Cocoa and 64-bit + as a chance to jettison Qt 3 constructs and classes. + + \i \e{Support for versions of Mac OS X below 10.5}: + We are using methods and classes that are only available in 10.5 and + higher. Most of these functions don't have any equivalent on earlier + versions. We recommend using the Carbon version for earlier versions of Mac + OS X. We anticipate keeping the Carbon port supported at least for the + lifetime of 4.5. + + \i \e{Support for -no-framework or -static}: + Cocoa requires that we load a nib in order to properly access the global + menu bar. This nib has to reside on disk somewhere. The most logical place + for it to reside is inside the QtGui framework. For this reason, building + Qt as standard "dylibs" or statically is no longer supported. + + \endlist + +*/ |