Kapitel 4. Information for udviklere og avancerede brugere

Indholdsfortegnelse

Reference til DCOP-grænseflade

KFortune tilbyder, som mange andre KDE-programmer, en DCOP-grænseflade som gør det muligt at styre en del af funktionen fra f.eks. et skalscript.

For at bruge DCOP-funktionerne, kan du enten bruge kommandolinjeprogrammet dcop, eller det behageligere program Kdcop. Begge sørger for samme funktioner, så det er mest en smagssag og brugsområde hvilket der vælges.

Dette kapitel antager at du bruger kommandolinjeprogrammet dcop. For at få adgang til KFortune's DCOP-funktioner, skal du sørge for at KFortune er startet, og derefter indskrives noget i retning af følgende på en kommandolinje:

% dcop kfortune-X KFortuneWindow [funktion]
        

Bemærk

Hvis en fejlmeddelelse vises, som fortæller for dig at dcop ikke blev fundet eller ikke kunne køres, så sørg for at den binære fil dcop findes i $KDEDIR/bin, og at denne mappe er i din $PATH. Sørg også for at rettighederne for filen er rigtigt indstillede (så du kan køre filen).

På kommandolinjen, erstattes blot “X” med det rigtige nummer for KFortune-processen og “[funktion]” med de respektive navne på funktioner som du vil kalde.

Reference til DCOP-grænseflade

Foruden de generelle DCOP-funktioner som er tilgængelige for alle KDE-programmer, så har KFortune følgende funktioner, som er specifikke for programmet.

currentFortune

Returnerer den nuværende spådoms tekst.

Eksempel:

% echo `kfortune-31754 KFortuneWindow currentFortune`
                                        
nextFortune

Beder KFortune om at vise en ny spådom.

Eksempel:

% dcop kfortune-31754 KFortuneWindow nextFortune