4D Write v14

WR INSERT HYPERLINK

Home

 
4D Write v14
WR INSERT HYPERLINK

WR INSERT HYPERLINK 


 

WR INSERT HYPERLINK ( Bereich ; linkTyp ; urlStil ; linkBezeichnung ; linkInhalt ; MethRef ) 
Parameter Typ   Beschreibung
Bereich  Lange Ganzzahl in 4D Write Bereich
linkTyp  Ganzzahl in Hyperlink Typ: 0 = Methode, 1 = URL, 2 = 4D Write Dokument
urlStil  Ganzzahl in URL Darstellung: 1 = Standardstil, 0 = Eigener Stil
linkBezeichnung  Text in Sichtbarer Text des Link (Menü Anzeigen/Werte)
linkInhalt  Text in Hyperlink Wert
MethRef  Lange Ganzzahl in Wert für $3, 3. Parameter der Methode (wenn linkTyp eine Methode ist)

Der Befehl WR INSERT HYPERLINK fügt in Bereich eine “hyperlink” Referenz ein, und zwar an der Cursor-Position oder anstelle des ausgewählten Textes.

linkTyp
Der Parameter linkTyp definiert die Art des einzufügenden Hypertext Links. 4D Write läßt drei Arten zu: Links vom Typ Methode, Links vom Typ URL und Links vom Typ Dokument.

  • Ein Link vom Typ Methode führt eine 4D Methode aus, wenn auf die Referenz geklickt wird. Die Methode kann keine Funktion sein, es kann auch kein Parameter übergeben werden. Sie kann jedoch Werte empfangen in $1, $2 und optional in $3:
    - $1 (Lange Ganzzahl) enthält die Referenz des 4D Write Bereichs,
    - $2 (Text) enthält die Bezeichnung des Link,
    - $3 (Lange Ganzzahl) enthält eine willkürliche Zahl, die Sie dem Link über den Parameter MethRef oder in der Benutzeroberfläche von 4D Write zuordnen können.
    Zum Kompilieren der Datenbank müssen Sie $1 und $3 als Lange Ganzzahl, $2 als Text deklarieren, auch wenn Sie diese nicht benutzen.
    Um ein Link vom Typ Methode einzufügen, setzen Sie 0 in linkTyp.
  • Ein Link vom Typ URL öffnet den Standard-Browser und greift auf ein spezifisches URL zu, das im Parameter linkInhalt definiert wurde. Um ein Link vom Typ URL einzufügen, setzen Sie 1 in linkTyp.
  • Ein Link vom Typ Dokument ersetzt, sobald Sie auf den Link klicken, das aktuelle Dokument durch ein anderes, dessen Pfad Sie im Parameter linkInhalt übergeben haben. Es muss natürlich ein Format haben, das 4D Write erkennt. Um ein Link vom Typ Dokument einzufügen, setzen Sie 2 in linkTyp.

Im Parameter linkTyp übergeben Sie eine der folgenden Konstanten unter dem Thema WR Parameter:

Konstante Typ Wert Meldung
wr method type link Lange Ganzzahl 0 Fügt ein Link vom Typ Methode ein
wr URL type link Lange Ganzzahl 1 Fügt ein Link vom Typ URL ein
wr document type link Lange Ganzzahl 2 Fügt ein Link vom Typ Dokument ein

urlStil
Mit dem Parameter urlStil können Sie die Darstellung des eingefügten Hypertext Links definieren. In diesem Parameter übergeben Sie eine der folgenden Konstanten unter dem Thema WR Parameter:

Konstante Typ Wert Meldung
wr custom link appearance Lange Ganzzahl 0 Ermöglicht, eine eigene Darstellung zu verwenden. In diesem Fall können Sie den Link auswählen und den Stil über den Befehl WR SET TEXT PROPERTY festlegen.
wr default link appearance Lange Ganzzahl 1 Behält die Standarddarstellung des Hyperlinks (blau und unterstrichen) bei. Über den Befehl WR SET DOC PROPERTY können Sie Standardfarben per Programmierung ändern.

Verwenden Sie die Konstante wr custom link appearance, ohne einen Stil für den Link festzulegen, erscheint der Link als aktueller Text, d.h. er wird nicht grafisch hervorgehoben.

linkBezeichnung
Der Parameter linkBezeichnung setzt den sichtbaren Text des Links (wenn im Menü Anzeigen/Werte eingestellt ist).

