diff options
Diffstat (limited to 'examples/pykde-sampler')
44 files changed, 2474 insertions, 0 deletions
diff --git a/examples/pykde-sampler/HOWTO.samples b/examples/pykde-sampler/HOWTO.samples new file mode 100644 index 0000000..7418054 --- /dev/null +++ b/examples/pykde-sampler/HOWTO.samples @@ -0,0 +1,60 @@ +How to Write Samples for the PyKDE Sampler +========================================== + + +Create or locate a directory within the sampler application root directory. + +Add a module. + +In side the module, add the following: + +- iconName - string (optional) + default: 'filenew' + example: 'colorize' + + When supplied, this should be the short name of a KDE icon, such as + 'stop', 'editclear', etc. If available, This icon will be used as + the list item's icon in the sampler. Not all icons are available in + all themes, so try to use the icons that are available in the + default KDE installation. + + +- labelText - string (optional) + default: module name + example: 'KMessageBox' + + When supplied, this value is used as the list item text for the + sample. If it's not supplied, the application will use the name of + the module instead. + + +- docParts - two-tuple (optional) + default: None + example: ('kdeui', 'KAboutDialog') + + If specified, this sequence should contain two items, first item + name of pykde module, second item name of class within the module. + These two values are used to form the URL to the documentation for + the sample. + + +- one of buildWidget, buildDialog, buildApp, MainFrame - callable (required) + default: None + example: MainFrame(QFrame): ... + + The sample module must contain a callable with one of these names. + The callable must accept a single positional parameter, the parent + widget. + + In most cases, it is sufficient to define a subclass of QFrame named + 'MainFrame'. To construct a more complex sample, define a function + with one of the other names. + + The callable should return (or instatiate) a widget for display in + the main sampler widget. The created frame is responsible for + displaying it's help text and for any providing any widgets + necessary to + + + + diff --git a/examples/pykde-sampler/TODO b/examples/pykde-sampler/TODO new file mode 100644 index 0000000..730cc02 --- /dev/null +++ b/examples/pykde-sampler/TODO @@ -0,0 +1,12 @@ +Sampler App +=========== + +- Turn off word wrap in the source viewer +- Add application icon +- Enable hyperlink signal and slot in doc viewer + + +Samples +======= + +- More samples diff --git a/examples/pykde-sampler/__init__.py b/examples/pykde-sampler/__init__.py new file mode 100644 index 0000000..4265cc3 --- /dev/null +++ b/examples/pykde-sampler/__init__.py @@ -0,0 +1 @@ +#!/usr/bin/env python diff --git a/examples/pykde-sampler/about.py b/examples/pykde-sampler/about.py new file mode 100644 index 0000000..61fdd8a --- /dev/null +++ b/examples/pykde-sampler/about.py @@ -0,0 +1,57 @@ +#!/usr/bin/env python +""" About the PyKDE Sampler + +Defines the 'about' function to create a KAboutData instance for the +sampler application. +""" +from os.path import dirname, join +from kdecore import KAboutData + + +appName = 'pykdesampler' +progName = 'PyKDE Sampler' +authorName = 'Troy Melhase' +authorEmail = bugsEmailAddress = 'troy@gci.net' +version = '0.1' +shortDescription = 'The PyKDE Sampler' +licenseType = KAboutData.License_GPL_V2 +copyrightStatement = '(c) 2006, %s' % (authorName, ) +homePageAddress = 'http://www.riverbankcomputing.co.uk/pykde/' +aboutText = ("The application sampler for PyKDE.") +contributors = [] # module-level global for keeping the strings around; intentional + + +def about(): + """ creates KAboutData instance for the app + + """ + about = KAboutData( + appName, + progName, + version, + shortDescription, + licenseType, + copyrightStatement, + aboutText, + homePageAddress, + bugsEmailAddress) + about.addAuthor(authorName, '', authorEmail) + + try: + contrib = open(join(dirname(__file__), 'contributors.txt')) + contrib = [line.strip() for line in contrib] + contrib = [line for line in contrib if not line.startswith('#')] + for line in contrib: + try: + name, task, addr = [s.strip() for s in line.split(',')] + contributors.append((name, task, addr)) + except: + pass + except: + pass + + contributors.sort(lambda a, b:cmp(a[0], b[0])) + for name, task, addr in contributors: + about.addCredit(name, task, addr) + + return about diff --git a/examples/pykde-sampler/aboutkde.png b/examples/pykde-sampler/aboutkde.png Binary files differnew file mode 100644 index 0000000..3bb4e68 --- /dev/null +++ b/examples/pykde-sampler/aboutkde.png diff --git a/examples/pykde-sampler/basic_widgets/__init__.py b/examples/pykde-sampler/basic_widgets/__init__.py new file mode 100644 index 0000000..2442375 --- /dev/null +++ b/examples/pykde-sampler/basic_widgets/__init__.py @@ -0,0 +1,17 @@ +labelText = 'Widgets' +iconName = 'about_kde' + +helpText = """KDE provides a large set of basic widgets for application use. +Select the children of this item to see for yourself.""" + +from qt import QFrame, QVBoxLayout +from kdeui import KTextEdit + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + self.text = KTextEdit(helpText, '', self) + layout.addWidget(self.text, 1) + layout.addStretch(1) diff --git a/examples/pykde-sampler/basic_widgets/datepicker.py b/examples/pykde-sampler/basic_widgets/datepicker.py new file mode 100644 index 0000000..aa36de5 --- /dev/null +++ b/examples/pykde-sampler/basic_widgets/datepicker.py @@ -0,0 +1,42 @@ +from qt import QFrame, QStringList, QVBoxLayout, SIGNAL, QLabel, QSizePolicy, Qt +from qttable import QTable +from kdeui import KTextEdit, KDatePicker, KDateWidget + + +labelText = 'KDatePicker' +iconName = 'date' +helpText = """A date selection widget. + +Provides a widget for calendar date input. + +Different from the previous versions, it now emits two types of +signals, either dateSelected() or dateEntered() (see documentation for +both signals). + +A line edit has been added in the newer versions to allow the user to +select a date directly by entering numbers like 19990101 or 990101. +""" + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + self.dateDisplay = KDateWidget(self) + + self.dateDisplay.setSizePolicy(QSizePolicy(QSizePolicy.Maximum, + QSizePolicy.Maximum)) + + self.datePicker = KDatePicker(self) + + layout = QVBoxLayout(self) + layout.addWidget(self.help, 1) + layout.addWidget(self.datePicker, 0, Qt.AlignHCenter) + layout.addStretch(1) + + self.other = QLabel('Selected Date:', self) + layout.addWidget(self.other, 0) + layout.addWidget(self.dateDisplay, 2) + + self.connect(self.datePicker, SIGNAL('dateChanged(QDate)'), + self.dateDisplay.setDate) + diff --git a/examples/pykde-sampler/basic_widgets/historycombo.py b/examples/pykde-sampler/basic_widgets/historycombo.py new file mode 100644 index 0000000..aa35b53 --- /dev/null +++ b/examples/pykde-sampler/basic_widgets/historycombo.py @@ -0,0 +1,53 @@ +from qt import Qt, QFrame, QHBoxLayout, QVBoxLayout, QStringList, QLabel, \ + SIGNAL, SLOT +from kdeui import KHistoryCombo, KTextEdit + + +iconName = 'history' +labelText = 'KHistoryCombo' +docParts = ('kdeui', 'KHistoryCombo') +helpText = ('An example of the KHistoryCombo widget.' + '\n\n' + 'Completion is enabled via the setHistoryItems call; when the second ' + 'parameter is True, matching items from the list appear as you type.' + '\n\n' + 'The activated signal is connected to the addToHistory ' + 'slot to automatically add new items.') + + +historyText = 'a quick brown fox jumps over the lazy dog' + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + self.historyCombo = KHistoryCombo(self) + + self.historySelectionLabel = QLabel('Selected value: ', self) + self.historySelection = QLabel('(none)', self) + + items = QStringList() + for item in historyText.split(): + items.append(item) + self.historyCombo.setHistoryItems(items, True) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help, 3) + layout.addStretch(1) + selectionLayout = QHBoxLayout(layout, 4) + selectionLayout.addWidget(self.historySelectionLabel, 1) + selectionLayout.addWidget(self.historySelection, 10, Qt.AlignLeft) + layout.addWidget(self.historyCombo, 0) + layout.addStretch(10) + + self.connect(self.historyCombo, SIGNAL('activated(const QString& )'), + self.historyCombo, SLOT('addToHistory(const QString&)')) + self.connect(self.historyCombo, SIGNAL('cleared()'), + self.historyCleared) + self.connect(self.historyCombo, SIGNAL('activated(const QString &)'), + self.historySelection.setText) + + def historyCleared(self): + print 'History combo cleared.' + diff --git a/examples/pykde-sampler/contributors.txt b/examples/pykde-sampler/contributors.txt new file mode 100644 index 0000000..18b9a81 --- /dev/null +++ b/examples/pykde-sampler/contributors.txt @@ -0,0 +1,4 @@ +# author, contributions, email +Phil Thompson, For PyQt and SIP, phil@riverbankcomputing.co.uk +Jim Bublitz, For PyKDE, jbublitz@nwinternet.com + diff --git a/examples/pykde-sampler/dialogs/__init__.py b/examples/pykde-sampler/dialogs/__init__.py new file mode 100644 index 0000000..c6f70f9 --- /dev/null +++ b/examples/pykde-sampler/dialogs/__init__.py @@ -0,0 +1,18 @@ +labelText = 'Dialog Boxes' +iconName = 'launch' + + +helpText = ("KDE provides a convenient set of dialog boxes for application use. " + "Select the children of this item to see for yourself.") + + +from qt import QFrame, QVBoxLayout +from kdeui import KTextEdit + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + self.text = KTextEdit(helpText, '', self) + layout.addWidget(self.text, 1) diff --git a/examples/pykde-sampler/dialogs/about/__init__.py b/examples/pykde-sampler/dialogs/about/__init__.py new file mode 100644 index 0000000..4c40da7 --- /dev/null +++ b/examples/pykde-sampler/dialogs/about/__init__.py @@ -0,0 +1,16 @@ +labelText = 'About Dialogs' +iconName = 'info' + +helpText = ("KDE has multiple dialog types to display information about your " +"applicaiton and environment. They provide a tremendous amount of functionality " +"and consistency. They're easy to use, and they're good for the environment!") + +from qt import QFrame, QVBoxLayout +from kdeui import KTextEdit + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + self.text = KTextEdit(helpText, '', self) + layout.addWidget(self.text, 1) diff --git a/examples/pykde-sampler/dialogs/about/aboutapp.py b/examples/pykde-sampler/dialogs/about/aboutapp.py new file mode 100644 index 0000000..afdd71a --- /dev/null +++ b/examples/pykde-sampler/dialogs/about/aboutapp.py @@ -0,0 +1,29 @@ +iconName = 'about_kde' +labelText = 'KAboutApplication' + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KAboutApplication, KPushButton, KTextEdit + + +helpText = ("Typically available via the applications 'Help' menu, this " + "dialog presents the user with the applications About widget.") + +docParts = ('kdeui', 'KAboutDialog') + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('About Application'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showAboutDialog) + + def showAboutDialog(self): + dlg = KAboutApplication(self) + dlg.show() diff --git a/examples/pykde-sampler/dialogs/about/aboutkde.py b/examples/pykde-sampler/dialogs/about/aboutkde.py new file mode 100644 index 0000000..9c73f9d --- /dev/null +++ b/examples/pykde-sampler/dialogs/about/aboutkde.py @@ -0,0 +1,28 @@ +iconName = 'about_kde' +labelText = 'KAboutKDE' + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KAboutKDE, KPushButton, KTextEdit + + +helpText = ("Typically available via the applications 'Help' menu, this " + "dialog presents the user with the standard KDE About dialog.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('About KDE'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showAboutDialog) + + def showAboutDialog(self): + dlg = KAboutKDE(self) + dlg.show() diff --git a/examples/pykde-sampler/dialogs/bugreport.py b/examples/pykde-sampler/dialogs/bugreport.py new file mode 100644 index 0000000..6c41165 --- /dev/null +++ b/examples/pykde-sampler/dialogs/bugreport.py @@ -0,0 +1,34 @@ +iconName = 'core' +labelText = 'KBugReport' + +##~ if we wanted to, we could define the name of a KDE class used for lookup of +##~ the documentation url. The 'labelText' string above already +##~ specifies what we want. +##~ docItemName = 'KBugReport' + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KAboutDialog, KPushButton, KBugReport, KTextEdit + + +helpText = ("KDE provides a way to report bugs from applications. This dialog" + "is typically available from the application 'Help' menu.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Bug Report Dialog'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showBugDialog) + + + def showBugDialog(self): + dlg = KBugReport(self) + dlg.exec_loop() diff --git a/examples/pykde-sampler/dialogs/color.py b/examples/pykde-sampler/dialogs/color.py new file mode 100644 index 0000000..b749cce --- /dev/null +++ b/examples/pykde-sampler/dialogs/color.py @@ -0,0 +1,42 @@ +iconName = 'colorize' +labelText = 'KColorDialog' + + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KPushButton, KColorDialog, KColorPatch, KTextEdit + + +helpText = ("KDE provides a nifty common color selection dialog." + "The color selection in the dialog is tracked via a SIGNAL " + "connected to the KColorPatch area below.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Color Dialog'), self) + self.help = KTextEdit(helpText, '', self) + self.patch = KColorPatch(self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addWidget(self.patch, 10) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showColorDialog) + + def showColorDialog(self): + dlg = KColorDialog(self) + + ## this connection is made so that there's a default color + self.connect(dlg, SIGNAL('colorSelected(const QColor &)'), + self.patch.setPaletteBackgroundColor) + dlg.setColor(self.patch.paletteBackgroundColor()) + + ## this connection is the one that changes the patch color to match + ## the color selected in the dialog + self.connect(dlg, SIGNAL('colorSelected(const QColor &)'), + self.patch.setColor) + dlg.exec_loop() diff --git a/examples/pykde-sampler/dialogs/config.py b/examples/pykde-sampler/dialogs/config.py new file mode 100644 index 0000000..74454ab --- /dev/null +++ b/examples/pykde-sampler/dialogs/config.py @@ -0,0 +1,59 @@ + +from qt import QFrame, QHBoxLayout, QVBoxLayout, QTimer, SIGNAL, QString +from kdecore import i18n, KConfigSkeleton +from kdeui import KPushButton, KConfigDialog, KTextEdit + +iconName = 'configure' +labelText = 'KConfigDialog' +docParts = ('kdeui', 'KConfigDialog') +helpText = ("") + + +class SampleSettings(KConfigSkeleton): + def __init__(self): + KConfigSkeleton.__init__(self) + self.anyString = QString() + + self.setCurrentGroup("Strings") + self.addItemString("Test", self.anyString, "Default Value") + + self.setCurrentGroup("Booleans") + self.addItemBool("Any Bool", False) + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Config Dialog'), self) + self.help = KTextEdit(helpText, '', self) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showConfigDialog) + + + def showConfigDialog(self): + config = SampleSettings() + dlg = KConfigDialog(self, 'Sampler Config', config) + self.strings = StringsSettings(self) + self.bools = BoolSettings(self) + dlg.addPage(self.strings, 'Strings', 'Strings') + dlg.addPage(self.bools, 'Bools', 'Bools') + dlg.exec_loop() + + +class StringsSettings(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.text = KTextEdit('A String', '', self) + + +class BoolSettings(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.text = KTextEdit('A Bool', '', self) + diff --git a/examples/pykde-sampler/dialogs/edfind.py b/examples/pykde-sampler/dialogs/edfind.py new file mode 100644 index 0000000..685902e --- /dev/null +++ b/examples/pykde-sampler/dialogs/edfind.py @@ -0,0 +1,52 @@ + +from qt import QFrame, QHBoxLayout, QVBoxLayout, QTimer, SIGNAL, QFont, QString +from kdecore import i18n +from kdeui import KPushButton, KEdFind, KTextEdit + +iconName = 'find' +labelText = 'KEdFind' +docParts = ('kdeui', 'KEdFind') +helpText = ("An example of the KEdFind dialog.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Edit Find Dialog'), self) + self.help = KTextEdit(helpText, '', self) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showEdFind) + + + def showEdFind(self): + dlg = self.dlg = KEdFind(self) + self.connect(dlg, SIGNAL('done()'), + self.doneClicked) + self.connect(dlg, SIGNAL('search()'), + self.searchClicked) + dlg.exec_loop() + + + def doneClicked(self): + print 'done searching' + + def searchClicked(self): + print 'searching: ', self.dlg.getText(), + if self.dlg.get_direction(): + print '(backwards) ', + else: + print '(forwards) ', + if self.dlg.case_sensitive(): + print '(case-sensitive)' + else: + print '(case-insensitive)' + + + + diff --git a/examples/pykde-sampler/dialogs/edreplace.py b/examples/pykde-sampler/dialogs/edreplace.py new file mode 100644 index 0000000..df95614 --- /dev/null +++ b/examples/pykde-sampler/dialogs/edreplace.py @@ -0,0 +1,52 @@ +from qt import QFrame, QHBoxLayout, QVBoxLayout, QTimer, SIGNAL, QFont, QString +from kdecore import i18n +from kdeui import KPushButton, KEdReplace, KTextEdit + +iconName = 'findreplace' +labelText = 'KEdReplace' +docParts = ('kdeui', 'KEdReplace') +helpText = ("An example of the KEdReplace dialog.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Edit Find Dialog'), self) + self.help = KTextEdit(helpText, '', self) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showEdReplace) + + + def showEdReplace(self): + dlg = self.dlg = KEdReplace(self) + self.connect(dlg, SIGNAL('done()'), + self.doneClicked) + self.connect(dlg, SIGNAL('replace()'), + self.replaceClicked) + dlg.exec_loop() + + + def doneClicked(self): + print 'done replacing' + + def replaceClicked(self): + print 'replacing: ', self.dlg.getText() + return + if self.dlg.get_direction(): + print '(backwards) ', + else: + print '(forwards) ', + if self.dlg.case_sensitive(): + print '(case-sensitive)' + else: + print '(case-insensitive)' + + + + diff --git a/examples/pykde-sampler/dialogs/font.py b/examples/pykde-sampler/dialogs/font.py new file mode 100644 index 0000000..ae2189e --- /dev/null +++ b/examples/pykde-sampler/dialogs/font.py @@ -0,0 +1,53 @@ + +from qt import QFrame, QHBoxLayout, QVBoxLayout, QTimer, SIGNAL, QFont, QString +from kdecore import i18n +from kdeui import KPushButton, KFontDialog, KTextEdit + +iconName = 'fonts' +labelText = 'KFontDialog' +docParts = ('kdeui', 'KFontDialog') +helpText = ("KDE provides a font dialog box for users to select (can you " + "guess??) fonts. The button below displays a font dialog box. " + "The font of this widget (the text widget you're reading) is used " + "as the default. If the dialog is accepted, the font of this " + "widget is change to match the selection.") + + +fontText = """Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam +ante. Nam in mauris. Vestibulum ante velit, condimentum vel, congue +sit amet, lobortis a, dui. Fusce auctor, quam non pretium nonummy, leo +ante imperdiet libero, id lobortis erat erat quis eros. Pellentesque +habitant morbi tristique senectus et netus et malesuada fames ac +turpis egestas. Cras ut metus. Vivamus suscipit, sapien id tempor +elementum, nunc quam malesuada dolor, sit amet luctus sapien odio vel +ligula. Integer scelerisque, risus a interdum vestibulum, felis ipsum +pharetra eros, nec nonummy libero justo quis risus. Vestibulum +tincidunt, augue vitae suscipit congue, sem dui adipiscing nulla, ut +nonummy arcu quam ac sem. Nulla in metus. Phasellus neque. +""" + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Font Dialog'), self) + self.help = KTextEdit(helpText, '', self) + self.example = KTextEdit(fontText, '', self) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addWidget(self.example, 10) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showFontDialog) + + + def showFontDialog(self): + font = QFont(self.example.font()) + string = QString() + accepted, other = KFontDialog.getFontAndText(font, string, False, self) + if accepted: + self.example.setFont(font) + self.example.setText(string) diff --git a/examples/pykde-sampler/dialogs/input.py b/examples/pykde-sampler/dialogs/input.py new file mode 100644 index 0000000..30edc6f --- /dev/null +++ b/examples/pykde-sampler/dialogs/input.py @@ -0,0 +1,87 @@ +iconName = 'editclear' +labelText = 'KInputDialog' + +from qt import QFrame, QGridLayout, QLabel, QStringList, SIGNAL +from kdecore import i18n +from kdeui import KPushButton, KInputDialog, KTextEdit + + +helpText = ("KInputDialog allows the programmer to display a simple dialog to " + "request a bit of text, an integer value, a double value, or a " + "list item from the user.") + + +class MainFrame(QFrame): + items = ['Apples', 'Bananas', 'Mangos', 'Oranges', 'Pears', ] + + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + + layout = QGridLayout(self, 5, 2, 4) # five rows, two cols, four px spacing + layout.setRowStretch(0, 10) + layout.setColStretch(1, 10) + layout.addMultiCellWidget(self.help, 0, 1, 0, 1) + + button = KPushButton(i18n('Get Text'), self) + self.connect(button, SIGNAL('clicked()'), self.getText) + self.getTextLabel = QLabel('text value', self) + layout.addWidget(button, 2, 0) + layout.addWidget(self.getTextLabel, 2, 1) + layout.setRowStretch(2, 0) + + button = KPushButton(i18n('Get Integer'), self) + self.connect(button, SIGNAL('clicked()'), self.getInt) + self.getIntLabel = QLabel('0', self) + layout.addWidget(self.getIntLabel, 3, 1) + layout.addWidget(button, 3, 0) + layout.setRowStretch(3, 0) + + button = KPushButton(i18n('Get Double'), self) + self.connect(button, SIGNAL('clicked()'), self.getDouble) + self.getDoubleLabel = QLabel('0.0', self) + layout.addWidget(self.getDoubleLabel, 4, 1) + layout.addWidget(button, 4, 0) + layout.setRowStretch(4, 0) + + button = KPushButton(i18n('Get Item'), self) + self.connect(button, SIGNAL('clicked()'), self.getItem) + self.getItemLabel = QLabel(self.items[0], self) + layout.addWidget(button, 5, 0) + layout.addWidget(self.getItemLabel, 5, 1) + layout.setRowStretch(5, 0) + + def getText(self): + title = 'KInputDialog.getText Dialog' + label = 'Enter some text:' + default = self.getTextLabel.text() + value, accepted = KInputDialog.getText(title, label, default) + if accepted: + self.getTextLabel.setText(value) + + def getInt(self): + title = 'KInputDialog.getInteger Dialog' + label = 'Enter an integer:' + default = int('%s' % self.getIntLabel.text()) + value, accepted = KInputDialog.getInteger(title, label, default) + if accepted: + self.getIntLabel.setText('%s' % value) + + def getDouble(self): + title = 'KInputDialog.getDouble Dialog' + label = 'Enter a double:' + default = float('%s' % self.getDoubleLabel.text()) + value, accepted = KInputDialog.getDouble(title, label, default, -10.0, 10.0) + if accepted: + self.getDoubleLabel.setText('%s' % value) + + def getItem(self): + title = 'KInputDialog.getItem Dialog' + label = 'Select an item:' + current = self.items.index('%s' % self.getItemLabel.text()) + selections = QStringList() + for item in self.items: + selections.append(item) + value, accepted = KInputDialog.getItem(title, label, selections, current) + if accepted: + self.getItemLabel.setText('%s' % value) diff --git a/examples/pykde-sampler/dialogs/key.py b/examples/pykde-sampler/dialogs/key.py new file mode 100644 index 0000000..4c437da --- /dev/null +++ b/examples/pykde-sampler/dialogs/key.py @@ -0,0 +1,29 @@ +iconName = 'configure_shortcuts' +labelText = 'KKeyDialog' + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KPushButton, KKeyDialog, KTextEdit + + +helpText = ("Configuring keystroke shortcuts is simple with KActions and the " + "KKeyDialog type. This sample starts the KKeyDialog for the " + "sampler application.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Key Configuration Dialog'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showKeysDialog) + + def showKeysDialog(self): + top = self.topLevelWidget() + KKeyDialog.configure(top.actionCollection(), self) diff --git a/examples/pykde-sampler/dialogs/msgbox.py b/examples/pykde-sampler/dialogs/msgbox.py new file mode 100644 index 0000000..a0b3c9a --- /dev/null +++ b/examples/pykde-sampler/dialogs/msgbox.py @@ -0,0 +1,141 @@ +iconName = 'stop' +labelText = 'KMessageBox' + +from random import random +from traceback import print_exc +from StringIO import StringIO + +from qt import QFrame, QGridLayout, QLabel, QStringList, SIGNAL +from kdecore import i18n +from kdeui import KGuiItem, KPushButton, KMessageBox, KTextEdit + + +helpText = ("The KMessageBox Python class wraps the static methods of its C++ " + "counterpart. Some of these methods are used below. Refer to the " + "docs for KMessageBox for a full list.") + + +class MainFrame(QFrame): + msg = 'Do you like food?' + caption = 'Simple Question' + err = 'Some kind of error happened, but it could be worse!' + info = 'Always wash your hands after eating.' + items = ['Apples', 'Bananas', 'Cantaloupe', 'Mangos', 'Oranges', 'Pears', ] + + def __init__(self, parent=None): + QFrame.__init__(self, parent) + items = QStringList() + for item in self.items: + items.append(item) + self.items = items + + responses = 'Ok Cancel Yes No Continue'.split() + responses = [(getattr(KMessageBox, res), res) for res in responses] + self.responses = dict(responses) + + self.help = KTextEdit(helpText, '', self) + + layout = QGridLayout(self, 5, 2, 4) + layout.setRowStretch(0, 10) + layout.setColStretch(1, 10) + layout.addMultiCellWidget(self.help, 0, 1, 0, 1) + + button = KPushButton(i18n('Question Yes-No'), self) + self.connect(button, SIGNAL('clicked()'), self.questionYesNo) + layout.addWidget(button, 2, 0) + layout.setRowStretch(2, 0) + + button = KPushButton(i18n('Warning Yes-No-Cancel'), self) + self.connect(button, SIGNAL('clicked()'), self.warningYesNoCancel) + layout.addWidget(button, 3, 0) + layout.setRowStretch(3, 0) + + button = KPushButton(i18n('Warning Continue-Cancel-List'), self) + self.connect(button, SIGNAL('clicked()'), self.warningContinueCancelList) + layout.addWidget(button, 4, 0) + layout.setRowStretch(4, 0) + + button = KPushButton(i18n('Error'), self) + self.connect(button, SIGNAL('clicked()'), self.error) + layout.addWidget(button, 5, 0) + layout.setRowStretch(5, 0) + + button = KPushButton(i18n('Detailed Error'), self) + self.connect(button, SIGNAL('clicked()'), self.detailedError) + layout.addWidget(button, 6, 0) + layout.setRowStretch(6, 0) + + button = KPushButton(i18n('Sorry'), self) + self.connect(button, SIGNAL('clicked()'), self.sorry) + layout.addWidget(button, 7, 0) + layout.setRowStretch(7, 0) + + button = KPushButton(i18n('Detailed Sorry'), self) + self.connect(button, SIGNAL('clicked()'), self.detailedSorry) + layout.addWidget(button, 8, 0) + layout.setRowStretch(8, 0) + + button = KPushButton(i18n('Information'), self) + self.connect(button, SIGNAL('clicked()'), self.information) + layout.addWidget(button, 9, 0) + layout.setRowStretch(9, 0) + + button = KPushButton(i18n('Information List'), self) + self.connect(button, SIGNAL('clicked()'), self.informationList) + layout.addWidget(button, 10, 0) + layout.setRowStretch(10, 0) + + def questionYesNo(self): + dlg = KMessageBox.questionYesNo(self, self.msg, self.caption) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def warningYesNoCancel(self): + dlg = KMessageBox.warningYesNoCancel(self, self.msg, self.caption) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def warningContinueCancelList(self): + uiitem = KGuiItem('Time to Eat', 'favorites') + ctor = KMessageBox.warningContinueCancelList + dlgid = '%s' % random() + args = self, self.msg, self.items, self.caption, uiitem, dlgid + dlg = ctor(*args) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def error(self): + dlg = KMessageBox.error(self, self.err) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def detailedError(self): + try: + x = self.thisAttributeDoesNotExist + except (AttributeError, ), ex: + handle = StringIO() + print_exc(0, handle) + details = handle.getvalue() + dlg = KMessageBox.detailedError(self, self.err, details) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def sorry(self): + dlg = KMessageBox.sorry(self, self.err) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def detailedSorry(self): + try: + x = self.thisAttributeDoesNotExist + except (AttributeError, ), ex: + handle = StringIO() + print_exc(0, handle) + details = handle.getvalue() + dlg = KMessageBox.detailedSorry(self, self.err, details) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def information(self): + dlgid = '%s' % random() + dlg = KMessageBox.information(self, self.info, '', dlgid) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) + + def informationList(self): + dlgid = '%s' % random() + ctor = KMessageBox.informationList + dlg = ctor(self, self.info, self.items, '', dlgid) + print 'You pressed "%s"' % (self.responses.get(dlg, dlg), ) diff --git a/examples/pykde-sampler/dialogs/passwd.py b/examples/pykde-sampler/dialogs/passwd.py new file mode 100644 index 0000000..554093b --- /dev/null +++ b/examples/pykde-sampler/dialogs/passwd.py @@ -0,0 +1,34 @@ +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KPushButton, KPasswordDialog, KTextEdit + +iconName = 'password' +labelText = 'KPasswordDialog' +docParts = ('kdeui', 'KPasswordDialog') +helpText = ("KDE provides two variations on the password dialog. The simple " + "one shown here prompts for a password. The other type allows the " + "user to enter a new password, and provides a second field to " + "confirm the first entry.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Password Dialog'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showPasswordDialog) + + + def showPasswordDialog(self): + old = 'foo bar baz' + prompt = "Enter your super-secret password (enter anything, it's just an example):" + result = KPasswordDialog.getPassword(old, prompt) + if result == KPasswordDialog.Accepted: + pass + diff --git a/examples/pykde-sampler/dialogs/progress.py b/examples/pykde-sampler/dialogs/progress.py new file mode 100644 index 0000000..ba85b8e --- /dev/null +++ b/examples/pykde-sampler/dialogs/progress.py @@ -0,0 +1,39 @@ +iconName = 'go' +labelText = 'KProgressDialog' + + +from qt import QFrame, QHBoxLayout, QVBoxLayout, QTimer, SIGNAL +from kdecore import i18n +from kdeui import KPushButton, KProgressDialog, KTextEdit + + +helpText = """KDE provides a ready-built dialog to display a bit of text and a +progress bar.""" + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Progress Dialog'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showProgressDialog) + + def showProgressDialog(self): + self.dlg = dlg = KProgressDialog(self, None, 'Sample Progress Dialog', + helpText) + dlg.progressBar().setTotalSteps(20) + dlg.progressBar().setFormat('% complete: %p - value: %v - maximum: %m') + timer = QTimer(self) + self.connect(timer, SIGNAL('timeout()'), self.updateProgress) + timer.start(250, False) + dlg.exec_loop() + timer.stop() + + def updateProgress(self): + self.dlg.progressBar().advance(1) diff --git a/examples/pykde-sampler/dialogs/tip.py b/examples/pykde-sampler/dialogs/tip.py new file mode 100644 index 0000000..29ac66b --- /dev/null +++ b/examples/pykde-sampler/dialogs/tip.py @@ -0,0 +1,31 @@ +iconName = 'idea' +labelText = 'KTipDialog' + +import os + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KPushButton, KTipDatabase, KTipDialog, KTextEdit + + +helpText = ("The KDE standard Tip-of-the-Day dialog.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Tip-of-the-Day Dialog'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showTipDialog) + + def showTipDialog(self): + filename = os.path.abspath(os.path.join(os.path.dirname(__file__), 'tips')) + tips = KTipDatabase(filename) + dlg = KTipDialog(tips, self) + dlg.exec_loop() diff --git a/examples/pykde-sampler/dialogs/tips b/examples/pykde-sampler/dialogs/tips new file mode 100644 index 0000000..9f24457 --- /dev/null +++ b/examples/pykde-sampler/dialogs/tips @@ -0,0 +1,24 @@ + +<tip category="PyKDE Sampler|General"> +<html> +<p>Don't tug on Superman's cape.</p> +</html> +</tip> + +<tip category="PyKDE Sampler|General"> +<html> +<p>Don't spit into the wind.</p> +</html> +</tip> + +<tip category="PyKDE Sampler|General"> +<html> +<p>Don't pull the mask off the Lone Ranger.</p> +</html> +</tip> + +<tip category="PyKDE Sampler|General"> +<html> +<p>And don't mess around with <em>Jim</em>!</p> +</html> +</tip> diff --git a/examples/pykde-sampler/gen_todo.py b/examples/pykde-sampler/gen_todo.py new file mode 100644 index 0000000..02d73de --- /dev/null +++ b/examples/pykde-sampler/gen_todo.py @@ -0,0 +1,19 @@ +mods = ['dcop', 'kdecore', 'kdefx', 'kdeprint', 'kdesu', 'kdeui', 'kfile', 'khtml', 'kio', 'kmdi', 'kparts', 'kspell', ] +all = [] + + +print 'Module,Item,Path,Contributor' +for mod in mods: + module = __import__(mod) + items = dir(module) + items.sort() + items = [item for item in items if not item.startswith('_')] + items = [item for item in items if not item in all] + + for item in items: + all.append(item) + print '%s,%s,,,' % (mod, item, ) + + + + diff --git a/examples/pykde-sampler/icon_handling/__init__.py b/examples/pykde-sampler/icon_handling/__init__.py new file mode 100644 index 0000000..f25a8f0 --- /dev/null +++ b/examples/pykde-sampler/icon_handling/__init__.py @@ -0,0 +1,18 @@ +labelText = 'Icons' +iconName = 'icons' + + +helpText = ("KDE icons are nice. " + "Select the children of this item to see for yourself.") + + +from qt import QFrame, QVBoxLayout +from kdeui import KTextEdit + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + self.text = KTextEdit(helpText, '', self) + layout.addWidget(self.text, 1) diff --git a/examples/pykde-sampler/icon_handling/misc.py b/examples/pykde-sampler/icon_handling/misc.py new file mode 100644 index 0000000..4c7f425 --- /dev/null +++ b/examples/pykde-sampler/icon_handling/misc.py @@ -0,0 +1,31 @@ + +iconName = 'icons' +labelText = 'Misc.' + + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL, QPoint +from kdecore import i18n +from kdeui import KAboutDialog, KPushButton, KBugReport, KTextEdit +from kdeui import KRootPermsIcon, KWritePermsIcon + + +helpText = ("Samples for the KRootPermsIcon and KWritePermsIcon classes." + "These icons don't do anything.") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + + layout = QVBoxLayout(self, 4) + layout.setAutoAdd(True) + + self.help = KTextEdit(helpText, '', self) + self.root = KRootPermsIcon(None) + self.root.reparent(self, 0, QPoint(0,0), True) + + import os + fn = os.path.abspath('.') + print fn + self.write = KWritePermsIcon(fn) + self.write.reparent(self, 0, QPoint(0,0), True) diff --git a/examples/pykde-sampler/icon_handling/sizes.py b/examples/pykde-sampler/icon_handling/sizes.py new file mode 100644 index 0000000..b3f5e1c --- /dev/null +++ b/examples/pykde-sampler/icon_handling/sizes.py @@ -0,0 +1,30 @@ + +iconName = 'icons' +labelText = 'Icon Sizing' + + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdecore import i18n +from kdeui import KAboutDialog, KPushButton, KBugReport, KTextEdit + + +helpText = ("") + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Bug Report Dialog'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showBugDialog) + + + def showBugDialog(self): + dlg = KBugReport(self) + dlg.exec_loop() diff --git a/examples/pykde-sampler/lib.py b/examples/pykde-sampler/lib.py new file mode 100644 index 0000000..875ae1a --- /dev/null +++ b/examples/pykde-sampler/lib.py @@ -0,0 +1,105 @@ +#!/usr/bin/env python +""" + +""" +import os +import sys + +from os import listdir, walk +from os.path import dirname, isdir, abspath, split, join, exists + + +samplerpath = dirname(abspath(__file__)) +packagepath, packagename = split(samplerpath) + +samplerpath += os.path.sep +packagepath += os.path.sep + + +def namedimport(name): + """ import a module given a dotted package name + + Taken directly from the Python library docs for __import __ + """ + mod = __import__(name) + components = name.split('.') + for comp in components[1:]: + mod = getattr(mod, comp) + return mod + + +def ispackage(path): + return isdir(path) and exists(join(path, '__init__.py')) + + +def ismodule(path): + head, tail = os.path.split(path) + if tail in ('__init__.py', '__init__.pyc', '__init__.pyo'): + return False + head, tail = os.path.splitext(path) + return tail in ('.py', ) # don't use these, which filters them out dupes ( '.pyc', '.pyo') + + +def listimports(top): + top = abspath(top) + yield top + for path in listdir(top): + path = join(top, path) + if ispackage(path): + yield path + for subpath in listimports(path): + yield subpath + elif ismodule(path): + yield path + + +def listmodules(): + if samplerpath not in sys.path: + sys.path.append(samplerpath) + + dirs = [join(samplerpath, d) for d in listdir(samplerpath)] + dirs = [d for d in dirs if exists(join(d, '__init__.py'))] + + modules = [] + for dirname in dirs: + dirpath = join(samplerpath, dirname) + for path in listimports(dirpath): + path = path.replace('.py', '') + path = path.replace(samplerpath, '').replace(os.path.sep, '.') + try: + module = namedimport(path) + except (ValueError, ImportError, ), exc: + print 'Exception %s importing %s' % (exc, path, ) + else: + modules.append((path, module)) + modules.sort() + return [(path, SamplerModule(module)) for path, module in modules] + + +class SamplerModule(object): + defaultIcon = 'filenew' + + + def __init__(self, module): + self.module = module + + + def name(self): + return self.module.__name__.split('.')[-1] + + + def labelText(self): + return getattr(self.module, 'labelText', self.name()) + + + def icon(self): + return getattr(self.module, 'iconName', self.defaultIcon) + + + def builder(self): + for name in ('buildWidget', 'buildDialog', 'buildApp', 'MainFrame'): + try: + return getattr(self.module, name) + except (AttributeError, ): + pass + raise AttributeError('No builder found') diff --git a/examples/pykde-sampler/misc/__init__.py b/examples/pykde-sampler/misc/__init__.py new file mode 100644 index 0000000..b0c9208 --- /dev/null +++ b/examples/pykde-sampler/misc/__init__.py @@ -0,0 +1,16 @@ +labelText = 'Misc' +iconName = 'misc' + + +helpText = ("") + +from qt import QFrame, QVBoxLayout +from kdeui import KTextEdit + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + self.text = KTextEdit(helpText, '', self) + layout.addWidget(self.text, 1) diff --git a/examples/pykde-sampler/misc/gradientselect.py b/examples/pykde-sampler/misc/gradientselect.py new file mode 100644 index 0000000..724dd52 --- /dev/null +++ b/examples/pykde-sampler/misc/gradientselect.py @@ -0,0 +1,51 @@ +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL, QColor, QSizePolicy, QLabel +from kdecore import i18n +from kdeui import KPushButton, KGradientSelector, KTextEdit, KDualColorButton, KColorPatch + +iconName = 'colors' +labelText = 'KGradientSelector' +docParts = ('kdeui', 'KGradientSelector') +helpText = ("An example of the KGradientSelector widget." + "\n" + "Change the start and finish colors with the dual color button." + ) + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + self.selector = KGradientSelector(self) + self.dualLabel = QLabel('Select Colors:', self) + + self.startColor = QColor('red') + self.finishColor = QColor('blue') + + self.selector.setColors(self.startColor, self.finishColor) + self.selector.setText('Start', 'Finish') + + self.dualButton = KDualColorButton(self.startColor, self.finishColor, self) + self.dualButton.setSizePolicy(QSizePolicy(QSizePolicy.Maximum, + QSizePolicy.Maximum)) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help, 20) + + buttonLayout = QHBoxLayout(layout, 4) + buttonLayout.addWidget(self.dualLabel, 0) + buttonLayout.addWidget(self.dualButton, 1) + + layout.addWidget(self.selector, 10) + + + self.connect(self.dualButton, SIGNAL('fgChanged(const QColor &)'), + self.selector.setFirstColor) + self.connect(self.dualButton, SIGNAL('bgChanged(const QColor &)'), + self.selector.setSecondColor) + self.connect(self.selector, SIGNAL('valueChanged(int)'), + self.updateValue) + + + def updateValue(self, value): + ## this should be extended to update a color swatch + pass diff --git a/examples/pykde-sampler/misc/passivepop.py b/examples/pykde-sampler/misc/passivepop.py new file mode 100644 index 0000000..81d383a --- /dev/null +++ b/examples/pykde-sampler/misc/passivepop.py @@ -0,0 +1,43 @@ +from qt import Qt, QFrame, QHBoxLayout, QVBoxLayout, QLabel, SIGNAL +from kdeui import KPassivePopup, KTextEdit, KPushButton +from kdecore import KGlobal, KIcon + +iconName = 'popup' +labelText = 'KPassivePopup' +docParts = ('kdeui', 'KPassivePopup') +helpText = ('Examples of the KPassivePopup widget.') + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + self.button = KPushButton('Show Passive Popups', self) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help, 10) + buttonLayout = QHBoxLayout(layout, 4) + buttonLayout.addWidget(self.button, 1) + buttonLayout.addStretch(10) + layout.addStretch(10) + + + self.connect(self.button, SIGNAL('clicked()'), self.showPopups) + + + def showPopups(self): + ## no support for all of the 3.5 calls + pop = KPassivePopup.message('Hello, <i>KPassivePopup</i>', self) + pop.setTimeout(3000) + pop.show() + + + pos = pop.pos() + pos.setY(pos.y() + pop.height() + 10) + + ico = KGlobal.instance().iconLoader().loadIcon('help', KIcon.NoGroup, + KIcon.SizeSmall) + pop = KPassivePopup.message('<b>Hello</b>', 'With Icons', ico, self) + pop.setTimeout(3000) + pop.show() + pop.move(pos) diff --git a/examples/pykde-sampler/misc/window_info.py b/examples/pykde-sampler/misc/window_info.py new file mode 100644 index 0000000..08bff22 --- /dev/null +++ b/examples/pykde-sampler/misc/window_info.py @@ -0,0 +1,35 @@ + + + +from qt import QFrame, QHBoxLayout, QVBoxLayout, SIGNAL +from kdeui import KWindowInfo, KPushButton, KTextEdit +from kdecore import i18n, KApplication + +iconName = 'misc' +labelText = 'KWindowInfo' +helpText = '' + + +class MainFrame(QFrame): + def __init__(self, parent): + QFrame.__init__(self, parent) + self.button = KPushButton(i18n('Show Message'), self) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + buttonlayout = QHBoxLayout(layout, 4) + buttonlayout.addWidget(self.button) + buttonlayout.addStretch(1) + layout.addStretch(1) + self.connect(self.button, SIGNAL('clicked()'), self.showWindowInfo) + + + def showWindowInfo(self): + main = KApplication.kApplication() + print main + print main.mainWidget() + + info = KWindowInfo(main) + info.message('Updated Window Info', 3) + + diff --git a/examples/pykde-sampler/qt_widgets/CONTRIB b/examples/pykde-sampler/qt_widgets/CONTRIB new file mode 100644 index 0000000..e814d1e --- /dev/null +++ b/examples/pykde-sampler/qt_widgets/CONTRIB @@ -0,0 +1,537 @@ +Module,Item,Path,Contributor +dcop,DCOPClient,,, +dcop,DCOPClientTransaction,,, +dcop,DCOPObject,,, +dcop,DCOPObjectProxy,,, +dcop,DCOPRef,,, +dcop,DCOPReply,,, +dcop,DCOPStub,,, +kdecore,BarIcon,,, +kdecore,BarIconSet,,, +kdecore,DesktopIcon,,, +kdecore,DesktopIconSet,,, +kdecore,IconSize,,, +kdecore,KAboutData,,, +kdecore,KAboutPerson,,, +kdecore,KAboutTranslator,,, +kdecore,KAccel,,, +kdecore,KAccelAction,,, +kdecore,KAccelActions,,, +kdecore,KAccelBase,,, +kdecore,KAccelShortcutList,,, +kdecore,KApplication,,, +kdecore,KAsyncIO,,, +kdecore,KAudioPlayer,,, +kdecore,KBufferedIO,,, +kdecore,KCalendarSystem,,, +kdecore,KCalendarSystemFactory,,, +kdecore,KCatalogue,,, +kdecore,KCharsets,,, +kdecore,KClipboardSynchronizer,,, +kdecore,KCmdLineArgs,,, +kdecore,KCmdLineOptions,,, +kdecore,KCodecs,,, +kdecore,KCompletion,,, +kdecore,KCompletionBase,,, +kdecore,KConfig,,, +kdecore,KConfigBackEnd,,, +kdecore,KConfigBase,,, +kdecore,KConfigDialogManager,,, +kdecore,KConfigGroup,,, +kdecore,KConfigGroupSaver,,, +kdecore,KConfigINIBackEnd,,, +kdecore,KConfigSkeleton,,, +kdecore,KConfigSkeletonItem,,, +kdecore,KCrash,,, +kdecore,KDCOPPropertyProxy,,, +kdecore,KDE,,, +kdecore,KDesktopFile,,, +kdecore,KEntry,,, +kdecore,KEntryKey,,, +kdecore,KGlobal,,, +kdecore,KGlobalAccel,,, +kdecore,KGlobalSettings,,, +kdecore,KIDNA,,, +kdecore,KIPC,,, +kdecore,KIcon,,, +kdecore,KIconEffect,,, +kdecore,KIconLoader,,, +kdecore,KIconTheme,,, +kdecore,KInstance,,, +kdecore,KKey,,, +kdecore,KKeyNative,,, +kdecore,KKeySequence,,, +kdecore,KKeyServer,,, +kdecore,KLibFactory,,, +kdecore,KLibLoader,,, +kdecore,KLibrary,,, +kdecore,KLocale,,, +kdecore,KMD5,,, +kdecore,KMacroExpander,,, +kdecore,KMacroExpanderBase,,, +kdecore,KMimeSourceFactory,,, +kdecore,KMountPoint,,, +kdecore,KMultipleDrag,,, +kdecore,KNotifyClient,,, +kdecore,KPalette,,, +kdecore,KPixmapProvider,,, +kdecore,KProcIO,,, +kdecore,KProcess,,, +kdecore,KProcessController,,, +kdecore,KPty,,, +kdecore,KRFCDate,,, +kdecore,KRandomSequence,,, +kdecore,KRegExp,,, +kdecore,KRootProp,,, +kdecore,KSaveFile,,, +kdecore,KSelectionOwner,,, +kdecore,KSelectionWatcher,,, +kdecore,KServerSocket,,, +kdecore,KSessionManaged,,, +kdecore,KShared,,, +kdecore,KSharedConfig,,, +kdecore,KShell,,, +kdecore,KShellProcess,,, +kdecore,KShortcut,,, +kdecore,KShortcutList,,, +kdecore,KSimpleConfig,,, +kdecore,KSocket,,, +kdecore,KStandardDirs,,, +kdecore,KStartupInfo,,, +kdecore,KStartupInfoData,,, +kdecore,KStartupInfoId,,, +kdecore,KStaticDeleterBase,,, +kdecore,KStdAccel,,, +kdecore,KStringHandler,,, +kdecore,KTempDir,,, +kdecore,KTempFile,,, +kdecore,KURL,,, +kdecore,KURLDrag,,, +kdecore,KUniqueApplication,,, +kdecore,KWin,,, +kdecore,KWinModule,,, +kdecore,KZoneAllocator,,, +kdecore,MainBarIcon,,, +kdecore,MainBarIconSet,,, +kdecore,NET,,, +kdecore,NETIcon,,, +kdecore,NETPoint,,, +kdecore,NETRect,,, +kdecore,NETRootInfo,,, +kdecore,NETRootInfo2,,, +kdecore,NETSize,,, +kdecore,NETStrut,,, +kdecore,NETWinInfo,,, +kdecore,SmallIcon,,, +kdecore,SmallIconSet,,, +kdecore,UserIcon,,, +kdecore,UserIconSet,,, +kdecore,i18n,,, +kdecore,locate,,, +kdecore,locateLocal,,, +kdecore,testKEntryMap,,, +kdecore,urlcmp,,, +kdefx,KCPUInfo,,, +kdefx,KImageEffect,,, +kdefx,KPixmap,,, +kdefx,KPixmapEffect,,, +kdefx,KPixmapSplitter,,, +kdefx,KStyle,,, +kdefx,kColorBitmaps,,, +kdefx,kDrawBeButton,,, +kdefx,kDrawNextButton,,, +kdefx,kDrawRoundButton,,, +kdefx,kDrawRoundMask,,, +kdefx,kRoundMaskRegion,,, +kdeprint,DrBase,,, +kdeprint,DrBooleanOption,,, +kdeprint,DrChoiceGroup,,, +kdeprint,DrConstraint,,, +kdeprint,DrFloatOption,,, +kdeprint,DrGroup,,, +kdeprint,DrIntegerOption,,, +kdeprint,DrListOption,,, +kdeprint,DrMain,,, +kdeprint,DrPageSize,,, +kdeprint,DrStringOption,,, +kdeprint,KMJob,,, +kdeprint,KMJobManager,,, +kdeprint,KMManager,,, +kdeprint,KMObject,,, +kdeprint,KMPrinter,,, +kdeprint,KPReloadObject,,, +kdeprint,KPrintAction,,, +kdeprint,KPrintDialog,,, +kdeprint,KPrintDialogPage,,, +kdeprint,KPrinter,,, +kdeprint,pageNameToPageSize,,, +kdeprint,pageSizeToPageName,,, +kdeprint,rangeToSize,,, +kdesu,KCookie,,, +kdesu,KDEsuClient,,, +kdesu,PTY,,, +kdesu,PtyProcess,,, +kdesu,SshProcess,,, +kdesu,StubProcess,,, +kdesu,SuProcess,,, +kdeui,KAboutApplication,,, +kdeui,KAboutContainer,,, +kdeui,KAboutContributor,,, +kdeui,KAboutDialog,,, +kdeui,KAboutKDE,,, +kdeui,KAboutWidget,,, +kdeui,KAction,,, +kdeui,KActionCollection,,, +kdeui,KActionMenu,,, +kdeui,KActionPtrShortcutList,,, +kdeui,KActionSeparator,,, +kdeui,KActionShortcutList,,, +kdeui,KActiveLabel,,, +kdeui,KAnimWidget,,, +kdeui,KArrowButton,,, +kdeui,KAuthIcon,,, +kdeui,KBugReport,,, +kdeui,KButtonBox,,, +kdeui,KCModule,,, +kdeui,KCharSelect,,, +kdeui,KCharSelectTable,,, +kdeui,KColor,,, +kdeui,KColorButton,,, +kdeui,KColorCells,,, +kdeui,KColorCombo,,, +kdeui,KColorDialog,,, +kdeui,KColorDrag,,, +kdeui,KColorPatch,,, +kdeui,KComboBox,,, +kdeui,KCommand,,, +kdeui,KCommandHistory,,, +kdeui,KCompletionBox,,, +kdeui,KConfigDialog,,, +kdeui,KContextMenuManager,,, +kdeui,KCursor,,, +kdeui,KDCOPActionProxy,,, +kdeui,KDateInternalMonthPicker,,, +kdeui,KDateInternalWeekSelector,,, +kdeui,KDateInternalYearSelector,,, +kdeui,KDatePicker,,, +kdeui,KDateTable,,, +kdeui,KDateTimeWidget,,, +kdeui,KDateValidator,,, +kdeui,KDateWidget,,, +kdeui,KDialog,,, +kdeui,KDialogBase,,, +kdeui,KDialogQueue,,, +kdeui,KDockArea,,, +kdeui,KDockMainWindow,,, +kdeui,KDockManager,,, +kdeui,KDockTabGroup,,, +kdeui,KDockWidget,,, +kdeui,KDockWidgetAbstractHeader,,, +kdeui,KDockWidgetAbstractHeaderDrag,,, +kdeui,KDockWidgetHeader,,, +kdeui,KDockWidgetHeaderDrag,,, +kdeui,KDockWindow,,, +kdeui,KDoubleNumInput,,, +kdeui,KDoubleSpinBox,,, +kdeui,KDoubleValidator,,, +kdeui,KDualColorButton,,, +kdeui,KEdFind,,, +kdeui,KEdGotoLine,,, +kdeui,KEdReplace,,, +kdeui,KEdit,,, +kdeui,KEditListBox,,, +kdeui,KEditToolbar,,, +kdeui,KEditToolbarWidget,,, +kdeui,KFloatValidator,,, +kdeui,KFontAction,,, +kdeui,KFontChooser,,, +kdeui,KFontCombo,,, +kdeui,KFontDialog,,, +kdeui,KFontRequester,,, +kdeui,KFontSizeAction,,, +kdeui,KGradientSelector,,, +kdeui,KGuiItem,,, +kdeui,KHSSelector,,, +kdeui,KHelpMenu,,, +kdeui,KHistoryCombo,,, +kdeui,KIconView,,, +kdeui,KIconViewItem,,, +kdeui,KInputDialog,,, +kdeui,KIntNumInput,,, +kdeui,KIntSpinBox,,, +kdeui,KIntValidator,,, +kdeui,KJanusWidget,,, +kdeui,KKeyButton,,, +kdeui,KKeyChooser,,, +kdeui,KKeyDialog,,, +kdeui,KLed,,, +kdeui,KLineEdit,,, +kdeui,KLineEditDlg,,, +kdeui,KListAction,,, +kdeui,KListBox,,, +kdeui,KListView,,, +kdeui,KListViewItem,,, +kdeui,KMacroCommand,,, +kdeui,KMainWindow,,, +kdeui,KMainWindowInterface,,, +kdeui,KMenuBar,,, +kdeui,KMessageBox,,, +kdeui,KMimeTypeValidator,,, +kdeui,KNamedCommand,,, +kdeui,KNumInput,,, +kdeui,KPaletteTable,,, +kdeui,KPanelAppMenu,,, +kdeui,KPanelApplet,,, +kdeui,KPanelExtension,,, +kdeui,KPanelMenu,,, +kdeui,KPassivePopup,,, +kdeui,KPasswordDialog,,, +kdeui,KPasswordEdit,,, +kdeui,KPasteTextAction,,, +kdeui,KPixmapIO,,, +kdeui,KPopupFrame,,, +kdeui,KPopupMenu,,, +kdeui,KPopupTitle,,, +kdeui,KProgress,,, +kdeui,KProgressDialog,,, +kdeui,KPushButton,,, +kdeui,KRadioAction,,, +kdeui,KRecentFilesAction,,, +kdeui,KRestrictedLine,,, +kdeui,KRootPermsIcon,,, +kdeui,KRootPixmap,,, +kdeui,KRuler,,, +kdeui,KSelectAction,,, +kdeui,KSelector,,, +kdeui,KSeparator,,, +kdeui,KSplashScreen,,, +kdeui,KSqueezedTextLabel,,, +kdeui,KStatusBar,,, +kdeui,KStatusBarLabel,,, +kdeui,KStdAction,,, +kdeui,KStdGuiItem,,, +kdeui,KStringListValidator,,, +kdeui,KSystemTray,,, +kdeui,KTabBar,,, +kdeui,KTabCtl,,, +kdeui,KTabWidget,,, +kdeui,KTextBrowser,,, +kdeui,KTextEdit,,, +kdeui,KTimeWidget,,, +kdeui,KTipDatabase,,, +kdeui,KTipDialog,,, +kdeui,KToggleAction,,, +kdeui,KToggleFullScreenAction,,, +kdeui,KToggleToolBarAction,,, +kdeui,KToolBar,,, +kdeui,KToolBarButton,,, +kdeui,KToolBarPopupAction,,, +kdeui,KToolBarRadioGroup,,, +kdeui,KToolBarSeparator,,, +kdeui,KURLLabel,,, +kdeui,KValueSelector,,, +kdeui,KWidgetAction,,, +kdeui,KWindowInfo,,, +kdeui,KWindowListMenu,,, +kdeui,KWizard,,, +kdeui,KWordWrap,,, +kdeui,KWritePermsIcon,,, +kdeui,KXMLGUIBuilder,,, +kdeui,KXMLGUIClient,,, +kdeui,KXMLGUIFactory,,, +kdeui,KXYSelector,,, +kdeui,QXEmbed,,, +kdeui,testKActionList,,, +kfile,KApplicationPropsPlugin,,, +kfile,KBindingPropsPlugin,,, +kfile,KCombiView,,, +kfile,KCustomMenuEditor,,, +kfile,KDesktopPropsPlugin,,, +kfile,KDevicePropsPlugin,,, +kfile,KDirOperator,,, +kfile,KDirSelectDialog,,, +kfile,KDirSize,,, +kfile,KDiskFreeSp,,, +kfile,KEncodingFileDialog,,, +kfile,KExecPropsPlugin,,, +kfile,KFile,,, +kfile,KFileDetailView,,, +kfile,KFileDialog,,, +kfile,KFileFilterCombo,,, +kfile,KFileIconView,,, +kfile,KFileIconViewItem,,, +kfile,KFileListViewItem,,, +kfile,KFileOpenWithHandler,,, +kfile,KFilePermissionsPropsPlugin,,, +kfile,KFilePreview,,, +kfile,KFilePropsPlugin,,, +kfile,KFileSharePropsPlugin,,, +kfile,KFileTreeBranch,,, +kfile,KFileTreeView,,, +kfile,KFileTreeViewItem,,, +kfile,KFileTreeViewToolTip,,, +kfile,KFileView,,, +kfile,KFileViewSignaler,,, +kfile,KIconButton,,, +kfile,KIconCanvas,,, +kfile,KIconDialog,,, +kfile,KImageFilePreview,,, +kfile,KNotify,,, +kfile,KNotifyDialog,,, +kfile,KOpenWithDlg,,, +kfile,KPreviewWidgetBase,,, +kfile,KPropertiesDialog,,, +kfile,KPropsDlgPlugin,,, +kfile,KRecentDocument,,, +kfile,KURLBar,,, +kfile,KURLBarItem,,, +kfile,KURLBarItemDialog,,, +kfile,KURLBarListBox,,, +kfile,KURLComboBox,,, +kfile,KURLComboRequester,,, +kfile,KURLPropsPlugin,,, +kfile,KURLRequester,,, +kfile,KURLRequesterDlg,,, +khtml,DOM,,, +khtml,KHTMLPart,,, +khtml,KHTMLSettings,,, +khtml,KHTMLView,,, +kio,KAr,,, +kio,KArchive,,, +kio,KArchiveDirectory,,, +kio,KArchiveEntry,,, +kio,KArchiveFile,,, +kio,KAutoMount,,, +kio,KAutoUnmount,,, +kio,KDCOPServiceStarter,,, +kio,KDEDesktopMimeType,,, +kio,KDataTool,,, +kio,KDataToolAction,,, +kio,KDataToolInfo,,, +kio,KDirLister,,, +kio,KDirNotify,,, +kio,KDirWatch,,, +kio,KEMailSettings,,, +kio,KExecMimeType,,, +kio,KFileFilter,,, +kio,KFileItem,,, +kio,KFileMetaInfo,,, +kio,KFileMetaInfoGroup,,, +kio,KFileMetaInfoItem,,, +kio,KFileMetaInfoProvider,,, +kio,KFileMimeTypeInfo,,, +kio,KFilePlugin,,, +kio,KFileShare,,, +kio,KFileSharePrivate,,, +kio,KFilterBase,,, +kio,KFilterDev,,, +kio,KFolderType,,, +kio,KIO,,, +kio,KImageIO,,, +kio,KMimeMagic,,, +kio,KMimeMagicResult,,, +kio,KMimeType,,, +kio,KOCRDialog,,, +kio,KOCRDialogFactory,,, +kio,KOpenWithHandler,,, +kio,KProcessRunner,,, +kio,KProtocolInfo,,, +kio,KProtocolManager,,, +kio,KRun,,, +kio,KST_CTimeInfo,,, +kio,KST_KCustom,,, +kio,KST_KDEDesktopMimeType,,, +kio,KST_KExecMimeType,,, +kio,KST_KFolderType,,, +kio,KST_KImageIO,,, +kio,KST_KImageIOFormat,,, +kio,KST_KMimeType,,, +kio,KST_KProtocolInfo,,, +kio,KST_KProtocolInfoFactory,,, +kio,KST_KService,,, +kio,KST_KServiceFactory,,, +kio,KST_KServiceGroup,,, +kio,KST_KServiceGroupFactory,,, +kio,KST_KServiceType,,, +kio,KST_KServiceTypeFactory,,, +kio,KST_KSycocaEntry,,, +kio,KScanDialog,,, +kio,KScanDialogFactory,,, +kio,KService,,, +kio,KServiceGroup,,, +kio,KServiceOffer,,, +kio,KServiceSeparator,,, +kio,KServiceType,,, +kio,KServiceTypeProfile,,, +kio,KShellCompletion,,, +kio,KShred,,, +kio,KSimpleFileFilter,,, +kio,KSycoca,,, +kio,KSycocaEntry,,, +kio,KSycocaFactory,,, +kio,KTar,,, +kio,KTrader,,, +kio,KURIFilter,,, +kio,KURIFilterData,,, +kio,KURIFilterPlugin,,, +kio,KURLCompletion,,, +kio,KURLPixmapProvider,,, +kio,KZip,,, +kio,KZipFileEntry,,, +kio,Observer,,, +kio,RenameDlgPlugin,,, +kio,ThumbCreator,,, +kio,testKIOMetaData,,, +kio,testKIOUDSEntry,,, +kio,testKIOUDSEntryList,,, +kmdi,KMdi,,, +kmdi,KMdiChildArea,,, +kmdi,KMdiChildFrm,,, +kmdi,KMdiChildFrmCaption,,, +kmdi,KMdiChildFrmDragBeginEvent,,, +kmdi,KMdiChildFrmDragEndEvent,,, +kmdi,KMdiChildFrmMoveEvent,,, +kmdi,KMdiChildFrmResizeBeginEvent,,, +kmdi,KMdiChildFrmResizeEndEvent,,, +kmdi,KMdiChildView,,, +kmdi,KMdiMainFrm,,, +kmdi,KMdiTaskBar,,, +kmdi,KMdiTaskBarButton,,, +kmdi,KMdiToolViewAccessor,,, +kmdi,KMdiViewCloseEvent,,, +kmdi,KMdiWin32IconButton,,, +kparts,KParts,,, +kparts,createReadOnlyPart,,, +kparts,createReadWritePart,,, +kparts,testQMapQCStringInt,,, +kspell,KS_ADD,,, +kspell,KS_CANCEL,,, +kspell,KS_CLIENT_ASPELL,,, +kspell,KS_CLIENT_HSPELL,,, +kspell,KS_CLIENT_ISPELL,,, +kspell,KS_CONFIG,,, +kspell,KS_E_ASCII,,, +kspell,KS_E_CP1251,,, +kspell,KS_E_CP1255,,, +kspell,KS_E_KOI8R,,, +kspell,KS_E_KOI8U,,, +kspell,KS_E_LATIN1,,, +kspell,KS_E_LATIN13,,, +kspell,KS_E_LATIN15,,, +kspell,KS_E_LATIN2,,, +kspell,KS_E_LATIN3,,, +kspell,KS_E_LATIN4,,, +kspell,KS_E_LATIN5,,, +kspell,KS_E_LATIN7,,, +kspell,KS_E_LATIN8,,, +kspell,KS_E_LATIN9,,, +kspell,KS_E_UTF8,,, +kspell,KS_IGNORE,,, +kspell,KS_IGNOREALL,,, +kspell,KS_REPLACE,,, +kspell,KS_REPLACEALL,,, +kspell,KS_STOP,,, +kspell,KS_SUGGEST,,, +kspell,KSpell,,, +kspell,KSpellConfig,,, +kspell,KSpellDlg,,, diff --git a/examples/pykde-sampler/qt_widgets/__init__.py b/examples/pykde-sampler/qt_widgets/__init__.py new file mode 100644 index 0000000..ffe7bed --- /dev/null +++ b/examples/pykde-sampler/qt_widgets/__init__.py @@ -0,0 +1,17 @@ +labelText = 'Qt Widgets' +iconName = 'designer' + +helpText = """Qt provides a rich set of widgets for application use. +Select the children of this item to see for yourself.""" + +from qt import QFrame, QVBoxLayout, SIGNAL +from kdeui import KTextEdit + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + layout.addStretch(1) diff --git a/examples/pykde-sampler/qt_widgets/table.py b/examples/pykde-sampler/qt_widgets/table.py new file mode 100644 index 0000000..d6b6e3e --- /dev/null +++ b/examples/pykde-sampler/qt_widgets/table.py @@ -0,0 +1,42 @@ +labelText = 'QTable' +iconName = 'inline_table' + +helpText = """From the docs: 'The QTable class provides a flexible +editable table widget.' +""" + +import csv +import os + +from qt import QFrame, QStringList, QVBoxLayout, SIGNAL +from qttable import QTable + +from kdeui import KTextEdit + +contrib = os.path.join(os.path.split(__file__)[0], 'CONTRIB') + + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + self.help = KTextEdit(helpText, '', self) + + data = csv.reader(open(contrib)) + header = data.next() + items = [item for item in data] + + self.table = table = QTable(len(items), len(header), self) + headers = QStringList() + for headertext in header: + headers.append(headertext) + table.setColumnLabels(headers) + + cols = range(len(header)) + for row, record in enumerate(items): + for col in cols: + table.setText(row, col, record[col]) + + layout = QVBoxLayout(self, 4) + layout.addWidget(self.help) + layout.addWidget(self.table) + layout.addStretch(1) diff --git a/examples/pykde-sampler/runner.py b/examples/pykde-sampler/runner.py new file mode 100755 index 0000000..8b1ad2c --- /dev/null +++ b/examples/pykde-sampler/runner.py @@ -0,0 +1,58 @@ +#!/usr/bin/env python +""" + +""" +import sys +from kdecore import KApplication, KCmdLineArgs +from kdeui import KMainWindow +from qt import QVBoxLayout + +## relative import -- cry me a river! +import about + + +class SamplerRunnerWindow(KMainWindow): + def __init__(self, ctor): + KMainWindow.__init__(self) + layout = QVBoxLayout(self) + layout.setAutoAdd(True) + self.widget = ctor(self) + + +def importItem(name): + """ importItem(name) -> import an item from a module by dotted name + + """ + def importName(name): + """ importName(name) -> import and return a module by name in dotted form + + Copied from the Python lib docs. + """ + mod = __import__(name) + for comp in name.split('.')[1:]: + mod = getattr(mod, comp) + return mod + + names = name.split('.') + modname, itemname = names[0:-1], names[-1] + mod = importName(str.join('.', modname)) + return getattr(mod, itemname) + + + +if __name__ == '__main__': + options = [('+item', 'An item in the sys.path')] + KCmdLineArgs.init(sys.argv, about.about) + KCmdLineArgs.addCmdLineOptions(options) + + args = KCmdLineArgs.parsedArgs() + if not args.count(): + args.usage() + else: + pathitem = args.arg(0) + widget = importItem(pathitem) + + app = KApplication() + mainWindow = SamplerRunnerWindow(widget) + mainWindow.show() + app.exec_loop() diff --git a/examples/pykde-sampler/sampler.py b/examples/pykde-sampler/sampler.py new file mode 100755 index 0000000..bacf634 --- /dev/null +++ b/examples/pykde-sampler/sampler.py @@ -0,0 +1,423 @@ +#!/usr/bin/env python +""" The PyKDE application sampler + +This module defines the top-level widgets for displaying the sampler +application. + + +""" +import inspect +import os +import sys + +from qt import SIGNAL, SLOT, PYSIGNAL, Qt +from qt import QVBoxLayout, QLabel, QPixmap, QSplitter, QFrame, QDialog +from qt import QSizePolicy, QHBoxLayout, QSpacerItem, QPushButton + +from kdecore import i18n, KAboutData, KApplication, KCmdLineArgs, KGlobal +from kdecore import KGlobalSettings, KWin, KWinModule, KURL, KIcon + +from kdeui import KComboBox, KListView, KListViewItem, KTabWidget, KTextEdit +from kdeui import KMainWindow, KPushButton, KSplashScreen, KStdAction +from kdeui import KKeyDialog, KEditToolbar + +from kio import KTrader +from kparts import createReadOnlyPart, createReadWritePart +from khtml import KHTMLPart + +import about +import lib + + +try: + __file__ +except (NameError, ): + __file__ = sys.argv[0] + + +sigDoubleClicked = SIGNAL('doubleClicked(QListViewItem *)') +sigViewItemSelected = SIGNAL('selectionChanged(QListViewItem *)') +sigSampleSelected = PYSIGNAL('sample selected') + +blank = KURL('about:blank') + + +def appConfig(group=None): + """ appConfig(group=None) -> returns the application KConfig + + """ + config = KGlobal.instance().config() + if group is not None: + config.setGroup(group) + return config + + +def getIcon(name, group=KIcon.NoGroup, size=KIcon.SizeSmall): + """ returns a kde icon by name + + """ + return KGlobal.instance().iconLoader().loadIcon(name, group, size) + + +def getIconSet(name, group=KIcon.NoGroup, size=KIcon.SizeSmall): + """ returns a kde icon set by name + + """ + return KGlobal.instance().iconLoader().loadIconSet(name, group, size) + + +def buildPart(parent, query, constraint, writable=False): + """ builds the first available offered part on the parent + + """ + offers = KTrader.self().query(query, constraint) + for ptr in offers: + if writable: + builder = createReadWritePart + else: + builder = createReadOnlyPart + part = builder(ptr.library(), parent, ptr.name()) + if part: + break + return part + + + +class CommonFrame(QFrame): + """ provides a modicum of reuse + + """ + def __init__(self, parent): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + layout.setAutoAdd(True) + layout.setAlignment(Qt.AlignCenter | Qt.AlignVCenter) + + +class SamplerFrame(CommonFrame): + """ frame type that swaps out old widgets for new when told to do so + + """ + def __init__(self, parent): + CommonFrame.__init__(self, parent) + self.widget = None + + def setWidget(self, widget): + self.layout().deleteAllItems() + previous = self.widget + if previous: + previous.close() + delattr(self, 'widget') + self.widget = widget + + def showSample(self, item, module): + try: + frameType = module.builder() + except (AttributeError, ): + print 'No sample callable defined in %s' % (module.name(), ) + else: + frame = frameType(self) + self.setWidget(frame) + frame.show() + + +class SourceFrame(CommonFrame): + """ frame with part for displaying python source + + """ + def __init__(self, parent): + CommonFrame.__init__(self, parent) + query = '' + self.part = buildPart(self, 'application/x-python', query, False) + + def showModuleSource(self, item, module): + if not self.part: + print 'No part available for displaying python source.' + return + try: + modulefile = inspect.getabsfile(module.module) + except: + return + self.part.openURL(blank) + if os.path.splitext(modulefile)[-1] == '.py': + self.part.openURL(KURL('file://%s' % modulefile)) + + +class WebFrame(CommonFrame): + """ frame with part for viewing web pages + + """ + docBase = 'http://www.riverbankcomputing.com/Docs/PyKDE3/classref/' + + def __init__(self, parent): + CommonFrame.__init__(self, parent) + self.part = part = buildPart(self, 'text/html', "Type == 'Service'") + #part.connect(part, SIGNAL('khtmlMousePressEvent(a)'), self.onURL) + + def onURL(self, a): + print '****', a + + def showDocs(self, item, module): + try: + mod, cls = module.module.docParts + except (AttributeError, ): + url = blank + else: + url = KURL(self.docUrl(mod, cls)) + self.part.openURL(url) + + + def docUrl(self, module, klass): + """ docUrl(name) -> return a doc url given a name from the kde libs + + """ + return '%s/%s/%s.html' % (self.docBase, module, klass, ) + + +class OutputFrame(KTextEdit): + """ text widget that acts (just enough) like a file + + """ + def __init__(self, parent, filehandle): + KTextEdit.__init__(self, parent) + self.filehandle = filehandle + self.setReadOnly(True) + self.setFont(KGlobalSettings.fixedFont()) + + + def write(self, text): + self.insert(text) + + + def clear(self): + self.setText('') + + + def __getattr__(self, name): + return getattr(self.filehandle, name) + + +class SamplerListView(KListView): + """ the main list view of samples + + """ + def __init__(self, parent): + KListView.__init__(self, parent) + self.addColumn(i18n('Sample')) + self.setRootIsDecorated(True) + + modules = lib.listmodules() + modules.sort(lambda a, b: cmp(a[0], b[0])) + + modmap = dict(modules) + modules = [(name.split('.'), name, mod) for name, mod in modules] + roots, cache = {}, {} + + for names, modname, module in modules: + topname, subnames = names[0], names[1:] + item = roots.get(topname, None) + if item is None: + roots[topname] = item = KListViewItem(self, module.labelText()) + item.module = module + item.setPixmap(0, getIcon(module.icon())) + + bname = '' + subitem = item + for subname in subnames: + bname = '%s.%s' % (bname, subname, ) + item = cache.get(bname, None) + if item is None: + subitem = cache[bname] = \ + KListViewItem(subitem, module.labelText()) + subitem.module = module + subitem.setPixmap(0, getIcon(module.icon())) + subitem = item + + for root in roots.values(): + self.setOpen(root, True) + + +class SamplerMainWindow(KMainWindow): + """ the main window + + """ + def __init__(self, *args): + KMainWindow.__init__(self, *args) + self.hSplitter = hSplit = QSplitter(Qt.Horizontal, self) + self.samplesList = samplesList = SamplerListView(hSplit) + self.vSplitter = vSplit = QSplitter(Qt.Vertical, hSplit) + self.setCentralWidget(hSplit) + self.setIcon(getIcon('kmail')) + + hSplit.setOpaqueResize(True) + vSplit.setOpaqueResize(True) + + self.contentTabs = cTabs = KTabWidget(vSplit) + self.outputTabs = oTabs = KTabWidget(vSplit) + + self.sampleFrame = SamplerFrame(cTabs) + self.sourceFrame = SourceFrame(cTabs) + self.webFrame = WebFrame(cTabs) + + cTabs.insertTab(self.sampleFrame, getIconSet('exec'), i18n('Sample')) + cTabs.insertTab(self.sourceFrame, getIconSet('source'), i18n('Source')) + cTabs.insertTab(self.webFrame, getIconSet('help'), i18n('Docs')) + + sys.stdout = self.stdoutFrame = OutputFrame(oTabs, sys.stdout) + sys.stderr = self.stderrFrame = OutputFrame(oTabs, sys.stderr) + + termIcons = getIconSet('terminal') + oTabs.insertTab(self.stdoutFrame, termIcons, i18n('stdout')) + oTabs.insertTab(self.stderrFrame, termIcons, i18n('stderr')) + + self.resize(640, 480) + height, width = self.height(), self.width() + hSplit.setSizes([width * 0.35, width * 0.65]) + vSplit.setSizes([height * 0.80, height * 0.20]) + + self.xmlRcFileName = os.path.abspath(os.path.join(os.path.dirname(__file__), 'sampler.rc')) + self.setXMLFile(self.xmlRcFileName) + config = appConfig() + actions = self.actionCollection() + actions.readShortcutSettings("", config) + self.quitAction = KStdAction.quit(self.close, actions) + + self.toggleMenubarAction = \ + KStdAction.showMenubar(self.showMenubar, actions) + self.toggleToolbarAction = \ + KStdAction.showToolbar(self.showToolbar, actions) + self.toggleStatusbarAction = \ + KStdAction.showStatusbar(self.showStatusbar, actions) + self.configureKeysAction = \ + KStdAction.keyBindings(self.showConfigureKeys, actions) + self.configureToolbarAction = \ + KStdAction.configureToolbars(self.showConfigureToolbars, actions) + self.configureAppAction = \ + KStdAction.preferences(self.showConfiguration, actions) + + connect = self.connect + connect(samplesList, sigViewItemSelected, self.sampleSelected) + connect(self, sigSampleSelected, self.reloadModule) + connect(self, sigSampleSelected, self.sourceFrame.showModuleSource) + connect(self, sigSampleSelected, self.sampleFrame.showSample) + connect(self, sigSampleSelected, self.webFrame.showDocs) + + self.restoreWindowSize(config) + self.createGUI(self.xmlRcFileName, 0) + self.sourceFrame.part.openURL(KURL('file://%s' % os.path.abspath(__file__))) + + + def showConfiguration(self): + """ showConfiguration() -> display the config dialog + + """ + return + ## not yet implemented + dlg = configdialog.ConfigurationDialog(self) + for obj in (self.stderrFrame, self.stdoutFrame, self.pythonShell): + call = getattr(obj, 'configChanged', None) + if call: + self.connect(dlg, util.sigConfigChanged, call) + dlg.show() + + + def senderCheckShow(self, widget): + """ senderCheckShow(widget) -> show or hide widget if sender is checked + + """ + if self.sender().isChecked(): + widget.show() + else: + widget.hide() + + + def showMenubar(self): + """ showMenuBar() -> toggle the menu bar + + """ + self.senderCheckShow(self.menuBar()) + + + def showToolbar(self): + """ showToolbar() -> toggle the tool bar + + """ + self.senderCheckShow(self.toolBar()) + + + def showStatusbar(self): + """ showStatusbar() -> toggle the status bar + + """ + self.senderCheckShow(self.statusBar()) + + + def showConfigureKeys(self): + """ showConfigureKeys() -> show the shortcut keys dialog + + """ + ret = KKeyDialog.configure(self.actionCollection(), self) + print ret + if ret == QDialog.Accepted: + actions = self.actionCollection() + actions.writeShortcutSettings(None, appConfig()) + + + def showConfigureToolbars(self): + """ showConfigureToolbars() -> broken + + """ + dlg = KEditToolbar(self.actionCollection(), self.xmlRcFileName) + self.connect(dlg, SIGNAL('newToolbarConfig()'), self.rebuildGui) + #connect(self, sigSampleSelected, self.sourceFrame.showModuleSource) + + dlg.exec_loop() + + + def rebuildGui(self): + """ rebuildGui() -> recreate the gui and refresh the palette + + """ + self.createGUI(self.xmlRcFileName, 0) + for widget in (self.toolBar(), self.menuBar(), ): + widget.setPalette(self.palette()) + + + def sampleSelected(self): + """ sampleSelected() -> emit the current item and its module + + """ + self.stdoutFrame.clear() + self.stderrFrame.clear() + item = self.sender().currentItem() + self.emit(sigSampleSelected, (item, item.module)) + + + def setSplashPixmap(self, pixmap): + """ setSplashPixmap(pixmap) -> assimilate the splash screen pixmap + + """ + target = self.sampleFrame + label = QLabel(target) + label.setPixmap(pixmap) + target.setWidget(label) + + + def reloadModule(self, item, module): + print >> sys.__stdout__, 'reload: ', reload(module.module) + + +if __name__ == '__main__': + aboutdata = about.about() + KCmdLineArgs.init(sys.argv, aboutdata) + app = KApplication() + + splashpix = QPixmap(os.path.join(lib.samplerpath, 'aboutkde.png')) + splash = KSplashScreen(splashpix) + splash.resize(splashpix.size()) + splash.show() + mainWindow = SamplerMainWindow() + mainWindow.setSplashPixmap(splashpix) + mainWindow.show() + splash.finish(mainWindow) + app.exec_loop() diff --git a/examples/pykde-sampler/sampler.rc b/examples/pykde-sampler/sampler.rc new file mode 100644 index 0000000..fc068ca --- /dev/null +++ b/examples/pykde-sampler/sampler.rc @@ -0,0 +1,13 @@ +<!DOCTYPE kpartgui> +<kpartgui version="1" name="MainWindow" > + <MenuBar> + <Merge/> + </MenuBar> + <ToolBar noMerge="1" name="mainToolBar" > + <Action name="options_configure_toolbars" /> + <Action name="options_configure_keybinding" /> + <Action name="file_quit" /> + <Action name="help_about_kde" /> + </ToolBar> + <ActionProperties/> +</kpartgui> diff --git a/examples/pykde-sampler/wizards/__init__.py b/examples/pykde-sampler/wizards/__init__.py new file mode 100644 index 0000000..63472b4 --- /dev/null +++ b/examples/pykde-sampler/wizards/__init__.py @@ -0,0 +1,2 @@ +iconName = 'wizard' +labelText = 'Wizards' diff --git a/examples/pykde-sampler/wizards/wiz.py b/examples/pykde-sampler/wizards/wiz.py new file mode 100644 index 0000000..1cb5544 --- /dev/null +++ b/examples/pykde-sampler/wizards/wiz.py @@ -0,0 +1,2 @@ +iconName = 'wizard' +labelText = 'Wizard' diff --git a/examples/pykde-sampler/xwin/__init__.py b/examples/pykde-sampler/xwin/__init__.py new file mode 100644 index 0000000..f9ff0b1 --- /dev/null +++ b/examples/pykde-sampler/xwin/__init__.py @@ -0,0 +1,18 @@ +labelText = 'X Windows Features' +iconName = 'kcmx' + +helpText = """KDE and PyKDE allow interaction with the X Window system. Check +out the nifty samples below.""" + +from qt import QFrame, QLabel, QVBoxLayout + +class MainFrame(QFrame): + def __init__(self, parent=None): + QFrame.__init__(self, parent) + layout = QVBoxLayout(self) + self.text = QLabel(helpText, self) + layout.addWidget(self.text, 1) + + + + |
