Anhang A. Informationen für Entwickler und fortgeschrittene Benutzer

Inhaltsverzeichnis

DCOP-Referenz

KNewsTicker enthält eine umfangreiche DCOP-Schnittstelle. Dies ist nicht nur für die Kommunikation mit anderen Anwendungen notwendig, sondern ermöglicht auch die Steuerung von KNewsTicker über ein Shellskript. Je mehr die Schnittstelle ausgearbeitet ist, desto umfangreicher sind die Steuerungsmöglichkeiten.

Um diese DCOP-Funktionen zu nutzen, können Sie entweder den Befehldcop oder das komfortablere Programm KDCOP verwenden. Beide sind funktionell gleich, also entscheidet lediglich der Geschmack.

In diesem Kapitel wird angenommen, dass das Befehlszeilenprogramm DCOP verwendet wird, um KNewsTickers DCOP-Funktionen zu verwenden. Sie müssen zunächst KNewsTicker starten und dann das Folgende an der Konsole eingeben:

% dcop knewsticker KNewsTicker [function]

Anmerkung

Erscheint eine Fehlermeldung, die besagt, dass dcop nicht gefunden oder ausgeführt werden kann, sollten Sie überprüfen, ob die Datei dcop im Ordner $KDEDIR/bin existiert und die korrekten Rechte gesetzt sind.

In dieser Befehlszeile ersetzen Sie einfach „[Funktion]“ mit dem entsprechenden Funktionsnamen, z. B.

% dcop knewsticker KNewsTicker updateNews

um KNewsTicker nach neuen Nachrichten suchen und diese bei Bedarf herunterladen zu lassen.

DCOP-Referenz

In diesem Abschnitt werden alle Methoden beschrieben, die über die DCOP-Schnittstelle von KNewsTicker erreichbar sind.

updateNews

Mit dieser Funktion wird KNewsTicker veranlasst, die interne Artikelliste zu aktualisieren (also die Liste der eingerichteten Nachrichtenquellen nach Neuigkeiten zu durchsuchen) und diese bei Bedarf herunterzuladen.

Anmerkung

Das funktioniert auch, wenn KNewsTicker gerade im Offline-Modus ist.

Beispiel:

% dcop knewsticker KNewsTicker updateNews

reparseConfig

Die Funktion reparseConfig lässt KNewsTicker die Einrichtung aus der Einrichtungsdatei erneut einlesen. Diese Funktion wird vom Einrichtungsdialog verwendet, aber Sie können sie auch selbst verwenden, wenn die Konfigurationsdatei von Hand geändert wurde.

Tipp

Die Einstellungen befinden sich in ~/.kde/share/config/knewsticker_appletrc

Beispiel:

% dcop knewsticker KNewsTicker reparseConfig

setOfflineMode [bool]

Diese Funktion wird zum Aktivieren oder Deaktivieren des Offline-Modus verwendet (das heißt, ob KNewsTicker die eingerichteten Nachrichtenquellen nach neuen Nachrichten absuchen soll).

Beispiel:

% dcop knewsticker KNewsTicker setOfflineMode true

um den Offline-Modus zu aktivieren, oder geben Sie Folgendes ein:

% dcop knewsticker KNewsTicker setOfflineMode false

um den Offline-Modus zu deaktivieren.

interval

Gibt das augenblicklich eingestellte Intervall der Nachrichtenquellenabfrage in Minuten zurück.

Beispiel:

% dcop knewsticker KNewsTicker interval
                        30
                        %

Geschwindigkeit des Lauftextes

Gibt die derzeit eingestellte Lauftextgeschwindigkeit zurück. Es wird das Zeitintervall für die Bewegung in Pixel pro Millisekunden ausgegeben.

Beispiel:

% dcop knewsticker KNewsTicker scrollingSpeed
                        20
                        %

mouseWheelSpeed

Gibt die Anzahl der Pixel an, um die der Lauftext bei einem Schritt des Mausrades verschoben wird.

Beispiel:

