Der Script-Editor

Die Liste Script im Navigator ,   Script in den Text einfügen ,
Script in einen Verweis einfügen , Script in eine Grafik einfügen ,
Eigenschaften von Scripts ändern , Erweiterte Scripteinstellungen ,
Stamm-Script ins Projekt laden , Neues Script erstellen Allgemein ,
HTML-Script erstellen , Hilfe-Makro erstellen ,
Stamm-Script erstellen , Platzhalter in Stamm-Scripts ,
Syntax für Feld-HTML ,

vorige Seite

nächste Seite

    Mit dem Script Editor haben Sie ein Werkzeug, mit dem Sie Scripts aller Arten sehr komfortabel verwalten und editieren können.
    Sie können auf eine Vielzahl vorgefertigter Scripts, sowohl für HTML als auch für WinHelp, in der Stammscriptdatenbank zurückgreifen, oder beliebig viele eigene Scripts anlegen. Ein einmal angelegtes Script kann dann wie gewohnt ganz einfach auf die Seite gezogen oder in Grafiken, Formularelemente, Verweise etc. eingefügt werden.
    Ein Script kann sehr Umfangreich sein, und z.B Java Funktionen in die Head, Body oder den HTML-Bereich der Seite einfügen. Es kann bei Bedarf aber auch nur eine einfache HTML-Erweiterung für ein Objekt beinhalten, um z.B dessen Name oder ID festzulegen.
    Den Umgang mit Scripts die über umfangreiche Einstellmöglichkeiten verfügen, können Sie durch hinzufügen einer HTML-Help Projects spezifischen Syntax vereinfachen.

Nach oben   Die Liste Script im Navigator

    Alle Scripts werden im Projektnavigator unter "Script" verwaltet:

Jedes Script ist einer Gruppe zugeordnet. Hier z.B Warp der Gruppe "Java-Applet". Hierdurch erhöht sich die Übersichtlichkeit erheblich.
Sie können beliebig viele Gruppen anlegen und weitere Scripts in beliebigen Gruppen ablegen.


Sie aktivieren die Liste direkt mit der Maus oder über F8. Mit + klappen Sie eine Gruppe auf , mit - klappen Sie eine Gruppe zu.

Um ein Script an der aktuellen Position einzufügen wählen Sie die rechte Maustaste und dann "Neues Script" HTML-Help Projects erzeugt einen neuen Eintrag und öffnet den Script-Editor.


Nach oben   Script in den Text einfügen

    Um ein Script an der aktuellen Cursorposition einzufügen gibt es mehrere Möglichkeiten.

    1. Wählen Sie die Stelle, an der ein Script eingefügt werden soll. Ziehen Sie mit der Maus das Script aus dem Projektnavigator über den Editor und lassen Sie dort die Maustaste los.
    2. Wählen Sie die Stelle, an der ein Script eingefügt werden soll. Wählen Sie aus dem Menü "Einfügen" den Menüpunkt "Script", oder betätigen Sie F11. Der Projektnavigator ist jetzt aktiv. Wählen Sie mit den Pfeiltasten das Script aus und betätigen Sie die Leertaste.
    3. Wählen Sie zunächst mit der Maus ein Script im Projektnavigator an. Klicken Sie dann auf die Stelle im Text, an der ein Script eingefügt werden soll. Wählen Sie dann in der Toolbar VerweisUndObjekte den Button Scripttoolb aus.

Nach oben   Script in einen Verweis einfügen

    Um einem Verweis ein Script hinzuzufügen öffnen Sie das Eigenschaftenfenster zum Verweis und ziehen ein Script in das Feld "Script im Verweis Tag". zur genauen Erklärung  
    Ein Beispiele für ein im Verweis integriertes Script wäre z.B eine
    OnClick Anweisung. In den Stammscripts finden Sie z.B unter JavaScript-Frames das Script FrameButtonG auch dieses können Sie in einen Verweis einfügen Zusätzlich zum Sprung auf das Verweisziel wird mit diesem z.B. noch eine Frame ganz nach unten gescrollt.

 

Nach oben Script in eine Grafik einfügen

    Um einer Grafik ein Script hinzuzufügen öffnen Sie das Eigenschaftenfenster zur Grafik und ziehen ein Script in das Feld "Script im Image Tag". zur genauen Erklärung  
    Auch hier könnte z.B
    eine OnClick Anweisung hinzugefügt werden.
    In den Stammscripts finden Sie z.B unter Java-
    JavaApplet-Bildmanipulation viele Scripts, die Sie in eine Grafik ziehen können. Die Grafik wird durch diese meist verfremdet, oder um Besondere Effekte erweitert.

 

Nach oben Eigenschaften von Scripts ändern

    Zum ändern von Scripts wählen Sie dieses durch Doppelklick an, oder bringen Sie den Cursor neben dieses und betätigen "F4" (Eigenschaften).
    HTML-Help Projects öffnet folgendes Fenster  

Script ändern
ziehen sie das neue Script aus dem Navigator in das Feld Name.

OderAuswahlicon:

  1. betätigen Sie wenn der Cursor im Feld "Name" steht die Taste F4
  2. wählen Sie das neue Script in der Liste an
  3. betätigen Sie die Leertaste

