[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    KDE/kdelibs/kio/kio
From:       Stephen Kelly <steveire () gmail ! com>
Date:       2009-01-26 15:10:07
Message-ID: 1232982607.273667.9730.nullmailer () svn ! kde ! org
[Download RAW message or body]

SVN commit 916960 by skelly:

Update the apidox with a note about QPersistentModelIndexes.



 M  +7 -0      kdirmodel.h  


--- trunk/KDE/kdelibs/kio/kio/kdirmodel.h #916959:916960
@@ -32,6 +32,13 @@
  * KDirModel implements the QAbstractItemModel interface (for use with Qt's \
                model/view widgets)
  * around the directory listing for one directory or a tree of directories.
  *
+ * Note that there are some cases when using QPersistentModelIndexes from this model \
will not give + * expected results. QPersistentIndexes will remain valid and updated \
if its siblings are added or  + * removed. However, if the QPersistentIndex or one of \
its ancestors is moved, the QPersistentIndex will become  + * invalid. For example, \
if a file or directory is renamed after storing a QPersistentModelIndex for it,  + * \
the index (along with any stored children) will become invalid even though it is \
still in the model. The reason  + * for this is that moves of files and directories \
are treated as separate insert and remove actions. + *
  * @see KDirSortFilterProxyModel
  *
  * @author David Faure


[prev in list] [next in list] [prev in thread] [next in thread]