% dcop knewsticker KNewsTicker mouseWheelSpeed
                        15
                        %

scrollingDirection

Gibt eine ganze Zahl zurück (Integer), die die Richtung des Lauftextes angibt:

1 = nach links
2 = nach rechts
3 = aufwärts
4 = abwärts
5 = aufwärts, rotiert
6 = abwärts, rotiert

Beispiel:

% dcop knewsticker KNewsTicker scrollingDirection
                        1
                        %

customNames

Gibt entweder ‚true‘ oder ‚false‘ aus, je nachdem, ob KNewsTicker benutzerdefinierte Namen für Nachrichtenquellen verwendet oder nicht.

Beispiel:

% dcop knewsticker KNewsTicker customNames
                        false
                        %

endlessScrolling

Gibt entweder ‚true‘ oder ‚false‘ aus, je nachdem ob die Option für endlosen Lauftext in KNewsTicker aktiviert ist.

Beispiel:

% dcop knewsticker KNewsTicker endlessScrolling
                        true
                        %

scrollMostRecentOnly

Gibt entweder ‚true‘ oder ‚false‘ aus, abhängig davon, ob im Lauftext von KNewsTicker augenblicklich nur die aktuellste Schlagzeile jeder Nachrichtenquelle anzeigt.

Beispiel:

% dcop knewsticker KNewsTicker scrollMostRecentOnly
                        false
                        %

offlineMode

Gibt entweder ‚true‘ oder ‚false‘ zurück, abhängig davon, ob KNewsTicker gerade im Offline-Modus ausgeführt wird.

Beispiel:

% dcop knewsticker KNewsTicker offlineMode
                        false
                        %

underlineHighlighted

Gibt entweder ‚true‘ oder ‚false‘ zurück, abhängig davon, ob KNewsTicker so eingerichtet ist, das die unter dem Mauszeiger befindliche Schlagzeile unterstrichen wird oder nicht.

Beispiel:

% dcop knewsticker KNewsTicker underlineHighlighted
                        true
                        %

showIcons

Gibt entweder ‚true‘ oder ‚false‘ zurück, abhängig davon, ob KNewsTicker augenblicklich so eingerichtet ist, dass das Symbol der Nachrichtenquelle vor jeder Schlagzeile angezeigt wird.

Beispiel:

% dcop knewsticker KNewsTicker showIcons
                        true
                        %

slowedScrolling

Gibt entweder ‚true‘ oder ‚false‘ zurück, abhängig davon, ob bei KNewsTicker die Funktion „verlangsamter Lauftext“ aktiviert ist.

Beispiel:

% dcop knewsticker KNewsTicker slowedScrolling
                        false
                        %

foregroundColor

Gibt die augenblicklich eingestellte Vordergrundfarbe als Text im Format „#rrggbb“ zurück. Dabei sind „rr“, „gg“ und „bb“ zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.

Beispiel:

% dcop knewsticker KNewsTicker foregroundColor
                        #804000
                        %

backgroundColor

Gibt die augenblicklich eingestellte Hintergrundfarbe als Text im Format „#rrggbb“ zurück. Dabei sind „rr“, „gg“ und „bb“ zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.

Beispiel:

% dcop knewsticker KNewsTicker backgroundColor
                        #0030ff
                        %

highlightedColor

Gibt die augenblicklich eingestellte Hervorhebungsfarbe als Text im Format „#rrggbb“ zurück. Dabei sind „rr“, „gg“ und „bb“ zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.

Beispiel:

% dcop knewsticker KNewsTicker highlightedColor
                        #000080
                        %

newsSources

Gibt eine Liste der registrierten Nachrichtenquellen zurück. Hierbei werden alle Nachrichtenquellen zurückgegeben, nicht nur die ausgewählten Quellen. In der Ausgabe wird der Name jeder Nachrichtenquelle in einer eigenen Zeile ausgegeben.

Beispiel:

% dcop knewsticker KNewsTicker newsSources
                        Freshmeat
                        GNOME News
                        dot.kde.org
                        Slashdot.org
                        %