Script löschen
Wählen Sie Löschen, das Fenster wird geschlossen und das Script ist gelöscht.

    Nicht in Web-Seite / Nicht in HTML-Hilfe:
    Sie können wählen, ob das Script auf der Web-Seite oder in der HTML-Hilfe nicht
    erscheinen soll.

    HTML-Code:
    HTML-Help Projects zeigt Ihnen hier genau den HTML-Code an der später in die Seite eingefügt wird. Der HTML-Code besteht aus dem Eintrag "Script" im Script Editor.

    Hinweis Einen eventuellen Eintrag in der Head oder Body Section, den dieses Script vornimmt können Sie hier nicht sehen. Gehen Sie hierzu in den Script-Editor, indem Sie das Feld "Name" anwählen und zweimal F4 betätigen.

    HTML-Code nicht ändern:
    Wählt den Direkt-HTML Modus. Der HTML-Code wird nicht mehr verändert, bzw. kann manuell eingegeben werden.

Nach oben   Erweiterte Scripteinstellungen

    Wenn Sie im vorigen Eigenschaftendialog im Feld Name stehen und zweimal die Taste F4 betätigen können Sie das aktuelle Script im Scripteditor bearbeiten.

    Bei vielen bereits vordefinierten Scripts können Sie die Eigenschaften zum Script unter Einstellungen zum Script sehr einfach auswählen, ohne dass Sie sich in den Quelltext einlesen müssen.
    Bei Bedarf können Sie aber auch jederzeit den Quelltext selbst ändern, oder die Liste Einstellungen zum Script erweitern.

    Arbeiten mit der Liste Einstellungen zum Script:

    Hinweis Für die folgenden Erläuterungen wurde das Script ScrollMenue aus der Stammscriptdatenbank in das Projekt geladen, in eine Seite gezogen und wie weiter oben angegeben über zweimal F4 im Scripteditor zur Anzeige gebracht.
    Sie finden das Script in den Stammscripts unter Java / JavaScript / Steuerleisten.

    In der ersten Spalte finden Sie jeweils Hinweise um welche Einstellungen es sich handelt.
    Bei unserem ScrollMenü haben wir Allgemeine Einstellungen zum Script und die Menüpunkte.

    Die zweite Spalte ist normalerweise leer. Sie finden dort lediglich das Zeichen "->", wenn Sie einen Einstellungsbereich beliebig verfielfachen können.
    Dies ist z.B beim ScrollMenü bei den Menüpunkten der Fall. Sie können beliebig viele Menüpunkte hinzufügen, indem Sie ein Feld mit dem Zeichen "->" anwählen, und dann mit der rechten Maustaste "AddLoop" wählen.
    Geben Sie dann jeweils die Beschriftung (Caption) der neuen Menüpunkte ein und verknüpfen Sie über F4 jeweils die Zielseite.

    In der dritten Spalte wird der Eintrag zum Script definiert. Um hier Werte zu ändern, wählen Sie den Eintrag an und betätigen Sie dann die Leertaste. Je nachdem was für ein Eingabewert erwartet wird, stellt HTML-Help Projects eine Auswahlliste z.B für Zahlenauswahl, Farbauswahl etc. bereit.

    In der vierten Spalte ist ein Hinweis zum Einstellwert definiert. Wenn der Einstellwert über eine Verknüpfung in den Projektnavigator herzustellen ist, dann finden Sie hier den Hinweis F4. Zum definieren dieser Einträge also F4 wählen, das Ziel oder das Objekt aus der Liste auswählen und dann mit der Leertaste übernehmen.

    scriptaddloop

    Pop-Up Menü im Einstellungsfenster:
    Die vorige Grafik zeigt die Liste mit den Einstellungen zum Script ScrollMenü bei angewähltem Farbauswahlfeld und betätigter rechter Maustaste.
    AddLoop:
    Hinzufügen von Einstellungsbereichen. Im obigen Beispiel z.B weitere Menüpunkte anlegen.
    DelLoop:
    Löschen von zuvor hinzugefügten weiteren Einstellungsbereichen.
    Reset Liste:
    Stellt die Einstelliste auf Ihre Startwerte zurück und löscht alle mit AddLoop hinzugefügten Einträge.
    Farbformat:
    Je nach Script werden die Farbwerte in den verschiedensten Formaten verlangt. Die bereits angelegten Scripts in der Stammdatenbank sind auf die richtige Farbformatierung eingestellt. Wenn Sie eigene Scripts anlegen, können Sie hier das Farbformat für jedes Eingabefeld, das eine Farbe erwartet einzeln einstellen.


    Hinweis wenn Sie in dieser Einstelliste Verknüpfungen zu Grafiken oder Multimedia Dateien herstellen, sorgt HTML-Help Projects automatisch dafür, dass diese Dateien ins Zielprojektverzeichnis kopiert werden.

Nach oben   Stamm-Script ins Projekt laden:

    HTML-Help Projects bietet Ihnen die Möglichkeit Scripts, die Sie immer wieder benötigen als Stamm-Script anzulegen, diese können in jedes beliebige Projekt geladen werden.

    Alle Stammscripts und zugehörige Dateien werden im Verzeichnis programmverzeichnis\scripts gespeichert. Das anlegen eines Stammscripts ist identisch mit dem eines neuen Scripts für das Projekt. Das Stamm-Script wird lediglich in der Liste Stamm-Script im Scripteditor eingetragen.
    Um die vorhandenen Stammscripts anzuzeigen wählen Sie im Menü Datei den Punkt Stammscript laden oder ic-stamm.

    li-stamm

Jedes Stammscript ist einer Gruppe zugeordnet. Hier z.B "Sound abspielen" der Gruppe "Helpcompiler/Win-Help/Multimedia". Hierdurch erhöht sich die Übersichtlichkeit erheblich.
Sie können beliebig viele Gruppen anlegen und weitere Scripts in beliebigen Gruppen ablegen.


Sie aktivieren die Liste direkt mit der Maus nach Anwahl des Menüpunktes Stamm-Script laden. Mit + klappen Sie eine Gruppe auf , mit - klappen Sie eine Gruppe zu.

