Brugerdefinerede handlinger

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:

At oprette handlinger

Du kan oprette en handling ved at vælge Opsætning->Indstil handlinger . Klik på Ny handling og du får en ny dialog at se:

Type: Angiver handlingens type (Tekst, Mærke, Script).
Tekst: Den del af handlingens navn som er synlig for brugeren
Knappen nær ved Tekst etiketten.: Ikonen der tildeles til denne handling. Klik på den for at ændre den aktuelle ikon.
Værktøjsvink: Kort beskrivelse af hvad handlingen gør.
Genvejstast: 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.
Værktøjslinjebeholdere: De brugerdefinerede værktøjslinjer, hvor handlingen foregår. Se “Opret værktøjslinjer”.
Detaljerede indstillinger: Specifikke indstillinger for en anden type handlinger. Se herunder

Teksthandlinger

De simpleste handlinger. Du kan indtaste noget tekst i Detaljerede indstillinger-feltet og så snart handlingen udføres, bliver denne tekst indsat i dit dokument ved den aktuelle markørposition. Se herunder for et eksempel.

Mærkehandlinger

Brugbar til at indsætte XML-mærker, men selvfølgelig kan du også indsætte dem til andre formål.

<mærke>: Navnet på mærket.
</mærke>: 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.
Kør "Redigér mærke"-dialogen hvis den er til rådighed: 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.

<Mærke> og </mærke> bliver indsat som du har skrevet det her. <, > eller /-tegnet bliver ikke automatisk vedhæftet.

Scripthandlinger

Den mest kraftfulde handlingstype. Ved hjælp af denne handling kan du køre eksterne programmer (normalt scripter, men ikke begrænset til dette), som kan ændre dit dokument eller bruge dit dokument (eller en del af det) som inddata. Eksempler fra Quanta Plus selv er Hurtigstart-dialogen, de forskellige Vis i... handlinger til (X)HTML DTEP'er.

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

Der er andre specielle variable du kan bruge på kommandolinjen:

%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:
Første argument
Scriptets entydige identifikation
Andet argument
begivenhedsnavnet
Tredje argument
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.

Du kan specificere hvad der skal ske med teksten udskrevet til stdout. Dette kan gøres ved at ændre værdien i Uddata kombinationsfeltet:

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