SmallBasic 1.2 API DE API

SmallBasic 1.2 API DE Extension API

Array

Ein Array ermöglicht das Speichern mehrerer Werte unter einem angegebenen Name. Auf die Werte kann dann mit zusätzlichem Index zugegriffen werden.
Werte können (SMP)Strings, Zahlen, Arrays, Images (von ImageList.LoadImage) oder Controls/Shapes sein.
Indizes können -/0/+ (rationale) Zahlen, "Strings" oder Variablen sein, auch gemischt.
Indizes unterscheiden nicht zwischen GROß-/kleinschreibung, Werte schon.
Direktdefinition als String, zB.
arr = "id1=wert1;id2=wert2;..;" nur mit Konstanten oder Strings (keine Variablennamen, \ für Escape zB. arr="1=\;;2=\=;3=\\;").
Merkliche Geschwindigkeitsverluste bei großen Arrays (ab 100 Elemente).
Arrays können mit File.WriteContents/-Line gespeichert und mit File.ReadContents/-Line eingelesen werden.
Für Arraysortierung s. 'LDSort'.
example 'Stringdefinition "1=3;2=4;3=5;"
arr = "1=3;2="+ Math.Abs(-4) +";3="+ Text.GetLength("hallo") '+";"
'Ungültig in Datei-/Ordnername
inv = "1=\\;2=/;3=:;4=*;5=?;6=<;7=>;8=|;9="+ Text.GetCharacter(34) '+";"

'Array arr kopieren
arr2 = arr

'Index i abschneiden/löschen
arr[i] = ""
TextWindow.Write(arr[i]) ' ""

'Dimension dim von arr (regulär)
While Array.IsArray(arr)
dim = dim+1
ids = Array.GetAllIndices(arr)
arr = arr[ids[1]]
EndWhile
TextWindow.WriteLine(dim)

ContainsIndex	ContainsValue	GetAllIndices
GetItemCount	GetValue	IsArray
RemoveValue	SetValue

ContainsIndex(array,index)

Ermittelt ob ein Array den angegebenen Index enthält. Nützlich, um herausfinden, ob dieser Index bereits mit einem Wert belegt wurde.
SB Arrays können keine leeren Indizes (Index mit Leerwert "") enthalten.
(Nicht für Arrays die mittels Array.SetValue erstellt wurden.)
array Der Name des Arrays.
index Der zu suchende Index (GROß-/kleinschreibung egal, exakte Länge).
returns "True" oder "False", je nachdem ob der Index im angegebenen Array gefunden wurde.

ContainsValue(array,value)

Ermittelt ob ein Array den angegebenen Wert buchstabengetreu enthält. Dies ist nützlich, um herauszufinden, ob der Wert im Array bereits unter einem Index gespeichert wurde.
(Nicht für Arrays die mittels Array.SetValue erstellt wurden.)
array Der Name des Arrays.
value Der zu suchende Wert (buchstabengetreu und exakte Länge) oder direkte Unterarray für 2D Array.
returns "True" oder "False", je nachdem ob der Wert buchstabengetreu im angegebenen Array gefunden wurde.

GetAllIndices(array)

Ermittelt alle Indizes für den angegebenen Array als neuen Array. (Nicht für Arrays die mittels Array.SetValue erstellt wurden.)
array Der Name des Arrays.
returns Ein Array (ab 1) mit allen Indizes des angegebenen Arrays (selbe Elementreihenfolge).

GetItemCount(array)

Ermittelt die Anzahl der im Array enthaltenen Indizes/Elemente bzw. Unterarrays für 2D Array. (Nicht für Arrays die mittels Array.SetValue erstellt wurden.)
array Der Name des Arrays (bzw. Variable).
returns Die Anzahl der Werte im angegebenen Array, 0 bei ungültigem Array (Zahl, "Text", "").
example arr = ""
Array.GetItemCount(arr) '0
Array.IsArray(arr) ' "False"

arr = "1=1;2=2;"
Array.GetItemCount(arr) '>0 (2)
Array.IsArray(arr) ' "True"

'Array aufbauen:
For v = 1 To 10
'arr[Array.GetItemCount(arr)] = v 'ab 0
arr[Array.GetItemCount(arr)+1] = v 'ab 1
EndFor

GetValue(arrayName,index)

Ermittelt den Arraywert am angegebenen Index. Nur für Arrays/Werte die mittels Array.SetValue erstellt wurden (Ausgeblendet in IntelliSense).
Diese Methode ist bedeutend schneller als die herkömmliche Methode val = arr[i].
arrayName Der Name des Arrays (in "" oder zuvor definiert). Exakte Schreibweise einhalten.
index Der Index des abzurufenden Wertes (zB. -3, 0, "i", var). Exakte Schreibweise einhalten.
returns Der Arraywert (auch Leerwerte "" möglich) bei Erfolg, sonst "".
example val = Array.GetValue("arr", 0)
v2 = Array.GetValue(123, "i")

IsArray(array)

Ermittelt ob eine Variable ein Array (mit mind. 1 Element) ist. (Nicht für Arrays die mittels Array.SetValue erstellt wurden.)
array Der Name des Arrays (bzw. Variable).
returns "True", wenn die angegebene Variable ein Array ist, sonst "False" (zB. "", "1=;", Zahl, String).
example arr = ""
Array.IsArray(arr) ' "False"
Array.GetItemCount(arr) '0

arr = "1=1;2=2;"
Array.IsArray(arr) ' "True"
Array.GetItemCount(arr) '>0 (2)

RemoveValue(arrayName,index)

Entfernt den Arraywert am angegebenen Index. Nur für Arrays/Werte die mittels Array.SetValue erstellt wurden (Ausgeblendet in IntelliSense).
arrayName Der Name des Arrays (in "" oder zuvor definiert). Exakte Schreibweise einhalten.
index Der Index des zu entfernenden Arraywertes (zB. -3, 0, "i", var). Exakte Schreibweise einhalten.
example Array.RemoveValue("arr", 0)
Array.RemoveValue(123, "i")

SetValue(arrayName,index,value)

Setzt den Arraywert am angegebenen Index. Hiermit gesetzte Werte müssen mittels Array.GetValue ermittelt bzw. mit Array.RemoveValue entfernt werden (Ausgeblendet in IntelliSense).
Diese Methode ist bedeutend schneller als die herkömmliche Methode arr[i] = val.
arrayName Der Name des Arrays (in "" oder zuvor definiert). Exakte Schreibweise einhalten.
index Der Index des zu setzenden Wertes (zB. -3, 0, "i", var). Exakte Schreibweise einhalten.
value Der zu setzende Arraywert (auch Leerwerte "" möglich).
example 'als Stringname
Array.SetValue("arr", 0,5)
'als Variablenname
arr = 123
Array.SetValue(arr, "i","+-*/")

Clock

Bietet Zugriff auf die Systemuhr zum Ermitteln von Datums- und Zeitangaben.
Manche Formate sind abhängig von aktuellen Systemeinstellungen ('Region und Sprache').
example '2-stellig für 1-9
hh = Text.GetSubText(Text.Append("0",h),Text.GetLength(h),2)

Date	Day	ElapsedMilliseconds
Hour	Millisecond	Minute
Month	Second	Time
WeekDay	Year

Date

Ermittelt das aktuelle kurze Systemdatum als TT.MM.JJ (zB. 27.08.14). Führende '0' vor Werten von 0-9.

Day

Ermittelt den aktuellen Monatstag (1-31, einstellig für 1-9).

ElapsedMilliseconds

Ermittelt die Anzahl vergangener Millisekunden seit 1900 (mit 2 Dezimalen).
example '1. Bildrate in Hauptschleife
bps = 40 '[Bilder/s]
ms = 1000/bps '25 [ms/Bild]

While "True"
start = Clock.ElapsedMilliseconds
ANIMATION()
dt = ms - (Clock.ElapsedMilliseconds-start)
If dt > 0 Then
Program.Delay(dt)
EndIf
EndWhile

'2. Konst. Bildrate in Sub
dt = Clock.ElapsedMilliseconds
While "True"
ANIMATION()
Bildrate()
EndWhile

Sub Bildrate
While (Clock.ElapsedMilliseconds - dt) < ms
Program.Delay(5)
EndWhile
dt = Clock.ElapsedMilliseconds
EndSub

'3. Konst. Bildrate2 in Sub
While "True"
ANIMATION()
Bildrate2()
EndWhile

Sub Bildrate2
While Clock.ElapsedMilliseconds < dt
Program.Delay(5)
EndWhile
dt = Clock.ElapsedMilliseconds + ms
EndSub

Hour

Ermittelt die aktuelle Tagesstunde (0-23, einstellig für 0-9).

Millisecond

Ermittelt die aktuelle Millisekunde (3-stellig).

Minute

Ermittelt die aktuelle Minute der Stunde (0-59, einstellig für 0-9).

Month

Ermittelt die aktuelle Monatsnummer (1-12, einstellig für 1-9).

Second

Ermittelt die aktuelle Sekunde der Minute (0-59, einstellig für 0-9).

Time

Ermittelt die aktuelle Systemzeit als HH:mm:ss (24h Format, zB. 21:04:07). Führende '0' bei Werten von 0-9.

WeekDay

Ermittelt den Name des aktuellen Wochentags (deutsch, zB. Montag).

Year

Ermittelt die aktuelle Jahreszahl (zB. 2014).

Controls

Hinzufügen, Positionieren und Interaktion für Steuerelemente im GraphicsWindow.
Funktioniert zT. auch für Shapes (Controls sind Shapes in SB. Interne Namensverarbeitung für Objekte).

AddButton	AddMultiLineTextBox	AddTextBox
ButtonClicked	GetButtonCaption	GetTextBoxText
HideControl	LastClickedButton	LastTypedTextBox
Move	Remove	SetButtonCaption
SetSize	SetTextBoxText	ShowControl
TextTyped

AddButton(caption,left,top)

