1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
<?xml version="1.0" encoding="UTF-8" ?>
<sect1 id="dcop-interface">
<sect1info>
<title>&DCOP;-funktioner</title>
</sect1info>
<title>&DCOP;-funktioner</title>
<para>&kommander; började med att komma åt grafiska komponenter internt med &DCOP;, vilket utvecklades till komponentfunktioner. &DCOP; är fortfarande tillgängligt och kan användas för att dela information mellan dialogrutor. Det kan också användas för att utöka och integrera nästan alla befintliga KDE-program. &DCOP; kan anropas på flera sätt i &kommander;. Det första är terminalmetoden. Öppna en &kommander;-dialogruta och en terminal, och pröva det här. </para>
<note><para>Detta är till största delen fokuserat på den gamla tolken. Om du letar efter interna grafiska komponentfunktioner, se <link linkend="new_parserdocs">den nya tolken</link>. Informationen här är särskilt relevant för kommunikation mellan dialogrutor och program, eller när andra skriptspråk används inne i Kommander för skript.</para></note>
<screen>dcop | grep kmdr
dcop `dcop | grep kmdr`
dcop `dcop | grep kmdr` KommanderIf
</screen>
<para>Det visar vilka dialogrutor som kör, och vilka gränssnitt som är tillgängliga, samt vad som är tillgängligt att anropa i det särskilda gränssnittet för interna funktioner i &kommander;. Vid förklaringen av &DCOP; här, kom ihåg att &DCOP; används internt av KDE-program (ersatt av D-Bus i KDE 4) och är mycket användbart. Ta en titt på <command>kdcop</command> genom att trycka på Alt+F2 och skriva det i kördialogrutan. Här kan du utforska allt som kör. Nu åter till &DCOP; i &kommander;. </para>
<screen>dcop kmdr-executor-@pid KommanderIf setText minKomponent <quote>ny text</quote>
</screen>
<para>Det här antar att du är inne i en &kommander; fil och har tillgång till specialvärdet @pid, som innehåller process-id. Det är i själva verket enklare att ersätta <quote>kmdr-executor-@pid</quote> med @dcopid. Du kan dock använda syntaxen (men förstås utan specialvärden) från kommandoraden eller vilket externt skript som helst för att ändra &kommander;-fönstret. </para>
<para>&kommander; utvecklade den mycket snabbare interna &DCOP;-funktionen. Att använda den från ett annat programfönster (&DCOP; via terminalen är mycket långsamt) är mer komplicerat, eftersom du måste ange mycket information, inklusive anropets prototyp. Anropet ovan skulle bli (observera att @dcopid i själva verket är internt till dialogrutan, men det skulle kunna ersättas med giltigt processid): </para>
<screen>@dcop(@dcopid, KommanderIf, <quote>enableWidget(TQString, bool)</quote>, komponent, true)
</screen>
<para>I tidiga versioner av &kommander; använde lokala &DCOP;-anrop inne i skriptspråkstrukturer (som <application>bash</application>) anrop med terminalmetoder. <emphasis>Om du använder intern &DCOP; körs alla &kommander; specialvärden först och därefter körs skriptet.</emphasis> Läs föregående mening igen, eftersom det kommer att ge dig många sorger och bekymmer med en <application>bash</application>-snurra som använder &kommander;-specialvärden. </para>
<para>Det finns ett nytt förenklat sätt att använda &DCOP; inne i &kommander; genom att använda en objektsyntax. Låt oss anta att du vill ändra texten i den grafiska komponenten @Radeditor1. Det skulle se ut så här: </para>
<screen>@Radeditor1.setText(Ny text)
</screen>
<para>Som du kan se är den nya syntaxen mycket enkel, samt visuellt överensstämmande med funktionsgrupper. Alla &DCOP;-referenser här använder den nya objektsyntaxen som listas ovan. <emphasis>Observera att om du hänvisar till en grafisk komponent via &DCOP; från ett annat fönster eller ett annat program är den första parametern alltid komponentnamnet. Alla funktioner listas här med början från den andra parametern.</emphasis> </para>
<sect2 id="dcop-globals">
<title>&DCOP; för globala variabler</title>
<variablelist>
<varlistentry>
<term>global(TQString variabelnamn)</term>
<listitem>
<para>Returnerar den angivna globala variabelns värde. När ett skript körs från ett fönster i &kommander; upphör alla (icke-globala) variabler som anges i skriptet att existera efter skriptet är färdigt, och är därför inte tillgängliga för andra skriptprocesser eller i en ny instans av den anropande processen. Det globala <quote>omfattningen</quote> betyder att variabeln existerar för alla fönstrets processer ända till fönstret stängs. Du kan ändra variablerna när som helst med ett nytt anrop till <function>@setGlobal</function>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>setGlobal(TQString variabelnamn, TQString värde)</term>
<listitem>
<para>Skapar en variabel som är global i fönsterprocessen och tilldelar värdet till den. Värdet kan hämtas med global(TQString variabelnamn) eller tilldelas igen. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="dcop-all">
<title>&DCOP; för alla grafiska komponenter</title>
<para>Följande lista är gammal, och finns bara kvar i referenssyfte. Titta i <emphasis>funktionsbläddraren</emphasis> för en fullständig och aktuell referens till alla grafiska komponentfunktioner, som är tillgänglig från alla texteditorfönster i &kommander; genom att klicka på knappen längst ner till vänster. De är nu komponentfunktioner, inte &DCOP;-funktioner, men &DCOP;-funktionerna är publicerade i &DCOP;-gränssnittet <emphasis>KommanderIf</emphasis> som beskrivs ovan. Dialogrutor för att lista och skapa anrop till dessa funktioner är tillgängliga på vår webbplats. </para>
<variablelist>
<varlistentry>
<term>setText(TQString text)</term>
<listitem>
<para>Det här tar bort texten som visas i den grafiska komponenten och ersätter den med den angivna texten. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>enableWidget(bool aktivera)</term>
<listitem>
<para>Aktiverar eller inaktiverar en grafisk komponent. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>associatedText</term>
<listitem>
<para>Returnerar texten som är associerad med den angivna grafiska komponenten. Det är inte samma som texten som visas. Det skulle vara <quote>@widgetText</quote> eller texten och/eller skriptet som används för att erhålla det visade värdet. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>setAssociatedText(TQString text)</term>
<listitem>
<para>Det här tilldelar den förvalda strängen för &kommander; text. Den tilldelas typiskt värdet <quote>@widgetText</quote> för att visa vad som skrivs in i komponenten. Det är inte troligt att du har mycket nytta av det, men om du gör det finns det där. Gäller alla grafiska komponenter som kan innehålla data. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="dcop-box">
<title>&DCOP; för listrutor och kombinationsrutor</title>
<variablelist>
<varlistentry>
<term>addListItem(TQString objekt, int index)</term>
<listitem>
<para>Lägger till ett objekt i en listruta på angivet index. Listindex börjar på noll. För att lägga till i slutet på listan, använd -1. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>addListItems(QStringList objekt, int index)</term>
<listitem>
<para>Det här lägger till en stränglista på en gång. Listan ska avdelas av nyrader (\n - nyrader). Det är bekvämt eftersom du kan använda bash för att ganska enkelt få fram listan. Att till exempel använda @exec(s -l ~/projects | grep kmdr) som objekt, ger en kataloglistning med &kommander; filer i din projektkatalog. Listindex börjar med 0. Använd -1 för att lägga till sist i listan. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>addUniqueItem(TQString objekt)</term>
<listitem>
<para>addUniqueItem lägger till ett objekt i slutet på listan, men bara om det är unikt. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>clearList</term>
<listitem>
<para>Tar bort alla objekt. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>removeListItem(int index)</term>
<listitem>
<para>Tar bort objektet vid angivet index. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>item(int index)</term>
<listitem>
<para>Returnerar texten för objektet på angivet index. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>setCurrentListItem(int index)</term>
<listitem>
<para>Tilldela nuvarande (eller markerat) objekt till angivet index. Gäller de grafiska komponenterna listruta och kombinationsruta. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="dcop-button">
<title>&DCOP; för kryssrutor och alternativknappar</title>
<variablelist>
<varlistentry>
<term>setChecked(TQString komponentnamn, bool markerad)</term>
<listitem>
<para>Markerar/avmarkerar en kryssruta eller alternativknapp. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="dcop-tab">
<title>&DCOP; for flikkomponenter</title>
<variablelist>
<varlistentry>
<term>setCurrentTab(TQString komponentnamn, int index)</term>
<listitem>
<para>Väljer fliken med index för flikkomponenter. Index börjar med 0. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
|
