Doc: Ensure deprecated APIs in Qt Core are documented as such
Added \deprecated [version_since] when needed Remove references to deprecated functions in \sa statements Fixes: QTBUG-94534 Pick-to: 6.2 Change-Id: I3b3d4277d63fc5d6d207c28ff2484aed30b83247 Reviewed-by: Edward Welbourne <edward.welbourne@qt.io>
This commit is contained in:
parent
53e4a50c6b
commit
a2c8184b6b
@ -531,10 +531,9 @@ void QLibraryInfoPrivate::keyAndDefault(QLibraryInfo::LibraryPath loc, QString *
|
|||||||
}
|
}
|
||||||
|
|
||||||
/*! \fn QString QLibraryInfo::location(LibraryLocation loc)
|
/*! \fn QString QLibraryInfo::location(LibraryLocation loc)
|
||||||
\deprecated Use path() instead.
|
\deprecated [6.0] Use path() instead.
|
||||||
|
|
||||||
Returns the path specified by \a loc.
|
Returns the path specified by \a loc.
|
||||||
\sa path()
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
|
@ -323,8 +323,6 @@ JavaVM *QJniEnvironment::javaVM()
|
|||||||
}
|
}
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\fn bool QJniEnvironment::registerNativeMethods(const char *className, const JNINativeMethod methods[], int size)
|
|
||||||
|
|
||||||
Registers the Java methods in the array \a methods of size \a size, each of
|
Registers the Java methods in the array \a methods of size \a size, each of
|
||||||
which can call native C++ functions from class \a className. These methods
|
which can call native C++ functions from class \a className. These methods
|
||||||
must be registered before any attempt to call them.
|
must be registered before any attempt to call them.
|
||||||
@ -355,10 +353,10 @@ bool QJniEnvironment::registerNativeMethods(const char *className, const JNINati
|
|||||||
return false;
|
return false;
|
||||||
return registerNativeMethods(classObject.objectClass(), methods, size);
|
return registerNativeMethods(classObject.objectClass(), methods, size);
|
||||||
}
|
}
|
||||||
|
#if QT_DEPRECATED_SINCE(6, 2)
|
||||||
/*!
|
/*!
|
||||||
\overload
|
\overload
|
||||||
\obsolete Use the overload with a const JNINativeMethod[] instead.
|
\deprecated [6.2] Use the overload with a const JNINativeMethod[] instead.
|
||||||
|
|
||||||
Registers the Java methods in the array \a methods of size \a size, each of
|
Registers the Java methods in the array \a methods of size \a size, each of
|
||||||
which can call native C++ functions from class \a className. These methods
|
which can call native C++ functions from class \a className. These methods
|
||||||
@ -380,7 +378,6 @@ bool QJniEnvironment::registerNativeMethods(const char *className, const JNINati
|
|||||||
env.registerNativeMethods("org/qtproject/android/TestJavaClass", methods, 2);
|
env.registerNativeMethods("org/qtproject/android/TestJavaClass", methods, 2);
|
||||||
\endcode
|
\endcode
|
||||||
*/
|
*/
|
||||||
#if QT_DEPRECATED_SINCE(6, 2)
|
|
||||||
bool QJniEnvironment::registerNativeMethods(const char *className, JNINativeMethod methods[],
|
bool QJniEnvironment::registerNativeMethods(const char *className, JNINativeMethod methods[],
|
||||||
int size)
|
int size)
|
||||||
{
|
{
|
||||||
|
@ -378,7 +378,7 @@ static void customClear(QVariant::Private *d)
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use QMetaType::Type instead.
|
\deprecated Use \l QMetaType::Type instead.
|
||||||
\enum QVariant::Type
|
\enum QVariant::Type
|
||||||
|
|
||||||
This enum type defines the types of variable that a QVariant can
|
This enum type defines the types of variable that a QVariant can
|
||||||
@ -795,7 +795,7 @@ QVariant::QVariant(const QVariant &p)
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/*! \fn QVariant::QVariant(Type type)
|
/*! \fn QVariant::QVariant(Type type)
|
||||||
\deprecated
|
\deprecated [6.0] Use the constructor taking a QMetaType instead.
|
||||||
|
|
||||||
Constructs an uninitialized variant of type \a type. This will create a
|
Constructs an uninitialized variant of type \a type. This will create a
|
||||||
variant in a special null state that if accessed will return a default
|
variant in a special null state that if accessed will return a default
|
||||||
@ -951,7 +951,7 @@ QVariant::QVariant(const QPersistentModelIndex &modelIndex)
|
|||||||
#endif
|
#endif
|
||||||
|
|
||||||
/*! \fn QVariant::Type QVariant::type() const
|
/*! \fn QVariant::Type QVariant::type() const
|
||||||
\deprecated
|
\deprecated [6.0] Use typeId() or metaType() instead.
|
||||||
|
|
||||||
Returns the storage type of the value stored in the variant.
|
Returns the storage type of the value stored in the variant.
|
||||||
Although this function is declared as returning QVariant::Type,
|
Although this function is declared as returning QVariant::Type,
|
||||||
@ -1088,7 +1088,7 @@ void QVariant::clear()
|
|||||||
|
|
||||||
/*!
|
/*!
|
||||||
\fn const char *QVariant::typeToName(int typeId)
|
\fn const char *QVariant::typeToName(int typeId)
|
||||||
\deprecated Use QMetaType instead
|
\deprecated [6.0] Use \c QMetaType(typeId).name() instead.
|
||||||
|
|
||||||
Converts the int representation of the storage type, \a typeId, to
|
Converts the int representation of the storage type, \a typeId, to
|
||||||
its string representation.
|
its string representation.
|
||||||
@ -1098,7 +1098,7 @@ void QVariant::clear()
|
|||||||
|
|
||||||
/*!
|
/*!
|
||||||
\fn QVariant::Type QVariant::nameToType(const char *name)
|
\fn QVariant::Type QVariant::nameToType(const char *name)
|
||||||
\deprecated Use QMetaType instead
|
\deprecated [6.0] Use \c QMetaType.fromName(name).id() instead
|
||||||
|
|
||||||
Converts the string representation of the storage type given in \a
|
Converts the string representation of the storage type given in \a
|
||||||
name, to its enum representation.
|
name, to its enum representation.
|
||||||
@ -1360,13 +1360,13 @@ QDataStream &operator<<(QDataStream &s, const QVariant &p)
|
|||||||
}
|
}
|
||||||
|
|
||||||
/*! \fn QDataStream& operator>>(QDataStream &s, QVariant::Type &p)
|
/*! \fn QDataStream& operator>>(QDataStream &s, QVariant::Type &p)
|
||||||
\deprecated
|
\deprecated [6.0] Stream QMetaType::Type instead.
|
||||||
|
|
||||||
Reads a variant type \a p in enum representation from the stream \a s.
|
Reads a variant type \a p in enum representation from the stream \a s.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*! \fn QDataStream& operator<<(QDataStream &s, const QVariant::Type p)
|
/*! \fn QDataStream& operator<<(QDataStream &s, const QVariant::Type p)
|
||||||
\deprecated
|
\deprecated [6.0] Stream QMetaType::Type instead.
|
||||||
|
|
||||||
Writes a variant type \a p to the stream \a s.
|
Writes a variant type \a p to the stream \a s.
|
||||||
*/
|
*/
|
||||||
@ -1980,7 +1980,7 @@ QVariantList QVariant::toList() const
|
|||||||
/*!
|
/*!
|
||||||
\fn bool QVariant::canConvert(int targetTypeId) const
|
\fn bool QVariant::canConvert(int targetTypeId) const
|
||||||
\overload
|
\overload
|
||||||
\deprecated
|
\deprecated [6.0] Use \c canConvert(QMetaType(targetTypeId)) instead.
|
||||||
|
|
||||||
\sa QMetaType::canConvert()
|
\sa QMetaType::canConvert()
|
||||||
*/
|
*/
|
||||||
@ -1999,7 +1999,7 @@ QVariantList QVariant::toList() const
|
|||||||
|
|
||||||
/*!
|
/*!
|
||||||
\fn bool QVariant::convert(int targetTypeId)
|
\fn bool QVariant::convert(int targetTypeId)
|
||||||
\deprecated
|
\deprecated [6.0] Use \c convert(QMetaType(targetTypeId)) instead.
|
||||||
|
|
||||||
Casts the variant to the requested type, \a targetTypeId. If the cast cannot be
|
Casts the variant to the requested type, \a targetTypeId. If the cast cannot be
|
||||||
done, the variant is still changed to the requested type, but is left in a cleared
|
done, the variant is still changed to the requested type, but is left in a cleared
|
||||||
@ -2017,7 +2017,7 @@ QVariantList QVariant::toList() const
|
|||||||
failed a previous conversion will always fail, changing the type, remaining null,
|
failed a previous conversion will always fail, changing the type, remaining null,
|
||||||
and returning \c false.
|
and returning \c false.
|
||||||
|
|
||||||
\sa canConvert(int targetTypeId), clear()
|
\sa canConvert(), clear()
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
|
@ -1211,7 +1211,7 @@ void QLocale::setDefault(const QLocale &locale)
|
|||||||
/*!
|
/*!
|
||||||
Returns the language of this locale.
|
Returns the language of this locale.
|
||||||
|
|
||||||
\sa script(), country(), languageToString(), bcp47Name()
|
\sa script(), territory(), languageToString(), bcp47Name()
|
||||||
*/
|
*/
|
||||||
QLocale::Language QLocale::language() const
|
QLocale::Language QLocale::language() const
|
||||||
{
|
{
|
||||||
@ -1223,7 +1223,7 @@ QLocale::Language QLocale::language() const
|
|||||||
|
|
||||||
Returns the script of this locale.
|
Returns the script of this locale.
|
||||||
|
|
||||||
\sa language(), country(), languageToString(), scriptToString(), bcp47Name()
|
\sa language(), territory(), languageToString(), scriptToString(), bcp47Name()
|
||||||
*/
|
*/
|
||||||
QLocale::Script QLocale::script() const
|
QLocale::Script QLocale::script() const
|
||||||
{
|
{
|
||||||
@ -1244,7 +1244,7 @@ QLocale::Territory QLocale::territory() const
|
|||||||
|
|
||||||
#if QT_DEPRECATED_SINCE(6, 6)
|
#if QT_DEPRECATED_SINCE(6, 6)
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use territory() instead.
|
\deprecated [6.6] Use \l territory() instead.
|
||||||
|
|
||||||
Returns the territory of this locale.
|
Returns the territory of this locale.
|
||||||
|
|
||||||
@ -1263,10 +1263,10 @@ QLocale::Country QLocale::country() const
|
|||||||
and country is an uppercase, two- or three-letter ISO 3166 country code.
|
and country is an uppercase, two- or three-letter ISO 3166 country code.
|
||||||
|
|
||||||
Note that even if QLocale object was constructed with an explicit script,
|
Note that even if QLocale object was constructed with an explicit script,
|
||||||
name() will not contain it for compatibility reasons. Use bcp47Name() instead
|
name() will not contain it for compatibility reasons. Use \l bcp47Name() instead
|
||||||
if you need a full locale name.
|
if you need a full locale name.
|
||||||
|
|
||||||
\sa QLocale(), language(), script(), country(), bcp47Name()
|
\sa QLocale(), language(), script(), territory(), bcp47Name()
|
||||||
*/
|
*/
|
||||||
|
|
||||||
QString QLocale::name() const
|
QString QLocale::name() const
|
||||||
@ -1323,7 +1323,7 @@ T toIntegral_helper(const QLocalePrivate *d, QStringView str, bool *ok)
|
|||||||
|
|
||||||
This function tries to conform the locale name to BCP47.
|
This function tries to conform the locale name to BCP47.
|
||||||
|
|
||||||
\sa language(), country(), script(), uiLanguages()
|
\sa language(), territory(), script(), uiLanguages()
|
||||||
*/
|
*/
|
||||||
QString QLocale::bcp47Name() const
|
QString QLocale::bcp47Name() const
|
||||||
{
|
{
|
||||||
@ -1338,7 +1338,7 @@ QString QLocale::bcp47Name() const
|
|||||||
For \c QLocale::AnyLanguage an empty string is returned.
|
For \c QLocale::AnyLanguage an empty string is returned.
|
||||||
|
|
||||||
\since 6.1
|
\since 6.1
|
||||||
\sa codeToLanguage(), language(), name(), bcp47Name(), countryToCode(), scriptToCode()
|
\sa codeToLanguage(), language(), name(), bcp47Name(), territoryToCode(), scriptToCode()
|
||||||
*/
|
*/
|
||||||
QString QLocale::languageToCode(Language language)
|
QString QLocale::languageToCode(Language language)
|
||||||
{
|
{
|
||||||
@ -1352,7 +1352,7 @@ QString QLocale::languageToCode(Language language)
|
|||||||
If the code is invalid or not known QLocale::AnyLanguage is returned.
|
If the code is invalid or not known QLocale::AnyLanguage is returned.
|
||||||
|
|
||||||
\since 6.1
|
\since 6.1
|
||||||
\sa languageToCode(), codeToCountry(), codeToScript()
|
\sa languageToCode(), codeToTerritory(), codeToScript()
|
||||||
*/
|
*/
|
||||||
QLocale::Language QLocale::codeToLanguage(QStringView languageCode) noexcept
|
QLocale::Language QLocale::codeToLanguage(QStringView languageCode) noexcept
|
||||||
{
|
{
|
||||||
@ -1391,7 +1391,7 @@ QLocale::Territory QLocale::codeToTerritory(QStringView territoryCode) noexcept
|
|||||||
|
|
||||||
#if QT_DEPRECATED_SINCE(6, 6)
|
#if QT_DEPRECATED_SINCE(6, 6)
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use territoryToCode(Territory) instead.
|
\deprecated [6.6] Use \l territoryToCode() instead.
|
||||||
|
|
||||||
Returns the two-letter territory code for \a country, as defined
|
Returns the two-letter territory code for \a country, as defined
|
||||||
in the ISO 3166 standard.
|
in the ISO 3166 standard.
|
||||||
@ -1411,7 +1411,7 @@ QString QLocale::countryToCode(Country country)
|
|||||||
|
|
||||||
If the code is invalid or not known QLocale::AnyTerritory is returned.
|
If the code is invalid or not known QLocale::AnyTerritory is returned.
|
||||||
|
|
||||||
\deprecated Use codeToTerritory(QStringView) instead.
|
\deprecated [6.6] Use codeToTerritory(QStringView) instead.
|
||||||
\since 6.1
|
\since 6.1
|
||||||
\sa territoryToCode(), codeToLanguage(), codeToScript()
|
\sa territoryToCode(), codeToLanguage(), codeToScript()
|
||||||
*/
|
*/
|
||||||
@ -1428,7 +1428,7 @@ QLocale::Country QLocale::codeToCountry(QStringView countryCode) noexcept
|
|||||||
\note For \c{QLocale::AnyScript} an empty string is returned.
|
\note For \c{QLocale::AnyScript} an empty string is returned.
|
||||||
|
|
||||||
\since 6.1
|
\since 6.1
|
||||||
\sa script(), name(), bcp47Name(), languageToCode(), countryToCode()
|
\sa script(), name(), bcp47Name(), languageToCode(), territoryToCode()
|
||||||
*/
|
*/
|
||||||
QString QLocale::scriptToCode(Script script)
|
QString QLocale::scriptToCode(Script script)
|
||||||
{
|
{
|
||||||
@ -1442,7 +1442,7 @@ QString QLocale::scriptToCode(Script script)
|
|||||||
If the code is invalid or not known QLocale::AnyScript is returned.
|
If the code is invalid or not known QLocale::AnyScript is returned.
|
||||||
|
|
||||||
\since 6.1
|
\since 6.1
|
||||||
\sa scriptToCode(), codeToLanguage(), codeToCountry()
|
\sa scriptToCode(), codeToLanguage(), codeToTerritory()
|
||||||
*/
|
*/
|
||||||
QLocale::Script QLocale::codeToScript(QStringView scriptCode) noexcept
|
QLocale::Script QLocale::codeToScript(QStringView scriptCode) noexcept
|
||||||
{
|
{
|
||||||
@ -1452,7 +1452,7 @@ QLocale::Script QLocale::codeToScript(QStringView scriptCode) noexcept
|
|||||||
/*!
|
/*!
|
||||||
Returns a QString containing the name of \a language.
|
Returns a QString containing the name of \a language.
|
||||||
|
|
||||||
\sa countryToString(), scriptToString(), bcp47Name()
|
\sa territoryToString(), scriptToString(), bcp47Name()
|
||||||
*/
|
*/
|
||||||
|
|
||||||
QString QLocale::languageToString(Language language)
|
QString QLocale::languageToString(Language language)
|
||||||
@ -1478,7 +1478,7 @@ QString QLocale::territoryToString(QLocale::Territory territory)
|
|||||||
|
|
||||||
#if QT_DEPRECATED_SINCE(6, 6)
|
#if QT_DEPRECATED_SINCE(6, 6)
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use territoryToString(Territory) instead.
|
\deprecated [6.6] Use \l territoryToString() instead.
|
||||||
|
|
||||||
Returns a QString containing the name of \a country.
|
Returns a QString containing the name of \a country.
|
||||||
|
|
||||||
@ -1495,7 +1495,7 @@ QString QLocale::countryToString(Country country)
|
|||||||
|
|
||||||
Returns a QString containing the name of \a script.
|
Returns a QString containing the name of \a script.
|
||||||
|
|
||||||
\sa languageToString(), countryToString(), script(), bcp47Name()
|
\sa languageToString(), territoryToString(), script(), bcp47Name()
|
||||||
*/
|
*/
|
||||||
QString QLocale::scriptToString(QLocale::Script script)
|
QString QLocale::scriptToString(QLocale::Script script)
|
||||||
{
|
{
|
||||||
@ -2639,7 +2639,7 @@ QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Scr
|
|||||||
|
|
||||||
#if QT_DEPRECATED_SINCE(6, 6)
|
#if QT_DEPRECATED_SINCE(6, 6)
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use matchingLocales() instead and consult the territory() of each.
|
\deprecated [6.6] Use \l matchingLocales() instead and consult the \l territory() of each.
|
||||||
\since 4.3
|
\since 4.3
|
||||||
|
|
||||||
Returns the list of countries that have entries for \a language in Qt's locale
|
Returns the list of countries that have entries for \a language in Qt's locale
|
||||||
@ -4379,7 +4379,7 @@ QString QLocale::nativeTerritoryName() const
|
|||||||
|
|
||||||
#if QT_DEPRECATED_SINCE(6, 6)
|
#if QT_DEPRECATED_SINCE(6, 6)
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use nativeTerritoryName() instead.
|
\deprecated [6.6] Use \l nativeTerritoryName() instead.
|
||||||
\since 4.8
|
\since 4.8
|
||||||
|
|
||||||
Returns a native name of the territory for the locale. For example
|
Returns a native name of the territory for the locale. For example
|
||||||
|
@ -5399,17 +5399,13 @@ QString QString::fromUtf16(const char16_t *unicode, qsizetype size)
|
|||||||
|
|
||||||
/*!
|
/*!
|
||||||
\fn QString QString::fromUtf16(const ushort *str, qsizetype size)
|
\fn QString QString::fromUtf16(const ushort *str, qsizetype size)
|
||||||
\deprecated
|
\deprecated [6.0] Use the \c char16_t overload instead.
|
||||||
|
|
||||||
Use the \c char16_t overload.
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
\fn QString QString::fromUcs4(const uint *str, qsizetype size)
|
\fn QString QString::fromUcs4(const uint *str, qsizetype size)
|
||||||
\since 4.2
|
\since 4.2
|
||||||
\deprecated
|
\deprecated [6.0] Use the \c char32_t overload instead.
|
||||||
|
|
||||||
Use the \c char32_t overload instead.
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
|
@ -199,8 +199,7 @@
|
|||||||
#if QT_DEPRECATED_SINCE(6, 0)
|
#if QT_DEPRECATED_SINCE(6, 0)
|
||||||
/*! \fn template <typename T> void QFuture<T>::setPaused(bool paused)
|
/*! \fn template <typename T> void QFuture<T>::setPaused(bool paused)
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use setSuspended() instead.
|
||||||
Use setSuspended() instead.
|
|
||||||
|
|
||||||
If \a paused is true, this function pauses the asynchronous computation
|
If \a paused is true, this function pauses the asynchronous computation
|
||||||
represented by the future. If the computation is already paused, this
|
represented by the future. If the computation is already paused, this
|
||||||
@ -216,13 +215,12 @@
|
|||||||
returned by QtConcurrent::run() cannot be paused; but the future returned
|
returned by QtConcurrent::run() cannot be paused; but the future returned
|
||||||
by QtConcurrent::mappedReduced() can.
|
by QtConcurrent::mappedReduced() can.
|
||||||
|
|
||||||
\sa pause(), resume(), togglePaused()
|
\sa suspend(), resume(), toggleSuspended()
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*! \fn template <typename T> bool QFuture<T>::isPaused() const
|
/*! \fn template <typename T> bool QFuture<T>::isPaused() const
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use isSuspending() or isSuspended() instead.
|
||||||
Use isSuspending() or isSuspended() instead.
|
|
||||||
|
|
||||||
Returns \c true if the asynchronous computation has been paused with the
|
Returns \c true if the asynchronous computation has been paused with the
|
||||||
pause() function; otherwise returns \c false.
|
pause() function; otherwise returns \c false.
|
||||||
@ -231,13 +229,12 @@
|
|||||||
function returns \c true. See setPaused() for more details. To check
|
function returns \c true. See setPaused() for more details. To check
|
||||||
if pause actually took effect, use isSuspended() instead.
|
if pause actually took effect, use isSuspended() instead.
|
||||||
|
|
||||||
\sa setPaused(), togglePaused(), isSuspended()
|
\sa toggleSuspended(), isSuspended()
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*! \fn template <typename T> void QFuture<T>::pause()
|
/*! \fn template <typename T> void QFuture<T>::pause()
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use suspend() instead.
|
||||||
Use suspend() instead.
|
|
||||||
|
|
||||||
Pauses the asynchronous computation represented by this future. This is a
|
Pauses the asynchronous computation represented by this future. This is a
|
||||||
convenience method that simply calls setPaused(true).
|
convenience method that simply calls setPaused(true).
|
||||||
@ -247,15 +244,14 @@
|
|||||||
|
|
||||||
/*! \fn template <typename T> void QFuture<T>::togglePaused()
|
/*! \fn template <typename T> void QFuture<T>::togglePaused()
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use toggleSuspended() instead.
|
||||||
Use toggleSuspended() instead.
|
|
||||||
|
|
||||||
Toggles the paused state of the asynchronous computation. In other words,
|
Toggles the paused state of the asynchronous computation. In other words,
|
||||||
if the computation is currently paused, calling this function resumes it;
|
if the computation is currently paused, calling this function resumes it;
|
||||||
if the computation is running, it is paused. This is a convenience method
|
if the computation is running, it is paused. This is a convenience method
|
||||||
for calling setPaused(!isPaused()).
|
for calling setPaused(!isPaused()).
|
||||||
|
|
||||||
\sa setPaused(), pause(), resume()
|
\sa setSuspended(), suspend(), resume()
|
||||||
*/
|
*/
|
||||||
#endif // QT_DEPRECATED_SINCE(6, 0)
|
#endif // QT_DEPRECATED_SINCE(6, 0)
|
||||||
|
|
||||||
|
@ -136,8 +136,7 @@ void QFutureWatcherBase::cancel()
|
|||||||
#if QT_DEPRECATED_SINCE(6, 0)
|
#if QT_DEPRECATED_SINCE(6, 0)
|
||||||
/*! \fn template <typename T> void QFutureWatcher<T>::setPaused(bool paused)
|
/*! \fn template <typename T> void QFutureWatcher<T>::setPaused(bool paused)
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.6] Use setSuspended() instead.
|
||||||
Use setSuspended() instead.
|
|
||||||
|
|
||||||
If \a paused is true, this function pauses the asynchronous computation
|
If \a paused is true, this function pauses the asynchronous computation
|
||||||
represented by the future(). If the computation is already paused, this
|
represented by the future(). If the computation is already paused, this
|
||||||
@ -154,7 +153,7 @@ void QFutureWatcherBase::cancel()
|
|||||||
QFuture returned by QtConcurrent::run() cannot be paused; but the QFuture
|
QFuture returned by QtConcurrent::run() cannot be paused; but the QFuture
|
||||||
returned by QtConcurrent::mappedReduced() can.
|
returned by QtConcurrent::mappedReduced() can.
|
||||||
|
|
||||||
\sa pause(), resume(), togglePaused()
|
\sa suspend(), resume(), toggleSuspended()
|
||||||
*/
|
*/
|
||||||
void QFutureWatcherBase::setPaused(bool paused)
|
void QFutureWatcherBase::setPaused(bool paused)
|
||||||
{
|
{
|
||||||
@ -233,15 +232,14 @@ void QFutureWatcherBase::resume()
|
|||||||
#if QT_DEPRECATED_SINCE(6, 0)
|
#if QT_DEPRECATED_SINCE(6, 0)
|
||||||
/*! \fn template <typename T> void QFutureWatcher<T>::togglePaused()
|
/*! \fn template <typename T> void QFutureWatcher<T>::togglePaused()
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use toggleSuspended() instead.
|
||||||
Use toggleSuspended() instead.
|
|
||||||
|
|
||||||
Toggles the paused state of the asynchronous computation. In other words,
|
Toggles the paused state of the asynchronous computation. In other words,
|
||||||
if the computation is currently paused, calling this function resumes it;
|
if the computation is currently paused, calling this function resumes it;
|
||||||
if the computation is running, it is paused. This is a convenience method
|
if the computation is running, it is paused. This is a convenience method
|
||||||
for calling setPaused(!isPaused()).
|
for calling setPaused(!isPaused()).
|
||||||
|
|
||||||
\sa setPaused(), pause(), resume()
|
\sa setSuspended(), suspend(), resume()
|
||||||
*/
|
*/
|
||||||
void QFutureWatcherBase::togglePaused()
|
void QFutureWatcherBase::togglePaused()
|
||||||
{
|
{
|
||||||
@ -359,8 +357,7 @@ bool QFutureWatcherBase::isCanceled() const
|
|||||||
|
|
||||||
/*! \fn template <typename T> bool QFutureWatcher<T>::isPaused() const
|
/*! \fn template <typename T> bool QFutureWatcher<T>::isPaused() const
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use isSuspending() or isSuspended() instead.
|
||||||
Use isSuspending() or isSuspended() instead.
|
|
||||||
|
|
||||||
Returns \c true if the asynchronous computation has been paused with the
|
Returns \c true if the asynchronous computation has been paused with the
|
||||||
pause() function; otherwise returns \c false.
|
pause() function; otherwise returns \c false.
|
||||||
@ -369,7 +366,7 @@ bool QFutureWatcherBase::isCanceled() const
|
|||||||
function returns \c true. See setPaused() for more details. To check
|
function returns \c true. See setPaused() for more details. To check
|
||||||
if pause actually took effect, use isSuspended() instead.
|
if pause actually took effect, use isSuspended() instead.
|
||||||
|
|
||||||
\sa setPaused(), togglePaused(), isSuspended()
|
\sa setSuspended(), toggleSuspended(), isSuspended()
|
||||||
*/
|
*/
|
||||||
|
|
||||||
bool QFutureWatcherBase::isPaused() const
|
bool QFutureWatcherBase::isPaused() const
|
||||||
@ -661,8 +658,7 @@ QT_WARNING_POP
|
|||||||
#if QT_DEPRECATED_SINCE(6, 0)
|
#if QT_DEPRECATED_SINCE(6, 0)
|
||||||
/*! \fn template <typename T> void QFutureWatcher<T>::paused()
|
/*! \fn template <typename T> void QFutureWatcher<T>::paused()
|
||||||
|
|
||||||
\deprecated
|
\deprecated [6.0] Use suspending() instead.
|
||||||
Use suspending() instead.
|
|
||||||
|
|
||||||
This signal is emitted when the state of the watched future is
|
This signal is emitted when the state of the watched future is
|
||||||
set to paused.
|
set to paused.
|
||||||
@ -673,7 +669,7 @@ QT_WARNING_POP
|
|||||||
still be delivered. To to be informed when pause() actually
|
still be delivered. To to be informed when pause() actually
|
||||||
took effect, use the suspended() signal.
|
took effect, use the suspended() signal.
|
||||||
|
|
||||||
\sa setPaused(), pause(), suspended()
|
\sa setSuspended(), suspend(), suspended()
|
||||||
*/
|
*/
|
||||||
#endif // QT_DEPRECATED_SINCE(6, 0)
|
#endif // QT_DEPRECATED_SINCE(6, 0)
|
||||||
|
|
||||||
|
@ -502,7 +502,7 @@ QLocale::Territory QTimeZone::territory() const
|
|||||||
|
|
||||||
#if QT_DEPRECATED_SINCE(6, 6)
|
#if QT_DEPRECATED_SINCE(6, 6)
|
||||||
/*!
|
/*!
|
||||||
\deprecated Use territory() instead.
|
\deprecated [6.6] Use territory() instead.
|
||||||
|
|
||||||
Returns the territory for the time zone.
|
Returns the territory for the time zone.
|
||||||
*/
|
*/
|
||||||
|
@ -877,14 +877,14 @@ void QHashSeed::resetRandomGlobalSeed()
|
|||||||
#if QT_DEPRECATED_SINCE(6,6)
|
#if QT_DEPRECATED_SINCE(6,6)
|
||||||
/*! \relates QHash
|
/*! \relates QHash
|
||||||
\since 5.6
|
\since 5.6
|
||||||
\deprecated Use QHashSeed::globalSeed() instead.
|
\deprecated [6.6] Use QHashSeed::globalSeed() instead.
|
||||||
|
|
||||||
Returns the current global QHash seed.
|
Returns the current global QHash seed.
|
||||||
|
|
||||||
The seed is set in any newly created QHash. See \l{qHash} about how this seed
|
The seed is set in any newly created QHash. See \l{qHash} about how this seed
|
||||||
is being used by QHash.
|
is being used by QHash.
|
||||||
|
|
||||||
\sa qSetGlobalQHashSeed, QHashSeed::globalSeed()
|
\sa QHashSeed, QHashSeed::globalSeed()
|
||||||
*/
|
*/
|
||||||
int qGlobalQHashSeed()
|
int qGlobalQHashSeed()
|
||||||
{
|
{
|
||||||
@ -893,7 +893,7 @@ int qGlobalQHashSeed()
|
|||||||
|
|
||||||
/*! \relates QHash
|
/*! \relates QHash
|
||||||
\since 5.6
|
\since 5.6
|
||||||
\deprecated Use QHashSeed instead.
|
\deprecated [6.6] Use QHashSeed instead.
|
||||||
|
|
||||||
Sets the global QHash seed to \a newSeed.
|
Sets the global QHash seed to \a newSeed.
|
||||||
|
|
||||||
@ -913,7 +913,7 @@ int qGlobalQHashSeed()
|
|||||||
If the environment variable \c QT_HASH_SEED is set, calling this function will
|
If the environment variable \c QT_HASH_SEED is set, calling this function will
|
||||||
result in a no-op.
|
result in a no-op.
|
||||||
|
|
||||||
\sa qGlobalQHashSeed, QHashSeed
|
\sa qHashSeed::globalSeed, QHashSeed
|
||||||
*/
|
*/
|
||||||
void qSetGlobalQHashSeed(int newSeed)
|
void qSetGlobalQHashSeed(int newSeed)
|
||||||
{
|
{
|
||||||
|
@ -248,7 +248,7 @@ QT_BEGIN_NAMESPACE
|
|||||||
/*!
|
/*!
|
||||||
\fn template <typename T, typename Cleanup> T *QScopedPointer<T, Cleanup>::take()
|
\fn template <typename T, typename Cleanup> T *QScopedPointer<T, Cleanup>::take()
|
||||||
|
|
||||||
\deprecated Use std::unique_ptr and release() instead.
|
\deprecated [6.1] Use \c std::unique_ptr and \c release() instead.
|
||||||
|
|
||||||
Returns the value of the pointer referenced by this object. The pointer of this
|
Returns the value of the pointer referenced by this object. The pointer of this
|
||||||
QScopedPointer object will be reset to \nullptr.
|
QScopedPointer object will be reset to \nullptr.
|
||||||
@ -265,7 +265,7 @@ QT_BEGIN_NAMESPACE
|
|||||||
|
|
||||||
/*! \fn template <typename T, typename Cleanup> void QScopedPointer<T, Cleanup>::swap(QScopedPointer<T, Cleanup> &lhs, QScopedPointer<T, Cleanup> &rhs)
|
/*! \fn template <typename T, typename Cleanup> void QScopedPointer<T, Cleanup>::swap(QScopedPointer<T, Cleanup> &lhs, QScopedPointer<T, Cleanup> &rhs)
|
||||||
|
|
||||||
\deprecated Use std::unique_ptr instead; this function may let a pointer
|
\deprecated [6.1] Use \c std::unique_ptr instead; this function may let a pointer
|
||||||
escape its scope.
|
escape its scope.
|
||||||
|
|
||||||
Swaps \a lhs with \a rhs.
|
Swaps \a lhs with \a rhs.
|
||||||
@ -335,7 +335,7 @@ QT_BEGIN_NAMESPACE
|
|||||||
|
|
||||||
/*! \fn template <typename T, typename Cleanup> void QScopedArrayPointer<T, Cleanup>::swap(QScopedArrayPointer<T, Cleanup> &other)
|
/*! \fn template <typename T, typename Cleanup> void QScopedArrayPointer<T, Cleanup>::swap(QScopedArrayPointer<T, Cleanup> &other)
|
||||||
|
|
||||||
\deprecated Use std::unique_ptr instead; this function may let a pointer
|
\deprecated [6.1] Use \c std::unique_ptr instead; this function may let a pointer
|
||||||
escape its scope.
|
escape its scope.
|
||||||
|
|
||||||
Swap this pointer with \a other.
|
Swap this pointer with \a other.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user