Mit la-stamm laden Sie das aktuell angewählte Stammscript in Ihr Projekt. Sie können hierbei bei Bedarf noch den Namen anpassen.
Den neuen Eintrag finden Sie dann im Projektnavigator in der Liste Script.

Wählen Sie den neuen Eintrag im Projektnavigator an und definieren Sie nun, sofern vorhanden die "Einstellungen zum Script". Anschließend können Sie das Script wie gewohnt in den Editor ziehen.

    HTML-Help Projects wir mit einer Vielzahl von vorbereiteten Stamm-Scripts ausgeliefert, alle Scripts sind direkt lauffähig und müssen nur ins Projekt übernommen und in eine Seite eingefügt werden.

    Hinweis Bitte beachten Sie, daß viele JavaScripts nur dann frei verwendet werden dürfen, wenn die Copyrighthinweise nicht entfernt werden. Also löschen Sie diese bitte nicht. Außerdem ist Ihnen jeder Autor dankbar, wenn Sie einen Link auf seine Seite mit aufnehmen. Dies gilt übrigens auch für den Autor von HTML-Help Projects

Nach oben   Neues Script erstellen Allgemein:

    Um ein Script in Ihre Seiten einfügen zu können, müssen Sie dieses einmalig in das Projekt laden, bzw ein neues erstellen. Ein neues Script erstellen Sie, indem Sie bei aktiviertem Projektnavigator die Liste Script auswählen und anschließend im Menü Bearbeiten "Neues Script" wählen. HTML-Help Projects öffnet den Script-Editor, in welchem Sie Ihr neues Script eintragen können.
    Für die folgenden Erläuterungen wurde das Script ScrollMenue aus der Stammscriptdatenbank in das Projekt geladen.

    Name aktuelles Script:
    Der von Ihnen angegebene Name, der auch in der Liste
    Script erscheint. Sie ändern diesen, indem Sie im Projektnavigator die Bezeichnung ändern.

    Allgemein:
    Eine kurze Anmerkung zum Script kann hier angegeben werden. Dieser Text wird nicht in den HTML-Code eingebunden.

    Demo:
    Sie können im Internet eine Vielzahl von Scripts laden, welche Sie frei für Ihre Seiten verwenden können. Oftmals liegen Java Applets oder Scripts Info-Dateien bei, in welchen weitere Infos zum Script oder zu Script-Parametern enthalten sind.
    Über ".." können Sie einen Verweis auf eine solche Seite hinzufügen. Über den Button "Demo" können Sie die Seite dann aufrufen.
    demoscript Wenn der Button Demo aktiv ist, liegt eine Infoseite vor, auf welcher Sie weitere Infos einsehen können.


    Hinweis Teilweise handelt es sich bei den Scripts (vor allem Java) in der Stammscriptdatenbank um reine Demos, das heißt, Sie müssen, wenn Sie das entsprechende Script auf Ihrer Seite letztendlich einsetzen wollen, dieses beim jeweiligen Programmierer registrieren.

    Über den Button ".." können Sie für das aktuelle Script die Demoseite oder Infoseite selbst angeben.

    Einstellungen zum Script:
    In dieser Tabelle können Sie Einstellungen zum Script vornehmen.
    Für das geladene ScrollMenü kann hier z.B ganz einfach die Position und Farbe angegeben werden.
    Außerdem können die Menüpunkte und Verweisziele hier ganz übersichtlich definiert werden.
    Sie können Menüpunkte hinzufügen und entfernen und die Verweisziele wie gewohnt über F4 aus dem Projektnavigator auswählen. Lesen Sie mehr hierzu im Absatz Scripteinstellungen.

    Hinweis Wenn Sie soeben ein neues Script angelegt haben, können Sie hier noch keine Eingaben vornehmen.
    Wenn Sie ein Script aus der Stammscriptdatenbank in das Projekt geladen haben, können Sie hier direkt Einstellungen vornehmen.
    In diesem Einstellungsfenster können Sie nur Einstellungen für Scripts vornehmen, die um eine HTML-Help Projects spezifische Syntax erweitert wurden. Mehr hierzu im Absatz Stammscripts definieren.

    Hinweistext bzw. Copyright:
    Hinweise oder Copyrighttexte des Autors können Sie hier von Hand eintragen oder über den Button".." laden.
    Für die bereits angelegten Stammscripts finden Sie hier eventuelle Copyright Hinweise.

    Platzhalter im Editor:
    Wenn es sich um ein Script handelt, das frei im Text platziert wird, wie z.B unser ScrollMenü, dann empfiehlt es sich über ".." eine Grafik auszuwählen, die als Platzhalter dient.
    Im Menü Bearbeiten haben Sie außerdem die Möglichkeit den
    Platzhalter
      - aus der Zwischenablage zu laden.
      - über die Capture Funktionen vom Bildschirm zu übernehmen. (Siehe hierzu Wie kann ich.. Capture Funktion
    )

    Außerdem können Sie den Platzhalter löschen. Wenn Sie den Platzhalter löschen verwendet HTML-Help Projects eine Standardgrafik als Platzhalter.
    Über den Button "E" wird der aktuell eingestellte Platzhalter in Ihrem Grafikprogramm geöffnet, so dass Sie dort ebenfalls noch Änderungen an dieser vornehmen können.



    Hinweis
    Web-HTML und HTML-Help Projekte

    Die hier verwendete Grafik erscheint im Editor als Platzhalter. Erstellen, Sie ein HTML-Projekt und verwenden HTML oder Javascripts, dann wird nicht die Grafik in Ihre Seite eingebunden, sondern der Script-Code, der zu dieser Anzeige führt.
    Win-Help Projekte

    Die hier verwendete Grafik ist im Hilfefenster sichtbar, sofern das Script direkt in den Text eingefügt wird, wird das Script in eine Grafik, oder als Startscript beim Seitenaufruf eingebunden, ist die Grafik nicht zu sehen.

    Info:
    Zeigt für das aktuelle Script an, wo es eingefügt werden sollte. Es macht z.B keinen Sinn, wenn ein Script zum manipulieren einer Grafik in den Text eingefügt wird. Die hier vorgenommenen Einstellungen sind nur zur Information und erscheinen nicht im Zielprojekt oder im Editor.

    Script:
    Das eigentliche Script wird unter den Reitern HTML-Script und Hilfe-Makro notiert.
    Wenn Sie ein Web-HTML Projekt oder HTML-Help Projekt erstellen ist der Reiter HTML-Script relevant.
    Sie werden in diesem Fall HTML-Tags oder verschiedene Script-Sprachen verwenden.
    Sehen Sie hierzu in der Stammscriptdatenbank nach, in der bereits viele Beispiele definiert sind.

    Hinweis Wenn Sie ein Win-Help Projekt erstellen ist der Reiter Hilfe-Makro relevant.
    Sie werden in diesem die verfügbaren Win-Help Makros verwenden.
    Sehen Sie hierzu in der Stammscriptdatenbank nach, in der alle Win-Help Makros bereits definiert sind.

    Tip Sie können unter HTML-Script und Hilfe-Makro Einträge vornehmen, wenn Sie aus Ihrem Projekt heraus beide Zielprojekte erstellen wollen und Sie für das aktuelle Script in beiden Scriptsprachen einen Quelltext haben..

