KDE 4.5 PyKDE API Reference
KLanguageButton Class Reference
from PyKDE4.kdeui import *
Detailed Description
KLanguageButton is a pushbutton which allows a language to be selected from a popup list.
Languages are identified by their ISO 639-1 codes, e.g. en, pt_BR.
"KDE Language Selection Widget"
David Jarvie <software@astrojar.org.uk>
Signals | |
| activated (QString languageCode) | |
| highlighted (QString languageCode) | |
Methods | |
| __init__ (self, QWidget parent=0) | |
| __init__ (self, QString text, QWidget parent=0) | |
| clear (self) | |
| bool | contains (self, QString languageCode) |
| int | count (self) |
| QString | current (self) |
| insertLanguage (self, QString languageCode, QString name=QString(), int index=-1) | |
| insertSeparator (self, int index=-1) | |
| loadAllLanguages (self) | |
| setCurrentItem (self, QString languageCode) | |
| setLocale (self, KLocale locale) | |
| setText (self, QString text) | |
| showLanguageCodes (self, bool show) | |
Signal Documentation
| activated | ( | QString | languageCode | |
| ) |
This signal is emitted when a new item is activated.
- Parameters:
-
languageCode code of the activated language
- Signal syntax:
QObject.connect(source, SIGNAL("activated(const QString&)"), target_slot)
| highlighted | ( | QString | languageCode | |
| ) |
This signal is emitted when a new item is highlighted.
- Parameters:
-
languageCode code of the highlighted language
- Signal syntax:
QObject.connect(source, SIGNAL("highlighted(const QString&)"), target_slot)
Method Documentation
| __init__ | ( | self, | ||
| QWidget | parent=0 | |||
| ) |
Constructs a button whose text is determined by the current language in the popup list.
- Parameters:
-
parent the parent of the button
Constructs a button with static text.
- Parameters:
-
text the text of the button parent the parent of the button
| clear | ( | self ) |
Removes all combobox items.
| bool contains | ( | self, | ||
| QString | languageCode | |||
| ) |
Checks whether the specified language is in the popup list.
- Parameters:
-
languageCode the language's code
- Returns:
- true if in the list
| int count | ( | self ) |
Returns the number of items in the combo box.
| QString current | ( | self ) |
Returns the language code of the combobox's current item.
- Returns:
- the current item's language code
Inserts a language into the combo box. Normally the display name of the language is obtained automatically, but if either the language code does not exist, or there are special display requirements, the name of the language can be specified in name.
- Parameters:
-
languageCode the code for the language name language name. If empty, the name is obtained automatically. index the insertion position, or -1 to insert in alphabetical order
| insertSeparator | ( | self, | ||
| int | index=-1 | |||
| ) |
Inserts a separator item into the combo box. A negative index will append the item.
- Parameters:
-
index the insertion position
| loadAllLanguages | ( | self ) |
Load all known languages into the popup list. The current language in the list is set to the default language for the current locale (as modified by setLocale()).
| setCurrentItem | ( | self, | ||
| QString | languageCode | |||
| ) |
Sets a given language to be the current item.
- Parameters:
-
languageCode the language's code
| setLocale | ( | self, | ||
| KLocale | locale | |||
| ) |
Sets the locale to display language names. By default, KGlobal.locale() is used.
- Parameters:
-
locale locale to use
| setText | ( | self, | ||
| QString | text | |||
| ) |
Sets a static button text.
- Parameters:
-
text button text
| showLanguageCodes | ( | self, | ||
| bool | show | |||
| ) |
Specifies whether language codes should be shown alongside language names in the popup. Calling this method does not affect any previously inserted language texts, so it should normally be called before populating the list.
- Parameters:
-
show true to show codes, false to hide codes