linkInhalt
Der Parameter linkInhalt enthält den Wert des Hypertext Links. Die Art des Wertes hängt von der Art des Links ab:

  • Für ein Link vom Typ 4D Methode setzen Sie den Namen der Methode (z.B. “Order_Clients”),
  • Für ein Link vom Typ URL setzen Sie das komplette URL (z.B. “http://www.4D.com/”)
  • Für ein Link vom Typ Dokument setzen Sie den vollständigen Pfad des Dokuments (z.B. unter Windows “C:\MeinOrdner\MeinDok.4w7”, auf MacOS “Festplatte:MeinOrdner:MeinDok”).

MethRef
Über den Parameter MethRef können Sie, wenn der Link vom Typ 4D Methode ist, der aufgerufenen Methode einen zusätzlichen Wert hinzufügen. Die Methode empfängt diesen Wert im Parameter $3 (vom Typ Lange Ganzzahl).

Sie möchten die URL Ihrer Web Site in den 4D Write Bereich einsetzen:

 WR INSERT HYPERLINK(Bereich;wr URL type link;wr default link appearance;
 "Besuchen Sie uns im Internet";"http:/www.MySite.com/")

Sie möchten Ihre 4D Write Dokumente mit Hypertext Navigation ausstatten, die auf Links vom Typ Dokument basieren. Die folgende Methode verwaltet Pfadnamen dynamisch und plattformunabhängig:

 $Doc:=Strukturdatei
 Doc:=$Doc
 While(Position(":";$Doc)#0)
    $Doc:=Substring($Doc;1+Position(":";$Doc);Length($Doc))
    $Long:=Length($Doc)
 End while
 Doc:=Substring(Doc;1;Length(Doc)-$Long)
 PLATFORM PROPERTIES($Platf;$Syst;$Computer)
 If($Platf=Windows)
    $name:=Doc+"Dokumentation"+"/"+"01_Einleitung.4W7"
 Else
    $name:=Doc+"Dokumentation"+":"+"01_01_Einleitung.4W7"
 End if
 $title:="Siehe Dokumentation"
 WR INSERT HYPERLINK(WriteBereich;wr document type link;wr default link appearance;
 $title;$name)

Dieses Beispiel zeigt Links vom Typ Methode. Der Benutzer soll in Ihrem Dokument in einen bestimmten Bereich Informationen eingeben können, zum Beispiel seinen Vor- und Nachnamen. Sie fügen ein Hyperlink über die Methode Hyperlink_Methode ein. Diese Methode fordert den Benutzer auf, entweder den Vor- oder Nachnamen einzugeben, je nachdem, welcher Wert in $3 übergeben wurde. Die eingegebenen Daten ersetzen dann den Link:

  `Hyperlink_Methode
 C_LONGINT($1;$3)
 C_TEXT($2)
 Case of
    :($3=1)
       WR INSERT TEXT($1;Request("Geben Sie Ihren Vornamen ein"))
    :($3=2)
       WR INSERT TEXT($1;Request("Geben Sie Ihren Nachnamen ein"))
 End case
 WR GET SELECTION($1;$deb;$end)
 WR SET SELECTION($1;$deb;$end+1)
 WR EXECUTE COMMAND($1;wr cmd clear)

Die Methode vom Typ Hyperlink in den 4D Write Bereich eingeben:

 $title:="Klicke für Eingabe"
 $method:="Hyperlink_Methode"
 WR INSERT TEXT(Bereich;"Name: ")
 WR INSERT HYPERLINK(Bereich;wr method type link;wr default link appearance;$title;$method;1)
 WR INSERT TEXT(Bereich;Char(Carriage return)+"Vorname: ")
 $title:="Eingeben"
 WR INSERT HYPERLINK(Bereich;wr method type link;wr default link appearance;
 "Klicke für Eingabe";"Hyperlink_Methode";2)

 
EIGENSCHAFTEN 

Produkt: 4D Write
Thema: WR Datenbankobjekte
Nummer: 89430

 
GESCHICHTE 

Erstellt: 4D Write 6.7

 
SIEHE AUCH 

WR GET HYPERLINK

 
ARTIKELVERWENDUNG

4D Write Programmiersprache ( 4D Write v11.6)
4D Write Programmiersprache ( 4D Write v12)
4D Write Programmiersprache ( 4D Write v14)
4D Write Programmiersprache ( 4D v13)
4D Write Programmiersprache ( 4D Write v14 R2)
4D Write Programmiersprache ( 4D Write v14 R3)
4D Write Programmiersprache ( 4D Write v14 R4)