Nach oben HTML-Script erstellen:

    Um ein Script auf einer HTML-Seite einzufügen bedarf es meist mehrerer Einträge an verschiedenen Stellen im HTML-Gerüst. Wir unterscheiden zwischen Head, Body und Texteinträgen.
    Außerdem sind teilweise für die Funktion noch sogenannte Class Dateien nötig, die die Funktion überhaupt erst ermöglichen.
    html-script
    Das zum besseren Verständniss geladene Script ScrollMenü belegt lediglich den Textbereich.


    Eintrag in Head Section:
    Tragen Sie in dieses Feld den Teil des Scripttextes ein, der in die Head-Section eingefügt werden muß. Dieser Teil steht also zwischen <head> und </head> der HTML-Seite. Verwenden Sie aber nur den reinen Script Eintrag ohne <head> und </head>.

    Eintrag in Body-Tag:
    Tragen Sie in dieses Feld den Teil des Scripttextes ein, der in die Body-Section eingefügt werden muß. Dieser Teil steht also im <body> Tag der HTML-Seite.

    Eintrag im HTML-Text bzw. Objekt:
    Der Teil des Scripts, welcher im Text eingefügt werden muß, bzw. der in ein Objekt-Tag eingetragen werden soll.

    Script Abschlußtag:
    Wenn Sie ein Script notieren, mit welchem z.B ein Textbereich formatiert werden soll, dann können Sie hier das Abschlußtag definieren.

      z.B haben Sie im Feld HTML-Text
        <div ............>   notiert.

    Dann müssen Sie unter Abschlußtag

          </div> eintragen, damit der Browser weis, dass der definierte Bereich hier zu ende ist.

    In allen anderen Fällen lassen Sie dieses Feld bitte leer.

    Script benötigt folgende Laufzeitdateien:
    Oft werden, für ein Script bestimmte Dateien benötigt, damit dieses überhaupt funktionsfähig ist. Hierzu zählen z.B Klangdateien, Videodateien, Grafikdateien, Java-class Dateien etc.

    Mit dem Button ".." wird ein Dateiauswahl geöffnet und Sie können dem Script beliebige Dateien anhängen. Diese Dateien werden nach projektverzeichnis\scriptsp kopiert. Beim erstellen einer Seite in welchem sich das Script befindet, werden diese Dateien automatisch in das Verzeichniss der Seite kopiert. Ihr Script ist also wenn es einmal angelegt ist, ohne weiteres zutun auf jeder Seite einfügbar und sofort lauffähig.

    Hinweis Grafik und Multimediadateien, die Sie unter dem Reiter Allgemein in den Einstellungen angeben können, werden automatisch in Ihr Projektverzeichnis kopiert, Sie müssen diese Dateien also hier nicht zusätzlich eintragen.

    Übrigens: Sie können jedes Script beliebig oft auf beliebigen Seiten einfügen.

Nach oben Hilfe-Makro erstellen:

