Get a string that is representative of the characters needed to
render a particular language.
The sample text may be a pangram, but is not necessarily. It is chosen to
be demonstrative of normal text in the language, as well as exposing font
feature requirements unique to the language. It is suitable for use
as sample text in a font selection dialog.
If @language is %NULL, the default language as found by
pango_language_get_default() is used.
If Pango does not have a sample string for @language, the classic
"The quick brown fox..." is returned. This can be detected by
comparing the returned pointer value to that returned for (non-existent)
language code "xx". That is, compare to:
<informalexample><programlisting>
pango_language_get_sample_string (pango_language_from_string ("xx"))
</programlisting></informalexample>
Return: the sample string. This value is owned by Pango
and should not be freed.
Get a string that is representative of the characters needed to render a particular language.
The sample text may be a pangram, but is not necessarily. It is chosen to be demonstrative of normal text in the language, as well as exposing font feature requirements unique to the language. It is suitable for use as sample text in a font selection dialog.
If @language is %NULL, the default language as found by pango_language_get_default() is used.
If Pango does not have a sample string for @language, the classic "The quick brown fox..." is returned. This can be detected by comparing the returned pointer value to that returned for (non-existent) language code "xx". That is, compare to: <informalexample><programlisting> pango_language_get_sample_string (pango_language_from_string ("xx")) </programlisting></informalexample>
Return: the sample string. This value is owned by Pango and should not be freed.