dist/changes-0.96
changeset 0 1918ee327afb
equal deleted inserted replaced
-1:000000000000 0:1918ee327afb
       
     1 Here is a list of (major) changes in Qt from 0.95 to 0.96.
       
     2 
       
     3 Bug-fixes, optimizations and improved documentation, of course.
       
     4 QClipboard is new.
       
     5 
       
     6 There are some changes in the API (Qt header files).  Some functions have
       
     7 been renamed or the arguments have changed. The old versions of these
       
     8 functions have been obsoleted. A call to an obsoleted function will by
       
     9 default generate a runtime warning the first time it is called, but it
       
    10 will be executed correctly. If you really need to ship code fast, you can
       
    11 turn off the runtime obsolescence warnings by calling
       
    12 qSuppressObsoleteWarnings().
       
    13 
       
    14 Obsoleted functions will disappear in a future release.  To get
       
    15 compile-time errors for each use of an obsoleted function, compile your
       
    16 code with -DTEST_OBSOLETE. You should recompile without this option when
       
    17 you have upgraded your code (otherwise, you may get linking errors). 
       
    18 Note: it is probably not a good idea to compile the Qt library with
       
    19 -DTEST_OBSOLETE, it may cause problems if you try to link or run
       
    20 programs that use obsoleted functions.
       
    21 
       
    22 For new users: obsoleted functions are no longer documented, in fact they
       
    23 are not even visible in the documentation.
       
    24 
       
    25 *************** Changes that might affect runtime behavior *****************
       
    26 
       
    27 QFileInfo:
       
    28 ----------
       
    29   size() returns uint(previousy int), 0 if the size cannot be fetched (was -1).
       
    30 	Use isFile() to check.
       
    31 
       
    32 
       
    33 QPopupMenu
       
    34 ------------
       
    35   When a popup menu is a submenu (directly or as a subsub...menu) of a
       
    36   menu bar(QMenuBar), the menu bar will now always emit the activated() or
       
    37   highlighted() signal when a submenu emits these signals. This fix might
       
    38   have undesired effects if you previously have worked around it by
       
    39   connecting to signals both in menu bar and its submenus.
       
    40 
       
    41 *************** Changes that might generate compile errors *****************
       
    42 **************           when compiling old code           *****************
       
    43 
       
    44 QDataStream:
       
    45 -----------
       
    46   Serialization of int and uint is no longer supported. Use INT32 and
       
    47   UINT32 instead. This had to be changed in order to run Qt on 64-bit
       
    48   architectures.
       
    49 
       
    50 
       
    51 QImage:
       
    52 -------
       
    53   24-bpp pixel format no longer supported, use 32-bpp instead.
       
    54 
       
    55   This means that you have to use uint* instead of uchar* when accessing
       
    56   pixel values. You cannot use the uchar* pointer directly, because the
       
    57   pixel format depends on the byte order on the underlying platform. Use
       
    58   qRgb() and friends (qcolor.h) to access the pixels.
       
    59 
       
    60 
       
    61 QWidget:
       
    62 --------
       
    63   setMouseTracking() does not return bool. Call hasMouseTracking() to
       
    64   determine the mouse tracking state. (This only affects code that
       
    65   actually uses the return value.)
       
    66 
       
    67   (There are other changes in QWidget, see below)
       
    68 
       
    69 
       
    70 *************** Type changes that might generate warnings: *****************
       
    71 
       
    72 
       
    73 QCache/QIntCache:
       
    74 -----------------
       
    75   Using int/uint instead of long/ulong.
       
    76 
       
    77 
       
    78 QDate/QTime/QDateTime:
       
    79 ----------------------
       
    80   Using int/uint instead of long/ulong (MS-DOS required long).
       
    81 
       
    82 
       
    83 QIODevice/QBuffer/QFile:
       
    84 ------------------------
       
    85   Using int/uint instead of long/ulong.
       
    86 
       
    87 
       
    88 QKeyEvent:
       
    89 ----------
       
    90   ascii() now returns int (previously uchar).
       
    91 
       
    92 
       
    93 QTableView:
       
    94 ------------
       
    95   uint used instead of ulong (tableFlags() etc.)
       
    96 
       
    97 
       
    98 QTextStream:
       
    99 ------------
       
   100   int used instead of long (flags() etc.)
       
   101 
       
   102 
       
   103 *****************         Obsoleted functions         **********************
       
   104 
       
   105 QAccel:
       
   106 -------
       
   107   enable(), disable() and isDisabled() are obsolete.
       
   108   Use setEnabled(TRUE/FALSE) and !isEnabled() instead.
       
   109   isItemDisabled(), enableItem(), disableItem() are obsolete.
       
   110   Use !isItemEnabled(), setItemEnabled(TRUE/FALSE) instead.
       
   111 
       
   112 
       
   113 QApplication:
       
   114 -------------
       
   115   cursor(), setCursor() and restoreCursor() obsoleted.
       
   116   Use overrideCursor(), setOverrideCursor() and restoreOverrideCursor()
       
   117   instead.
       
   118 
       
   119 
       
   120 QBitmap:
       
   121 --------
       
   122   Constructor takes "const uchar *bits" instead of "const char *"
       
   123   because of sign problems (uchar = unsigned char). Old constructors are
       
   124   obsolete.
       
   125 
       
   126 
       
   127 QButton:
       
   128 --------
       
   129   toggleButton() is obsolete, renamed to isToggleButton().
       
   130 
       
   131 
       
   132 QColor:
       
   133 -------
       
   134   The functions QRED, QGREEN, QBLUE, QRGB, QGRAY obsolete.
       
   135   Instead, use  qRed, qGreen, qBlue, qRgb, qGray.
       
   136 
       
   137 
       
   138 QComboBox:
       
   139 ----------
       
   140   setStrList() obsolete, use clear() + insertStrList() instead.
       
   141   string() obsolete, use text() instead.
       
   142 
       
   143 
       
   144 QLCDNumber:
       
   145 ----------
       
   146   longValue() is obsolete, use intValue() instead.
       
   147 
       
   148 
       
   149 QListbox:
       
   150 ---------
       
   151   The macro LBI_String is obsolete, use LBI_text instead.
       
   152   string() obsolete, use text() instead.
       
   153   stringCopy() and setStringCopy() are obsolete.
       
   154 
       
   155 
       
   156 QMenuData:
       
   157 ----------
       
   158   string() obsolete, use text() instead.
       
   159   isItemDisabled(), enableItem(), disableItem() are obsolete.
       
   160   Use !isItemEnabled(), setItemEnabled(TRUE/FALSE) instead.
       
   161   checkItem() and uncheckItem() are obsolete.
       
   162   Use setItemChecked(TRUE/FALSE) instead.
       
   163 
       
   164 
       
   165 QPainter: 
       
   166 --------- 
       
   167 
       
   168   drawBezier() is obsolete, general Bezier curves are rarely used and
       
   169   cost too much. Qt will only support drawQuadBezier() (four-point
       
   170   Bezier) in the future.
       
   171 
       
   172 QPointArray:
       
   173 -----------
       
   174   move() is obsolete, use translate() instead.
       
   175   bezier() is obsolete, general Bezier curves are rarely used and
       
   176   cost too much. Qt will only support quadBezier() (four-point
       
   177   Bezier) in the future.
       
   178 
       
   179 
       
   180 
       
   181 QRect:
       
   182 ------
       
   183   move() is obsolete, use moveBy() instead.
       
   184   setTopLeft(), setTopRight(), setBottomLeft(), setBottomRight() and
       
   185   setCenter() is obsolete, use moveTopLeft(), moveTopRight(),
       
   186   moveBottomLeft(), moveBottomRight() and moveCenter() instead.
       
   187 
       
   188 
       
   189 QRegion:
       
   190 -------
       
   191   move() is obsolete, use translate() instead.
       
   192 
       
   193 
       
   194 QSocketNotifier:
       
   195 ----------------
       
   196   enabled() is obsolete. Use isEnabled() instead.
       
   197 
       
   198 
       
   199 QWidget:
       
   200 --------
       
   201   enable(), disable() and isDisabled() are obsolete.
       
   202   Use setEnabled(TRUE/FALSE) and !isEnabled() instead.
       
   203 
       
   204   setMinimumSize(), setMaximumSize(), minimumSize(), maximumSize() are obsolete
       
   205   use setMinSize(), setMaxSize(), minSize(), maxSize() instead.
       
   206 
       
   207   enableUpdates() obsolete, use isUpdatesEnabled()/setUpdatesEnabled().
       
   208 
       
   209   id() is obsolete, it has been renamed to winId().
       
   210 
       
   211 ***************** All other changes from 0.95 to 0.96 **********************
       
   212 
       
   213 moc
       
   214 ----------
       
   215     Gives a warning if no output is generated.
       
   216 
       
   217 
       
   218 qglobal.h:
       
   219 ----------
       
   220   INT32 and UINT32 typedefs changed to work with DEC Alpha.
       
   221 
       
   222 
       
   223 QApplication:
       
   224 -------------
       
   225   clipboard() is new.
       
   226 
       
   227 
       
   228 QButtonGroup:
       
   229 -------------
       
   230   Exclusive group setting added (isExclusive and setExclusive).
       
   231   find() is new.
       
   232 
       
   233 
       
   234 QColor:
       
   235 -------
       
   236   New type QRgb (uint), used for RGB triplet.
       
   237 
       
   238 
       
   239 QLineEdit:
       
   240 ----------
       
   241   You can now mark text, and copy and paste to/from the clipboard.
       
   242 
       
   243 
       
   244 QPaintDevice:
       
   245 ---------
       
   246   The bitblt function now takes an ignoreMask parameter. It has a default
       
   247   value, so no old code will be broken.
       
   248 
       
   249 QPrinter:
       
   250 ------------
       
   251   fixed minor bugs in handling of polygons and beziers.
       
   252 
       
   253 
       
   254 QWidget:
       
   255 --------
       
   256   New protected virtual functions styleChange(), backgroundColorChange(),
       
   257   backgroundPixmapChange(), paletteChange() and fontChange().
       
   258   These functions are called from setStyle(), setBackgroundColor() etc.
       
   259   You can reimplement them to if you need to know when widget properties
       
   260   changed and to optimize updates.
       
   261 
       
   262   The destroyed() signal has been moved to QObject.
       
   263