Nur relevant, wenn Sie ein Win-Help Projekt erstellen wollen

    Für die folgenden Erläuterungen habe ich das Script Sound abspielen aus der Stammscriptdatenbank in das Projekt geladen.
    Dieses Hilfe Makro spielt ein WAV File ab.

    Hinweis Um Multimedia Dateien abzuspielen müssen Sie bei HTML-Help Projects keine Makros programmieren. Sie können diese wie gewohnt unter Objekte anlegen und einfach auf die Seite ziehen. HTML-Help Projects fügt alle nötigen Einträge automatisch in die Hilfedatei ein.

    Auch bei der Win-Help Hilfe sind meist Einträge an verschiedenen Stellen nötig. So wird der eigentliche Makro-Text in den Seitentext eingefügt.
    In der Config-Section der Projektdatei muss oftmals zusätzlich die Funktion eingetragen werden und schließlich müssen die benötigten Dateien in das Projektzielverzeichnis kopiert werden, oder direkt in die Hilfedatei integriert werden. (HTML-Help Projects erledigt dies alles für Sie)

    Das zum besseren Verständniss geladene Makro Sound abspielen belegt den Textbereich und nimmt in der Config-Section der Projektdatei einen Eintrag vor..

    Makro:
    Tragen Sie in dieses Feld das eigentliche Makro ein.

    Initialisierung in der Config Section:
    Tragen Sie in dieses Feld den oder die Einträge ein, die in der Config-Section der Projektdatei nötig sind.

    Benötigte Dateien Baggage:
    Wählen Sie mit ".." die Dateien aus, die zum ausführen des Scripts nötig sind. (z.B) Musik oder Video Files. Die hier eingetragenen Dateien werden in die Hilfedatei integriert, somit müssen diese nicht extra mitgeliefert werden.

    Benötigte Dateien:
    Die hier eingetragenen Dateien werden nicht in die Hilfedatei integriert, somit müssen diese im gleichen Verzeichnis wie die Hilfedatei mitgeliefert werden.

    Hinweis HTML-Help Projects spielt alle benötigten Dateien in Ihr Zielprojektverzeichnis.

    Info Help:
    Hier können Sie zu Ihrer eigneen Information anwählen ab welcher Version das angelegte Makro lauffähig ist.

    Makro Testen:
    HTML-Help Projects bietet Ihnen hier die Möglichkeit ein Makro vorab zu testen.
    testmakro
    Geben Sie im Feld Makroanweisung das Makro ein und wählen Sie über ".." eine vorhandene Win-Help Hilfedatei.
    (dies kann z.B eine soeben erstellte Seitenvorschau ihrer aktuellen Seite sein.)
    Bei Bedarf können Sie noch ein Zielfenster wählen (F4) und dann mit OK das Makro starten.
    Im obigen Beispiel wird der About Dialog der Hilf gezeigt.
    Sie können in das Feld Makroanweisung natürlich auch umfangreichere Makros eintragen.

Nach oben   Stamm-Script erstellen

    Um ein neues Stamm-Script zu erstellen, laden Sie wie oben angegeben die vorhandenen Stammscripts in die Liste.
    Wählen Sie dann die passende Gruppe in der Liste an, oder erstellen Sie eine neue Gruppe für Ihr neues Script.
    Mit der rechten Maustaste kann nun über "Neuer Eintrag" ein neues Script hinzugefügt werden.

    Tip Sie können an dieser Stelle auch ein vorhandenes Script kopieren.

    Sie können nun genauso wie unter "Neues Script erstellen" beschrieben Ihr Script anlegen und mit "Übernehmen" jeweils speichern.

Nach oben   Platzhalter in Stamm-Scripts

    Es besteht die Möglichkeit in Stamm-Scripts Eingabefelder einzubauen. Diese werden später durch Werte ersetzt, die der Benutzer in der Liste Einstellungen zum Script eingeben bzw. auswählen kann.

    Das Menü zum einfügen von Eingabefeldern für HTML ist aktiv wenn Sie den Head, Body oder Textbereich eines HTML-Scripts editieren.

    Das Menü zum einfügen von Eingabefeldern für WinHelp ist aktiv wenn Sie das Makro eines Win-Help-Scripts editieren.
    Nur relevant wenn Sie ein Win-Help Projekt
    erstellen wollen

    Desweiteren können Sie in Stamm-Scripts Platzhalter eintragen. Diese werden später durch HTML-Help Projects automatisch durch die entsprechenden Werte ersetzt. Im Menü "Platzhalter HTML" kann z.B der Objektname oder die Objektbreite gewählt werden. Wenn Sie das Script später z.B in eine Grafik einfügen, wird der Platzhalter Objektname durch deren Name und der Platzhalter Objektbreite durch deren Breite ersetzt.

    Beispiel:

    Als Beispiel hier das Script WAVE aus der Stammscriptdatenbank unter Java/JavaApplet/Bildmanipulation
    Vor der Anpassung und Erweiterung mit Platzhaltern.

      <applet code=Wave.class width=30 height=45>
      <param name=image value="testimage.gif>
      <param name=horizMotion value=0.06>
      </applet>

    Wenn Sie dieses Script auf Ihre Seite einfügen müssen Sie dafür sorgen dass eine Grafik mit dem Namen testimage.gif mit den Abmessungen 30 mal 45 Pixel bereitsteht. Die Effektstärke ist fest auf 0.06 eingestellt.

    Nach der Erweiterung mit Platzhaltern

      <#ersetzen>
      <applet code=Wave.class width=<#breite> height=<#höhe>>
      <param name=image value="<#url>">
      <param name=horizMotion value=<#?>Stärke des Effektes z.B 0.03<##>>
      </applet>

    Über das Menü Einfügen Platzhalter-HTML wurde anstelle der festen Breite von 30 und Höhe von 45 Objekt-Breite und Objekt-Höhe gewählt.
    Anstelle des Filenamens "testimage.gif" wurde Objekt-URL eingefügt.
    Damit die Effektstärke auch einfach eingegeben werden kann, ohne dass jedesmal der Scripttext studiert werden muss, wurde außerdem anstelle des festen Wertes von 0.06 ein Eingabefeld definiert. Menüpunkt Einfügen/Feld-HTML/Direkte Texteingabe

    Dieses Script kann nun im Editor in eine beliebige Grafik eingefügt werden. Die Wave.class erhält jeweils die richtigen Werte für Breite und Höhe sowie den jeweiligen Filenamen.
    Die Effektstärke kann im Scripteditor in der Liste "Einstellungen zum Script" ganz einfach vorgewählt werden.

    Als Besonderheit sei hier noch der Platzhalter <#ersetzen> erwähnt.
    Normalerweise wird beim einfügen eines Scripts in ein Objekt also Grafik Multimediadatei etc. das Script in den HTML-Text eingefügt.

    Hier ein typischer HTML Code, der eine Grafik anzeigt.

      <img src="grafik/testmakro.png" alt="testmakro" width=413 height=267 border=0 name="testmakro" >

    Ohne obiges <#ersetzen> würde der HTML-Code nachdem das Script in die Grafik eingefügt wurde wie folgt aussehen.

      <img src="grafik/testmakro.png" alt="testmakro" width=413 height=267 border=0 name="testmakro"
      <applet code=Wave.class width=413 height=267>
      <param name=image value="grafik/testmakro.png">
      <param name=horizMotion value=0.06>
      </applet>
      >

    Wir hätten also sowohl den bisherigen HTML-Code für die Grafik als auch den für das Java-Applett im HTML-Quelltext.
    Da in unserem Fall aber das Java-Aplett Wave.class für die Anzeige der Grafik sorgt, können wir den Eintrag "img src=" hier nicht gebrauchen.

    Durch den Einsatz von <#ersetzen> wird HTML-Help Projects angewiesen, den kompletten HTML-Code den er normalerweise für dieses Objekt bereithält nicht zu verwenden und anstelle dessen den Code hinter <#ersetzen> zu benutzen. Womit in unserem Fall der HTML-Quellcode wie folgt aussieht.

      <applet code=Wave.class width=413 height=267>
      <param name=image value="grafik/testmakro.png">
      <param name=horizMotion value=0.06>
      </applet>

