Allow getting all usable translations languages

Add a method to return the full list of translations that can be used,
generalizing the existing GetBestTranslation().
This commit is contained in:
Lauri Nurmi
2018-10-02 19:49:50 +03:00
committed by Vadim Zeitlin
parent 4099e75edb
commit 5d08e404c7
3 changed files with 89 additions and 18 deletions

View File

@@ -137,6 +137,49 @@ public:
const wxString& msgIdLanguage = "en");
/**
Returns the best and all other suitable UI languages for the @a domain.
This is nearly the same as GetBestTranslation(), but returns the
whole list of preferred UI languages for which a translation for the
@a domain was found.
@param domain
The catalog domain to look for.
@param msgIdLanguage
Specifies the language of "msgid" strings in source code
(i.e. arguments to GetString(), wxGetTranslation() and the _() macro).
@return An array of language codes if any suitable matches were found, empty array
otherwise.
@since 3.1.2
*/
wxArrayString GetAllGoodTranslations(const wxString& domain, wxLanguage msgIdLanguage);
/**
Returns the best and all other suitable UI languages for the @a domain.
This is nearly the same as GetBestTranslation(), but returns the
whole list of preferred UI languages for which a translation for the
@a domain was found.
@param domain
The catalog domain to look for.
@param msgIdLanguage
Specifies the language of "msgid" strings in source code
(i.e. arguments to GetString(), wxGetTranslation() and the _() macro).
@return An array of language codes if any suitable matches were found, empty array
otherwise.
@since 3.1.2
*/
wxArrayString GetAllGoodTranslations(const wxString& domain,
const wxString& msgIdLanguage = "en");
/**
Add standard wxWidgets catalogs ("wxstd" and possible port-specific
catalogs).