Appendiks A. Information for udviklere og avancerede brugere

Indholdsfortegnelse

DCOP-Reference

Nyhedstelegrafen sørger for en DCOP-grænseflade, som er ganske omfattende, og stadigt voksende. Dette bruges ikke kun til at kommunikere med andre programmer, men gør det også muligt at kontrollere nyhedstelegrafen med et skal-script. Desto mere grænsefladen udvides, jo mere nyttigt bliver den og jo mere fleksible bliver mulighederne for at kontrollere nyhedstelegrafen fra et script.

For at bruge disse DCOP-funktionerne kan du kalde kommandolinjeprogrammet dcop eller bruge det bekvemmere program KDCOP. Begge sørger for samme funktionalitet, så det er kun en spørgsmål om smag når det gælder hvilket program du foretrækker. :-)

Dette kapitel antager at du bruger kommandolinjeprogrammet dcop. For at komme til nyhedstelegrafens DCOP-funktioner, så sørg for at nyhedstelegrafen er startet og skriv derefter blot noget lignende i terminalen:

% dcop knewsticker KNewsTicker [funktion]

Bemærk

Hvis en fejlmeddelelse vises som siger at dcop ikke kunne findes eller køres, kontrollér om filen dcop findes i mappen $KDEDIR/bin og sørg for at rettighederne er rigtigt indstillede.

På kommandolinjen, erstattes “[funktion]” med et tilsvarende funktionsnavn, dvs. skriv

% dcop knewsticker KNewsTicker updateNews

for at få nyhedstelegrafen at kigge efter opdaterede nyheder og hente dem om nødvendigt.

DCOP-Reference

I dette afsnit er en liste af alle metoder som er tilgængelige via nyhedstelegrafens DCOP-grænseflade.

updateNews

Denne funktion tvinger nyhedstelegrafen til at opdatere den interne liste over artikler (dvs. den spørger de indstillede nyhedskilder efter opdaterede nyheder) og henter dem når det behøves.

Bemærk

Dette virker også hvis nyhedstelegrafen er i frakoblet tilstand.

Eksempel:

% dcop knewsticker KNewsTicker updateNews

reparseConfig

Kommandoen reparseConfig får nyhedstelegrafen til at genindlæse sine indstillinger fra konfigurationsfilen. Denne funktion bruges af indstillingsdialogen til at tale med nyhedstelegrafen, men du kan bruge den hvis du har ændret konfigurationsfilen i hånden.

Vink

Konfigurationsfilen gemmes i ~/.kde/share/config/knewsticker_appletrc

Eksempel:

% dcop knewsticker KNewsTicker reparseConfig

setOfflineMode [bool]

Du kan kalde denne funktion for at angive om nyhedstelegrafen er i nedkoblet tilstand for øjeblikket (dvs. hvis nyhedstelegrafen skal spørge de indstillede nyhedskilder efter opdaterede nyheder).

Eksempel:

% dcop knewsticker KNewsTicker setOfflineMode true

for at aktivere nedkoblet tilstand.

% dcop knewsticker KNewsTicker setOfflineMode false

for at deaktivere nedkoblet tilstand.

interval

Returnerer det nuværende indstillede interval mellem nyhedsforespørgsler i minutter.

Eksempel:

% dcop knewsticker KNewsTicker interval
                        30
                        %

scrollingSpeed

Returnerer nuværende indstillede rullehastighed. Intervallet som teksten rulles med i billedpunkter returneres i billedpunkter pr sekund.

Eksempel:

% dcop knewsticker KNewsTicker scrollingSpeed
                        20
                        %

mouseWheelSpeed

Returnerer antallet af billedpunkter som den rullende tekst flyttes for hvert trin på musehjulet.

Eksempel:

% dcop knewsticker KNewsTicker mouseWheelSpeed
                        15
                        %

scrollingDirection

Returnerer et heltal som svarer til retningen som den rullende teksten bevæger sig:

1 = Til venstre
2 = Til højre
3 = Opad
4 = Nedad
5 = Opad, roteret
6 = Nedad, roterer

Eksempel:

% dcop knewsticker KNewsTicker scrollingDirection
                        1
                        %

customNames

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen bruger egne navn for nyhedskilder.

Eksempel:

% dcop knewsticker KNewsTicker customNames
                        false
                        %

endlessScrolling

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen har funktionen uendelig rulning aktiveret.

Eksempel:

% dcop knewsticker KNewsTicker endlessScrolling
                        true
                        %

scrollMostRecentOnly

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen for øjeblikket kun viser de seneste overskrifter for hver nyhedskilde.

Eksempel:

% dcop knewsticker KNewsTicker scrollMostRecentOnly
                        false
                        %

offlineMode

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen er i nedkoblet tilstand.

Eksempel:

% dcop knewsticker KNewsTicker offlineMode
                        false
                        %

underlineHighlighted

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen er blevet bedt om at understrege overskrifter som for øjeblikket er under musemarkøren.

Eksempel:

% dcop knewsticker KNewsTicker underlineHighlighted
                        true
                        %

showIcons

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen viser ikonen for nyhedskilden hvor hver enkelt overskrift publiceredes foran overskriften.

Eksempel:

% dcop knewsticker KNewsTicker showIcons
                        true
                        %

slowedScrolling

Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen har funktionen “langsom rulning” aktiveret.

Eksempel:

% dcop knewsticker KNewsTicker slowedScrolling
                        false
                        %

foregroundColor

Returnerer den for øjeblikket indstillede forgrundsfarve, som en streng på formatet “#rrggbb”, hvor “rr”, “gg” og “bb” er to cifres hexadecimale værdier som repræsenterer intensiteten for den røde, grønne og blå komponent på en skala fra 00 til ff.

Eksempel:

% dcop knewsticker KNewsTicker foregroundColor
                        #804000
                        %

backgroundColor

Returnerer den for øjeblikket indstillede baggrundsfarve, som en streng på formatet “#rrggbb”, hvor “rr”, “gg” og “bb” er to cifres hexadecimale værdier som repræsenterer intensiteten for den røde, grønne og blå komponent på en skala fra 00 til ff.

Eksempel:

% dcop knewsticker KNewsTicker backgroundColor
                        #0030ff
                        %

highlightedColor

Returnerer den for øjeblikket indstillede fremhævningsfarve, som en streng på formatet “#rrggbb”, hvor “rr”, “gg” og “bb” er to cifres hexadecimale værdier som repræsenterer intensiteten for den røde, grønne og blå komponent på en skala fra 00 til ff.

Eksempel:

% dcop knewsticker KNewsTicker highlightedColor
                        #000080
                        %

newsSources

Returnerer listen over nyhedskilder som for øjeblikket er registrerede. Bemærk at dette returnerer alle nyhedskilder, ikke kun de valgte. I udskriften, skrives navnet på hver nyhedskilde på en linje.

Eksempel:

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

forrige	hjem
Ordforklaring	op