Brugerdefinerede handlinger |
forrige | Udvidelse af Quanta Plus | næste |
Handlinger er meget hyppige i alle programmer. Du møder dem ofte når du bruger enhver applikation. Et klik på en værktøjslinjeikon, valg af en menuindgang eller brug af en genvejstast udfører normalt en handling. I Quanta Plus er handlinger videreført til næste niveau. Istedet for fastlagte handlinger (som er defineret af forfatteren af programmet på kildekodeniveau), er det muligt for den almindelige bruger at oprette og modificere handlinger og på den måde indføre ny funktionalitet i Quanta Plus. Det er de brugerdefinerede handlinger og mange af standardhandlingerne i Quanta Plus er brugerdefinerede (og mulige at ændre af brugeren) handlinger også.
Der er tre slags brugerdefinérbare handlinger:
Du kan oprette en handling ved at vælge -> . Klik på og du får en ny dialog at se:
Den del af handlingens navn som er synlig for brugeren
Ikonen der tildeles til denne handling. Klik på den for at ændre den aktuelle ikon.
Kort beskrivelse af hvad handlingen gør.
Genvejstasten der tildeles denne handling. Klik på Brugerdefineret eller knappen tæt på Brugerdefineret for at tildele en genvejstst til handlingen. Klik på Ingen for at fjerne den aktuelle tildelte genvejstast.
De brugerdefinerede værktøjslinjer, hvor handlingen foregår. Se “Opret værktøjslinjer”.
Specifikke indstillinger for en anden type handlinger. Se herunder
Brugbar til at indsætte XML-mærker, men selvfølgelig kan du også indsætte dem til andre formål.
Navnet på mærket.
Hvis afkrydset når handlingen udføres bliver denne tekst indsat som et lukke-mærke. Hvis der er markeret et område i dokumentet før du udfører handlingen, bliver <mærket> indsat før det markerede område og </mærke> efter.
Hvis afkrydset og der er en mærkeXML-fil til dette mærke, vises der en mærkeredigeringsdialog før mærket indsættes i dokumentet så du kan finjustere mærkeegenskaberne først.
Først skal du indtaste navnet på dit script og også fortolkeren. Eksempel: sh /home/minhjemmemappe/mitscript.sh.
Selvom du kan bruge fuldstændige stier, er den anbefalede måde at bruge %scriptdir variablen på kommandolinjen således sh %scriptdir/mitScript.sh. På den måde vil Quanta Plus forsøge at lokalisere dit script de følgende steder:
global scriptmappe: $KDEDIR
/share/apps/quanta/scripts
local scriptmappe: $KDEHOME
/share/apps/quanta/scripts
din sti: $PATH
%f: erstattes af adressen på det aktuelle dokument. I fald det er lokale dokumenter bilver file:/ fjernet fra dokumentet.
%input: bliver erstattet med den valgte inddata. Se herunder.
%projectbase:bliver erstattet med adressen på det aktuelle projekt. Er den tom bliver intet projekt indlæst.
%pid: bliver erstattet med PID af den kørende Quanta Plus-proces. Hvis Quanta Plus kører i unik-tilstand, mode, the "unique " teksten foranstillet PID-nummeret. Brugbart når du bruger DCOP til at kontrollere Quanta Plus fra det eksterne script.
%userarguments: Nyttigt i tilfældet med begivenheder. Indgangen erstattes af begivenhedens egenskaber i følgende rækkefølge:
Scriptets entydige identifikation
begivenhedsnavnet
begivenhedens parameter, oftest det nuværende dokuments filnavn eller søgestien til projektfilen.
Udover de ovennævnte metoder, kan scriptet modtage inddata fra Quanta Plus via stdin. I Indata kombinationsfeltet kan du vælge hvad der skal sendes til stdin. Valgene er:
Ingen: intet sendes til scriptet.
Aktuelt dokument: hele dokumentet sendes til scriptet.
Markeret tekst: det markerede tekstområde i dokumentet sendes til scriptet. At bruge %input variablen giver nomalt kun mening når man bruger denne indstilling.
I samme stil som Inddata kan du fange uddata fra den udførte applikation. Der er to slags uddata:
normal uddata, udskrevet til stdout;
fejlmeddelelser, udskrevet til stderr.
Ingen: applikationens uddata ignoreres.
Indsæt ved markørposition: uddata indsættes i det aktuelle dokument ved markørpositionen.
Erstat markering: det markerede område i dokumentet erstattes med uddata.
Erstat markering: det markerede område i dokumentet erstattes med uddata.
Opret et nyt dokument: et nyt dokument bliver oprettet og indeholder scriptets uddata.
Erstat aktuelt dokument: hele dokumentet erstattes med uddata.
Beskedvindue: uddata vises i Beskeder værktøjsvisningen.
Valgene for stderr uddata (Fejl) er det samme som for normal uddata.
forrige | hjem | næste |
Udvidelse af Quanta Plus | op | Opret værktøjslinjer |