Nach oben   Syntax für Feld-HTML

    Alle im folgenden Beschriebenen Codezeilen können Sie unter Menü Einfügen direkt auswählen.

    Direkte Texteingabe:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgendes Eingabefeld definiert werden

    Syntax

Erklärung

    <#?>Hinweis<##>

    <#?> = Kennung Eingabedialog.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#?> und <##> als Hinweis angezeigt. Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte der Liste eingetragen werden..
Die gesamt Syntax von <#?> bis <##> wird durch den eingegebenen Text ersetzt.


    z.B
    Scripttext = <meta http-eqiv="Erstellt" content ="<#?>Bitte geben Sie das Erstelldatum ein<##>">

    Auswahllisten HTML:

    Syntax Auswahlliste Allgemein

Erklärung

    <#A>Hinweis(Bez1"Wert1",Bez2"Wert2",Bez3"Wert3")
    <##>

    <#A> = Kennung Auswahldialog.
    Hinweis= Beliebiger Hinweistext.
    Bez1.. Bez3 Bezeichnungen dir in der Auswahlliste erscheinen
    "Wert1" ... "Wert3" Der Text der in den HTML-Code eingefügt wird
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann verwendet werden, wenn die im weiteren aufgeführten Auswahllisten nicht geeignet erscheinen.

In der Liste "Einstellungen zum Script" wird der Text   innerhalb von <#A> und ( als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden. Die BEzeichnungen der einzelnen Werte sind in Bez1 ...Bez3 notiert, der Text der in den Quellcode eingetragen wird in "Wert1 .. "Wert3".
Die gesamt Syntax von <#A> bis <##> wird durch den ausgewählten Wert ersetzt.

    Syntax Auswahlliste Yes/No

Erklärung

    <#A>Yes/No(##yes/no##)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in vielen Scripts verwendet werden die mit yes / no bestimmte Funktionen aktivieren bzw. deaktivieren

In der Liste "Einstellungen zum Script" wird eine Yes/No Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
Die gesamt Syntax von <#A> bis <##> wird durch yes oder no ersetzt.

    Syntax Auswahlliste Nummernauswahl

Erklärung

    <#A>Nummer(##numbers##,2,10)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in vielen Scripts verwendet werden die Zahleneingaben innerhalb eines bestimmten Bereiches verlangen.

In der Liste "Einstellungen zum Script" wird eine Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
In diesem Fall eine Zahl zwischen 2 und 10.
Die gesamt Syntax von <#A> bis <##> wird durch diese Zahl ersetzt.

    Syntax Auswahlliste Zielfenster

Erklärung

    <#A>Target(##target##)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in vielen Scripts verwendet werden bei denen das Zielfenster z.B mit _self, _top, _parent, oder _blank angegeben werden kann.
    Außerdem stehen alle Fenster der angelegten Frames zur Auswahl

In der Liste "Einstellungen zum Script" wird eine Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
In diesem Fall ein Zielfenster.
Die gesamt Syntax von <#A> bis <##> wird durch diese Kennung ersetzt.

    Syntax Auswahlliste Ausrichtung

Erklärung

    <#A>Alignment(##alignment##)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in Scripts verwendet werden bei denen eine Ausrichtung left, center, right
    angegeben werden kann.

In der Liste "Einstellungen zum Script" wird eine Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
In diesem Fall eine Ausrichtung.
Die gesamt Syntax von <#A> bis <##> wird durch diese Kennung ersetzt.

    Syntax Auswahlliste Schriftart

Erklärung

    <#A>Fontname(##fontnames##)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in Scripts verwendet werden bei denen die Angabe einer Schriftart verlangt wird.

In der Liste "Einstellungen zum Script" wird eine Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
In diesem Fall ein Fontname.
Die gesamt Syntax von <#A> bis <##> wird durch diesen Namen ersetzt.

    Syntax Auswahlliste Schriftgröße

Erklärung

    <#A>Font Size(##numbers##,6,70)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in Scripts verwendet werden bei denen die Angabe einer Schriftgröße verlangt wird.

In der Liste "Einstellungen zum Script" wird eine Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
In diesem Fall eine Fontgröße.
Die gesamt Syntax von <#A> bis <##> wird durch diesen Namen ersetzt.

    Syntax Auswahlliste Framenamen

