KLanguageButton Class Reference

from PyKDE4.kdeui import *

Inherits: QWidget → QObject

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"

Author:: Hans Petter Bieker <bieker@kde.org>, Martijn Klingens <klingens@kde.org>,

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

__init__	(	self,
		QString	text,
		QWidget	parent=0
	)

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

insertLanguage	(	self,
		QString	languageCode,
		QString	name=QString(),
		int	index=-1
	)

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

KLanguageButton Class Reference

Detailed Description

Signals

Methods

Signal Documentation

Method Documentation

Modules