diff options
Diffstat (limited to 'tde-i18n-sv/docs/tdewebdev/kommander/extending.docbook')
| -rw-r--r-- | tde-i18n-sv/docs/tdewebdev/kommander/extending.docbook | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/tde-i18n-sv/docs/tdewebdev/kommander/extending.docbook b/tde-i18n-sv/docs/tdewebdev/kommander/extending.docbook index 8a0604eff06..8e3978fffac 100644 --- a/tde-i18n-sv/docs/tdewebdev/kommander/extending.docbook +++ b/tde-i18n-sv/docs/tdewebdev/kommander/extending.docbook @@ -31,36 +31,36 @@ class KomLineEdit : public KLineEdit, public KommanderWidget { TQ_OBJECT - TQ_PROPERTY(QString populationText READ populationText WRITE setPopulationText DESIGNABLE false) + TQ_PROPERTY(TQString populationText READ populationText WRITE setPopulationText DESIGNABLE false) TQ_PROPERTY(QStringList associations READ associatedText WRITE setAssociatedText DESIGNABLE false) TQ_PROPERTY(bool KommanderWidget READ isKommanderWidget) public: - KomLineEdit(QWidget *a_parent, const char *a_name); + KomLineEdit(TQWidget *a_parent, const char *a_name); ~KomLineEdit(); - virtual QString widgetText() const; + virtual TQString widgetText() const; virtual bool isKommanderWidget() const; virtual void setAssociatedText(const QStringList&); virtual QStringList associatedText() const; - virtual QString currentState() const; + virtual TQString currentState() const; - virtual QString populationText() const; - virtual void setPopulationText(const QString&); + virtual TQString populationText() const; + virtual void setPopulationText(const TQString&); public slots: - virtual void setWidgetText(const QString &); + virtual void setWidgetText(const TQString &); virtual void populate(); protected: void showEvent( QShowEvent *e ); signals: void widgetOpened(); - void widgetTextChanged(const QString &); + void widgetTextChanged(const TQString &); }; </screen> <para>Det mesta av detta är bara mallkod som du inte behöver bry dig om. De enda två saker du måste försäkra dig om är att filen kommanderwidget.h inkluderas längst upp, och att klassen först härleds från komponenten vi önskar integrera med &kommander; och därefter från KommanderWidget. </para> <para>Det finns några delar i cpp-filen som är viktiga för varje enskild komponent. </para> -<screen>KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) +<screen>KomLineEdit::KomLineEdit(TQWidget *a_parent, const char *a_name) : KLineEdit(a_parent, a_name), KommanderWidget(this) { QStringList states; @@ -70,23 +70,23 @@ signals: } </screen> <para>Vi anger tillstånden komponenten kan ha i konstruktorn. Vår radeditor har ingen form av tillstånd, så vi ger den bara tillståndet <emphasis>default</emphasis>. Om du skapar en komponent som har olika tillstånd, som en kryssruta, kan du ange tre tillstånd <emphasis>unchecked</emphasis>, <emphasis>semichecked</emphasis> och <emphasis>checked</emphasis> här. </para> -<screen>QString KomLineEdit::currentState() const +<screen>TQString KomLineEdit::currentState() const { - return QString("default"); + return TQString("default"); }</screen> <para>Vi angav tillstånden i konstruktorn ovan, och detta returnerar bara komponentens nuvarande tillstånd. För vår komponent är det alltid <emphasis>default</emphasis>, men du bör lägga till kod här som kontrollerar vilket tillstånd komponenten för närvarande har, och returnerar lämplig sträng här. </para> -<screen>QString KomLineEdit::widgetText() const +<screen>TQString KomLineEdit::widgetText() const { return KLineEdit::text(); } -void KomLineEdit::setWidgetText(const QString &a_text) +void KomLineEdit::setWidgetText(const TQString &a_text) { KLineEdit::setText(a_text); emit widgetTextChanged(a_text); } </screen> -<para>Detta är de två viktigaste metoderna, där den största delen av koden som utgör funktionen finns. Metoden <emphasis>QString KomLineEdit::widgetText() const</emphasis> returnerar komponenttexten (texten som <emphasis>@widgetText</emphasis> expanderas till i textassociationer). Komponenttexten i vår komponent är helt enkelt texten i radeditorn, så vi returnerar den. På liknande sätt, när komponenttexten ändras, ändrar vi bara texten i radeditorn. Vi skickar signalen <emphasis>widgetTextChanged()</emphasis> efter komponenttexten har ändrats, så att andra komponenter kan får reda på det faktum att komponenten har uppdaterats. </para> +<para>Detta är de två viktigaste metoderna, där den största delen av koden som utgör funktionen finns. Metoden <emphasis>TQString KomLineEdit::widgetText() const</emphasis> returnerar komponenttexten (texten som <emphasis>@widgetText</emphasis> expanderas till i textassociationer). Komponenttexten i vår komponent är helt enkelt texten i radeditorn, så vi returnerar den. På liknande sätt, när komponenttexten ändras, ändrar vi bara texten i radeditorn. Vi skickar signalen <emphasis>widgetTextChanged()</emphasis> efter komponenttexten har ändrats, så att andra komponenter kan får reda på det faktum att komponenten har uppdaterats. </para> <para>För att lägga till funktioner i komponenten, måste du registrera några funktioner och lägga till kod för att hantera dem. Här är koden som används för att registrera dem. Lägg den i början av cpp-filen, ovanför konstruktorn. </para> <screen>#include <tdelocale.h> // för i18n @@ -99,16 +99,16 @@ enum Functions { Function2, LastFunction }; -KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) +KomLineEdit::KomLineEdit(TQWidget *a_parent, const char *a_name) : KLineEdit(a_parent, a_name), KommanderWidget(this) { ... // kod som beskrivs ovan KommanderPlugin::setDefaultGroup(Group::DCOP); - KommanderPlugin::registerFunction(Function1, "function1(QString widget, QString arg1, int arg2)", i18n("Call function1 with two arguments, second is optional."), 2, 3); - KommanderPlugin::registerFunction(function2, "function2(QString widget)", i18n("Get a QString as a result of function2."), 1); + KommanderPlugin::registerFunction(Function1, "function1(TQString widget, TQString arg1, int arg2)", i18n("Call function1 with two arguments, second is optional."), 2, 3); + KommanderPlugin::registerFunction(function2, "function2(TQString widget)", i18n("Get a TQString as a result of function2."), 1); } </screen> -<para>Detta registrerar två funktioner: <emphasis>function1 och function2</emphasis> Numren som tilldelas funktionerna (här <emphasis>1160</emphasis> och <emphasis>1161</emphasis>) måste vara unika, och inte användas av några andra insticksprogram eller inne i &kommander;. <emphasis>function1</emphasis> har två argument, ett valfritt, <emphasis>function2</emphasis> har inget argument och returnerar en sträng. Argumentet <emphasis>QString widget</emphasis> i signaturerna anger att funktionerna arbetar med en grafisk komponent, som: <emphasis>KomLineEdit.function1("komponent", 1)</emphasis>. </para> +<para>Detta registrerar två funktioner: <emphasis>function1 och function2</emphasis> Numren som tilldelas funktionerna (här <emphasis>1160</emphasis> och <emphasis>1161</emphasis>) måste vara unika, och inte användas av några andra insticksprogram eller inne i &kommander;. <emphasis>function1</emphasis> har två argument, ett valfritt, <emphasis>function2</emphasis> har inget argument och returnerar en sträng. Argumentet <emphasis>TQString widget</emphasis> i signaturerna anger att funktionerna arbetar med en grafisk komponent, som: <emphasis>KomLineEdit.function1("komponent", 1)</emphasis>. </para> <para>För att lära &kommander; att komponenten stöder dessa funktioner, lägg till en metod på följande sätt: </para> <screen>bool KomLineEdit::isFunctionSupported(int f) { @@ -116,7 +116,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) } </screen> <para>Det betyder att KomLineEdit stöder funktionerna ovan, och den vanliga funktionen <emphasis>text</emphasis>. Funktionskoden ska hanteras inne i metoden handeDCOP: </para> -<screen>QString KomLineEdit::handleDCOP(int function, const QStringList& args) +<screen>TQString KomLineEdit::handleDCOP(int function, const QStringList& args) { switch (function) { @@ -132,7 +132,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) default: return KommanderWidget::handleDCOP(function, args); } - return QString::null; + return TQString::null; } </screen> <para>Det finns tillfällen då komponenten ska se annorlunda ut i editorn än när den körs, vilket är fallet för skriptobjekt, om-dialogruta, etc. Den vanliga lösningen är att visa en QLabel istället för komponenten. För att göra det måste komponenten härledas från QLabel, och använda följande i konstruktorn: </para> @@ -147,7 +147,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) setHidden(true); </screen> <para>Du kan skapa själva komponenten (om en komponent över huvud taget behövs, kanske "komponenten" bara tillhandahåller funktioner för att t.ex. komma åt en databas) i en av dina funktioner, som i funktionen <emphasis>execute</emphasis>. Här är ett exempel från komponenten om-dialogruta: </para> -<screen>QString AboutDialog::handleDCOP(int function, const QStringList& args) +<screen>TQString AboutDialog::handleDCOP(int function, const QStringList& args) { switch (function) { ... @@ -184,7 +184,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) { public: MyKomPlugin(); - virtual QWidget *create( const QString &className, QWidget *parent = 0, const char *name = 0 ); + virtual TQWidget *create( const TQString &className, TQWidget *parent = 0, const char *name = 0 ); }; </screen> <para>Därefter skapar vi delklassen KommanderPlugin som kallas <emphasis>MyKomPlugin</emphasis>. Klassen har helt enkelt en konstruktor och den överskridna metoden create. </para> @@ -196,7 +196,7 @@ public: </screen> <para>I insticksprogrammets konstruktor, anropar vi <emphasis>addWidget()</emphasis>för varje komponent vi vill tillhandahålla i insticksprogrammet. <emphasis>addWidget()</emphasis> har sex argument, men bara de fyra första krävs. I ordning är argumenten, komponentklassens namn, grupp, verktygstips, en ikonuppsättning för ikonen som används i editorns verktygsrad, vad är det här-information, och en Boolean som anger om komponenten är omgivande komponent för andra komponenter eller inte. Informationen används av editorn när komponenten grupperas i menyer, tillhandahåller hjälpinformation, etc. </para> <para>När det gäller ikonen, så laddar exemplet ovan en ikon av medelstorlek som kallas <emphasis>iconname</emphasis> från &kde;:s vanliga ikonplats. </para> -<screen>QWidget *MyKomPlugin::create( const QString &className, QWidget *parent, const char *name ) +<screen>TQWidget *MyKomPlugin::create( const TQString &className, TQWidget *parent, const char *name ) { if( className == "KomLineEdit" ) return new KomLineEdit( parent, name ); @@ -251,7 +251,7 @@ void WidgetDatabase::setupDataBase( int id ) <screen>... #include "mywidget.h" ... -QWidget *WidgetFactory::createWidget( const QString &className, QWidget *parent, const char *name, bool init, +TQWidget *WidgetFactory::createWidget( const TQString &className, TQWidget *parent, const char *name, bool init, const QRect *r, Qt::Orientation orient ) { ... |