Erklärung

    <#A>Frame Name(##framename##)<##>

    <#A> = Kennung Auswahldialog.
    <##> = Kennung Ende.
    Hinweis: Diese Auswahlliste kann in Scripts verwendet werden bei denen das Zielfframe angegeben werden kann.

In der Liste "Einstellungen zum Script" wird eine Auswahlliste angezeigt.
Der zu verwendende Wert kann vom Benutzer in der zweiten Spalte in einer Auswahlliste ausgewählt werden.
In diesem Fall ein Zielframe.
Die gesamt Syntax von <#A> bis <##> wird durch diese Kennung ersetzt.

    Fileauswahl HTML:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgendes Eingabefeld definiert werden

    Syntax

Erklärung

    <#f>*.*;*.gif<##>

    <#f> = Kennung Eingabedialog.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#?> und <##> als Hinweis angezeigt. Der zu verwendende Wert kann vom Benutzer durch betätigen der Leertaste in einem Filedialog ausgewählt werden..
Die gesamt Syntax von <#f> bis <##> wird durch den Wert ersetzt.


    Auswahl Seite/Verweisziel:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgendes Eingabefeld definiert werden

    Syntax

Erklärung

    <#Sa> Seite absolut (F4)<##>
    <#Sr> Seite relativ (F4)<##>
    <#Sn> Seite Name (F4)<##>
    <#Sf> Seite Filename (F4)<##>

    <#Sx> = Kennung Auswahl Verweisziel.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#Sx> und <##> als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer durch betätigen von F4 aus der Liste Seiten ausgewählt werden.
Die gesamt Syntax von <#Sx> bis <##> wird durch den Wert ersetzt.

    Seite absolut: Fügt kpl. url ein z.B http://www.ihrserver.de/meineseite.html
    Seite relativ: Fügt die relative URL ein. (relativ zur Seite in welches dieses Script eingefügt wurde)
    Seite Name: Fügt den Namen ein, der auch in der Liste Seite angezeigt wird.
    Seite Filename: Fügt den kpl. Filenamen also z.B meineseite.html ein.

    Auswahl Objekt:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgendes Eingabefeld definiert werden

    Syntax

Erklärung

    <#Oa> Objekt Adresse absolut (F4)<##>
    <#Or> Objekt Adresse relativ (F4)<##>
    <#On> Objekt Name(F4)<##>
    <#Of> Objekt Filename(F4)<##>
    <#Ol> Objekt Filename auch in Projektfile HTML-Help(F4)<##>
    <#Oj> Objekt Filename wird durch 'path' ergänzt(F4)<##>

    <#Ox> = Kennung Auswahl Objekt.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#Ox> und <##> als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer durch betätigen von F4 aus der Liste Objekte ausgewählt werden.
Die gesamt Syntax von <#Ox> bis <##> wird durch den Wert ersetzt.

    Objekt Adresse absolut: Fügt kpl. url ein z.B http://www.ihrserver.de/grafik/meinlogo.png
    Objekt Adresse relativ: Fügt die relative URL ein. (relativ zur Seite in welches dieses Script eingefügt wurde).
    Objekt Name: Fügt den Namen ein, der auch in der Liste Objekte angezeigt wird.
    Objekt Filename: Fügt den kpl. Filenamen also z.B meinlogo.png ein.

    Die folgenden Optionen sind nur beim erstellen von HTML-Help Projekten relevant.
    Objekt Filename auch in File Section: Fügt den Namen auch in die FileSection der HTML-Help Projektdatei ein. Die Datei wird also in die Hilfedatei hineincompiliert.
    Objekt Filename wird durch 'path' auf Zielsystem ergänzt: Fügt auf dem Zielsystem zum Filenamen noch den kompletten Pfad hinzu. Die Datei ist also nicht in die Hilfedatei hineincompiliert, sondern wird extra mitgeliefert. Das Aplett etc. benötigt den kompletten Pfad. Dies ist nützlich, wenn Apletts oder Scripts nicht laufen.

    Auswahl Script:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgendes Eingabefeld definiert werden

    Syntax

Erklärung

    <#m>Bitte Script wählen (F4)<##>

    <#m>= Kennung Auswahl Script.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#m> und <##> als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer durch betätigen von F4 aus der Liste Script ausgewählt werden.
Die gesamt Syntax von <#m> bis <##> wird durch den Scriptnamen ersetzt.

    Farbauswahl:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgendes Eingabefeld definiert werden

    Syntax

Erklärung

    <#c>Bitte Farbe wählen<##>

    <#c>= Kennung Auswahl Farbe.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#c> und <##> als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer durch Auswahl aus einer Farbpalette gewählt werden.
Die gesamt Syntax von <#c> bis <##> wird durch die Auswahl ersetzt.

    Hinweis In der Liste Einstellungen zum Script kann das Format der Farbe über die rechte Maustaste festgelegt werden. So kann der Fontname, der Hex Wert der RGB Wert etc. gewählt werden.
    Die meisten Scripts verlangen den HEX Wert.


    Optionen:
    Vordefinierte häufig verwendbare HTML-Notierungen.

    Syntax

Erklärung

    name="<#?>Name<##>"
    id="<#?>ID <##>"
    href="<#S>Adresse/Verweisziel wählen (F4)<##>"
    data="<#?>Daten<##>"
    width=<#?>Breite<##>
    bgcolor=<#c>Bitte Farbe wählen<##>
    background="<#O>Bitte Objekt (Grafik) wählen (F4)<##>"

    und viele mehr

    <#c>= Kennung Auswahl Farbe.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#x> und <##> als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer eingegeben oder auch teils ausgewählt werden.