Fügt eine Schaltfläche an der angegebenen Position im GraphicsWindow hinzu (Mindestbreite: 12, Standardhöhe: 26/25/24/23 (bei FontSize 12/11/10/9); Intern: Button#).
Texteigenschaften bestimmbar durch vorangehendes BrushColor, FontName,-Size,-Bold,-Italic.
Erlaubt Tasten Space und Return/Enter.
caption Der auf der Schaltfläche anzuzeigende Text. Für senkrechten Text, zwischen den Buchstaben lf bzw. Text.GetCharacter(10) einfügen.
left Die x-Koordinate des Button.
top Die y-Koordinate des Button.
returns Der Name des Button.

AddMultiLineTextBox(left,top)

Fügt ein mehrzeiliges Texteingabefeld an der angegebenen Position im GraphicsWindow hinzu (Standardbreite: 200, -höhe: 80; Intern: TextBox#).
Texteigenschaften bestimmbar durch vorangehendes BrushColor, FontName,-Size,-Bold,-Italic.
Linksbündige Ausrichtung für alle Einträge.
Bei Bedarf rechte/untere Scrollleiste (Breite: 18).
left Die x-Position der MultiLineTextBox (Standard: 0).
top Die y-Position der MultiLineTextBox (Standard: 0).
returns Der Name der MultiLineTextBox.

AddTextBox(left,top)

Fügt ein Texteingabefeld an der angegebenen Position im GraphicsWindow hinzu (Standardbreite: 160, -höhe: 22/21/20/19 (bei FontSize 12/11/10/9); Intern: TextBox#).
Texteigenschaften bestimmbar durch vorangehendes BrushColor, FontName,-Size,-Bold,-Italic.
Linksbündige Ausrichtung für alle Einträge.
left Die x-Position der TextBox (Standard: 0).
top Die y-Position der TextBox (Standard: 0).
returns Der Name der TextBox.

ButtonClicked

Ereignisaufruf wenn ein Button geklickt oder "Space"/"Return"-Taste (Buttonwahl mit Tab,Up,Down,Left,Right) gedrückt wurde (erst beim Loslassen, MouseDown/-Up Ereignis wird dabei nicht ausgelöst).

GetButtonCaption(buttonName)

Ermittelt den Text auf einem angegebenen Button.
buttonName Der Name des Button.
returns Der angezeigte Buttontext.

GetTextBoxText(textBoxName)

Ermittelt den Text in einer angegebenen (MultiLine)TextBox (Standard ANSI, sonst UTF8).
textBoxName Der Name der (MultiLine)TextBox.
returns Der Text in der (MultiLine)TextBox oder "".

HideControl(controlName)

Blendet ein bereits hinzugefügtes Steuerelement aus (s. Shapes.HideShape, Elementposition bleibt unverändert, andere Methoden funktionieren weiterhin).
controlName Der Name des Steuerelements.

LastClickedButton

Ermittelt den Name des Button, der zuletzt gedrückt wurde.

LastTypedTextBox

Ermittelt den Name der (MultiLine)TextBox, in der zuletzt Text geschrieben/eingefügt/geändert wurde.

Move(control,x,y)

Verschiebt ein angegebenes Steuerelement (bzw. Shape) an eine neue Position im GraphicsWindow.
control Der Name des Steuerelements/Shapes.
x Die neue x-Position im GraphicsWindow.
y Die neue y-Position im GraphicsWindow.

Remove(controlName)

Entfernt ein Steuerelement aus dem GraphicsWindow (Interne # bleibt unverändert).
controlName Der Name des zu entfernenden Steuerelements.

SetButtonCaption(buttonName,caption)

Setzt den Text auf einem angegebenen Button.
buttonName Der Name des Button.
caption Der neue Buttontext.

SetSize(control,width,height)

Setzt eine neue Größe für ein Steuerelement oder Shape (zB. Bild-/Textshape). S.a. LDShapes.SetSize bzw. ReSize, Schriftgröße in Textshape nicht, Ankerpunkt (l.o) bleibt unverändert.
Standard Bildshape wird proportional skaliert (UI-Eigenschaft: Stretch=Uniform, Seitenverhältnis konstant).
control Der Name des Steuerelements/Shape.
width Die neue Breite (>=0).
height Die neue Höhe (>=0).

SetTextBoxText(textBoxName,text)

Setzt den Text in einer angegebenen (MultiLine)TextBox (Standard UTF8, ev. Anzeigeproblem von ANSI). Bei Inhaltsänderung wird auch 'TextTyped' Event ausgelöst.
Linksbündige Ausrichtung für alle Einträge.
textBoxName Der Name der (MultiLine)TextBox.
text Der neue Text für die (MultiLine)TextBox oder "".

ShowControl(controlName)

Zeigt ein zuvor ausgeblendetes Steuerelement an der zuletzt definierten Position wieder an (s. Shapes.ShowShape).
controlName Der Name des Steuerelements.

TextTyped

Ereignisaufruf wenn Text in einer (MultiLine)TextBox eingegeben oder geändert wurde.
Nicht bei Mausklick, Cursortasten, Pos1/Ende usw. Jedoch bei 'Back'(Space), Ausschneiden/Einfügen.

Desktop

Funktionen zur Interaktion mit der Desktop Anzeige.
PxlPos x/y: 0 bis Desktop.Width-1 bzw. Desktop.Height-1.

Height

SetWallPaper

Width

Height

Ermittelt die Bildschirmhöhe des primären Desktops.
(zB. Standard: 768)

2-zeilige Taskbarhöhe: 60

SetWallPaper(fileOrUrl)

Setzt das angegebene Bild als Hintergrundbild für den Desktop. Dies kann eine lokale, Netzwerkdatei oder Web-Url sein.
fileOrUrl Der volle Dateipfad oder die Url des Bildes.

Width

Ermittelt die Bildschirmbreite des primären Desktops.
(zB. Standard: 1366)

Dictionary

Ermöglicht den Zugriff auf einen Online Lexikon-Dienst zur Wortdefinition und Übersetzung.
(Bei Fehler s. LDDictionary)
example http://rr.office.microsoft.com/Research/query.asmx (Research WebService)

GetDefinition	GetDefinitionEnglishToEnglish	GetDefinitionEnglishToFrench
GetDefinitionEnglishToGerman	GetDefinitionEnglishToItalian	GetDefinitionEnglishToJapanese
GetDefinitionEnglishToKorean	GetDefinitionEnglishToSimplifiedChinese	GetDefinitionEnglishToSpanish
GetDefinitionEnglishToTraditionalChinese	GetDefinitionFrenchToEnglish	GetDefinitionGermanToEnglish
GetDefinitionItalianToEnglish	GetDefinitionJapaneseToEnglish	GetDefinitionKoreanToEnglish
GetDefinitionSimplifiedChineseToEnglish	GetDefinitionSpanishToEnglish	GetDefinitionTraditionalChineseToEnglish

GetDefinition(word)

Ermittelt die Definition(en) zu einem Wort in Englisch (wie GetDefinitionEnglishToEnglish).
Bei Fehler s. LDDictionary.GetDefinition)
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionEnglishToEnglish(word)

Ermittelt die Definition(en) zu einem Wort in Englisch (wie GetDefinition).
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionEnglishToFrench(word)

Ermittelt die Definition(en) zu einem Wort in Französisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Französisch bei Erfolg, sonst "".

GetDefinitionEnglishToGerman(word)

Ermittelt die Definition(en) zu einem Wort in Deutsch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Deutsch bei Erfolg, sonst "".

GetDefinitionEnglishToItalian(word)

Ermittelt die Definition(en) zu einem Wort in Italienisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Italienisch bei Erfolg, sonst "".

GetDefinitionEnglishToJapanese(word)

Ermittelt die Definition(en) zu einem Wort in Japanisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Japanisch bei Erfolg, sonst "".

GetDefinitionEnglishToKorean(word)

Ermittelt die Definition(en) zu einem Wort in Koreanisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Koreanisch bei Erfolg, sonst "".

GetDefinitionEnglishToSimplifiedChinese(word)

Ermittelt die Definition(en) zu einem Wort in vereinfachtem Chinesisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in vereinfachtem Chinesisch bei Erfolg, sonst "".

GetDefinitionEnglishToSpanish(word)

Ermittelt die Definition(en) zu einem Wort in Spanisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in Spanisch bei Erfolg, sonst "".

GetDefinitionEnglishToTraditionalChinese(word)

Ermittelt die Definition(en) zu einem Wort in traditionellem Chinesisch.
word Das zu definierende Wort in Englisch.
returns Die Definition(en) zum angegebenen Begriff in traditionellem Chinesisch bei Erfolg, sonst "".

GetDefinitionFrenchToEnglish(word)

Übersetzt ein Wort von Französisch zu Englisch.
word Das zu definierende Wort in Französisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionGermanToEnglish(word)

Übersetzt ein Wort von Deutsch zu Englisch.
word Das zu definierende Wort in Deutsch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionItalianToEnglish(word)

Übersetzt ein Wort von Italienisch zu Englisch.
word Das zu definierende Wort in Italienisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionJapaneseToEnglish(word)

Übersetzt ein Wort von Japanisch zu Englisch.
word Das zu definierende Wort in Japanisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionKoreanToEnglish(word)

Übersetzt ein Wort von Koreanisch zu Englisch.
word Das zu definierende Wort in Koreanisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionSimplifiedChineseToEnglish(word)

Übersetzt ein Wort von vereinfachtem Chinesisch zu Englisch.
word Das zu definierende Wort in einfachem Chinesisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionSpanishToEnglish(word)

Übersetzt ein Wort von Spanisch zu Englisch.
word Das zu definierende Wort in Spanisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

GetDefinitionTraditionalChineseToEnglish(word)

Übersetzt ein Wort von traditionellem Chinesisch zu Englisch.
word Das zu definierende Wort in traditionellem Chinesisch.
returns Die Übersetzung für den angegebenen Begriff in Englisch bei Erfolg, sonst "".

File

Methoden zum Lese- und Schreibzugriff für Dateien auf einem Datenträger. Dies ermöglicht, Einstellungen über mehrere Programmsitzungen hinweg zu speichern.
Ungültige Zeichen in Ordner-/Dateiname sind \/:*?"<>|
Unterstützt "\" (Root), "." (CurrDir), ".." (ParentDir) relative Pfade und %PFADE%.

AppendContents	CopyFile	CreateDirectory
DeleteDirectory	DeleteFile	GetDirectories
GetFiles	GetSettingsFilePath	GetTemporaryFilePath
InsertLine	LastError	ReadContents
ReadLine	WriteContents	WriteLine

AppendContents(filePath,contents)

Öffnet die angegebene Datei und hängt Textinhalt am Ende der Datei an (+Zeilenvorschub, Standard ANSI, sonst UTF8).
filePath Der volle Dateipfad (zB. "C:\Temp\settings.data"). Eine nicht existierende Datei wird erstellt.
contents Der an das Dateiende anzuhängende Text, Array oder "" für eine Leerzeile.
returns "SUCCESS" bei Erfolg, sonst "FAILED".

CopyFile(sourceFilePath,destinationFilePath)

Kopiert die angegebene Quelldatei in den Zieldateipfad. Falls der Zielpfad nicht existiert, wird versucht diesen automatisch zu erstellen.
Eine bereits existierende Zieldatei wird ohne Nachfrage überschrieben. Es empfiehlt sich, die Existenz einer Zieldatei zu überprüfen, um ein Überschreiben zu vermeiden.
sourceFilePath Der volle Pfad der zu kopierenden Datei (zB. "C:\Temp\settings.data").
destinationFilePath Der Zielordner oder Zieldateipfad (ev. gleichzeitige Umbenennung des Dateiname).
returns "SUCCESS" bei Erfolg, sonst "FAILED".

CreateDirectory(directoryPath)

Erstellt ein angegebenes Verzeichnis bzw. Ordnerstruktur (incl. fehlender übergeordneter Elternordner).
directoryPath Der volle Pfad des zu erstellenden Verzeichnisses (mit oder ohne abschließendem '\').
returns "SUCCESS" bei Erfolg (auch wenn der Ordner bereits besteht), sonst "FAILED".

DeleteDirectory(directoryPath)

Löscht das angegebene Verzeichnis (incl. gesamtem Inhalt) ohne Rückfrage von der Festplatte.
directoryPath Der volle Pfad des zu löschenden Verzeichnisses (mit oder ohne abschließendem '\', nicht für Junction 'L' Attr.).
returns "SUCCESS" bei Erfolg, sonst "FAILED".

DeleteFile(filePath)

Löscht eine angegebene Datei ohne Rückfrage von der Festplatte.
filePath Der volle Pfad der zu löschenden Datei (zB. "C:\Temp\settings.data").
returns "SUCCESS" bei Erfolg, sonst "FAILED".

GetDirectories(directoryPath)

Ermittelt die vollen Pfade aller direkten Unterordner im angegebenen Ordnerpfad.
directoryPath Das Verzeichnis in dem Unterordner zu ermitteln sind (mit oder ohne abschließendem '\', nicht für Junction 'L' Attr.).
"\" C-Root
"." , ".\" akt. Startordner
".." , "..\" akt. Elternordner
returns Die vollen Ordnerpfade als Array (alphabetisch sortiert) oder "" bei Erfolg, sonst "FAILED".
Bei relativem Eingabepfad werden auch relative Pfade zurückgegeben.

GetFiles(directoryPath)

Ermittelt die Pfade aller direkten Dateien im angegebenen Ordnerpfad.
directoryPath Das Verzeichnis in dem Dateien zu ermitteln sind (mit oder ohne abschließendem '\', nicht für Junction 'L' Attr.).
"\" C-Root
"." , ".\" akt. Startordner
".." , "..\" akt. Elternordner
returns Die vollen Dateipfade als Array (alphabetisch sortiert) oder "" bei Erfolg, sonst "FAILED".
Bei relativem Eingabepfad werden auch relative Pfade zurückgegeben.

GetSettingsFilePath()

Ermittelt den vollen Pfad der Einstellungsdatei für das aktuelle Programm. Der Name der Einstellungsdatei basiert auf dem aktuellen Programmname mit Erweiterung .settings und befindet sich im selben Verzeichnis wie das Programm (ANSI Textdatei).
Die Einstellungsdatei selbst wird dabei nicht erstellt.
returns Der volle Pfad der Einstellungsdatei für dieses Programm.

GetTemporaryFilePath()

Erstellt eine neue temporäre Datei im Benutzer TEMP-Ordner (%TEMP%\tmp????.tmp) und gibt deren vollen Dateipfad zurück.
returns Der volle Pfad der temporären Datei (zB. C:\Users\NAME\AppData\Local\Temp\tmp3B80.tmp).

InsertLine(filePath,lineNumber,contents)

Öffnet die angegebene Datei und fügt Textinhalt in/ab der Zeile mit der angegebenen Zeilennummer ein (+Zeilenvorschub, Standard ANSI, sonst UTF8).
Diese Methode überschreibt keinen bestehenden Inhalt in der angegebenen Datei. Höhere Zeilennummern als im bestehenden Text vorhanden, werden nach letzter vorhandenen Zeile angefügt (ev. dazwischenliegende Leerzeilen werden ignoriert).
filePath Der volle Dateipfad (zB. "C:\Temp\settings.data"). Eine nicht existierende Datei wird erstellt.
lineNumber Die Zeilennummer für den einzufügenden Text ab 1 (0 ergibt keine Änderung).
contents Der in angegebene Zeile einzufügende Text, Array oder "" für eine Leerzeile.
returns "SUCCESS" bei Erfolg, sonst "FAILED".

LastError

Ermittelt oder setzt die letzte, auf einem Dateivorgang basierende Fehlermeldung. Diese Eigenschaft hilft herauszufinden, wenn eine File Methode nicht ausgeführt werden konnte.
(Standard: ""). Für AppendContents, CopyFile, CreateDirectory, DeleteDirectory, DeleteFile, GetDirectories, GetFiles, InsertLine, WriteContents.

ReadContents(filePath)

Öffnet eine lokale Datei und liest den gesamten Textinhalt/Einzelarray (Standard UTF8, ev. Anzeigeproblem bei ANSI, s. dazu LDFile.ReadANSI).
Diese Methode ist schnell bei Dateien unter 1MB, wird aber deutlich langsamer bei größeren Dateien, besonders über 10MB.
filePath Der volle Dateipfad (zB. "C:\Temp\settings.data").
returns Der gesamte Textinhalt der Datei bzw. "" wenn Datei fehlt oder leer ist.
example 'Einzelnen Array laden
arr = File.ReadContents(File.GetSettingsFilePath())

ReadLine(filePath,lineNumber)

Öffnet die angegebene Datei und liest Textinhalt/Array der angegebenen Zeilennummer (Standard UTF8, ev. Anzeigeproblem bei ANSI, s. dazu LDFile.ReadANSI).
filePath Der volle Dateipfad (zB. "C:\Temp\settings.data").
lineNumber Die Zeilennummer für den einzulesenden Text ab 1 (0 liest die erste Zeile).
returns Der Textinhalt der angegebenen Zeile. "" für Leerzeile oder wenn Datei oder Zeilennummer (zB. Leerdatei) nicht existiert.
example 'Array aus Zeile 1 einlesen
arr = File.ReadLine(File.GetSettingsFilePath(), 1)

WriteContents(filePath,contents)

Öffnet eine Datei und schreibt angegebenen Textinhalt/Einzelarray hinein (ohne Zeilenvorschub, Standard ANSI, sonst UTF8). Bestehende Inhalte werden durch den neuen Inhalt ersetzt.
filePath Der volle Dateipfad (zB. "C:\Temp\settings.data"). Eine nicht existierende Datei wird erstellt.
contents Der in die angegebene Datei zu schreibende Text oder Array. "" löscht einen bereits bestehenden Inhalt oder erstellt eine Leerdatei.
returns "SUCCESS" bei Erfolg, sonst "FAILED".
example 'Einzelnen Array speichern
File.WriteContents(File.GetSettingsFilePath(), arr)

WriteLine(filePath,lineNumber,contents)

Öffnet die angegebene Datei und schreibt Textinhalt/Array in die Zeile mit der angegebenen Zeilennummer (+Zeilenvorschub, Standard ANSI, sonst UTF8).
Diese Methode überschreibt den bestehenden Inhalt in der angegebenen Zeile. Höhere Zeilennmmern als im bestehenden Text vorhanden, werden nach letzter vorhandenen Zeile angefügt (ev. dazwischenliegende Leerzeilen werden ignoriert).
filePath Der volle Dateipfad (zB. "C:\Temp\settings.data"). Eine nicht existierende Datei wird erstellt.
lineNumber Die Zeilennummer für den zu schreibenden Text ab 1 (0 schreibt in die erste Zeile).
contents Der in angegebene Zeile zu schreibende Text, Array oder "" für Leerzeile.
returns "SUCCESS" bei Erfolg, sonst "FAILED".
example 'Array in Zeile 1 speichern
File.WriteLine(File.GetSettingsFilePath(), 1,arr)

'Zeile z in (leere) Datei schreiben
z = 11
len = LDFile.Length(path)

If len < 0 Then
File.WriteLine(path, i,"")
EndIf
For i = len To z-1
File.WriteLine(path, i,lf)
EndFor
File.WriteLine(path, z,"Text")

Flickr

Bietet Zugang zum 'Flickr' Fotodienst.
(Bei Fehler als Fix zuvor einmalig s. LDUtilities.FixFlickr() aufrufen)

GetPictureOfMoment

GetRandomPicture

GetPictureOfMoment()

Ermittelt die Webadresse für ein aktuelles 'Flickr' Bild. (Bei Fehler zuvor einmalig s. LDUtilities.FixFlickr() aufrufen)
returns Die Web-Url für das 'Flickr' Bild.

GetRandomPicture(tag)

Ermittelt die Webadresse für ein zufälliges 'Flickr' Bild zum angegebenen Thema. (Bei Fehler zuvor einmalig s. LDUtilities.FixFlickr() aufrufen)
tag Das Thema für das gewünschte Zufallsbild.
returns Die Web-Url für das 'Flickr' Bild (Zufallsauswahl).

GraphicsWindow

Graphische Benutzeroberfläche (GUI) mit Ein- und Ausgabefunktionen. Hier können zB. Kreise und Rechtecke gezeichnet und ausgefüllt werden.
PxlPos x,y: 0 bis GW.Width-1 bzw. GW.Height-1.
Die meisten enthaltenen Methoden initialisieren das GW auch ohne vorheriges GraphicsWindow.Show (GetColorFromRGB, GetRandomColor, Font.. nicht).

BackgroundColor

Ermittelt oder setzt die Hintergrundfarbe des GraphicsWindow (bzw. Anpassen der Transparenz für s. LDUtilities.TransparentGW).
Standard: #FFFFFF dh. 'White'. Fehler oder "" gibt #000000 dh. 'Black'. "#00FFFFFF" ist 'Transparent'.
example http://msdn.microsoft.com/library/System.Windows.Media.Colors.aspx
http://i.msdn.microsoft.com/dynimg/IC24340.png

BrushColor

Ermittelt oder setzt die Pinselfarbe, mit welcher Formen ausgefüllt bzw. Text in GraphicsWindow, Controls und Textshapes angezeigt wird.
(Standard: #6A5ACD dh. 'SlateBlue'; Fehler oder "" gibt #000000 dh. 'Black').
#AARRGGBB mit AA<>FF setzt Transparenz für Shapes und Zeichnungen (FF deckend, 00 transparent).
example http://msdn.microsoft.com/library/System.Windows.Media.Colors.aspx
http://i.msdn.microsoft.com/dynimg/IC24340.png

CanResize

Ermittelt oder setzt ob die Größe des GraphicsWindow mittels Mauszeiger angepasst werden kann. Setzen VOR GW.Width/-Height.
Änderung der Fenstergröße ist weiterhin möglich mittels GW.Width und GW.Height.
(Standard: "True", sonstiges wie "False", "", 0, 1, -1 usw. fixiert Fenstergröße und erhöht Standardwerte für GW.Width/-Height um 10 auf 634/452)
Min. GW.Width/Height: 126/10
"True" Min+Max Felder (LDGraphicsWindow.Resize 1)
"False" nur 'X' Feld (LDGraphicsWindow.Resize 2)

Clear()

Löscht alle Inhalte im GraphicsWindow wie: Bilder, Zeichnungen, Text, Controls und Shapes (außer Turtle).
Bestehende Shape# werden geleert (""). ImageList#, Schrift- und Farbeinstellungen (BackgroundColor) bleiben erhalten.
Alternativ GW (-Bereich) mit FillRectangle (in BrushColor) überzeichnen (nur für GW.Draw../Fill.., außer für Turtle/-Linie, Shapes, Controls).

DrawBoundText(x,y,width,text)

Schreibt eine Textzeile an der angegebenen Stelle (mit BrushColor, Font..).
x Die x-Koordinate für den Ankerpunkt (l.o.) des Textes.
y Die y-Koordinate für den Ankerpunkt (l.o.) des Textes (je nach FontSize sind Standardbuchstaben runter versetzt).
width Die maximal verfügbare Textbreite [Pxl] (0 volle Textlänge ohne Umbruch, s. DrawText). Bestimmt wo der Textumbruch (an Leerzeichen) stattfindet.
text Der anzuzeigende Text. Bei kleineren Werten für Textbreite nur oder endende '...' in Ausgabezeile.

DrawEllipse(x,y,width,height)

Zeichnet eine Ellipse mit dem gewählten Stift (PenColor/-Width). Koordinaten beziehen sich auf die Mitte der PenWidth Linienbreite.
x Die x-Koordinate der Ellipse.
y Die y-Koordinate der Ellipse.
width Die Breite der Ellipse (-/0/+ Werte, <0 kippt um y-Achse nach links).
height Die Höhe der Ellipse (-/0/+ Werte, <0 kippt um x-Achse nach oben).

DrawImage(imageName,x,y)

Zeigt ein (ImageList) Bild in Originalgröße im GraphicsWindow (in gleicher Ebene wie gefüllte Formen). Keine Anzeige wenn "ImageList#" leer "" ist. Keine Gif-Animation.
imageName Der ImageList-Name oder voller (Web)Dateipfad des anzuzeigenden Bildes (BMP, gif, ico, jp(e)g, PNG, tiff).
x Die x-Koordinate des Bildes im GraphicsWindow.
y Die y-Koordinate des Bildes im GraphicsWindow.
example GraphicsWindow.DrawImage("http://microsoft.com/favicon.ico", 0,0)

DrawLine(x1,y1,x2,y2)

Zeichnet eine Linie zwischen 2 Punkten mit dem gewählten Stift (PenColor/-Width). Koordinaten beziehen sich auf die Mitte der PenWidth Linienbreite.
x1 Die x-Koordinate von Punkt 1.
y1 Die y-Koordinate von Punkt 1.
x2 Die x-Koordinate von Punkt 2.
y2 Die y-Koordinate von Punkt 2.
example 'Gerade von x1,y1 nach y2 im Winkel deg
rad = Math.GetRadians(180-deg)
x2 = x1 + (y2-y1)/Math.Tan(rad)
GraphicsWindow.DrawLine(x1,y1, x2,y2)

DrawRectangle(x,y,width,height)

Zeichnet ein Rechteck mit dem gewählten Stift (PenColor/-Width). Koordinaten beziehen sich auf die Mitte der PenWidth Linienbreite.
x Die x-Koordinate des Rechtecks.
y Die y-Koordinate des Rechtecks.
width Die Breite des Rechtecks (0/+ Werte).
height Die Höhe des Rechtecks (0/+ Werte).
example 'Einzelpunkt in PenWidth
DrawRectangle(10,10, 0,0)
'horiz. Linie in PenWidth
DrawRectangle(10,10, 10,0)

DrawResizedImage(imageName,x,y,width,height)

Zeigt ein (ImageList) Bild in den angegebenen Abmessungen im GraphicsWindow (Ansicht wird ev. gestaucht, in gleicher Ebene wie gefüllte Formen). Keine Anzeige wenn "ImageList#" leer "" ist. Keine Gif-Animation.
imageName Der ImageList-Name oder voller (Web)Dateipfad des anzuzeigenden Bildes (BMP, gif, ico, jp(e)g, PNG, tiff).
x Die x-Koordinate des Bildes im GraphicsWindow.
y Die y-Koordinate des Bildes im GraphicsWindow.
width Die Anzeigebreite des Bildes (0/+ Werte, 0 gibt keine Anzeige).
height Die Anzeigehöhe des Bildes (0/+ Werte, 0 gibt keine Anzeige).

DrawText(x,y,text)

Zeichnet ein Dreieck mit dem gewählten Stift (PenColor/-Width). Koordinaten beziehen sich auf die Mitte der PenWidth Linienbreite.
x1 Die x-Koordinate von Punkt 1.
y1 Die y-Koordinate von Punkt 1.
x2 Die x-Koordinate von Punkt 2.
y2 Die y-Koordinate von Punkt 2.
x3 Die x-Koordinate von Punkt 3.
y3 Die y-Koordinate von Punkt 3.

FillEllipse(x,y,width,height)

Zeichnet eine gefüllte Ellipse (mit BrushColor).
x Die x-Koordinate der Ellipse.
y Die y-Koordinate der Ellipse.
width Die Breite der Ellipse (-/0/+ Werte, 0 gibt keine Anzeige, <0 kippt um y-Achse nach links).
height Die Höhe der Ellipse (-/0/+ Werte, 0 gibt keine Anzeige, <0 kippt um x-Achse nach oben).

FillRectangle(x,y,width,height)

Zeichnet ein gefülltes Rechteck (mit BrushColor).
x Die x-Koordinate des Rechtecks.
y Die y-Koordinate des Rechtecks.
width Die Breite des Rechtecks (0/+ Werte, 0 gibt keine Anzeige).
height Die Höhe des Rechtecks (0/+ Werte, 0 gibt keine Anzeige).

FillTriangle(x1,y1,x2,y2,x3,y3)

Zeichnet ein gefülltes Dreieck (mit BrushColor).
x1 Die x-Koordinate von Punkt 1.
y1 Die y-Koordinate von Punkt 1.
x2 Die x-Koordinate von Punkt 2.
y2 Die y-Koordinate von Punkt 2.
x3 Die x-Koordinate von Punkt 3.
y3 Die y-Koordinate von Punkt 3.

FontBold

Ermittelt oder setzt Text als Fettdruck im GraphicsWindow, Controls und Textshapes.
(Standard: "True")

FontItalic

Ermittelt oder setzt Text als Kursivdruck im GraphicsWindow, Controls und Textshapes.
(Standard: "False")

FontName

Ermittelt oder setzt den Name der Schriftart für Text im GraphicsWindow, Controls und Textshapes.
(Standard: Tahoma, Systemstandard: Segoe UI, 9)
FixedWidthFonts zB: Consolas, Courier New, Digital-7 Mono, Liberation Mono, Lucida Console, Lucida Sans Typewriter
Symbole zB: Cambria Math, Lucida Console, Segoe UI Symbol, Symbol(a), Webdings, Wingdings( 2,3)
example FontName = "(#)Schriftname(, ErsatzFont1, ..)"
FontName = "(file:///)Ordnerpfad\#Schriftname"
s. FontFallback, CompositeFonts:
http://msdn.microsoft.com/library/system.windows.media.fontfamily.aspx
http://msdn.microsoft.com/library/ms602323.aspx

FontSize

Ermittelt oder setzt die Schriftgröße von Text im GraphicsWindow, Controls und Textshapes (bei FixedWidthFont: Breite = 0.6*Höhe).
(Standard: 12)
example 8,9,10,11,12, 14,16,18,20,22,24,26,28, 36,48,72

GetColorFromRGB(red,green,blue)

Ermittelt den Hex-Farbwert (#RRGGBB) aus den angegebenen Rot-, Grün- und Blauwerten einer Farbe.
red Der Rotanteil der Farbe (0-255).
green Der Grünanteil der Farbe (0-255).
blue Der Blauanteil der Farbe (0-255).
returns Der Hex-Farbwert als #RRGGBB. Dieser kann zum Setzen der Pinsel- oder Stiftfarbe verwendet werden (zB. #808080).
example 'Pinselfarbe als R,G,B setzen
GraphicsWindows.BrushColor = GraphicsWindow.GetColorFromRGB(R,G,B)

GetPixel(x,y)

Ermittelt die Farbe eines Pixels an den gegebenen Koordinaten im GW (als #RRGGBB, für Draw.. Zeichnungen, Text, Images. NICHT für BackgroundColor oder Shapes).
(Standard: #000000, leeres GW)
x Die x-Koordinate des Pixels (>=0,
y Die y-Koordinate des Pixels (>=0,
returns Die Farbe des Pixels als #RRGGBB.

GetRandomColor()

Ermittelt einen gültigen Zufalls-Farbwert (GW wird nicht initialisiert).
returns Ein gültiger zufälliger Farbwert als #RRGGBB.

Height

Ermittelt oder setzt die Höhe des GraphicsWindow (Klientbereich).
(Standard: 442 (452 bei CanResize=False), Fensterhöhe = gh +2*7 (Rand) +22 (Titelleiste); 2-zeilige Taskbarhöhe 60. Kein Rand bei CanResize=False.)
Nicht ermittelbar nach GW.Hide am Beginn. Minimalwert: -38
example tbh = 60 'Taskbarhöhe
ghMax = Desktop.Height -tbh-38 'zB. 670

Hide()

Blendet das GraphicsWindow aus (auch wenn zuvor noch nicht initialisiert, dann bleibt jedoch 'Maximieren' Feld deaktivert).

KeyDown

Ereignisaufruf bei Drücken einer beliebigen Taste (wenn Mauszeiger im GraphicsWindow).
Für weitere Tastaturereignisse s. LDTextWindow.KeyDown und .KeyUp (mit .LastKey, LowLevel für GW u/o TW dh. auch OHNE Fensterfokus).
Für Zeichentasten wird auch 'GW.TextInput' ausgelöst.

KeyUp

Ereignisaufruf bei Loslassen einer Taste (Mauszeiger im GraphicsWindow).
Für weitere Tastaturereignisse s. LDTextWindow.KeyDown und .KeyUp (mit .LastKey, LowLevel für GW u/o TW dh. auch OHNE Fensterfokus).

LastKey

Ermittelt die zuletzt gedrückte/losgelassene Taste im GW (Tastencode für Buchstaben in Großbuchstaben zB. "A"). Bei Abfrage exakte Schreibweise einhalten.
(Standard: None)
example http://msdn.microsoft.com/library/system.windows.input.key.aspx
D0-D9 0-9
NumPad0-NumPad9 0-9 ZiffBl.
F1-F12 Funktion 1-12
Space Leertaste
Left-,RightShift Umschalt
Left-,RightCtrl Strg
System,RightAlt Alt
Return Eingabe
Tab Tabulator
Insert Einfg
Delete Entf
Home Pos1
End Ende
PageUp,Next BildAuf/-Ab
Left,Right,Down,Up ←,→,↓,↑
Add,Subtract +,-´ZiffBl.
Multiply,Divide *,/ ZiffBl.
OemOpenBrackets ß,?
OemQuotes ä,Ä
Oem3,Oem1 ö,Ö, ü,Ü
OemPlus,OemMinus +,*, -,_
OemQuestion #,'

LastText

Ermittelt das Schriftzeichen (Nummer, Buchstabe, Sonderzeichen), das zuletzt im GraphicsWindow eingegeben wurde. Unterscheidet zwischen GROß-/kleinbuchstaben.
Aufruf mittels 'TextInput' Ereignis und Sub (Standard: null).

Left

Ermittelt oder setzt die linke Position des GraphicsWindow (linker Fensterrand) am Desktop.
(Standard: 29 bis 145)
example 'GW Klientbereich links oben
GraphicsWindow.Left = -8
GraphicsWindow.Top = -30

'GW Klientbereich zentriert
GraphicsWindow.Left = (DT.Width-GW.Width)/2 -8
GraphicsWindow.Top = (DT.Height-GW.Height)/2 -30

MouseDown

Ereignisaufruf bei Drücken einer Maustaste (Links, Mitte/Rad oder Rechts) im GraphicsWindow (bzw. Shape). Linke Maustaste nicht für Controls und rechte auch nicht für (MultiLine)TextBox.
Ereignisaufruf für mittlere Maustaste/-rad ergibt sich aus 'Links NOr Rechts'.

MouseMove

Ereignisaufruf bei Bewegung des Mauszeigers (manuell oder programmgesteuert) im GraphicsWindow.

MouseUp

Ereignisaufruf bei Loslassen einer Maustaste (Links, Mitte/Rad oder Rechts) im GraphicsWindow (bzw. Shape). Linke Maustaste nicht für Controls.

MouseX

Ermittelt die x-Position des Mauszeigers im GraphicsWindow (0 bis GW.Width-1). Keine Aktualisierung außerhalb des GW (gibt 0 oder letzte bekannte Pos).

MouseY

Ermittelt die y-Position des Mauszeigers im GraphicsWindow (0 bis GW.Height-1). Keine Aktualisierung außerhalb des GW (gibt 0 oder letzte bekannte Pos).

PenColor

Ermittelt oder setzt die Stiftfarbe, die verwendet wird für Linienzeichnungen im GW, Shapes-Umrandungen und Turtle-Spur (Intern: "_turtleLine#").
(Standard: #000000 dh. 'Black' od. "")
example http://msdn.microsoft.com/library/System.Windows.Media.Colors.aspx
http://i.msdn.microsoft.com/dynimg/IC24340.png

PenWidth

Ermittelt oder setzt die Stiftbreite (Linienzeichnungen im GW, Shapes-Umrandungen und Turtle-Linie). Für Shapes ohne Umrandung (in PenColor) auf 0 setzen. (Standard: 2)
<2 hellere Doppellinie
<=0.18 Einzellinie >=0.07
<0.07 keine Linie

SetPixel(x,y,color)

Zeichnet ein Pixel an den angegebenen Koordinaten des GW in der gewählten Farbe (unabhängig von Pen-/BrushColor).
x Die x-Koordinate des Pixels (>=0).
y Die y-Koordinate des Pixels (>=0).
color Die Farbe des Pixels (zB. "Red" oder "#(AA)RRGGBB" bzw. #(A)RGB, "" für "#000000" bzw. "Black").

Show()

Zeigt das interaktionsbereite GraphicsWindow (wieder) an.

ShowMessage(text,title)

Zeigt ein (dem GW untergeordnetes) Meldungsfenster (zentriert am Desktop) und hält die Programmausführung an, bis 'OK' Button, "Space", "Escape" oder Eingabetaste gedrückt wurde. Max. Breite 480 Pxl bzw. ca. 39-61 Zeichen.
Schrifteigenschaften unveränderlich.
text Der im Meldungsfenster anzuzeigende Text.
title Der Titel des Meldungsfensters.

TextInput

Ereignisaufruf bei Drücken einer Zeichentaste (Nummer, Buchstabe, Sonderzeichen) im GraphicsWindow. Nicht für Steuer-/Funktionstasten. Gemeinsam mit 'GW.KeyDown' Event.

Title

Ermittelt oder setzt den Titel des GraphicsWindow (Tab funktioniert nicht, Systemstandard für Schrifteigenschaften, keine Symbole).
(Standard: Small Basic Graphics Window)

Top

Ermittelt oder setzt die obere Position des GraphicsWindow (Fenster, Oberkante Titelleiste) am Desktop.
(Standard: 29 bis 145)
example 'GW Klientbereich links oben
GraphicsWindow.Left = -8
GraphicsWindow.Top = -30

'GW Klientbereich zentriert
GraphicsWindow.Left = (DT.Width-GW.Width)/2 -8
GraphicsWindow.Top = (DT.Height-GW.Height)/2 -30

Width

Ermittelt oder setzt die Breite des GraphicsWindow (Klientbereich).
Min. Anzeigebreite: 116 (bei GW.Hide/CanResize: 132/126) bei 0, "" oder ungültiger Angabe.
(Standard: 624 (634 bei CanResize=False), Fensterbreite = gw +2*7 Rand. Kein Rand bei CanResize=False.)
Nicht ermittelbar nach GW.Hide am Beginn.
example gwMax = Desktop.Width -2*7 'zB. 1352

ImageList

Ermöglicht das Laden von Bilddateien in den Arbeitspeicher. Benötigt kein GW.
Transparenz in ImageList ist #D3D3D3 bzw. 'LightGray'.
pxlPos x/y: 0 bis GetWidthOfImage-1 bzw. 0 bis GetHeightOfImage-1.
Kopieren mittels img2 = img1 (behält gleiche ImageList#).

ClipImage	GetHeightOfImage	GetWidthOfImage
LoadImage

ClipImage(imageName,left,top,width,height)

Erstellt einen Ausschnitt eines angegebenen Bildes und liefert ein neues Bild mit diesem Ausschnitt (Entfernt in Code und IntelliSense, s. LDImage.Crop).
imageName Das Originalbild von dem der Ausschnitt erstellt wird.
left Die x-Koordinate des Ausschnittsrechtecks.
top Die y-Koordinate des Ausschnittsrechtecks.
width Die Breite des Ausschnittsrechtecks.
height Die Höhe des Ausschnittsrechtecks.
returns Der rechteckige Bildausschnitt.

GetHeightOfImage(imageName)

Ermittelt die Höhe eines angegebenen Bildes (ImageList oder Datei).
imageName Der Name des Bildes in ImageList, ImageList# oder voller Dateipfad.
returns Die Höhe des Bildes [Pxl] oder 0.

GetWidthOfImage(imageName)

Ermittelt die Breite eines angegebenen Bildes (ImageList oder Datei).
imageName Der Name des Bildes in ImageList, ImageList# oder voller Dateipfad.
returns Die Breite des Bildes [Pxl] oder 0.

LoadImage(fileNameOrUrl)

Lädt eine lokale oder Netzwerk Bilddatei in den Arbeitsspeicher (Intern: ImageList#+1).
ImageListName = "" entfernt das Bild aus ImageList, nicht jedoch die ImageList#.
Bei ICO Dateien mit mehreren Symbolen wird das größte Bild daraus geladen. Nicht für CUR Dateien. Keine Gif-Animation.
fileNameOrUrl Der volle Dateipfad des Bildes als lokale oder Netzwerkdatei (BMP, (anim)gif, ico, jp(e)g, PNG, tiff).
returns Der Name des neu geladenen ImageList Bildes, sonst "" (wenn fileNameOrUrl "").
example ImageList.LoadImage("") erstellt KEINE neue/leere ImageList#.
ImageList.LoadImage(" ") oder nichtexistenter Bildpfad erstellt neue/leere ImageList#+1, aber kein verwendbares Bild.

Math

Hilfreiche mathematische Methoden.
Wissenschaftliche Notation in der Form "-num.dezE-exp", zB:
555 - "1e3" '-445
"-.5E02" * 3 '-150
1 / "500E-2" '0.2
TextWindow.Write(0+"7.9228e28") '~maxNum
example Dezimalausgabe zwar mit Komma ',' aber intern wird Dezimalpunkt '.' verwendet.
s. http://social.technet.microsoft.com/wiki/contents/articles/19330.small-basic-parameter-or-return-value-range-for-math-function.aspx

Abs(number)

Ermittelt den Absolutwert einer Zahl, zB. gibt -32.233 den Wert 32.233 zurück.
Entfernt endende Nullen von Dezimalzahlen (s. Math.Power).
number Die Zahl deren Absolutwert zu ermitteln ist.
returns Der absolute Wert der Zahl.
example 'Endende Nullen entfernen
Math.Abs(-0.12300) '0.123

'Vorzeichen Funktion sgn(n)
If n = 0 Then
sgn = 0
Else
sgn = n/Math.Abs(n)
EndIf

'FlipFlop 0<->1
n = 1-Math.Abs(n) = Math.Abs(n-1) = Math.Abs(1-n)
'FlipFlop 0<->-1
n = Math.Abs(n)-1 = -Math.Abs(n+1)

ArcCos(cosValue)

Ermittelt den Bogenmaßwinkel aus dem Cosinuswert, [°] = [rad] * 180/pi.
cosValue Der Cosinuswert dessen Winkel zu ermitteln ist.
returns Der Bogenmaßwinkel [rad] für den angegebenen Cosinuswert (0 bis pi).
example https://en.wikipedia.org/wiki/Inverse_trigonometric_functions

ArcSin(sinValue)

Ermittelt den Bogenmaßwinkel aus dem Sinuswert, [°] = [rad] * 180/pi.
sinValue Der Sinuswert dessen Winkel zu ermitteln ist.
returns Der Bogenmaßwinkel [rad] für den angegebenen Sinuswert (-pi/2 bis pi/2).

ArcTan(tanValue)

Ermittelt den Bogenmaßwinkel aus dem Tangenswert, [°] = [rad] * 180/pi.
tanValue Der Tangenswert dessen Winkel zu ermitteln ist.
returns Der Bogenmaßwinkel [rad] für den angegebenen Tangenswert (-pi/2 bis pi/2).
example ArcTan(-x) = -ArcTan(x)
ArcTan(1/x) = pi/2 - ArcTan(x)
ATan2(y,x) = ArcTan(y/x) 'x>0
ArcCot(x) = ArcTan(1/x) 'x>0
ArcCot(x) = pi/2 - ArcTan(x)

Ceiling(number)

Ermittelt eine Ganzzahl, mit dem gleichen Wert wie die angegebene Dezimalzahl oder größer als diese. zB. gibt 32.233 den Wert 33 zurück (-32.233 gibt -32).
Aufrunden zur nächst höheren Ganzzahl (Gegenstück zu Math.Floor).
number Die Zahl deren größter Wert zu ermitteln ist.
returns Der größte Wert der angegebenen Zahl.
example 'Aufrunden zu max. 2 Dezimalen
Ceiling(100*n)/100 'zB. 123
'Aufrunden IMMER zu 2 Dezimalen (auch Ganzzahl)
Ceiling(100*n)*0.01 'zB. 123.00

Cos(angle)

Ermittelt den Cosinus (Ak/Hy) des angegebenen Winkels im Bogenmaß, [rad] = [°] * pi/180.
angle Der Winkel [rad] dessen Cosinuswert zu ermitteln ist.
returns Der Cosinus des angegebenen Winkels [-1,1] (x im Einheitskreis).
example Cos(-w) = Cos(w)
Cos(w) = -Cos(w+pi)
Cos(w) = Sin(pi/2 - w)
Cos²(w) = 1 - Sin²(w)

Floor(number)

Ermittelt eine Ganzzahl, mit dem gleichen Wert wie die angegebene Dezimalzahl oder kleiner als diese. zB. gibt 32.233 den Wert 32 zurück (-32.233 gibt -33).
Abrunden zur nächst niedrigeren Ganzzahl (Gaußklammer, Gegenstück zu Math.Ceiling).
number Die Zahl deren kleinster Wert zu ermitteln ist.
returns Der kleinste Wert der angegebenen Zahl.
example 'Abrunden zu max. 2 Dezimalen
Floor(100*n)/100 'zB. 123
'Abrunden IMMER zu 2 Dezimalen (auch Ganzzahl)
Floor(100*n)*0.01 'zB. 123.00
'n oder nächste Geradzahl
2 * Math.Floor((n+1)/2)
'n oder vorige Geradzahl
2 * Math.Ceiling((n-1)/2)
'n oder nächste UNgeradzahl
2 * Math.Ceiling((n-1)/2) +1
'n oder vorige UNgeradzahl
2 * Math.Floor((n+1)/2) -1

GetDegrees(angle)

Umrechnung eines Winkels vom Bogenmaß zum Gradmaß, [°] = [rad] * 180/pi.
angle Der Winkel im Bogenmaß [rad].
returns Der umgewandelte Winkel [°].
example '1rad = 180/pi [°]
Math.GetDegrees(1) '= 180/pi ~57.3°
rad2deg = 57.295779513082379939

GetRadians(angle)

Umrechnung eines Winkels vom Gradmaß zum Bogenmaß, [rad] = [°] * pi/180.
angle Der Winkel [°].
returns Der umgewandelte Winkel im Bogenmaß [rad].
example Math.GetRadians(1) '= pi/180 ~11/630 [1/°]
deg2rad = 0.017453292519943295

GetRandomNumber(maxNumber)

Ermittelt eine Zufallszahl zwischen 1 und der gegebenen Zahl (inkl.), 1<=Rand<=max.
maxNumber Die Obergrenze für die ermittelte Zufallszahl (<= 2147483647 = Int32.MaxValue, <=1 ergibt 1).
returns Eine Zufallszahl >=1, die kleiner oder gleich der angegebenen Zahl ist.
example 'min <= rnd <= max
rnd = min-1 + Math.GetRandomNumber(max-min+1)
'A - Z (65-90)
n = 64 + Math.GetRandomNumber(26)
chr = Text.GetCharacter(n)
'Zahl zw. 0.001 und 0.999
Math.GetRandomNumber(999)/1000
'Ausgabe -1 oder +1
2*Math.GetRandomNumber(2) - 3
'Ausgabe [-r,+r] (incl. 0)
Math.GetRandomNumber(2*r+1) -r-1
'Ausgabe [-r,+r] (ohne 0)
2*Math.GetRandomNumber(r+1) -r-2

Log(number)

Ermittelt den dekadischen Logarithmus (Basis 10) der angegebenen Zahl.
number Die Zahl deren Logarithmus zu ermitteln ist.
returns Der dekadische Logarithmus der angegebenen Zahl.
example log(a*b) = log(a) + log(b)
log(a/b) = log(a) - log(b)
log(a^b) = b * log(a)
log(a^(1/b)) = log(a) / b
'lg(n) zur Basis B
lgB(n) = log(n)/log(B)

Max(number1,number2)

Vergleicht zwei Zahlen und gibt die größere der beiden zurück.
number1 Die erste der beiden Vergleichszahlen.
number2 Die zweite der beiden Vergleichszahlen.
returns Die größere der beiden Zahlen.

Min(number1,number2)

Vergleicht zwei Zahlen und gibt die kleinere der beiden zurück.
number1 Die erste der beiden Vergleichszahlen.
number2 Die zweite der beiden Vergleichszahlen.
returns Die kleinere der beiden Zahlen.

NaturalLog(number)

Ermittelt den natürlichen Logarithmus (Basis e) der angegebenen Zahl.
number Die Zahl deren natürlicher Logarithmus zu ermitteln ist.
returns Der natürliche Logarithmus der angegebenen Zahl.
example ln(a*b) = ln(a) + ln(b)
ln(a/b) = ln(a) - ln(b)
ln(a^b) = b * ln(a)
ln(a^(1/b)) = ln(a)/b
'lg(n) zur Basis B
lgB(n) = ln(n)/ln(B)
e = n^(1/ln(n)) 'n>1

Pi

Ermittelt den Wert der Zahl Pi mit 14 Dezimalstellen (3.14159265358979).

Power(baseNumber,exponent)

Ermittelt die angegebene Potenz der Zahl baseNumber.
Math.Power(dezZahl,1) entfernt endende Nullen von Dezimalzahlen (s. Math.Abs).
Math.Power(base,-n) fügt endende Nullen an (Dezimalstellen).
baseNumber Die Zahl deren Potenz zu ermitteln ist (>=0 bei dezimalem exponent).
exponent Der Exponent zu dem die Basis potenziert wird.
returns Die angebenene Potenz der Zahl baseNumber.
example Math.Power(64, 1/3) 'pos. Kubikwurzel
'Entfernen endender Nullen
Math.Power(-0.12300,1) '-0.123
'Wissensch. Notation (Dezimalen)
1000 * Math.Power(10,-2) '10.00
1000 * "1E-2" '10.00

Remainder(dividend,divisor)

Teilt den Zähler z durch den Nenner n und gibt den +/- Rest r zurück:
r = sgn(z) * (|z| - |n| * floor(|z|/|n|))
dividend Die zu teilende Zahl (Zähler z).
divisor Die Zahl durch die geteilt wird (Nenner, n<>0).
returns Der +/- Divisionsrest (Modulo, z % n) mit dem Vorzeichen des Zählers z (- n-1 ..0.. + n-1).
example Math.Remainder(9,10) '9
Math.Remainder(10,10) '0
Math.Remainder(11,10) '1

'Dezimalteil von n
dez = Math.Remainder(n, 1)

'Zyklus durch Intervall
i = Math.Remainder(i, n)+1 '[1,n]
i = Math.Remainder(i+1, n) '[1..n,0]
i = Math.Remainder(1-i, n) '[1,0,1,0,..]

'Bidirekt. Zyklus durch Intervall [a,z]
n = a 'bis z
d = 1 '-/+ delta
n = Remainder(z+ Remainder(n+d -z-a, z-a+1), z-a+1)+a

'0,1,..,9 zu 10,1,..,9
n = Math.Max(Math.Remainder(n+10,11),n)

Round(number)

Rundet eine gegebene Zahl auf die nächstliegende Ganzzahl. 32.23 wird zB. auf 32 abgerundet,
während 32.56 auf 33 aufgerundet wird (-32.23 wird auf -32 aufgerundet und -32.56 zu -33 abgerundet).
'Banker Rundung' in Richtung Geradzahl dh.: 32.5 zu 32 aber 33.5 zu 34 (-32.5 zu -32, -33.5 zu -34).
number Die Zahl deren Näherungswert zu ermitteln ist.
returns Der gerundete Wert der angegebenen Zahl.
example 'Runden zu max. 2 Dezimalen
Round(100*n)/100 'zB. 123
'Runden IMMER zu 2 Dezimalen (auch Ganzzahl)
Round(100*n)*0.01 'zB. 123.00
'n runden auf Vielfache von x
Round(n/x) * x

Sin(angle)

Ermittelt den Sinus (Gk/Hy) des angegebenen Winkels im Bogenmaß, [rad] = [°] * pi/180.
angle Der Winkel [rad] dessen Sinuswert zu ermitteln ist.
returns Der Sinus des angegebenen Winkels [-1,1] (y im Einheitskreis).
example Sin(-w) = -Sin(w)
Sin(w) = -Sin(w+pi)
Sin(w) = Cos(pi/2-w)
Sin²(w) = 1 - Cos²(w)

SquareRoot(number)

Ermittelt die Quadratwurzel einer angegebenen positiven Zahl.
number Die positive Zahl deren Quadratwurzel zu ermitteln ist.
returns Die Quadratwurzel der gegebenen Zahl bei Erfolg, sonst 0 (zB. -4, "").

Tan(angle)

Ermittelt den Tangens (Gk/Ak, Sin/Cos) des angegebenen Winkels im Bogenmaß, [rad] = [°] * pi/180.
angle Der Winkel [rad] dessen Tangenswert zu ermitteln ist.
returns Der Tangens des angegebenen Winkels (Steigung y/x im Einheitskreis).
example Tan(-w) = -Tan(w)
Tan(w) = Tan(w+pi)
Cot(w) = 1/Tan(w) = Tan(pi/2-w)

Mouse

Ermöglicht den Zugriff auf Mauseigenschaften wie Zeigerkoordinaten, Zeigersymbol usw. Je nach Funktion für gesamten Desktop oder nur GW.
GW.MouseDown Ereignis für mittlere Maustaste/-rad ergibt sich aus 'Links NOr Rechts'.

HideCursor	IsLeftButtonDown	IsRightButtonDown
MouseX	MouseY	ShowCursor

HideCursor()

Blendet den Mauszeiger aus (nur GW).

IsLeftButtonDown

Ermittelt ob die linke Maustaste gedrückt ist (gesamter Desktop, Standard: "False").
Status für mittlere Maustaste/-rad ergibt sich aus 'Links NOr Rechts' im Ereignisaufruf.

IsRightButtonDown

Ermittelt ob die rechte Maustaste gedrückt ist (gesamter Desktop, Standard: "False").
Status für mittlere Maustaste/-rad ergibt sich aus 'Links NOr Rechts' im Ereignisaufruf.

MouseX

Ermittelt oder setzt die x-Position des Mauszeigers (gesamter Desktop, 0 bis Desktop.Width-1).
Bei Positionsänderung im GW wird auch 'GW.MouseMove' Event ausgelöst.

MouseY

Ermittelt oder setzt die y-Position des Mauszeigers (gesamter Desktop, 0 bis Desktop.Height-1).
Bei Positionsänderung im GW wird auch 'GW.MouseMove' Event ausgelöst.

ShowCursor()

Macht den Mauszeiger sichtbar (nur GW).

Network

Bietet Zugriff auf Netzwerkmethoden.

DownloadFile

GetWebPageContents

DownloadFile(url)

Download einer Netzwerkdatei in eine lokale temporäre Datei (%TEMP%\tmp????.tmp).
url Die Url der Netzwerkdatei (http://..). Ein bestehender lokaler Dateipfad wird nach temp. Pfad kopiert.
returns Der lokale Dateipfad unter dem die Netzwerkdatei gespeichert wurde bei Erfolg, sonst "".
Datum der gespeicherten Downloaddatei wird auf aktuelles Datum gesetzt.

GetWebPageContents(url)

Ermittelt den Textinhalt einer angegebenen Webseite (auch für Binärdateien, jedoch nur sinnvoll für textbasierte Dateien) oder lokalen Textdatei.
url Die Url der Webseite (http://)www... oder lokaler Dateipfad (zB. lokale Heimnetzwerk IPAdresse 192.168.1.99, http://familiePC).
returns Der Textinhalt (Quelltext) der angegebenen Webseite oder lokalen Textdatei.

Program

Funktionen zur Kontrolle der Programmausführung.
SB unterstützt auch "." (CurrDir), ".." (ParentDir), relative Pfade und %PFADE%.

ArgumentCount	Delay	Directory
End	GetArgument

ArgumentCount

Ermittelt die Anzahl der Befehlszeilenargumente, die an das Programm übergeben wurden. (Standard: 0)

Delay(milliSeconds)

Verzögert die Programmausführung um die angegebene Anzahl Millisekunden. Möglichst nicht innerhalb von Event-Subs oder daraus aufgerufenen Subs, sondern in Hauptschleife.
milliSeconds Die Dauer der Verzögerung [ms].

Directory

Ermittelt den Ordnerpfad für die aktuell ausgeführte Programmdatei.
SB unterstützt auch "." (CurrDir), ".." (ParentDir), relative Pfade und %PFADE%.
example Program.Directory +"\Datei.ext" ' ".\Datei.ext"

End()

Beendet das aktuelle Programm.

GetArgument(index)

Ermittelt das angegebene Argument, das an dieses Programm übergeben wurde (max. Gesamtlänge 8191 Zeichen).
index Der Index des Arguments (1 bis 'ArgumentCount').
returns Das Befehlszeilenargument am angegebenen Index oder "" wenn dieses nicht existiert.

Shapes

Ermöglicht das Hinzufügen, Bewegen und Rotieren von Formen (Geometrie-, Bild- oder TextShapes) im GraphicsWindow. Funktioniert zT. auch für Controls (Interne Namensverarbeitung).
Gegen Flackern, die Shape(s) bei verstecktem GW hinzufügen oder als transparente Geometrie-/Bildshape bzw. leere TextShape ("") oder leeres Rectangle/Ellipse (0) oder Triangle/Line außerhalb des GW (<0, >gw).

AddEllipse	AddImage	AddLine
AddRectangle	AddText	AddTriangle
Animate	GetLeft	GetOpacity
GetTop	HideShape	Move
Remove	Rotate	SetOpacity
SetText	ShowShape	Zoom

AddEllipse(width,height)

Fügt eine gefüllte Ellipse der angegebenen Breite und Höhe hinzu (Intern: Ellipse#).
width Die Breite der Ellipse (0/+ Werte, 0 gibt keine Anzeige, LeerEllipse).
height Die Höhe der Ellipse (0/+ Werte, 0 gibt keine Anzeige, LeerEllipse).
returns Der Shapename der Ellipse.

AddImage(imageName)

Fügt ein Bild als Bildshape hinzu, das bewegt, rotiert oder als Animation ausgeführt werden kann (Intern: Image#).
Die Abmessungen der Bildshape entsprechen der Bildgröße (s. ImageList.Get..OfImage) und können mit Controls.SetSize geändert werden.
ImageList Bild kann danach aus ImageList entfernt werden (LDImage.Remove).
Bild kann nach LDControls.AllowDrop per Drag&Drop geändert werden.
imageName Der Bildname in ImageList oder (Web)Dateipfad des anzuzeigenden Bildes (BMP, gif, ico, jp(e)g, PNG, tiff).
returns Der Name der Bildshape.
example Leershape erstellbar mit transparentem png Bild.
Shapes.AddImage("") 'erstellt neue leere Image# aber keine verwendbare Bildshape.

AddLine(x1,y1,x2,y2)

Fügt eine Gerade zwischen den angegebenen Punkten in PenColor hinzu (Intern: Line#).
x1 Die x-Koordinate von Punkt 1 (-/0/+).
y1 Die y-Koordinate von Punkt 1 (-/0/+).
x2 Die x-Koordinate von Punkt 2 (-/0/+).
y2 Die y-Koordinate von Punkt 2 (-/0/+).
returns Der Shapename der Linie. Ankerpunkt der Shape ist (0;0).
example dx = Math.Abs(x2 - x1)
dy = Math.Abs(y2 - y1)
l = Math.SquareRoot(dx*dx + dy*dy)
w = Math.ArcTan((y2-y1)/(x2-x1)) '-pi/2 bis pi/2

AddRectangle(width,height)

Fügt ein gefülltes Rechteck der angegebenen Breite und Höhe hinzu (Intern: Rectangle#).
width Die Breite des Rechtecks (0/+ Werte, 0 gibt keine Anzeige, LeerRechteck).
height Die Höhe des Rechtecks (0/+ Werte, 0 gibt keine Anzeige, LeerRechteck).
returns Der Shapename des Rechtecks.
example 'Rotes Rechteck mit blauem Rahmen
GraphicsWindow.BrushColor = "Red"
GraphicsWindow.PenColor = "Blue"
GraphicsWindow.PenWidth = 20
Shapes.AddRectangle(200,100)

AddText(text)

Fügt Text als Textshape hinzu, die bewegt, rotiert oder als Animation ausgeführt werden kann. Der Text kann mit SetText aktualisiert werden.
Texteigenschaften bestimmbar durch vorangehendes BrushColor sowie Font-Eigenschaften, Größe durch Controls-/LDShapes.SetSize und Hintergrundfarbe durch LDShapes.BrushColour.
Shapehöhe: 14.5 , Shapebreite/Buchst: 7 (bei FontSize 12).
Auch im Hintergrund (Intern: Text#).
text Der Text (linksbündig), der in der Shape angezeigt wird.
returns Der Name der Textshape.
example 'Neue leere Text# erstellen
Shapes.AddText("")

AddTriangle(x1,y1,x2,y2,x3,y3)

Fügt ein gefülltes Dreieck anhand der angegebenen Punkte hinzu (Intern: Triangle#).
x1 Die x-Koordinate von Punkt 1 (-/0/+).
y1 Die y-Koordinate von Punkt 1 (-/0/+).
x2 Die x-Koordinate von Punkt 2 (-/0/+).
y2 Die y-Koordinate von Punkt 2 (-/0/+).
x3 Die x-Koordinate von Punkt 3 (-/0/+).
y3 Die y-Koordinate von Punkt 3 (-/0/+).
returns Der Shapename des Dreiecks.

Animate(shapeName,x,y,duration)

Bewegt eine angegebene Shape animiert an eine neue Position. Als asynchroner Thread wartet die Programmausführung nicht auf dessen Beendigung. Daher ev. Program.Delay(duration) anschließen. (s. Shapes.Move)
shapeName Der Name der zu animierenden Shape.
x Die x-Koordinate der neuen Position.
y Die y-Koordinate der neuen Position.
duration Die Dauer der Animation [ms] (duration >= 0). 0 verschiebt unmittelbar.
example 'Animation über 1/2 Breite, dann Sprung
ell = Shapes.AddEllipse(10,10)
Shapes.Animate(ell, GraphicsWindow.Width,0, 5000)
Program.Delay(2500)
Shapes.Animate(ell, GraphicsWindow.Width,0, 0)

GetLeft(shapeName)

Ermittelt die linke Koordinate des Ankerpunktes einer angegebenen Shape. Unbeeinflußt von Shapes.Zoom oder -Rotate. Nicht für Controls, dazu erst ein Shape-Kommando zB. Shapes.Move für Control anwenden.
shapeName Der Name der Shape.
returns Die linke x-Koordinate [Pxl] der Shape im GW (0 bei Erstellung).

GetOpacity(shapeName)

Ermittelt die Deckkraft [%] einer Shape.
shapeName Der Name der Shape.
returns Die Deckkraft der Shape von 0 bis 100 [%]. 0 ist völlig transparent, 100 ist deckend.
example Alternativ für Zeichnungen und (Text)Shapes aus deren BrushColor #AARRGGBB, für AA = 00 (transparent) bis FF (deckend).

GetTop(shapeName)

Ermittelt die obere Koordinate des Ankerpunktes einer angegebenen Shape. Unbeeinflußt von Shapes.Zoom oder -Rotate. Nicht für Controls, dazu erst ein Shape-Kommando zB. Shapes.Move für Control anwenden.
shapeName Der Name der Shape.
returns Die obere y-Koordinate [Pxl] der Shape im GW (0 bei Erstellung).

HideShape(shapeName)

Blendet eine bereits hinzugefügte Shape aus (s. Controls.HideControl, Shapeposition bleibt unverändert. Animate, GetLeft/-Top, Move, SetText, Rotate, Zoom funktionieren weiterhin).
shapeName Der Name der Shape.

Move(shapeName,x,y)

Verschiebt die angegebene Shape an ihrem Ankerpunkt unmittelbar an eine neue Position (s. Shapes.Animate, Controls.Move). Auch bei versteckter Shape bzw. verstecktem GW, wenn dieses VOR GW.Hide bereits initialisiert wurde.
shapeName Der Name der zu verschiebenden Shape.
x Die x-Koordinate der neuen Position (l.o. Ecke des umgebenden Originalrechtecks).
y Die y-Koordinate der neuen Position (l.o. Ecke des umgebenden Originalrechtecks).

Remove(shapeName)

Entfernt eine Shape aus dem GraphicsWindow (Interne # bleibt unverändert).
shapeName Der Name der zu entfernenden Shape.

Rotate(shapeName,angle)

Dreht die angegebene Shape optisch um den angegebenen Winkel ab Originalposition (um Mittel-/Schwerpunkt der Gesamtshape).
shapeName Der Name der zu rotierenden Shape (bzw. Control).
angle Der Winkel [°] um den die Shape/Control ab Originalposition gedreht wird (+/- für im/gegen Uhrzeigersinn).
example Shapes.Rotate(shp, -380) '20° Linksdrehung ab OrigPos.

SetOpacity(shapeName,level)

Setzt die Deckkraft [%] einer Shape/Control.
shapeName Der Name der Shape.
level Die Deckkraft von 0 bis 100 [%]. 0 ist völlig transparent, 100 ist deckend.
example Alternativ für Zeichnungen und (Text)Shapes über deren BrushColor als #AARRGGBB, für AA = 00 (transparent) bis FF (deckend).

SetText(shapeName,text)

Setzt oder ändert den Text in einer Textshape.
shapeName Der Name der Textshape.
text Der zu setzende Text.

ShowShape(shapeName)

Zeigt eine ausgeblendete Shape an der zuletzt definierten Position wieder an (s. Controls.ShowControl).
shapeName Der Name der Shape.

Zoom(shapeName,scaleX,scaleY)

Vergrößert oder verkleinert eine Shape optisch mittels der angegebenen Zoomwerte von 0.1 bis 20 (s.a. Contols.SetSize, LDShapes.Re-/SetSize).
Die Größenänderung erfolgt im Mittelpunkt der Shape nur optisch, dh. dieser, der Ankerpunkt und die tatsächlichen Abmessungen der Basisshape bleiben erhalten.
shapeName Der Name der zu verkleinernden oder vergrößernden Shape.
scaleX Der Zoomfaktor in x-Richtung (0.1 bis 20, <1 verkleinert, >1 vergrößert, neg. Wert -> 0.1).
scaleY Der Zoomfaktor in y-Richtung (0.1 bis 20, <1 verkleinert, >1 vergrößert, neg. Wert -> 0.1).

Sound

Methoden zur Soundwiedergabe. Auch einige Beispiel Sounds sind enthalten.
Für SystemBeep (im TW) s. Text.GetCharacter(7).

Pause	Play	PlayAndWait
PlayBellRing	PlayBellRingAndWait	PlayChime
PlayChimeAndWait	PlayChimes	PlayChimesAndWait
PlayClick	PlayClickAndWait	PlayMusic
Stop

Pause(filePath)

Pausiert das Abspielen einer Audiodatei. Wird die Datei nicht gerade abgespielt, führt diese Operation nichts aus.
filePath Der volle Pfad der Audiodatei. zB. C:\Musik\Titel1.mp3 für einen lokalen oder "http://sounds.com/titel1.wma" für einen Netzwerkpfad.

Play(filePath)

Spielt eine Audiodatei ab (zB. im Hintergrund). Es kann sich hierbei um eine mp3, wav, wma (bzw. au, flac, m4a, ogg) Datei handeln. Andere Formate hängen von den am Computer installierten Codecs ab.
Wenn das Abspielen der Datei bereits angehalten wurde, startet diese Operation das Abspielen erneut. Zum Abspielen für eine bestimmte Dauer ev. weitere Programmausführung anhalten (asynchron).
filePath Der volle Pfad der Audiodatei. zB. "C:\Musik\Titel1.mp3" für einen lokalen oder "http://sounds.com/titel1.wma" für einen Netzwerkpfad.

PlayAndWait(filePath)

Spielt eine Audiodatei ab und wartet, bis der Vorgang abgeschlossen ist. Es kann sich hierbei um eine mp3, wav, wma (bzw. au, flac, m4a, ogg) Datei handeln. Andere Formate hängen von den am Computer installierten Codecs ab.
Wenn das Abspielen der Datei bereits angehalten wurde, startet diese Operation das Abspielen erneut.
filePath Der volle Pfad der Audiodatei. zB. "C:\Musik\Titel1.mp3" für einen lokalen oder "http://sounds.com/titel1.wma" für einen Netzwerkpfad.

PlayBellRing()

Spielt den Glockenzeichen Sound ab (asynchron).

PlayBellRingAndWait()

Spielt den Glockenzeichen Sound ab und wartet bis Abspielvorgang abgeschlossen ist.

PlayChime()

Spielt den Glockenton Sound ab (asynchron).

PlayChimeAndWait()

Spielt den Glockenton Sound ab und wartet bis Abspielvorgang abgeschlossen ist.

PlayChimes()

Spielt den Glockenläuten Sound ab (asynchron).

PlayChimesAndWait()

Spielt den Glockenläuten Sound ab und wartet bis Abspielvorgang abgeschlossen ist.

PlayClick()

Spielt den Mausklick Sound ab (asynchron).

PlayClickAndWait()

Spielt den Mausklick Sound ab und wartet bis Abspielvorgang abgeschlossen ist.

PlayMusic(notes)

Spielt Musiknoten synchron von einer Zeichenkette ab (nicht für Hintergrund, Programmausführung solange angehalten).
Standardinstrument: 1 - Acoustic_Grand_Piano

Music Markup Language (MML) Specification
http://xml.coverpages.org/mml-spec19990610.html
notes Ein String abzuspielender Musiknoten. Format ist Teil der in QBasic unterstützten Music Markup Language (MML).
Oktave: O1-O8 (<|> 1 Oktave ab|auf; Std: O4)
Note: C,D,E,F,G,A,B (-|+,# Halbton ab|auf; . 1.5x Dauer)
Länge: L1-L64 (Ln, Std: L4) oder Note+n
Pause: R od. P (Länge wie Noten)
Leerzeichen werden ignoriert
example Sound.PlayMusic("O5 C8 C8 G8 G8 A8 A8 G4 F8 F8 E8 E8 D8 D8 C4")

Stop(filePath)

Beendet die Wiedergabe einer Audiodatei. Wird die Datei nicht gerade abgespielt, führt diese Operation nichts aus.
filePath Der volle Pfad der Audiodatei. zB. "C:\Musik\Titel1.mp3" für einen lokalen oder "http://sounds.com/titel1.wma" für einen Netzwerkpfad.

Stack

Ermöglicht das Zwischenspeichern von Werten (Zahl, String, Var) in einem Stapel. Ein Wert kann zuoberst auf den Stapel abgelegt und von dort wieder abgenommen werden.
Es muß ein Wert nach dem anderen wieder vom Stapel abgenommen werden, beginnend mit dem Wert, der zuletzt im Stapel abgelegt wurde (Umgekehrte Reihenfolge, zuletzt rein-zuerst raus).
Stackname in "" oder vordefiniert. Exakte Schreibweise einhalten.

GetCount

PopValue

PushValue

GetCount(stackName)

Ermittelt die Anzahl der Werte im angegebenen Stapel.
stackName Der Name des Stapels (in "" oder vordefiniert). Exakte Schreibweise einhalten.
returns Die Anzahl der Werte im angegebenen Stapel oder 0.

PopValue(stackName)

Ermittelt (und entfernt) den obersten Wert im angegebenen Stapel (Fehlerabbruch, wenn Stapel leer ist).
stackName Der Name des Stapels (in "" oder vordefiniert). Exakte Schreibweise einhalten.
returns Der entladene, oberste Wert (kann auch "" sein) bei Erfolg, sonst Fehlerabbruch.
example val = Stack.PopValue("st")
v2 = Stack.PopValue(123)

PushValue(stackName,value)

Lädt/Setzt einen Wert 'oben' in den angegebenen Stapel.
stackName Der Name des Stapels (in "" oder vordefiniert). Exakte Schreibweise einhalten.
value Der zu ladende Wert (auch Leerwerte "" möglich).
example 'als Stringname
Stack.PushValue("st", 5.5)
'als Variablenname
st = 123
Stack.PushValue(st, "")

Text

Stringfunktionen zur Textverarbeitung. Diese unterscheiden zw. GROß-/kleinschreibung (zB. A<>a). zT. auch für Arrays anwendbar (zB. IsSubText usw.).
Ein Einzelstring darf auch ein/mehrere "" enthalten, jedoch nicht am Stringbeginn oder -ende.
example http://msdn.microsoft.com/library/windows/desktop/dd374081.aspx (Unicode Zeichen)

Append	ConvertToLowerCase	ConvertToUpperCase
EndsWith	GetCharacter	GetCharacterCode
GetIndexOf	GetLength	GetSubText
GetSubTextToEnd	IsSubText	StartsWith

Append(text1,text2)

Verbindet zwei Zeichenfolgen (Texte, Arrays, Variableninhalte) und gibt den Gesamtstring zurück. Nützlich bei Verarbeitung von unbekanntem Text in Variablen, der irrtümlich als Zahl behandelt und addiert werden könnte, anstatt zusammengefügt (Alternativ: '+').
text1 Der erste Teilstring.
text2 Der zweite Teilstring.
returns Der zusammengefügte String beider Teile.
example 'Führende spc/0 (zB. 3-st. Zeilennummer)
pre = " " 'od. "00"
For n = 1 To 110
z = Text.GetSubTextToEnd(Text.Append(pre,n), Text.GetLength(n))
TextWindow.WriteLine(z+": "+n)
EndFor

ConvertToLowerCase(text)

Konvertiert den angegebenen Text (bzw. gesamten Arrayinhalt) zu Kleinbuchstaben.
text Der Text oder Array, der in Kleinbuchstaben umzuwandeln ist.
returns Der angegebene Text bzw. Array in Kleinbuchstaben.

ConvertToUpperCase(text)

Konvertiert den angegebenen Text (bzw. gesamten Arrayinhalt) zu Großbuchstaben.
text Der Text oder Array, der in Großbuchstaben umzuwandeln ist.
returns Der angegebene Text bzw. Array in Großbuchstaben.

EndsWith(text,subText)

Ermittelt ob ein Text mit dem angegebenen String (buchstabengetreu) endet.
text Der zu durchsuchende Text.
subText Die gesuchte Zeichenfolge am Textende.
returns "True" wenn die Zeichenfolge am Textende gefunden wurde, sonst "False".

GetCharacter(characterCode)

Ermittelt das entsprechende Zeichen zu einem angegebenen Unicode Zahlencode. Dieses kann dann als normaler Textstring verwendet werden.
characterCode Der dekadische Unicode Zahlencode (UTF-16) für das Zeichen. Hex Unicode Codes (#xxxx) erst konvertieren (max. 65535 = #FFFF).
SMP Zeichen >65535 durch Kombination der Surrogate, zB. (55357)+(56459) für 💋 (kiss, 128139 = #1F48B).
returns Das entsprechende Unicode Zeichen ("", "0" oder 0 ergibt ' ' bzw. chr(0)).
example 'Umlaute, Smileys
arrUml="196=Ä;214=Ö;220=Ü;223=ß;228=ä;246=ö;252=ü;"
arrSmil="9785=☹;9786=☺;9787=☻;"

7 SystemBeep (im TW)
8 bs (BackSpace)
9 tab (8 stellig)
10 lf
13 cr 13+10 crlf
32 space ( )
34 qu (")
160 nbsp ( )
175 macron (¯)
818 u̲nderl
960 pi (π)
8364 euro (€)
8776 ungefähr (≈)
8800 ungleich (≠)
8801 identisch (≡)
10003 check (✓)
10067 quest (❓)
65533 repl (�)
55357+56524 pin (📌)
55357+56590 find (🔎)

GetCharacterCode(character)

Ermittelt den dekadischen Unicode (UTF-16) Zahlencode für ein angegebenes Zeichen. Für mehrere Zeichen oder Zahl, den Unicode Zahlencode des ersten Zeichens/Ziffer.
character Das Zeichen, dessen Unicode Zahlencode zu ermitteln ist.
returns Der dekadische Unicode Zahlencode für das (erste) Zeichen ("" ergibt 0, bis max. 65535 = #FFFF).
Für charCode >= 65536 (#10000) wird Math.Remainder(charCode, 65536) zurückgegeben.
Für SMP Zeichen >= U+10000, der dekadische Unicode Zahlencode für das erste/höhere Surrogat.
example 'Zeichen -> Code
0..9 '48-57
A..Z '65-90
a..z '97-122

'Whitespace Zeichen (tab,lf,cr,space)
arrWS="1=9;2=10;3=13;4=32;"
WS: 9-13,32,133,160,5760,8192-8203,8232,8233,12288,65279

GetIndexOf(text,subText)

Ermittelt die erste Position einer Zeichenfolge (buchstabengetreu) in einem angegebenen Text.
text Der zu durchsuchende Text.
subText Die zu suchende Zeichenfolge, Zeichen oder Zahl.
returns Die erste Position (ab 1) an der die Zeichenfolge im angegebenen Text gefunden wurde, sonst 0.

GetLength(text)

Ermittelt die Anzahl der Zeichen in einem angegebenen Text/String oder Zahl.
Bzw. Anzahl der Surrogate bei enthaltenen SMP Zeichen (2 / SMP-Zeichen).
text Der Text dessen Länge zu ermitteln ist.
returns Die Zeichenanzahl im angegebenen Text bzw. 0 für "".
example Text.GetLength("False") '5
Text.GetLength("-""-") '4
Text.GetLength(-123) '4
Text.GetLength(-.123) '6 (für -0.123)
Text.GetLength(chr) '2 (für SMP chr >= U+10000)

GetSubText(text,start,length)

Ermittelt eine Zeichenfolge innerhalb eines Textes, ab der angegebenen Position (incl.) und der Länge 'length'.
text Der zu durchsuchende Text.
start Die Startposition innerhalb des Textes (ab 1). Bei einem Startwert <1 oder >Textlänge wird "" zurückgegeben.
length Die Länge der Sub-Zeichenfolge (>= 0, ab 'start').
returns Der ermittelte Teilstring oder "".
example Text.GetSubText("12345678", 5,6) ' "5678"

GetSubTextToEnd(text,start)

Ermittelt eine Zeichenfolge am Ende eines Textes, ab der angegebenen Position (incl.) bis zum Textende.
text Der zu durchsuchende Text.
start Die Startposition innerhalb des Textes (ab 1). Bei einem Startwert <1 oder >Textlänge wird "" zurückgegeben.
returns Der ermittelte Teilstring am Textende oder "".
example Text.GetSubTextToEnd("12345678", 4) ' "45678"

IsSubText(text,subText)

Ermittelt ob ein Teiltext (buchstabengetreu) in in einem angegebenen Text enthalten ist. Auch Suche nach subText in einem Array.
text Der zu durchsuchende Text. (Für Array erscheinen hier '\' als '\\'.)
subText Die gesuchte Zeichenfolge im Text.
returns "True" wenn die Zeichenfolge im angegebenen Text gefunden wurde, sonst "False".
example 'Alternativ:
If Text.GetIndexOf(text, subText) > 0

StartsWith(text,subText)

Ermittelt ob ein Text mit dem angegebenen Teiltext (buchstabengetreu) beginnt.
text Der zu durchsuchende Text.
subText Die gesuchte Zeichenfolge am Textanfang.
returns "True" wenn die Zeichenfolge am Textbeginn gefunden wurde, sonst "False".

TextWindow

Funktionen für das TextWindow. Hier können Texte oder Zahlen ein- und ausgegeben werden.
TextWindow.ReadKey() ist ausgeblendet in IntelliSense.
(Standard Fensterbreite/-höhe: 667/402 Pxl)

BackgroundColor	Clear	CursorLeft
CursorTop	ForegroundColor	Hide
Left	Pause	PauseIfVisible
PauseWithoutMessage	Read	ReadKey
ReadNumber	Show	Title
Top	Write	WriteLine

BackgroundColor

Ermittelt (als Farbname) oder setzt die Hintergrundfarbe der weiteren Textanzeige (Farbname oder -nummer 0-15, s. Color /? in Cmd).
Anschließendes TextWindow.Clear() dehnt die Hintergrundfarbe auf gesamtes TextWindow aus.
(Standard: Black bzw. 0, nicht als #RRGGBB)
example 0=Black 8=DarkGray
1=DarkBlue 9=Blue
2=DarkGreen 10=Green
3=DarkCyan 11=Cyan
4=DarkRed 12=Red
5=DarkMagenta 13=Magenta
6=DarkYellow 14=Yellow
7=Gray 15=White

(DarkYellow entspricht Olive im GW)

Clear()

Löscht alle Inhalte im TextWindow.
example 'Farbe im gesamten TW setzen
TextWindow.BackgroundColor = "Farbe"
TextWindow.Clear()

CursorLeft

Ermittelt oder setzt die Ausgabespalte Cursorposition im TextWindow.
(0 bis 89 bzw. s. SBConsole.Width-1, Standard: 0)

CursorTop

Ermittelt oder setzt die Ausgabezeile Cursorposition im TextWindow.
(0 bis 29 ohne Scrollen bzw. s. SBConsole.Height-1, Standard: 0)

ForegroundColor

Ermittelt (als Farbname) oder setzt die Vordergrundfarbe der weiteren Textanzeige (Farbname oder -nummer 0-15, s. Color /? in Cmd).
(Standard: Green bzw. 10, nicht als #RRGGBB)
example 0=Black 8=DarkGray
1=DarkBlue 9=Blue
2=DarkGreen 10=Green
3=DarkCyan 11=Cyan
4=DarkRed 12=Red
5=DarkMagenta 13=Magenta
6=DarkYellow 14=Yellow
7=Gray 15=White

(DarkYellow entspricht Olive im GW)

Hide()

Blendet das TextWindow aus.
Ein angezeigter Textinhalt bleibt erhalten und wird beim nächsten TextWindow Aufruf (Show, WriteLine) wieder angezeigt.

Left

Ermittelt oder setzt die linke Position des TextWindow (linker Fensterrand) am Desktop.
(Standard: s. Cmd Eigenschaften - Layout - Fensterpos.)

Pause()

Wartet auf Benutzereingabe und hält das TextWindow geöffnet (mit "Press any key to continue...").

PauseIfVisible()

Wartet nur dann auf Benutzereingabe, wenn das TextWindow sichtbar ist (mit "Press any key to continue..."), sonst gleich Weiterausführung.

PauseWithoutMessage()

Wartet auf Benutzereingabe (ohne "Press any key to continue..."). Sinnvoll wenn gleichzeitig GW aktiv ist.
example TextWindow.Read() 'Alternat.

Read()

Liest eine Texteingabe aus dem TextWindow. Keine Rückgabe, bis die Eingabetaste gedrückt wurde.
Akzeptiert Zahlen, Buchstaben und Sonderzeichen. (s. TextWindow.ReadKey)
returns Der im TextWindow eingegebene Text.
example 'warten auf Eingabetaste (vor Beenden)
TextWindow.Read()
Program.End()

ReadKey()

Liest ein einzelnes Tastenzeichen aus dem TextWindow. Sofort und ohne vorherige Eingabetaste.
(Ausgeblendet in IntelliSense, s. TextWindow.Read und -ReadNumber)
returns Das Tastenzeichen, das aus dem TextWindow gelesen wurde (GROß-/kleinbuchstabe, Zahl, Sonderzeichen). Funktions- und Steuertasten geben nichts zurück (bzw. CharCode 0).
example While k <> Text.GetCharacter(27) 'Esc
k = TextWindow.ReadKey()
TextWindow.WriteLine(k +":"+ Text.GetCharacterCode(k))
Program.Delay(5)
EndWhile

ReadNumber()

Liest eine Zahleneingabe aus dem TextWindow. Keine Rückgabe, bis die Eingabetaste gedrückt wurde.
Akzeptiert Ziffern 0 bis 9, ein Komma "." und "-" am Anfang. (s. TextWindow.ReadKey)
returns Die im TextWindow eingegebene Zahl oder 0 bei "".

Show()

Blendet das TextWindow (wieder) ein.
Ein vor TextWindow.Hide angezeigter Textinhalt bleibt erhalten und wird wieder angezeigt.

Title

Ermittelt oder setzt den Titel für das TextWindow (Tab funktioniert nicht, Schrifteigenschaften nach Systemstandard, keine Symbole).
Das Fenster wird dabei (wieder) angezeigt.
(Standard: Voller Dateipfad der aktuellen .exe mit Argumenten)

Top

Ermittelt oder setzt die obere Position des TextWindow (Fenster, Oberkante Titelleiste) am Desktop.
(Standard: s. Cmd Eigenschaften - Layout - Fensterpos.)

Write(data)

Schreibt Text oder eine Zahl in das TextWindow. Im Gegensatz zu WriteLine wird kein Zeilenvorschub angefügt. Die nächste Ausgabe wird daher am Ende derselben Zeile angefügt, fortlaufend mit Umbruch am Zeilenende.
data Der auszugebende Text oder Zahl.
example Write(lf bzw. crlf) '1 Leerzeile bzw. Zeilenvorschub

WriteLine(data)

Schreibt Text oder eine Zahl in das TextWindow. Ein Zeilenvorschub (cr+lf bzw. chr13+chr10) wird automatisch angefügt, sodaß die nächste Ausgabe in neuer Zeile beginnt.
data Der auszugebende Text oder Zahl.
example WriteLine("") '1 Leerzeile
WriteLine(lf od. crlf) '2 Leerzeilen

Timer

Dient dazu einen Vorgang auszuführen, der sich in regelmäßigen Abständen wiederholt. Weiters zum Erstellen asynchroner Parallelthreads.

Interval	Pause	Resume
Tick

Interval

Ermittelt oder setzt das Intervall [ms] für den Timer. Dieses bestimmt die Zeitabstände in denen der Timer (Zeitgeber) das Tick Ereignis auslöst. Werte von 10 bis 100000000 = 10^8 (Standard).
Ein Setzen/Ändern des Intervalls startet gleichzeitig auch den Timer.Tick Ereignisaufruf (wie Timer.Resume).

Pause()

Hält den Timer (Zeitgeber) an. Tick Ereignisse werden nicht ausgelöst.

Resume()

Setzt den Timer (Zeitgeber) nach einer Pause wieder fort. Tick Ereignisse werden wieder ausgelöst.

Tick

Ereignisaufruf wenn der Timer (Zeitgeber) ein neues Zeitintervall beginnt.
Funktioniert als einziges Ereignis auch im TextWindow und dient zum Erstellen asynchroner Parallelthreads.

Turtle

Mit der Schildkröte kann man 'Logo' ähnliche Funktionalität erzielen und Formen zeichnen, indem man die Eigenschaften des Stifts und der Zeichnungsvariablen ändert.
Das Turtle Bild ist eine Bildshape (Intern: "_turtle"), die Spur eine Linienshape (Intern: "_turtleLine#") und beide liegen eine Ebene über GW, Linienzeichnungen, gefüllte Formen, Controls und Shapes.
Turtle Bildshape anpassbar mit zB. Shapes.SetOpacity("_turtle",Wert) oder Shapes.Zoom("_turtle", faktorX,faktorY).
Turtlelinie Shape anpassbar mit PenColor/-Width.
s. LDShapes.SetTurtleImage zum Ändern des Turtle Bildes.

Angle	Hide	Move
MoveTo	PenDown	PenUp
Show	Speed	Turn
TurnLeft	TurnRight	X
Y

Angle

Ermittelt oder setzt den Absolutwinkel [°] für die aktuelle Blickrichtung der Schildkröte. Das Festlegen ändert deren Blickrichtung unmittelbar (blendet Turtle nicht ein).
(Standard: 0 für 12h, +/- für im/gegen Uhrzeigersinn)

Hide()

Blendet die Schildkröte aus (nur Bildshape, Linie nicht) und deaktiviert die Funktion für Turn(Left/Right), Angle und Move(To) weiter moglich.
s. LDShapes.ResetTurtle(), Shapes.HideShape("_turtle") bzw. ShowShape("_turtle").

Move(distance)

Bewegt die Schildkröte um die angegebene Entfernung (initialisiert Turtle, Programmfortführung wird solange angehalten). Ist der Stift unten, wird mit dieser Bewegung eine Linie gezeichnet (Intern: Shapes.Move("_turtle", x,y)).
distance Die -/+ Entfernung die die Schildkröte in Blickrichtung zurücklegt.

MoveTo(x,y)

Dreht (in Zielrichtung) und bewegt die Schildkröte zur angegebenen Position (initialisiert Turtle, Programmfortführung wird solange angehalten). Ist der Stift aufgesetzt, wird dabei eine Linie gezeichnet (Intern: Shapes.Move("_turtle", x,y)).
Die Blickrichtung bleibt danach erhalten.
x Die x-Koordinate des Zielpunktes.
y Die y-Koordinate des Zielpunktes.

PenDown()

Setzt den Stift auf, sodaß die Schildkröte bei Bewegung zeichnet (in PenColor/-Width).
(Standard: aktiviert)

PenUp()

Hebt den Stift ab, sodaß die Schildkröte bei Bewegung nicht zeichnet.

Show()

Zeigt die Schildkröte (Bildshape wieder) an, für weitere Interaktion.
s. LDShapes.ResetTurtle(), Shapes.HideShape("_turtle") bzw. ShowShape("_turtle").

Speed

Ermittelt oder setzt die Bewegungs-/Drehgeschwindigkeit der Schildkröte (blendet diese nicht ein):
1 Min (bzw. <1)
5 Standard
10 Max (bzw. >10)
10 bewegt/dreht die Schildkröte sofort.
example animZeit [ms] = Math.Abs(distance [Pxl] * 320/(Turtle.Speed*Turtle.Speed))
'zB. 1280 ms für 100 Pxl bei Speed 5 usw.

Turn(angle)

Dreht die Schildkröte (ab aktueller Blickrichtung) um den angegebenen Winkel (auch wenn ausgeblendet, initialisiert Turtle). Startwinkel (0°) entspricht Richtung 12h.
(Intern: Shapes.Rotate("_turtle", grad))
angle Der -/+ Winkel [°] um den die Schildkröte gedreht wird (Standard: 0):
+angle rechts (im Uhrzeigersinn)
-angle links (gegen Uhrzeigersinn)
example 'Turtle Kreis(bogen) mit
'r = d/w * Math.GetDegrees(1) ~86
d = 6 'Teilsehne
w = 4 'Teilwinkel [°]
e = 270 'Endwinkel [°]
GraphicsWindow.PenWidth=1
For n = w To e Step w
Turtle.Move(d)
Turtle.Turn(w) '-/+ für L/R
EndFor

TurnLeft()

Dreht die Schildkröte um 90° gegen den Uhrzeigersinn (blendet diese ein, Intern: Shapes.Rotate("_turtle",-90)).

TurnRight()

Dreht die Schildkröte um 90° im Uhrzeigersinn (blendet diese ein, Intern: Shapes.Rotate("_turtle",90)).

X

Ermittelt oder setzt die aktuelle x-Koordinate der Schildkröte. Das Festlegen ändert deren Position unmittelbar (ohne Linie, blendet Turtle nicht ein).
(Standard: 320)

Y

Ermittelt oder setzt die aktuelle y-Koordinate der Schildkröte. Das Festlegen ändert deren Position unmittelbar (ohne Linie, blendet Turtle nicht ein).
(Standard: 240)

Array	Clock	Controls	Desktop	Dictionary
File	Flickr	GraphicsWindow	ImageList	Math
Mouse	Network	Program	Shapes	Sound
Stack	Text	TextWindow	Timer	Turtle

BackgroundColor	BrushColor	CanResize
Clear	DrawBoundText	DrawEllipse
DrawImage	DrawLine	DrawRectangle
DrawResizedImage	DrawText	DrawTriangle
FillEllipse	FillRectangle	FillTriangle
FontBold	FontItalic	FontName
FontSize	GetColorFromRGB	GetPixel
GetRandomColor	Height	Hide
KeyDown	KeyUp	LastKey
LastText	Left	MouseDown
MouseMove	MouseUp	MouseX
MouseY	PenColor	PenWidth
SetPixel	Show	ShowMessage
TextInput	Title	Top
Width

Abs	ArcCos	ArcSin
ArcTan	Ceiling	Cos
Floor	GetDegrees	GetRadians
GetRandomNumber	Log	Max
Min	NaturalLog	Pi
Power	Remainder	Round
Sin	SquareRoot	Tan