offapi/com/sun/star/i18n/XCharacterClassification.idl | 10 ++++++++++
1 file changed, 10 insertions(+)
New commits:
commit bb571bb225a5a5f3fa81b7aaea6cd559ebf1a94b
Author: Eike Rathke <er...@redhat.com>
AuthorDate: Tue Sep 6 20:34:32 2022 +0200
Commit: Eike Rathke <er...@redhat.com>
CommitDate: Tue Sep 6 21:38:16 2022 +0200
Add note to XCharacterClassification::getStringType() about meaninglessness
Given how it works that's almost deprecated, almost..
Change-Id: Ife2fe012db5568e4646b98b0ba55df8418069062
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/139534
Reviewed-by: Eike Rathke <er...@redhat.com>
Tested-by: Jenkins
diff --git a/offapi/com/sun/star/i18n/XCharacterClassification.idl
b/offapi/com/sun/star/i18n/XCharacterClassification.idl
index 72f69f850f49..2d8da610f4f7 100644
--- a/offapi/com/sun/star/i18n/XCharacterClassification.idl
+++ b/offapi/com/sun/star/i18n/XCharacterClassification.idl
@@ -106,6 +106,16 @@ published interface XCharacterClassification :
com::sun::star::uno::XInterface
A number with appropriate flags set to indicate what type of
characters the string contains, each flag value being one of
KCharacterType values.
+
+ @note The accumulated bits of several characters are meaningless
+ as soon as characters of different classifications are
+ involved, which even may have a common subset like
+ KCharacterType::LETTER or KCharacterType::PRINTABLE, unless
+ it is to be determined what overall character properties are
+ present in the string. Use getCharacterType() of single
+ characters instead and handle bits as needed if sets of
+ character properties are to be obtained.
+
*/
long getStringType( [in] string aText, [in] long nPos, [in] long nCount,
[in] com::sun::star::lang::Locale aLocale );