Die gesamt Syntax von <#x> bis <##> wird durch die eingabe/Auswahl ersetzt.

    Syntax

Erklärung

    name="<#?>Name<##>"
    id="<#?>ID <##>"
    href="<#S>Adresse/Verweisziel wählen (F4)<##>"
    data="<#?>Daten<##>"
    width=<#?>Breite<##>
    bgcolor=<#c>Bitte Farbe wählen<##>
    background="<#O>Bitte Objekt (Grafik) wählen (F4)<##>"

    und viele mehr

    <#c>= Kennung Auswahl Farbe.
    Hinweis= Beliebiger Hinweistext.
    <##> = Kennung Ende.

In der Liste "Einstellungen zum Script" wird der Text innerhalb von <#x> und <##> als Hinweis angezeigt.
Der zu verwendende Wert kann vom Benutzer eingegeben oder auch teils ausgewählt werden.
Die gesamt Syntax von <#x> bis <##> wird durch die eingabe/Auswahl ersetzt.

    z.B
    Scripttext = <meta http-eqiv="Erstellt" content ="<#?>Bitte geben Sie das Erstelldatum ein<##>">

    Syntax
    <#A>Hinweis(Bez1"Wert1",Bez2"Wert2",Bez3"Wert3")<##>

    Erklärung

    <#A> = Kennung Auswahldialog.  
    <##> = Kennung Ende
    Hinweis= Beliebiger Text der bei der Übernahme des Scripts in das Projekt angezeigt wird.

    wert1= Text der eingefügt wird, wenn Auswahl1 angewählt.

    wert2= Text der eingefügt wird, wenn Auswahl2 angewählt.

    wert..= Text der eingefügt wird, wenn Auswahl.. angewählt.

    Syntax

Erklärung

    <#A>Auswahlliste(Bezeichnung1"Wert1",Bezeichnung2"Wert2",Bezeichnung3"Wert3")<##>

    <#f>*.gif,*.gif<##>

    <#f> = Kennung Fileauswahldialog.

    *.gif,*.gif= Dateien mit dieser Datei-Kennung werden in der Auswahlliste angezeigt..

    <##> = Kennung Ende.

Bei der Übernahme in das Projekt wird ein Dateiauswahldialog angezeigt. Der Benutzer kann eine Datei auswählen.
Die gesamt Syntax von <#f> bis <##> wird durch den ausgewählten Filenamen ersetzt.

    Syntax

Erklärung

    <#f>*.gif,*.gif<##>

    <#f> = Kennung Fileauswahldialog.

    *.gif,*.gif= Dateien mit dieser Datei-Kennung werden in der Auswahlliste angezeigt..

    <##> = Kennung Ende.

Bei der Übernahme in das Projekt wird ein Dateiauswahldialog angezeigt. Der Benutzer kann eine Datei auswählen.
Die gesamt Syntax von <#f> bis <##> wird durch den ausgewählten Filenamen ersetzt.

    Syntax 3:
    Im Scripttext kann an beliebiger Stelle und beliebig oft folgender Auswahldialog platziert werden

    Syntax

Erklärung

    <#A>Hinweis(wert1"Auswahl1",
    wert2"Auswahl2",usw.)<##>

    <#A> = Kennung Auswahldialog.

    Hinweis= Beliebiger Text der bei der Übernahme des Scripts in das Projekt angezeigt wird.

    wert1= Text der eingefügt wird, wenn Auswahl1 angewählt.

    wert2= Text der eingefügt wird, wenn Auswahl2 angewählt.

    wert..= Text der eingefügt wird, wenn Auswahl.. angewählt.

    <##> = Kennung Ende

Bei der Übernahme in das Projekt wird ein Dateiauswahldialog angezeigt. Der Benutzer kann eine Datei auswählen.
Die gesamt Syntax von <#A> bis <##> wird durch den Wert ersetzt der zum Auswahltext gehört..


    z.B Scripttext = <marquee direction=<#A>Bitte wählen Sie die Scrollrichtung(right"rechts",left"links")<##>Inhalt</marquee>

    Bei der Übernahme ins Projekt wird ein Hinweistext angezeigt "Bitte wählen Sie die Scrollrichtung", außerdem eine Auswahlliste mit den Vorgaben "rechts" und "links"

    Wählen Sie hier z.B "links" an.
    Projektscript= <marquee direction=left >Inhalt</marquee>

    Beachten Sie hier das Schlüsselwort „Inhalt“ dieser Text wird durch den angewählten Bereich im Editor ersetzt.

    Syntax 4:
    Im Scripttext kann an beliebiger Stelle einmalig folgender Platzhalter platziert werden.

    Syntax

Erklärung

    <Tag>Inhalt</Tag>

Das Schlüsselwort Inhalt wird durch den im Editor mit diesem Script markierten Bereich ersetzt.


    Zusätzlich zu den bereits angegebenen Möglichkeiten, ein Script in die Seite einzufügen besteht noch die Möglichkeit, einen Text im Editor zu markieren und diesem Text ein Script zuzuweisen.

    HTML-Help Projects kennzeichnet diesen Text nicht, wenn Sie jedoch über einen solchen Bereich mit der Maus fahren, ändert sich der Mauszeiger.

    Findet HTML-Help Projects im Scripttext das Schlüsselwort Inhalt, dann wird dieses gelöscht und an dessen Stelle wird der im Editor angewählte Text gesetzt.

    Haben Sie z.B folgendes Script definiert.
    <marquee direction=left>Inhalt</marquee> und einem Textbereich im Editor zugewiesen, dann sieht der Text nach dem erstellen folgendermaßen aus
    <marquee direction=left>mein Textbereiche</marquee>

    (mein Textbereich wird als Lauftext definiert.)