[AutoIT][Scite]Calltips und Syntax Highlighting

Eigene Calltips und eigenes Syntax Highlighting in Scite
_____________________________________________

�bersicht

Vorwort
�ndern der Userfiles
1. Erstellen eines Calltips
2. Text Highlighting eines Calltips
Erstellen eigener Configfiles
1. �nderen der Properties

1. Vorwort

Ein neues Tutorial von mir! Diesmal geht es darum wie man Scite beibringen
kann, das man gerne seine eigene Funktion auch gerne als Calltip h�tte.
Wie das geht seht ihr gleich und lasst mich sagen es ist wirklich einfach ;)

Ein kurzes FAQ f�r jene, die noch Fragen offen haben:

Was ist ein Calltip?
Ein Calltip ist eine Art Notizzettel f�r eine Funktion!
Er zeigt euch auf einen Blick, noch w�hrend ihr die Funktion schreibt, welche Parameter die Funktion besitzt und was diese �berhaupt macht.
.
Was bedeutet Syntax Highlighting?
Syntax Highlighting bedeutet, dass man bestimmte W�rte wie zum Beispiel IF besonders makiert. Das kann wie in den Satz zuvor geschehen indem man einfach das Wort fett schreibt, oder aber auch indem das Wort farbig makiert zB rot.
In den meisten F�llen wird jedoch beides benutzt.
.
Was zur H�lle ist Scite?
Scite ist eine Entwicklungsplattform f�r unteranderen die beliebte Scriptsprache AutoIT.
F�r weitere Informationen:
Google is your friend ;)

2. �ndern der Userfiles

2.1 Erstellen eines Calltips

Scite ist was das Andern der Configs angeht zwar nicht sehr benutzerfreundlich zu uns, gibt uns jedoch eine "offiziele" M�glichkeit eigene Calltips zu erstellen.
�ffnet die folgende Datei mit Scite

Code:

[COLOR="Red"]Scite\Api\au3.user.calltips.api[/COLOR]

Sollte die Datei nicht existieren, erstellt sie.

In dem Ordner Api werden alle Datein gespeichert die was mit Calltips zu tuen haben.
In der Datei au3.user.calltips.api stehen alle
Calltips, die von Usern erstellt worden sind.

Schreibt in die Datei folgendes und speichert dann:

Code:

_test("string",nummer,$variable)Das ist eine Testfunktion

So nun probiert dochmal in einem AutoItScript _test zu schreiben. Huch ist euch Scite zuvorgekommen?

2.2 Text Highlighting eines Calltips

So mit einen Calltip geben wir uns nat�rlich nicht zu Frieden.
Wir wollen diesen Calltip nat�rlich noch einf�rben.
�ffnet jetzt die Datei(mit Scite):

Code:

[COLOR="Red"]Scite\Properties\au3.userudfs.properties[/COLOR]

Sollte sie nicht existieren, erstellt sie.

Diese Datei nimmt die gleiche Rolle wie die au3.user.calltips.api ein, jedoch ist sie f�r Farben zust�ndig.
Schreibt nun in die Datei:

Code:

au3.keywords.user.udfs= _test

Jede Funktion nach den = bekommt nun die Farbe der UDF Funktionen.
Wollt ihr eine weitere Funktion schreiben h�ngt ihr diese einfach dran.
F�r ein Absatzt benutzt ihr ein \.

Nat�rlich k�nnen wir auch auf andere Farben zugreifen:

Code:

[COLOR="Navy"]au3.keywords.functions= [/COLOR] [COLOR="SeaGreen"];normale Funktionen[/COLOR]
[COLOR="Blue"]au3.keywords.keywords= [/COLOR]  [COLOR="SeaGreen"];W�rter wie: If,While,Endif,for,Dim.....[/COLOR]
[COLOR="Magenta"]au3.keywords.macros= [/COLOR]    [COLOR="SeaGreen"];Makros wie zB: @autoitversion[/COLOR]
[COLOR="Orange"]au3.keywords.sendkeys= [/COLOR]  [COLOR="SeaGreen"];Speziele Keys wie: {enter}, {F1}....[/COLOR]

3. Erstellen eigener Configfiles

3.1 �nderen der Properties

In der 2. Section haben wir glerent welche Files wir �ndern m�ssen, damit Scite unsere Funktionen erkennt. Aber wenn wir zum Beispiel eine UDF schreiben ist ein einziger File eher ungew�nscht. Damit keine Calltips von anderen UDFs gel�scht werden, m�sste der User die Calltips per Copy and Past eintragen. Dies ist jedoch oft zu kompliziert, daher gibt es auch eine M�glichkeit um eigene Files zu verwenden.

Bennent eure Files, die ihr oben erstellt oder ver�ndert habt, um, zB:

Code:

au3.user.calltips.api ---> au3.meineUDF.calltips.api
au3.user.calltips.api ---> meineUDF.calltips.api
au3.user.calltips.api ---> meineUDF.api
------------------------------------------------------
au3.userudfs.properties ---> au3.meineUDF.properties
au3.userudfs.properties ---> meineUDF.properties

Wie ihr die Datei nacher nennt ist egal solange die Dateiendung stimmt. Jedoch sollte der �bersicht zu liebe das Format beibelassen werden.

Nachdem ihr dies getan habt, startet Scite neu und guckt nach ob die Funktion _test noch ein Calltip hat. Wenn doch, versichert euch das eure alten Dateien wirklich umbenannt oder gel�scht sind.

Ruft nun folgende Datei mit Scite auf:

Code:

[COLOR="Red"]Properties\au3.properties[/COLOR]

F�gt am Ende folgendes ein:

Code:

[COLOR="MediumTurquoise"]#Eure UDF Import:[/COLOR]
import properties\au3.eureUDF

Damit wird die Datei mit den Properties also zB mit den Farbeinstellungen importiert, sie hie� urspr�nglich au3.eureUDF.properties. Das .properties wird jedoch im Code weggelassen.

Um unsere eigentlichen Calltips jedoch zu importieren m�sst ihr in Zeile
286 folgendes anh�ngen:

Code:

;$(SciteDefaultHome)\api\au3.eureUDF.calltips.api

Das ganze scheint zwar etwas aufw�ndiger, aber es separiert eure Calltips und l�sst sich leichter mit einen Programm �berw�ltigen, welches diese Aktionen f�r euch tut.

Schlu�wort

Ich hoffe euch hat das Tutorial gefallen und ihr konntet etwas lernen.
Falls noch Fragen offen sind: :rtfm:
Solltet ihr jedoch wirklich verzweifeln stellt sie einfach in den Thread.

MfG

Xereon