Copyright: © StarDivision GmbH


StarBasic Online-Referenz

StarBasic

Das StarBasic Integrated Development Environment (IDE)

StarBasic Funktionen &  Anweisungen

Bildschirmein-/ausgabefunktionen

Dateiein-/ausgabefunktionen

Datums- und Zeitfunktionen

DDE-Anweisungen und Funktionen

Fehlerbehandlungsfunktionen

Logische Operatoren

Mathematische Operatoren

Numerische Funktionen

Programmablaufsteuerungsfunktionen

Sonstige Befehle

Variablenfunktionen

Vergleichsoperatoren

Zeichenfolgenfunktionen

Dialogboxelemente, -eigenschaften, -ereignisse & methoden

Ereignisse und Methoden

StarOffice

StarWriter

StarCalc


StarBasic Funktionen und Anweisungen

"-" Operator

"*" Operator

"/" Operator

"^" Operator

"+" Operator

=, <, >, <=, >=, <> - Operatoren

A

Abs-Funktion

And-Operator

Asc-Funktion

Atn-Funktion

B

Beep-Anweisung

Blue-Funktion

C

Call-Anweisung

CBool-Funktion

CByte-Funktion

CDate-Funktion

CDbl-Funktion

ChDir-Anweisung

ChDrive-Anweisung

Choose-Funktion

Chr$-Funktion

CInt-Funktion

CLng-Funktion

Close-Anweisung

Const-Anweisung

Cos-Funktion

CreateObject-Funktion

CSng-Funktion

CStr-Anweisung

CurDir-Funktion

D

Date-Funktion; Date-Anweisung

DateSerial-Funktion

DateValue-Funktion

Day-Funktion

DDEExecute-Anweisung

DDEInitiate-Funktion

DDEPoke-Anweisung

DDERequest$-Funktion

DDETerminateAll-Anweisung

DDETerminate-Anweisung

Declare-Anweisung

Defxxx-Anweisung

Dim-Anweisung

Dir-Funktion

Do...Loop-Anweisung

E

End-Anweisung

Eof-Funktion

Eqv-Operator

Erl-Funktion

Err-Funktion

Error$-Funktion

Error-Anweisung

Exp-Funktion

F

FileAttr-Funktion

FileCopy-Anweisung

FileDateTime-Funktion

FileLen-Funktion

Fix-Funktion

For...Next-Anweisung

Format$-Funktion

FreeFile-Funktion

Function...Exit Function...End Function-Anweisung

G

Get-Anweisung

GetAttr-Funktion

GetGUIType-Funktion

GetGUIVersion-Funktion

GetSystemType-Funktion

GoSub...Return-Anweisung

GoTo-Anweisung

Green-Funktion

H

Hex$-Funktion

Hour-Funktion

I

If...Then... ElseIf...Else...EndIf -Anweisung

IIf-Anweisung

Imp-Operator

Input #-Anweisung

InputBox$-Funktion

InStr-Funktion

Int-Funktion

IsArray-Funktion

IsDate-Funktion

IsEmpty-Funktion

IsError-Funktion

IsNull-Funktion

IsNumeric-Funktion

IsObject-Funktion

K

Kill-Anweisung

L

LBound-Funktion; UBound-Funktion

LCase$-Funktion

Left$-Funktion

Len-Funktion

Let-Anweisung

Line Input #-Anweisung

Loc-Funktion

Lof-Funktion

Log-Funktion

LSet-Anweisung

LTrim$-Funktion

M

Mid$-Funktion, Mid$-Anweisung

Minute-Funktion

MkDir-Anweisung

Month-Funktion

MsgBox-Anweisung; MsgBox-Funktion

N

Name-Anweisung

Not-Operator

Now-Funktion

O

Oct$-Funktion

On Error GoTo...Resume-Anweisung

On...GoSub-Anweisung; On...GoTo-Anweisung

Open-Anweisung

Option Base-Anweisung

Option Explicit

Or-Operator

P

Print-Anweisung; Spc-Funktion; Tab-Funktion

Public-Anweisung

Put-Anweisung

Q

QBColor-Funktion

R

Randomize-Anweisung

Red-Funktion

ReDim-Anweisung

Rem-Anweisung

Reset-Anweisung

RGB-Funktion

Right$-Funktion

RmDir-Anweisung

Rnd-Funktion

RSet-Anweisung

RTrim$-Funktion

S

Second-Funktion

Seek-Funktion, Seek-Anweisung

Select...Case...End Select-Anweisung

SetAttr-Anweisung

Sgn-Funktion

Shell-Funktion

Sin-Funktion

Space$-Funktion

Sqr-Funktion

Static-Anweisung

Stop-Anweisung

Str$-Funktion

StrComp-Funktion

String$-Funktion

Sub...Exit Sub...End Sub-Anweisung

Switch-Funktion

T

Tan-Funktion

Time-Anweisung

Timer-Funktion

TimeSerial-Funktion

TimeValue-Funktion

TypeName-Funktion; VarType-Funktion

U

UCase$-Funktion

V

Val-Funktion

W

Wait-Anweisung

WeekDay-Funktion

While...Wend -Anweisung

With-Anweisung

Write#-Anweisung

X

Xor-Operator

Y

Year-Funktion


Bildschirmein-/ausgabefunktionen

In diesem Abschnitt finden Sie alle Funktionen, mit denen Sie Anwenderaktionen interaktiv behandeln lassen können, ohne eigene Dialoge entwerfen zu müssen. D.h., alle Befehle, mit dessen Hilfe Sie auf einfache Art und Weise Benutzeingaben einlesen und auswerten bzw. Ausgaben auf dem Bildschirm durchführen können, werden an dieser Stelle beschrieben.

Bildschirmausgabefunktionen

•	MsgBox-Anweisung; MsgBox-Funktion

•	Print-Anweisung; Spc-Funktion; Tab-Funktion

Bildschirmeingabefunktionen

•	InputBox$-Funktion

Farbberechnungsfunktionen

•	Blue-Funktion

•	Green-Funktion

•	QBColor-Funktion

•	Red-Funktion

•	RGB-Funktion


Bildschirmein-/ausgabefunktionen
Blue-Funktion

Funktion:	Ermittelt den Blau-Anteil eines Long-Int-Farbwertes, der durch die RGB-Funktion erzeugt wurde.
Syntax:	Blue(Farbwert&)
	Parameter	Beschreibung
	Farbwert&	Long-Integerausdruck, der durch die RGB-Funktion generiert wurde.
Siehe auch:	Bildschirmein-/ausgabefunktionen , Print-Anweisung; Spc-Funktion; Tab-Funktion , QBColor-Funktion , Red-Funktion


Bildschirmein-/ausgabefunktionen
Green-Funktion

Funktion:	Ermittelt den Grün-Anteil eines Long-Int-Farbwertes, der durch die RGB-Funktion erzeugt wurde.
Syntax:	Green(Farbwert&)
	Parameter	Beschreibung
	Farbwert&	Long-Integerausdruck, der durch die RGB-Funktion generiert wurde.
Siehe auch:	Bildschirmein-/ausgabefunktionen , Print-Anweisung; Spc-Funktion; Tab-Funktion , QBColor-Funktion , Red-Funktion


Bildschirmein-/ausgabefunktionen
InputBox$-Funktion

Funktion:	Zeigt eine Dialogbox mit einem Eingabefeld und erlaubt dem Benutzer die Eingabe einer Zeichenfolge bis zur Bestätigung von [OK]. Die Eingabe wird in einer Variablen aufgenommen.
Syntax:	InputBox$(meldung$ [,titel$ [,vorgabe$ [,x_pos%, y_pos% [,helpfile [,contextID]]]]])
	Parameter	Beschreibung
	meldung$	Zeichenfolgeausdruck, der den im Dialogfeld anzuzeigenden Leittext enthält.
	titel$	Zeichenfolgeausdruck, der in der Titelleiste der Dialogbox erscheinen soll.
	vorgabe$	Zeichenfolgeausdurck, der im Eingabfeld der Dialogbox als Voreinstellung angezeigt wird.
	x_pos%	Integer-Ausdruck, der die horizontale Position der Dialogbox angibt.
	y_pos%	Integer-Ausdruck, der die vertikale Position der Dialogbox angibt.
	helpfile	Datei, die nach Betätigung der Funktionstaste 1 an die Windows-Hilfe übergeben wird.
	contextID	Integer-Ausdruck, der auf den Hilfstext für das aktuelle Eingabefeld verweist. Dieser Text befindet sich in der Datei, die der Windows-Hilfe übergeben wird (helpfile).
Die InputBox$-Anweisung bietet eine komfortable Möglichkeit der Eingabe über eine Dialogbox. Die Eingabeebene kann durch die Eingabetaste oder die Schaltfläche [OK] verlassen werden; die vom Anwender bis dahin eingegebene Zeichenfolge wird als Funktionsergebnis zurückgegeben. Wird der Dialog hingegen mit [ABBRECHEN] verlassen, liefert InputBox$ eine Nullzeichenfolge (““) zurück. Ohne Angabe von x_pos% und y_pos% erfolgt eine Zentrierung der Dialogbox.

Um den Bezug zu einer kontextsensitiven Hilfe herzustellen, kann mit helpfile der Pfad- und Dateiname einer Hilfe-Datei bestimmt werden; ContextID bestimmt – gemäß den Hilfedatei-Konventionen – die Kontext-Identifikationsnummer, d.h., welche Topic der Hilfe Datei direkt nach dem Start der Hilfe aufgerufen werden soll.

Siehe auch:	Bildschirmein-/ausgabefunktionen


Bildschirmein-/ausgabefunktionen
MsgBox-Anweisung; MsgBox-Funktion

Funktion:	Stellt einen Dialog auf dem Bildschirm dar, der einen Hinweistext enthält. Als Funktion verwendet, kann der Anwender diesen Dialog zusätzlich noch mit einer vom Programmierer ermittelbaren Schaltflächen bestätigen.
Syntax:	MsgBox text$ [,typ% [,dialogtitel$]] (als Anweisung)oder MsgBox(text$ [,typ% [,dialogtitel$]]) (als Funktion)
	Parameter	Beschreibung
	text$	Zeichenkettenausdruck, der als Meldung im Dialog gezeigt wird. Zeilenumbrüche werden durch Einfügen von Chr$(13) in den Zeichenkettenausdruck realisiert. Nur die ersten 255 Zeichen einer Zeichenkette werden dargestellt, alle weiteren Zeichen werden unberücksichtigt gelassen.
	Dialogtitel$	Zeichenkettenausdruck, der die Titelzeile der Dialogbox bestimmt. Wird dialogtitel$ ausgelassen, steht in der Titelzeile der Name der jeweiligen Applikation.
	typ%	Beliebiger Integer-Ausdruck, der den Typ der Dialogbox bestimmt und ferner definiert, mit welchem Symbol und mit welcher Art Schaltfläche(n) der Dialog ausgestattet sein soll. typ% stellt dabei eine Kombination von Bitmusters dar, d.h. sie bestimmen die Elemente des Dialogs durch die Addition der verschiedenen Werte der folgenden Tabelle:
Wert	Bedeutung
0	Nur [OK]-Schaltfläche wird dargestellt.
1	[OK]- und [ABBRUCH]-Schaltfläche werden dargestellt.
2	[ABBRUCH], [WIEDERHOLEN] und [IGNORIEREN]-Schaltflächen werden dargestellt.
3	[JA]-, [NEIN]- und [ABBRUCH]-Schaltflächen werden dargestellt.
4	[JA]- und [NEIN]-Schaltflächen werden dargestellt.
5	[WIEDERHOLEN]- und [ABBRUCH]-Schaltflächen werden dargestellt.
16	Das Stop-Symbol wird in den Dialog mit aufgenommen.
32	Das Fragezeichen-Symbol wird in den Dialog mit aufgenommen.
48	Das Erklärungs-Symbol wird mit in den Dialog aufgenommen.
64	Das Informations-Symbol wird mit in den Dialog aufgenommen.
0	Erste Schaltfläche des Dialogs ist voreingestellt.
256	Zweite Schaltfläche des Dialogs ist voreingestellt.
512	Dritte Schaltfläche des Dialogs ist voreingestellt.
Wird MsgBox als Funktion aufgerufen, wird die Nummer des Buttons zurückgeliefert, der für den Abbruch des Dialoges sorgte. Dabei gelten folgende Konventionen:

Rückgabewert	Button
1	OK
2	Abbrechen
3	Abbruch
4	Wiederholen
5	Ignorieren
6	Ja
7	Nein
Siehe auch:	Bildschirmein-/ausgabefunktionen


Bildschirmein-/ausgabefunktionen
Print-Anweisung; Spc-Funktion; Tab-Funktion

Funktion:	Gibt die angegebenen Zeichenfolgen oder numerische Ausdrücke in einer Dialogbox auf dem Bildschirm aus.
Syntax:	Print ausdruck1[{;|,}[Spc(leer%);][Tab(posi%);][ausdruck2[...]]]
	Parameter	Beschreibung
	ausdruck	Beliebiger numerischer Ausdruck oder Zeichenfolgeausdruck, der ausgegeben werden soll. Werden mehrere Ausdrücke hintereinander angegeben, so werden Sie bei der Ausgabe nebeneinander gesetzt, sofern Sie durch ein Semikolon getrennt wurden. Wurden Sie durch ein Komma getrennt, werden die einzelnen Ausdrücke jeweils zur nächsten Tabulatorposition gerückt. Die Tabulatorposition sind nicht einstellbar.
	leer%	Anzahl von Leerzeichen, die durch die Spc-Funktion eingefügt werden sollen.
	posi%	Es werden soviele Leerzeichen eingefügt, bis die angegebene Position erreicht ist.
Steht hinter dem letzten auszugebenden Ausdruck entweder ein Semikolon oder ein Komma, dann merkt sich StarBasic zunächst den auszugebenden Text in einem internen Speicher und fährt mit der Ausführung der folgenden Anweisung fort, ohne daß etwas geschieht. Erst wenn ein Print-Befehl erreicht wird, der mit keinem der beiden Zeichen endet, werden alle bis dorthin „gemerkten“ Ausdrücke dargestellt.

Bei der Ausgabe von positiven numerischen Ausdrücken, wird ein Leerzeichen quasi als imaginäres Plus-Zeichen vorangestellt. Negative Ausdrücke werden mit vorgestelltem Minuszeichen ausgegeben. Wird bei Fließkommawerten ein bestimmter Bereich überschritten, wird der jeweilige numerische Ausdruck in einer Exponential-Notation ausgegeben.

Sollte der auszugebende Ausdruck eine bestimmte Länge überschreiten, wird die Darstellung automatisch in die nächste Zeile umgebrochen.

Tip: Sie können die Tab-Funktion mit Semikolon getrennt zwischen Argumente stellen, um die Ausgabeposition bis zu einer bestimmten Stelle zu rücken oder die Spc-Funktion verwenden, um eine entsprechende Anzahl von Leerzeichen einzufügen.

Siehe auch:	Bildschirmein-/ausgabefunktionen


Bildschirmein-/ausgabefunktionen
QBColor-Funktion

Funktion:	Ermittelt einen RGB-Wert aufgrund einer Farbnummer die in älteren MS-DOS-Programmiersystemen üblich gewesen ist.
Syntax:	QBColor(FarbNummer%)
	Parameter	Beschreibung
	FarbNummer%	Beliebiger Integer-Ausdruck, der die Nummer der entsprechenden Farbe repräsentiert.
Siehe auch:	Red-Funktion , Green-Funktion , Blue-Funktion , RGB-Funktion


Bildschirmein-/ausgabefunktionen
Red-Funktion

Funktion:	Ermittelt den Red-Anteil eines Long-Int-Farbwertes, der durch die RGB-Funktion erzeugt wurde.
Syntax:	Red(Farbwert&)
	Parameter	Beschreibung
	Farbwert&	Long-Integer-Ausdruck, der durch die RGB-Funktion generiert wurde.
Siehe auch:	Blue-Funktion , Green-Funktion , QBColor-Funktion , RGB-Funktion


Bildschirmein-/ausgabefunktionen
RGB-Funktion

Funktion:	Ermittelt einen Long-Int-Farbwert aus Rot-, Grün- und Blauanteilen.
Syntax:	RGB(rot, gruen, blau)
	Parameter	Beschreibung
	rot	Beliebiger Byte-Ausdruck, der den Rot-Anteil (0-255) der Gesamtfarbe repräsentiert.
	gruen	Beliebiger Byte-Ausdruck, der den Grün-Anteil (0-255) der Gesamtfarbe repräsentiert.
	blau	Beliebiger Byte-Ausdruck, der den Blau-Anteil (0-255) der Gesamtfarbe repräsentiert.
Siehe auch:	QBColor-Funktion , Print-Anweisung; Spc-Funktion; Tab-Funktion , Red-Funktion , Blue-Funktion , Green-Funktion ,


Dateiein-/ausgabefunktionen

Mit Hilfe von Dateiein-/ausgabefunktionen können Sie eigene Daten-Dateien erstellen und verwalten. Spezielle Funktionen erlauben den Aufbau sogenannter relativer Dateien, in denen Sie Datensätze gezielt speichern durch direkte Eingabe einer Satznummer wieder laden können. Einige Basisdateifunktionen helfen bei der Organisation von Dateien. Sie können mit diesen Funktionen beispielsweise die Größe einer Datei, den aktuellen eingestellten Pfad oder alle Dateien und Unterverzeichnisse eines bestimmten Verzeichnisses ermitteln oder herausfinden, wann eine Datei oder ein Verzeichnis erstellt oder das letzte Mal geändert wurde.

Sie finden in diesem Kapitel folgende Funktionen und Anweisungen:

Öffnen, Schließen von Dateien

•	Close-Anweisung

•	FreeFile-Funktion

•	Open-Anweisung

•	Reset-Anweisung

Ein-/Ausgabe

•	Get-Anweisung

•	Input #-Anweisung

•	Line Input #-Anweisung

•	Put-Anweisung

•	Write#-Anweisung

Dateipositionierung

•	Eof-Funktion

•	Loc-Funktion

•	Lof-Funktion

•	Seek-Funktion, Seek-Anweisung

Dateiorganisation

•	ChDir-Anweisung

•	ChDrive-Anweisung

•	Close-Anweisung

•	CurDir-Funktion

•	Dir-Funktion

•	FileAttr-Funktion

•	FileCopy-Anweisung

•	FileDateTime-Funktion

•	FileLen-Funktion

•	GetAttr-Funktion

•	Kill-Anweisung

•	MkDir-Anweisung

•	Name-Anweisung

•	RmDir-Anweisung

•	SetAttr-Anweisung


Dateiein-/ausgabefunktionen
ChDir-Anweisung

Funktion:	Wechselt das aktuelle Verzeichnis auf dem aktuellen Laufwerk.
Syntax:	ChDir zeichenkettenausdruck$
	Parameter	Beschreibung
	zeichenketten- ausdruck$	Beliebiger Zeichenkettenausdruck, der den Verzeichnispfad enthält.
Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
ChDrive-Anweisung

Funktion:	Wechselt das aktuelle Laufwerk.
Syntax:
	Parameter	Beschreibung
	zeichenketten- ausdruck$	Beliebiger Zeichenkettenausdruck, der den Laufwerkbuchstaben des neuen aktuellen Laufwerks enthält.
Siehe auch:	Dateiein-/ausgabefunktionen ,Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
Close-Anweisung

Funktion:	Schließt eine Datei.
Syntax:	Close DateiNr%[,DateiNr2%[,...]]
Parameter	Beschreibung
DateiNr%	Beliebiger Integer-Ausdruck, der die Nummer des Datenkanals beschreibt, der geschlossen werden soll.
Siehe auch:	Dateiein-/ausgabefunktionen ,Name-Anweisung


Dateiein-/ausgabefunktionen
CurDir-Funktion

Funktion:	Liefert den auf dem angegebenen oder aktuellen Laufwerk derzeit eingestellten Pfad zurück.
Syntax:	CurDir[(zeichenfolgeausdruck$)]
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Ein beliebiger Zeichenfolgeausdruck, der den Laufwerksbuchstaben mit abschließendem Doppelpunkt angibt(beispielsweise „C:“ für in der Regel die erste im Computer eingebaute Festplatte).
Wird das Funktionsargument weggelassen, liefert CurDir das aktuell eingestellte Laufwerk zurück. Werden Laufwerksbeschreibungen mit ungültiger Syntax übergeben oder Laufwerke bestimmt, die entweder nicht vorhanden oder hinter denen liegen, die in der CONFIG.SYS mit der LASTDRIVE-Anweisung angegeben sind, meldet StarBasic einen Fehler.

Groß- und Kleinschreibung haben keinerlei Einfluß auf die Funktion.

Siehe auch:	Dateiein-/ausgabefunktionen ,ChDir-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung ,


Dateiein-/ausgabefunktionen
Dir-Funktion

Funktion:	Ermittelt den Namen einer Datei oder eines Verzeichnisses, bzw. alle Dateien und Verzeichnisse eines Laufwerkes oder eines Verzeichnisse, auf die der angegebene Suchpfad paßte.
Syntax:	Dir[(zeichenfolge-ausdruck$) [,attrib%]]
Parameter	Beschreibung
zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck, der nur beim ersten Aufruf der Anweisung angegeben wird. Er muß entweder den Suchpfad oder den Namen des Verzeichnisses oder der Datei enthalten, das oder die es zu überprüfen gilt.
attrib%	Beliebiger Integer-Ausdruck, der ein Attributmuster, das bitweise codiert ist, enthält. Geben Sie diesen Attributparameter an, findet die Dir-Funktion nur solche Dateien oder Verzeichnisse, auf die die ausgewählten Attribute zutrafen. Verschiedene Attribute sind durch Addition der Attributwerte miteinander kombinierbar.
Wert	Bedeutung
0	Normale Dateien.
2	Versteckte Dateien.
4	Systemdateien.
8	Der Namen des Volumes wird zurückgeliefert.
16	Nur Verzeichnisnamen werden zurückgeliefert.
Mit Hilfe dieser Funktion können Sie entweder die Existenz einer Datei oder eines Verzeichnisses überprüfen oder alle Dateien und Verzeichnisse in einem bestimmten Verzeichnis ermitteln.

Möchten Sie die Existenz einer Datei überprüfen, geben Sie den kompletten Pfad zusammen mit dem Dateinamen an. Liefert die Dir-Funktion den Namen zurück, ist das Verzeichnis bzw. die Datei vorhanden. Liefert Sie hingegen einen Leerstring („“) zurück, ist das Verzeichnis oder die Datei nicht vorhanden.

Wünschen Sie, daß die Dir-Funktion eine komplette Liste der Dateien ausgibt, die sich innerhalb eines bestimmten Verzeichnisses befinden, verfahren Sie wie folgt: Übergeben Sie beim ersten Mal, wenn Sie die Dir-Funktion aufrufen, den kompletten Suchpfad der Dateien, also beispielsweise „D:\OFFICE3\*.SDW“. Sie erhalten, sofern Pfadangaben gültig sind und die Suche wenigstens eine Datei zum Ergebnis hatte, den Namen der ersten Datei zurück, die dem Suchpfad entspricht. Rufen Sie den Dir-Befehl im folgenden ohne Parameter auf, liefert er nacheinander alle weiteren Dateien zurück, die dem Suchpfad entsprechen. Wenn die Dir-Funktion einen Leerstring zurückliefert, bedeutet das daß keine weiteren Dateien mehr vorhanden sind, die dem Suchkriterium entsprechen.

Wenn Sie nur Verzeichnisse ermitteln möchten, nehmen Sie den Attributparameter zu Hilfe. Das gleiche gilt, wenn Sie den Namen eines Volumes (z.B. eine Festplattenpartition) ermitteln möchten.

Beispiel:	Das folgende Beispielprogramm erlaubt die Eingabe eines Suchpfades und gibt anschließend hintereinander alle Dateien im spezifizierten Verzeichnis aus.
pfad$ = Inputbox$("Bitte geben Sie den Suchpfad ein","Suchpfad")

datei$ = Dir$(pfad$)

If datei$ <> "" Then

    Do

        Print datei$

        datei$ = Dir$

    Loop Until datei$ = ""

End If

Siehe auch:	Dateiein-/ausgabefunktionen ,ChDir-Anweisung , Close-Anweisung , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
Eof-Funktion

Funktion:	Stellt fest, ob der Dateizeiger das letzte Byte einer Datei erreicht hat.
Syntax:	Eof(intausdruck%)
Parameter	Beschreibung
intausdruck%	Beliebiger Intergerausdruck, der die Nummer der geöffneten Datei bestimmt.
Sie verwenden die Eof-Funktion, um das Ende einer sequentiell gelesenen Datei erkennen zu können. Immer wenn Sie mit Hilfe der Input-Anweisung, oder der Get-Anweisung, sequentiell aus einer Datei lesen, wird der sogenannte Dateizeiger um die Zeichen weitergerückt, wie Sie Zeichen gelesen haben. Erreicht der Dateizeiger das Ende der Datei, liefert Eof als Funktionsergebnis den Wert TRUE (-1). Sie müssen selbst dafür sorgen, daß ein Lesevorgang nicht das Ende der Datei überschreitet, da StarBasic sonst einen Fehler meldet.

Siehe auch:	Dateiein-/ausgabefunktionen ,Put-Anweisung , RmDir-Anweisung , Line Input #-Anweisung , Name-Anweisung


Dateiein-/ausgabefunktionen
FileAttr-Funktion

Funktion:	Liefert die MS-DOS-Dateikennung oder den Zugriffsmodus einer geöffneten Datei zurück.
Syntax:	FileAttr(dateinummer%,attribut%)
Parameter	Beschreibung
dateinummer%	Die Nummer der geöffneten Datei.
attribut%	Beliebiger Integer-Ausdruck. Erlaubt sind nur die Werte 1 und 2. Ist attribut% 1, liefert die FileAttr-Funktion die MS-DOS-Dateikennung (OSH, Operating System Handel) zurück. Setzen Sie für attribut% die 2, stellen Sie fest, in welchem Zugriffsmodus sich die Datei befindet. Dabei gelten folgende Werte:
Wert	Bedeutung
1	OUTPUT (Datei zur Ausgabe geöffnet)
2	INPUT (Datei zur Eingabe geöffnet)
4	RANDOM (Datei mit wahlfreiem Zugriff)
8	APPEND (Datei zum Erweitern geöffnet)
32	BINARY (Datei im Binärzugriff geöffnet)
Siehe auch:	Dateiein-/ausgabefunktionen ,


Dateiein-/ausgabefunktionen
FileCopy-Anweisung

Funktion:	Kopiert eine Datei auf einem Datenträger an eine andere Position oder an eine andere Position auf einem anderen Datenträger.
Syntax:	FileCopy Quell$, Ziel$
Parameter	Beschreibung
Quell$	Beliebiger Zeichenkettenausdruck, der den Dateinamen der zu kopierenden Datei incl. Pfad enthält.
Ziel$	Beliebiger Zeichenkettenausdruck, der den Namen des Zielverzeichnisses enthält, in das die Datei kopiert werden soll.
Siehe auch:	Dateiein-/ausgabefunktionen ,ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
FileDateTime-Funktion

Funktion:	Liefert eine Zeichenfolge zurück, die Datum und Uhrzeit der Erstellung oder letzten Modifizierung einer Datei enthält.
Syntax:	FileDateTime(zeichenfolgeausdruck$)
Parameter	Beschreibung
zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck, der den eindeutigen Namen der Datei samt Pfadangabe enthält.
Mit Hilfe dieser Funktion ermitteln Sie den genauen Zeitpunkt der Erstellung oder Modifikation einer Datei. Übergeben Sie den eindeutigen Dateinamen, und Sie erhalten Datum und Uhrzeit in einer Zeichenfolge im Format „TT.MM.JJJJ  HH.MM.SS“ zurück.

Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung , FileDateTime-Funktion


Dateiein-/ausgabefunktionen
FileLen-Funktion

Funktion:	Liefert die Länge einer Datei zurück.
Syntax:	FileLen(zeichenfolgeausdruck$)
Parameter	Beschreibung
zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck, der den eindeutigen Namen der Datei samt Pfadangabe enthält.
Mit Hilfe dieser Funktion ermitteln Sie die Länge einer Datei. Übergeben Sie den eindeutigen Dateinamen, und Sie erhalten die Dateilänge als Funktionsergebnis zurück.

Siehe auch:	Dateiein-/ausgabefunktionen , Line Input #-Anweisung , Eof-Funktion


Dateiein-/ausgabefunktionen
FreeFile-Funktion

Funktion:	Ermittelt den nächsten freien Dateikanal.
Syntax:	FreeFile
Benutzen Sie diese Funktion, um den nächsten freien Dateikanal zum Öffnen einer Datei zu ermitteln. Sie sollten diese Funktion direkt vor jeder Open-Anweisung verwenden. Jede Datei, die Sie öffnen, benötigt eine Dateikanal-Nummer. Da auch andere Applikationen Dateien öffnen können, dürfen Sie keine absoluten Nummern verwenden, da diese von eben diesen Applikationen schon verwendet sein könnten.

Achtung: Die Verwendung dieser Funktion macht natürlich nur dann Sinn, wenn Sie direkt vor einer Open-Anweisung erfolgt. FreeFile ermittelt nur die nächste Dateikanalnummer, reserviert Sie aber nicht. Möchten Sie mehrere Dateien hintereinander öffnen, muß vor jeder Open-Anweisung die Ermittlung der Dateikanalnummer mit FreeFile erfolgen.

Siehe auch:	Dateiein-/ausgabefunktionen , Name-Anweisung


Dateiein-/ausgabefunktionen
Get-Anweisung

Funktion:	Liest einen Datensatz aus einer relative Datei oder eine Folge von Bytes aus einer binären Datei.
Syntax:	Get [#] dateinr%, [position], Variable
Parameter	Beschreibung
dateinr%	Beliebiger Integer-Ausdruck, der bestimmt, aus welcher Datei gelesen werden soll.
position%	Bei relativen Datein (Random-Access-Dateien) die Nummer des Datensatzes, der gelesen werden soll. Bei binären Dateien (binary Access) die Byte-Position innerhalb der Datei, ab der die Daten gelesen werden sollen.
Variable	Beliebige Variable, die den Inhalt aufnimmt. Es gilt für relative Dateien: Der gesamte Inhalt eines Datensatzes wird in die Variable eingelesen. Ist der Inhalt für die Variable zu klein, werden nicht aufnehmbare Datenteile ignoriert. Es gilt für binäre Dateien: Es werden genau soviele Daten aus der Datei gelesen, wie in der Variablen Platz haben.
Siehe auch:	Dateiein-/ausgabefunktionen ,


Dateiein-/ausgabefunktionen
GetAttr-Funktion

Funktion:	Liefert ein Bitmuster zurück, daß den Dateityp kennzeichnet oder anzeigt, ob es sich um eine Volumenbezeichnung oder ein Verzeichnis handelt.
Syntax:	GetAttr(zeichenfolgeausdruck$)
Parameter	Beschreibung
zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck, der den eindeutigen Namen der Datei samt Pfadangabe enthält.
Mit Hilfe dieser Funktion ermitteln Sie die MS-DOS-Dateiattribute einer Datei. Diese Funktion liefert als Funktionsergebnis ein Bitmuster zurück, mit dessen Hilfe Sie die einzelnen Dateiattribute gemäß der folgenden Tabelle feststellen können:

Wert	Bedeutung
0	Normale Dateien.
1	Nur-Lese-Dateien (Read-Only).
2	Versteckte Dateien.
4	Systemdateien.
8	Der Name des Volumes wird zurückgeliefert.
16	Nur Verzeichnisnamen werden zurückgeliefert.
32	Datei hat sich nach dem letzten Back-Up geändert (Archive-Bit).
Möchten Sie wissen, ob ein Bit des Attributbytes gesetzt ist, bedienen Sie sich folgender Abfrage-Methodik:

If GetAttr(dateiname$) And wert% = wert% then

   ‘Bit ist gesetzt

   .

   .

   .

End If

Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung ,


Dateiein-/ausgabefunktionen
Input #-Anweisung

Funktion:	Erlaubt das Einlesen von numerischen Daten und Zeichenfolgen aus einer Datei.
Syntax:	Input #dateinummer%;var1[,var2[,var3[,...]]]
Parameter	Beschreibung
dateinummer%	Nummer der Datei, aus der die Daten gelesen werden sollen. Die Datei muß zuvor mit der Open-Anweisung und mit dem Zusatz READ geöffnet worden sein.
var	Eine Variable beliebigen Typs, die das Ergebnis des Einlesens aufnimmt. Erlaubt sind hier sowohl numerische Variablen als auch Zeichenfolgevariablen.
Mit Hilfe der Input#-Anweisung können Sie numerische Werte oder Zeichenfolgen aus einer geöffneten Datei in eine oder mehrere Variablen einlesen. Eine numerische Variable wird grundsätzlich bis zum ersten Carriage-Return (Asc=13), Line Feed (Asc=10), Leerzeichen oder Komma gelesen. Zeichenfolgevariablen werden bis zum ersten Carriage-Return (Asc=13), Line Feed (Asc=10) oder Komma gelesen. Haben Sie mehrere Variablen hinter Input# angegeben, werden entsprechend viele Datensätze auf einmal gelesen.

Aus der Tatsache, daß Datensätze auch durch Komma abgegrenzt sein können, folgt die logische Konsequenz, daß keine Kommata selbst mit in eine Zeichenfolgevariable eingelesen werden können. Sollte das jedoch erforderlich sein, verwenden Sie die Line Input#-Anweisung, um reine Textdateien (solche, die keine Steuerzeichen sondern nur druckbare Zeichen enthalten) zeilenweise nacheinander zu lesen.

Siehe auch:	Dateiein-/ausgabefunktionen , GetAttr-Funktion , Kill-Anweisung , Open-Anweisung


Dateiein-/ausgabefunktionen
Kill-Anweisung

Funktion:	Löscht eine Datei von einem Datenträger.
Syntax:	Kill Datei$
Parameter	Beschreibung
Datei$	Beliebiger Zeichenkettenausdruck, der den Dateinamen der zu löschenden Datei incl. Pfad beschreibt.
Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
Line Input #-Anweisung

Funktion:	Erlaubt das Einlesen von Zeichenfolgen aus einer Datei.
Syntax:	Line Input #dateinummer%, var$
Parameter	Beschreibung
dateinummer%	Nummer der Datei, aus der die Daten gelesen werden sollen. Die Datei muß zuvor mit der Open-Anweisung und mit dem Zusatz READ geöffnet worden sein.
var$	Eine Zeichenfolgevariable, die das Ergebnis des Einlesens aufnimmt.
Mit Hilfe der Line Input#-Anweisung können Sie Zeichenfolgen aus einer geöffneten Datei in eine oder mehrere Variablen einlesen. Zeichenfolgevariablen werden bis zum ersten Carriage-Return (Asc=13) oder  Line Feed (Asc=10), also zeilenweise gelesen.

Siehe auch:	Dateiein-/ausgabefunktionen , GetAttr-Funktion , Open-Anweisung


Dateiein-/ausgabefunktionen
Loc-Funktion

Funktion:	Gibt Aufschluß über die gegenwärtige Position innerhalb einer geöffneten Datei.
Syntax:	Loc(dateinummer)
Parameter	Beschreibung
dateinummer	Beliebiger numerischer Ausdruck, der die durch Open festgelegte Dateinummer für die entsprechende Datei enthält.
Wird die Loc-Funktion für eine geöffnete Direktzugriffsdatei verwendet, liefert sie die Nummer des zuletzt gelesenen oder geschriebenen Datensatzes zurück.

In Verbindung mit einer sequentiellen Datei gibt die Loc-Funktion die Position in der Datei an, dividiert durch 128.

Für Binärdateien gilt die Position des zuletzt gelesenen oder geschriebenen Bytes.

Siehe auch:	Dateiein-/ausgabefunktionen , FileDateTime-Funktion , Loc-Funktion


Dateiein-/ausgabefunktionen
Lof-Funktion

Funktion:	Liefert die Größe einer geöffneten Datei zurück.
Syntax:	Lof(dateinummer)
Parameter	Beschreibung
dateinummer	Beliebiger numerischer Ausdruck, der die durch Open festgelegte Dateinummer für die entsprechende Datei enthält.
Lof kann nur für die Ermittlung der Größe von Dateien auf einem Datenträger angewendet werden.

Siehe auch:	Dateiein-/ausgabefunktionen , FileDateTime-Funktion , Line Input #-Anweisung


Dateiein-/ausgabefunktionen
MkDir-Anweisung

Funktion:	Erstellt ein Verzeichnis auf einem Datenträger.
Syntax:	MkDir zeichenkettenausdruck$
	Parameter	Beschreibung
	zeichenketten- ausdruck$	Beliebiger Zeichenkettenausdruck, der den Verzeichnisnamen incl. Pfad enthält.
Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
Name-Anweisung

Funktion:	Gibt einer schon vorhandenen Datei einen neuen Namen.
Syntax:	Name AlteDatei$, NeueDatei$
	Parameter	Beschreibung
	AlteDatei$	Beliebiger Zeichenkettenausdruck, der den Namen der Datei enthält, welche umbenannt werden soll.
	NeueDatei$	Neuer Name der Datei.
Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , Reset-Anweisung ,


Dateiein-/ausgabefunktionen
Open-Anweisung

Funktion:	Öffnet einen Datenkanal.
Syntax:	Open PfadUndDatei$[For Modus][Access Zugriff][Geschuetzt] As[#]Dateinr% [Len=Datensatzlaeng]
Parameter	Beschreibung
PfadUndDatei$	Name und Pfad der Datei, die geöffnet werden soll. Sollte die Datei nicht existieren, wird aber zum Lesen (Access=READ) geöffnet, erscheint eine Fehlermeldung, anderenfalls wird die Datei erstellt.
Modus	Schlüsselwort, daß den Dateimodus beschreibt. Es existieren: Append (sequentielle Datei wird erweitert), binary (Daten können nur Byteweise über Get und Put gelesen werden), Input (Datenkanal wird zum Lesen geöffnet), Output (Datenkanal wird zum Schreiben geöffnet) und Random (relative Dateien werden bearbeitet).
Zugriff	Schlüsselwort, das definiert, auf welche Art der Zugriff erfolgen kann. Erlaubt sind: Read (nur lesen), Write (nur schreiben), Read Write (beides).
Geschuetzt	Schlüsselwort, das den Sicherheitsstatus der Datei nach dem öffnen definiert. Es gelten: Shared (Datei kann auch von anderen Programmen geöffnet werden), Lock Read (Datei wird vor dem Lesen geschützt), Lock Write (Datei wird vor dem Beschreiben geschützt), Lock Read Write(auf die Datei kann gar nicht zugegriffen werden).
Dateinr%	Beliebiger Integer-Ausdruck im Wertebereich von 0-511, der die Nummer eines freien Datenkanals angibt, über den später durch diverse Befehle auf die Datei zugegriffen werden kann. Die Dateinummer kann nicht irgendeine sein, sondern sollte direkt vor der Open-Anweisung mit der FreeFile-Funtkion ermittelt werden.
Datensatzlaeng	Bestimmt bei relativen Dateien die Länge eines Datensatzes. Diese Angabe ist nur notwendig, wenn die Datei als „Random-Access“ geöffnet wurde.
Eine Datei muß durch die Open-Anweisung geöffnet werden, bevor irgendwelche Dateioperationen, die den Inhalt der Datei beeinflussen, stattfinden können. Beim Öffnen einer Datei kommt es zu einer Fehlermeldung, wenn die Datei bereits geöffnet wurde.

Siehe auch:	Dateiein-/ausgabefunktionen , FreeFile-Funktion , GetAttr-Funktion , Open-Anweisung


Dateiein-/ausgabefunktionen
Put-Anweisung

Funktion:	Schreibt einen Datensatz in eine relative Datei oder eine Folge von Bytes in einer binäre Datei.
Syntax:	Put [#] dateinr%, [position], Variable
Parameter	Beschreibung
dateinr%	Beliebiger Integer-Ausdruck, der bestimmt, in welche Datei die Ausgabe erfolgen soll.
position%	Bei relativen Datein (Random Access-Dateien) die Nummer des Datensatzes, der geschrieben werden soll. Bei binären Dateien (Binary Access) die Byte-Position innerhalb der Datei, in die geschrieben werden soll.
Variable	Beliebige Variable, deren Inhalt geschrieben werden soll. Es gilt für relative Dateien: Entspricht der Inhalt dieser Variablen nicht der Länge eines Datensatzes wie er beim Öffnen der Datei durch den LEN-Zusatz bei OPEN definiert wurde, so bleiben die in der Datei vorhandenen Daten ab dem Ende der neu geschriebenen Daten bis zum nächsten Datensatz vorhanden; Die Startposition beim Schreiben ist garantiert immer ein Datensatzanfang. Es gilt für binäre Dateien: Der Inhalt der Variablen wird an die Position, geschrieben der Dateizeiger entsprechend auf die hinter dem letzten Byte geschriebene Position gerückt.
Siehe auch:	Dateiein-/ausgabefunktionen , GetAttr-Funktion , Kill-Anweisung , Open-Anweisung


Dateiein-/ausgabefunktionen
Reset-Anweisung

Funktion:	Schließt alle geöffneten Datenkanäle.
Syntax:	Reset
Siehe auch:	Dateiein-/ausgabefunktionen , RmDir-Anweisung , RmDir-Anweisung


Dateiein-/ausgabefunktionen
RmDir-Anweisung

Funktion:	Löscht ein Verzeichnis auf einem Datenträger.
Syntax:	RmDir zeichenkettenausdruck$
	Parameter	Beschreibung
	zeichenketten- ausdruck$	Beliebiger Zeichenkettenausdruck, der den Verzeichnisnamen incl. Pfad enthält.
Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung


Dateiein-/ausgabefunktionen
Seek-Funktion, Seek-Anweisung

Funktion:	Die Seek-Anweisung setzt die Dateiposition für den nächsten Schreib- oder Lesezugriff, die Funktion ermittelt diese.
Syntax:	Seek(dateinummer) (als Funktion) oder Seek [#]dateinummer, position (als Anweisung)
Parameter	Beschreibung
dateinummer	Beliebiger numerischer Ausdruck, der die durch Open festgelegte Dateinummer für die entsprechende Datei enthält.
position	Position innerhalb der geöffneten Datei, an der der nächste Schreib- oder Lesezugriff durchgeführt werden soll.
Für Direktzugriffsdateien liefert die Seek-Funktion die Nummer des nächsten Datensatzes zurück, der gelesen werden soll oder bestimmt bei Verwendung der Seek-Anweisung die Datensatznummer des nächsten zu schreibenden Datensatzes.

Für alle anderen Dateien gilt die Position des Bytes innerhalb der geöffneten Datei, das als nächstes geschrieben oder gelesen werden soll.

Siehe auch:	Dateiein-/ausgabefunktionen , Put-Anweisung , Get-Anweisung


Dateiein-/ausgabefunktionen
SetAttr-Anweisung

Funktion:	Setzt die Dateiattribute für eine auswählbare Datei auf einen Datenträger.
Syntax:	SetAttr PfadUndDatei$, Attribute%
Parameter	Beschreibung
PfadUndDatei$	Name der Datei incl. Pfadangabe, dessen Attribute bestimmt werden sollen.
Attribut%	Bitmuster, daß über die zu setzen bzw. zu löschenden Attribute Auskunft gibt. Es gilt:
	Wert	Bedeutung
	0	Normale Dateien.
	1	Nur-Lese-Dateien (Read-Only).
	2	Versteckte Dateien.
	4	Systemdateien.
	32	Datei hat sich nach dem letzten Back-Up geändert (Archive-Bit).
Siehe auch:	Dateiein-/ausgabefunktionen , ChDir-Anweisung , Close-Anweisung , CurDir-Funktion , Eof-Funktion , FileCopy-Anweisung , Get-Anweisung , Input #-Anweisung , Lof-Funktion , MkDir-Anweisung , Reset-Anweisung


Dateiein-/ausgabefunktionen
Write#-Anweisung

Funktion:	Schreibt Daten in eine sequentielle Datei.
Syntax:	Write [#]dateinummer, [ausdruckliste]
Parameter	Beschreibung
dateinummer	Beliebiger numerischer Ausdruck, der die durch Open festgelegte Dateinummer für die entsprechende Datei enthält.
Ausdruckliste	Durch Kommata getrennte Variablen oder Ausdrücke, die in eine Datei geschrieben werden sollen.
Die Ausdruckliste ist eine Folge von Variablen oder Ausdrücken, die in eine Datei abgelegt werden sollen. Wird sie nicht mit angegeben, fügt die Write#-Anweisung der Datei eine Leerzeile hinzu.

Eine neue Datei, die eine Ausdrucksliste aufnehmen soll oder eine bereits bestehende Datei, der eine Ausdrucksliste hinzugefügt werden soll, muß im Modus Output oder Append geöffnet sein.

Die Write-Anweisung schreibt Daten von Anführungszeichen umschlossen und durch Kommata getrennt in eine Datei. Es ist daher im Umterschied zur Print#-Anweisung nicht notwendig, gesonderte Trennzeichen in die Liste einzugeben. Das Ende einer mit der Write-Anweisung erstellten Datei, ist durch ein Zeilenendezeichen gekennzeichnet.

Siehe auch:	Dateiein-/ausgabefunktionen , GetAttr-Funktion , Kill-Anweisung , Open-Anweisung


Datums- und Zeitfunktionen

In diesem Kapitel finden Sie alle Anweisungen und Funktionen, die Ihnen helfen, Differenzen zwischen Uhrzeiten oder zwischen zwei Zeitdaten zu berechnen. Innerhalb dieser Funktionen gibt es zwei Kategorien, die sich entweder mit Datumsfunktionen oder mit Zeitfunktionen beschäftigen.

Normalerweise können Sie weder mit Zeitfunktionen noch mit Datumsfunktionen Differenzen berechen. Eine Zeichenfolge wie beispielsweise „12:30:45“ von „12:45:21“ zu subtrahieren macht einfach keinen Sinn. Sowohl für Zeiten als auch für Datumswerte geht StarBasic hier einen einfachen aber unkonventionellen Weg: Sowohl Zeit- als auch Datums-Werte werden in sogenannte fortlaufende numerische Werte umgerechnet, so daß sich ein Zeitpunkt (ein Tag, eine Uhrzeit) als einzelner Wert darstellen läßt. Mit diesen Werten können Sie wie mit normalen Zahlen rechnen. Haben Sie auf diese Art und Weise ein neues Datum oder eine neue Zeit berechnet, können Sie mit Hilfe von speziellen Funktionen die fortlaufenden Zeitzahlen wieder zurück in vom  „Menschen verständliche“ Zeitangaben zurückwandeln.

Sie finden in diesem Kapitel folgende Funktionen und Anweisungen:

Funktionen zur Umwandlung von Datumswerten in berechenbare Werte und zurück:

•	DateSerial-Funktion

•	DateValue-Funktion

•	Day-Funktion

•	Month-Funktion

•	WeekDay-Funktion

•	Year-Funktion

Funktionen zur Umwandlung von Uhrzeiten in berechenbare Werte und zurück:

•	Hour-Funktion

•	Minute-Funktion

•	Now-Funktion

•	Second-Funktion

•	TimeSerial-Funktion

•	TimeValue-Funktion

Funktionen und Anweisungen zur Ermittlung oder Neubestimmung von Systemdatum und Systemuhrzeit

•	Date-Funktion; Date-Anweisung

•	Time-Anweisung

•	Timer-Funktion

Tip: Beide Arten von fortlaufenden Zahlenwerten (Datum, Zeit) sind miteinander kombinierbar. Umrechnungen von Datumswerten in eine einzige Zahl liefern grundsätzlich nachkommalose Werte, während Umrechnungen von Zeitwerten vorkommalose Werte ergeben. Dadurch können Datum und Uhrzeit zusammen durch simple Addition in einer einzigen Fließkommazahl gespeichert werden. StarBasic kennt den Variablen-Typ Date, der eine Zeitangabe, die Datum und Uhrzeit enthält, aufnehmen kann.


Datums- und Zeitfunktionen
Date-Funktion; Date-Anweisung

Funktion:	Liefert das aktuelle Systemdatum als Zeichenfolge zurück oder setzt das Datum neu.
Syntax:	Date oder Date=zeichenfolge-ausdruck
	Parameter	Beschreibung
	zeichenfolge- ausdruck	Wird nur dann benötigt, wenn das Systemdatum neu gesetzt werden soll. In diesem Fall muß der Zeichenfolgeausdruck das Datumsformat erhalten, was aus der länderspezifischen Einstellung der Systemsteuerung hervorgeht. Ist hier „Deutschland“ eingestellt, lautet das Format „TT.MM.JJJJ“, für den 24. Juli 1969 also beispielsweise „24.07.1969“.
Diese Funktion liefert das aktuelle Datum als Zeichenfolge zurück. Das Datumsformat ist abhängig von den länderspezifischen Einstellungen in der Systemsteuerung. Wurde hier „Deutschland“ gewählt, wird die Zeit im Format „TT.MM.JJJJ“ zurückgeliefert.

Siehe auch:	Datums- und Zeitfunktionen , Date-Funktion; Date-Anweisung , DateValue-Funktion , WeekDay-Funktion


Datums- und Zeitfunktionen
DateSerial-Funktion

Funktion:	Erzeugt aus der Angabe von Jahr, Monat und Tag – Parameter, die als numerische Werte übergeben werden – eine fortlaufende Nummer, die in einem einzigen numerischen Wert ein komplettes Datum darstellt. Mit Hilfe dieser fortlaufenden Nummer können Sie Differenzen zwischen Daten berechnen.
Syntax:	DateSerial (year,month,day)
	Parameter	Beschreibung
	year	Integer-Ausdruck, der das Jahr des Datums bestimmt, dessen fortlaufende Nummer berechnet werden soll. Geben Sie die Jahreszahlen zweistellig ein, wenn sie sich im Bereich von 1900 bis 1999 bewegen sollen. Jahreszahlen, die außerhalb dieses Bereichs liegen (möglich sind die Jahre 100-9999 inclusive) müssen grundsätzlich vollständig angegeben werden (45 entspricht also 1945; 1812 müßte natürlich vierstellig angegeben werden).
	month	Integer-Ausdruck, der den Monat innerhalb des angegebenen Jahres bestimmt. Der Wertebereich bewegt sich dabei in der Regel zwischen 1 und 12. Werte außerhalb dieses Bereichs sind aber dennoch möglich. In diesem Fall beeinfluß der Monat auch die Jahreszahl. 1994,  0, 30 entspräche z.B. 1993, 12, 30 1994, 13, 30 entspräche 1995, 1, 30
	day	Integer-Ausdruck, der den Tag innerhalb des angegebenen Monats definiert.  Der Wertebereich bewegt sich dabei in der Regel zwischen 1 und 28, 29, 30 oder 31 (je nach Tages im angegebenen Monat). Werte außerhalb dieses Bereichs sind aber dennoch möglich. In diesem Fall beeinflußt der Tag auch die Monatszahl. 1994, 6, 31 entspräche z.B. 1994, 7, 1 1994, 3, 0 entspräche 1994, 2, 28
Mit Hilfe dieser Funktion können Sie ein beliebiges Datum in einen einzigen numerischen Wert umrechnen, mit dem Sie wiederum Datendifferenzen berechnen können.

Die DateSerial-Funktion liefert den Typen Variant mit VarType 7 (Date) zurück; intern wird dieser Wert jedoch als Wert doppelter Genauigkeit gespeichert. Der 1.1.1900 entspricht dabei dem Wert 2. Negative Werte entsprechen einem Datum, daß vor dem 30.12.1899 (nicht inclusive) entspricht. Zurückgelieferte Werte entsprechen also dem Zeitpunkt relativ zum 31.12.1899 in Tagen.

Wird der Funktion ein Datum übergeben, daß sich außerhalb des angegebenen Bereichs befindet, meldet StarBasic eine Fehlermeldung.

Der Unterschied zur DateValue-Funktion ist, daß Sie dort eine Zeichenfolge als Funktionsargument übergeben, der das Datum beinhaltet. Hingegen übergeben Sie der DateSerial-Funktion die einzelnen Parameter (Jahr, Monat, Tag) getrennt als numerische Ausdrücke.

Beispiel:	Das folgende Beispielprogramm fragt Sie nach Ihrem Geburtsdatum, berechnet anschließend Ihr Alter in Tagen und nennt Ihnen schließlich das Datum, das aktuell wäre, wenn Sie bei gleichem Alter heute vor 100 Jahre geboren wären:
temp$=Input Box$ ("Bitte geben Sie Ihr Geburtsdatum ein: ","Geburtsdatum")

GebDatum = DateValue(temp$)

Heute = DateValue(Date$)

Differenz = Heute - GebDatum

Print "Sie sind"; Differenz; "Tage alt"

HeuteTag = Day(Heute)

HeuteMonat = Month(Heute)

HeuteJahr = Year(Heute)

'Aktuelles Datum errechnen, wenn heute vor 100 Jahren geboren

Virtheute = DateSerial(HeuteJahr - 100, HeuteMonat, HeuteTag)

'Alter, also Differenz zwischen heute und

'Geburtsdatum dazurechnen

Virtheute = Virtheute + Differenz

'Datum zusammenbasteln

datumHeute$ = LTrim(Str$(Day(Virtheute))) + "."

datumHeute$ = datumHeute$ + LTrim(Str$(Month(Virtheute))) + "."

datumHeute$ = datumHeute$ + LTrim(Str$(Year(Virtheute)))

'neues Datum ausgeben

Print "Wären Sie heute vor hundert Jahren geboren und genauso alt wie jetzt,
 wäre heute erst der " + datumHeute$

Siehe auch:	Datums- und Zeitfunktionen , Datums- und Zeitfunktionen , Datums- und Zeitfunktionen , DateValue-Funktion , WeekDay-Funktion


Datums- und Zeitfunktionen
DateValue-Funktion

Funktion:	Erzeugt aus einer Datumszeichenfolge eine fortlaufende Nummer, die in einem einzigen numerischen Wert ein komplettes Datum darstellt. Mit Hilfe dieser fortlaufenden Nummer können Sie Differenzen zwischen Daten berechnen.
Syntax:	DateValue[(date)]
	Parameter	Beschreibung
	date	Beliebiger Zeichenfolgeausdruck, der das zu berechnende Datum in einem (fast) beliebigen Format enthält. Im folgenden Beispieldatum „12.6.1995“ sind alle Darstellungsvarianten erlaubt 12.06.1995 12.6.95 12.6.1995 12 Jun 1995 Jun 12. 95 12/95 Jun etc. Die Angabe dieses Parameters ist optional. Wird er ausgelassen, berechnet die Funktion das aktuelle Tagesdatum.
Mit Hilfe dieser Funktion können Sie ein beliebiges Datum in einen einzigen Integerwert umrechnen, mit dem Sie wiederum Datendifferenzen berechnen können.

Die DateSerial-Funktion liefert den Typen Variant mit VarType 7 (Date) zurück; intern wird dieser Wert jedoch als Wert doppelter Genauigkeit gespeichert. Der 1.1.1900 entspricht dabei dem Wert 2. Negative Werte entsprechen einem Datum, daß vor dem 30.12.1899 (also nicht inclusive) entspricht. Zurückgelieferte Werte entsprechen also dem Zeitpunkt relativ zum 31.12.1899 in Tagen.

Wird der Funktion ein Datum übergeben, daß sich außerhalb des angegebenen Bereichs befindet, meldet StarBasic eine Fehlermeldung.

Der Unterschied zur DateSerial-Funktion ist, daß Sie dort Jahr, Monat und Tag getrennt als numerische Ausdrücke übergeben. Hingegen übergeben Sie der DateValue-Funktion einen Zeichenfolgenausdruck, der das Format „T.M.J“ aufweisen muß.

Beispiel:	Siehe DateSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Date-Funktion; Date-Anweisung , DateSerial-Funktion , Day-Funktion , Month-Funktion , WeekDay-Funktion , Year-Funktion ,


Datums- und Zeitfunktionen
Day-Funktion

Funktion:	Liefert aus einer fortlaufenden Datumszahl, die mit DateSerial oder mit DateValue generiert wurde, den Tag des Datums im entsprechenden Monat zurück.
Syntax:	Day(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Ganzzahliger numerischer Ausdruck, der die fortlaufende Datumszahl enthält, aus der der Tag im Monat eines Datums ermittelt werden soll.
Diese Funktion stellt quasi teilweise die Umkehrfunktion zur DateSerial-Funktion dar. Sie ermittelt aus der fortlaufenden Datumszahl, die mit DateSerial oder mit DateValue generiert wurde, wieder den Tag innerhalb des Monats eines bestimmten Datums. Der Ausdruck

Print Day(DateSerial(1994, 12, 20))

ergibt also den Wert 20.

Beispiel:	Siehe DateSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Date-Funktion; Date-Anweisung ,DateSerial-Funktion , DateValue-Funktion , Month-Funktion , WeekDay-Funktion , Year-Funktion


Datums- und Zeitfunktionen
Hour-Funktion

Funktion:	Liefert aus einer fortlaufenden Zeitzahl, die mit TimeSerial oder mit TimeValue generiert wurde, die Stunde der Uhrzeit zurück.
Syntax:	Hour(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Numerischer Ausdruck, der die fortlaufende Uhrzeitzahl enthält, aus dem die Stunde berechnet werden soll.
Diese Funktion stellt quasi teilweise die Umkehrfunktion zur TimeSerial-Funktion dar. Sie ermittelt aus der fortlaufenden Uhrzeitzahl, die mit der TimeSerial-Funktion oder mit der TimeValue-Funktion generiert wurde, wieder die Stunde einer bestimmten Uhrzeit zurück. Der Ausdruck

Print Hour(TimeSerial(12:30:41))

ergibt also den Wert 12.

Beispiel:	Siehe TimeSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Minute-Funktion , Now-Funktion , Second-Funktion , Time-Anweisung , Timer-Funktion , TimeSerial-Funktion , TimeValue-Funktion


Datums- und Zeitfunktionen
Minute-Funktion

Funktion:	Liefert aus einer fortlaufenden Zeitzahl, die mit TimeSerial oder mit TimeValue generiert wurde, die Minute der gesamten Uhrzeit zurück.
Syntax:	Minute(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Numerischer Ausdruck, der die fortlaufende Uhrzeitzahl enthält, aus dem die Stunde berechnet werden soll.
Diese Funktion stellt quasi teilweise die Umkehrfunktion zur TimeSerial-Funktion dar. Sie ermittelt aus der fortlaufenden Uhrzeitzahl, die mit der TimeSerial-Funktion oder mit der TimeValue-Funktion generiert wurde, wieder die Minute einer bestimmten Uhrzeit zurück. Der Ausdruck

Print Minute(TimeSerial(12:30:41))

ergibt also den Wert 30.

Beispiel:	Siehe TimeSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Hour-Funktion , Now-Funktion , Second-Funktion , Time-Anweisung , Timer-Funktion , TimeSerial-Funktion , TimeValue-Funktion


Datums- und Zeitfunktionen
Month-Funktion

Funktion:	Liefert aus einer fortlaufenden Datumszahl, die mit DateSerial oder mit DateValue generiert wurde, den Monat des Datums im entsprechenden Jahr zurück.
Syntax:	Month(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Ganzzahliger numerischer Ausdruck, der die fortlaufende Datumszahl enthält, aus der der Monat im Jahr eines Datums ermittelt werden soll.
Diese Funktion stellt quasi teilweise die Umkehrfunktion zur DateSerial-Funktion dar. Sie ermittelt aus der fortlaufenden Datumszahl, die mit der DateSerial-Funktion oder mit der DateValue-Funktion generiert wurde, wieder den Monat innerhalb des Jahres eines bestimmten Datums. Der Ausdruck

Print Month(DateSerial(1994, 12, 20))

ergibt also den Wert 12.

Beispiel:	Siehe DateSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Date-Funktion; Date-Anweisung , DateSerial-Funktion , DateValue-Funktion , Day-Funktion , WeekDay-Funktion , Year-Funktion ,


Datums- und Zeitfunktionen
Now-Funktion

Funktion:	Ermittelt die aktuelle Zeit als fortlaufende Uhrzeitzahl, also eine fortlaufende Nummer, die in einem einzigen numerischen Wert die komplette Uhrzeit darstellt. Mit Hilfe dieser fortlaufenden Nummer können Sie Differenzen zwischen Uhrzeiten berechnen.
Syntax:	Now
Beispiel:	Siehe TimeSerial-Funktion ,

Siehe auch:	Datums- und Zeitfunktionen , Hour-Funktion , Minute-Funktion , Second-Funktion , Time-Anweisung , Timer-Funktion , TimeSerial-Funktion , TimeValue-Funktion


Datums- und Zeitfunktionen
Second-Funktion

Funktion:	Liefert aus einer fortlaufenden Zeitzahl, die mit TimeSerial oder mit TimeValue generiert wurde, die Sekunde der gesamten Uhrzeit zurück.
Syntax:	Second(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Numerischer Ausdruck, der die fortlaufende Uhrzeitzahl enthält, aus dem die Sekunde berechnet werden soll.
Diese Funktion stellt quasi teilweise die Umkehrfunktion zur TimeSerial-Funktion dar. Sie ermittelt aus der fortlaufenden Uhrzeitzahl, die mit der TimeSerial-Funktion oder mit der TimeValue-Funktion generiert wurde, wieder die Sekunde einer bestimmten Uhrzeit zurück. Der Ausdruck

Print Second(TimeSerial(12:30:41))

ergibt also den Wert 41.

Beispiel:	Siehe TimeSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Hour-Funktion , Minute-Funktion , Now-Funktion , Time-Anweisung ,  Timer-Funktion , TimeSerial-Funktion , TimeValue-Funktion ,


Datums- und Zeitfunktionen
Time-Anweisung

Funktion:	Diese Funktion liefert die aktuelle Systemzeit als Zeichenfolge im Format „HH:MM:SS“ zurück oder stellt die Systemuhr neu.
Syntax:	Time oder Time = zeichenfolge-ausdruck
	Parameter	Beschreibung
	zeichenfolge- ausdruck	Beliebiger Zeichenfolgeausdruck, der die neue Uhrzeit im Format „HH:MM:SS“ beschreibt.
Siehe auch:	Datums- und Zeitfunktionen , Hour-Funktion , Minute-Funktion , Now-Funktion , Second-Funktion , Timer-Funktion , TimeSerial-Funktion , TimeValue-Funktion , Date-Funktion; Date-Anweisung


Datums- und Zeitfunktionen
Timer-Funktion

Funktion:	Liefert eine Fließkommazahl mit zwei Nachkommastellen, die die vergangene Zeit seit Mitternacht in Sekunden darstellt. In der ersten Nachkommastelle befinden sich die zehntel, in der zweiten hundertstel Sekunden.
Syntax:	Timer
Siehe auch:	Datums- und Zeitfunktionen , Timer-Funktion , TimeSerial-Funktion


Datums- und Zeitfunktionen
TimeSerial-Funktion

Funktion:	Erzeugt aus der Angabe von Stunde, Minute und Sekunde – Parameter, die als numerische Werte übergeben werden – eine fortlaufende Nummer, die in einem einzigen numerischen Wert eine komplette Uhrzeit darstellt. Mit Hilfe dieser fortlaufenden Nummer können Sie Differenzen zwischen Uhrzeiten berechnen.
Syntax:	TimeSerial(hour,minute,second)
Parameter	Beschreibung
hour	Beliebiger Integer-Ausdruck, der die Stunde der gesamten Uhrzeit angibt, aus der der fortlaufende Zeitwert ermittelt werdem soll. Erlaubt sind hier Werte im Bereich von 0-23.
minute	Beliebiger Integer-Ausdruck, der die Minute der gesamten Uhrzeit angibt, aus der der fortlaufende Zeitwert ermittelt werden soll. Normalerweise geben Sie hier Werte zwischen 0 und 59 an. Werte außerhalb dieses Bereichs sind aber dennoch möglich. In diesem Fall beeinflußt die Minute auch die Stunde. 12, -5, 45 entspräche z.B. 11, 55, 45 12, 61, 45 entspräche 13, 2, 45
second	Beliebiger Integer-Ausdruck, der die Sekunde der gesamten Uhrzeit angibt, aus der der fortlaufende Zeitwert ermittelt werden soll. Normalerweise geben Sie hier Werte zwischen 0 und 59 an. Werte außerhalb dieses Bereichs sind aber dennoch möglich. In diesem Fall beeinflußt die Sekunde auch die Minute. 12, 20, -2 entspräche z.B. 12, 19, 58 12, 20, 63 entspräche 12, 21, 4
Mit Hilfe dieser Funktion können Sie eine beliebige Uhrzeit in einen einzigen Wert umrechnen, mit dem Sie wiederum Zeitdifferenzen berechnen können.

Die TimeSerial-Funktion liefert den Typen Variant mit VarType 7 (Date) zurück; intern wird dieser Wert jedoch als Wert doppelter Genauigkeit gespeichert, der Werte zwischen 0 und 0,9999999999 zuläßt. Im Gegensatz zur DateSerial- bzw. DateValue-Funktion, die fortlaufende Zahlen aus Datums-Angaben so errechnet, daß Sie Tage relativ zu einem festen Datum ergeben, können Sie zwar mit den Werten rechnen, die die TimeSerial-Funktion zurückliefert, diese aber nicht direkt auswerten.

Der Unterschied zur TimeValue-Funktion ist, daß Sie dort eine Zeichenfolge als Funktionsargument übergeben, die die Uhrzeit beinhaltet. Hingegen übergeben Sie der TimeSerial-Funktion die einzelnen Parameter (Stunde, Minute, Sekunde) getrennt als numerische Ausdrücke.

Beispiel:	Das folgende Beispiel nutzt alle Zeit- und Datumsfunktionen recht intensiv. Es erlaubt dem Anwender, zweimal jeweils ein Datum und eine Uhrzeit zu bestimmen, und berechnet die Differenz beider Daten in Minuten aus.
Sub Main()

   'Zeit und Datum abfragen

   Zeit1$ = InputBox$ ("Bitte geben Sie die erste Zeit ein","Zeiteingabe")

   datum1$ = InputBox$ ("Bitte geben Sie das erste Datum ein","Datumeingabe")

   Zeit2$ = InputBox$ ("Bitte geben Sie die zweite Zeit ein","Zeiteingabe")

   datum2$ = InputBox$ ("Bitte geben Sie das zweite Datum ein","Datumeingabe")

   Minuten = ZeitDifferenz(Zeit1$, datum1$, Zeit2$, datum2$)

   Ausgabe$ = "Die Differenz zwischen " + Zeit1$ + " am " + datum1$

   Ausgabe$ = Ausgabe$ + " und " + Zeit2$ + " am " + datum2$

   Ausgabe$ = Ausgabe$ + " beträgt" + Str$(Minuten)

   Ausgabe$ = Ausgabe$ + " Minuten,"

   Print Ausgabe$

   Print "bzw."; Int(Minuten / 60); " Stunden und"; Minuten Mod 60; "

     Minuten"

End Sub

'*******

'Berechnen der Zeitdifferenz zweier Zeitpunkte ein zwei

'verschiedenen Daten in Minuten; Sekunden bleiben

'dabei unberücksichtigt.

'*******

'

Function ZeitDifferenz& (Zeit1$, datum1$, Zeit2$, datum2$)

    'Feststellen, welche der beiden Zeitpunkte

    'früher liegt, ggf. die Werte vertauschen

    If DateValue(datum1$) > DateValue(datum2$) Then

        temp$ = Zeit1$: Zeit1$ = Zeit2$: Zeit2$ = temp$

        temp$ = datum1$: datum1$ = datum2$: datum2$ = temp$

    ElseIf DateValue(datum1$) = DateValue(datum2$) Then

        'Wenn Datum gleich Uhrzeit ohne Sekunden gleich,

        ' dann ist die Differenz null.

        If Left$(Zeit1$, 5) = Left$(Zeit2$, 5) Then

            ZeitDifferenz& = 0

            Exit Function

        ElseIf TimeValue(Zeit1$) > TimeValue(Zeit2$) Then

                temp$ = Zeit1$: Zeit1$ = Zeit2$: Zeit2$ = temp$

                temp$ = datum1$: datum1$ = datum2$: datum2$ = temp$

        End If

    End If

    'datum1$ und zeit1$ enthalten ab hier den früheren Zeitpunkt,

    'datum2$ und zeit2$ enthalten den späteren Zeitpunkt

    'Differenz zwischen Datum2 und Datum1 (jeweils von 0:00 Uhr

    ' an gerechnet) berechnen.

    Minuten = ((DateValue(datum2$) - DateValue(datum1$)) * 24 * 60)

    'Minuten und Stunden aus den Zeitangaben eliminieren

    Std1 = Hour(TimeValue(Zeit1$)): Min1 = Minute(TimeValue(Zeit1$))

    Std2 = Hour(TimeValue(Zeit2$)): Min2 = Minute(TimeValue(Zeit2$))

    'Offsets von 0:00 des jeweiligen Datums aus

    'gesehen in Minuten berechnen

    MinOffset1 = Std1 * 60 + Min1

    MinOffset2 = Std2 * 60 + Min2

    'endgültige Zeitdifferenz in Minuten ist die

    'Differenz der Tage in Minuten, zzgl. der Zeit seit 0:00 Uhr

    'des späteren Datums, abzgl. der Zeit seit 0:00 des

    'früheren Datums:

    ZeitDifferenz& = Minuten - MinOffset1 + MinOffset2

End Function

Siehe auch:	Datums- und Zeitfunktionen , DateValue-Funktion , WeekDay-Funktion


Datums- und Zeitfunktionen
TimeValue-Funktion

Funktion:	Erzeugt aus der Angabe von Stunde, Minute und Sekunde – Parameter, die als Zeichenfolge übergeben werden – eine fortlaufende Nummer, die in einem einzigen numerischen Wert eine komplette Uhrzeit darstellt. Mit Hilfe dieser fortlaufenden Nummer können Sie Differenzen zwischen Uhrzeiten berechnen.
Syntax:	TimeValue(zeichenfolge-ausdruck)
Parameter	Beschreibung
zeichenfolge- ausdruck:	Beliebiger Zeichenfolgeausdruck, der die zu berechnenden Uhrzeit im Format „HH:MM:SS“ beschreibt.
Mit Hilfe dieser Funktion können Sie eine beliebige Uhrzeit in einen einzigen Wert umrechnen, mit dem Sie wiederum Zeitdifferenzen berechnen können.

Die TimeValue-Funktion liefert den Typen Variant mit VarType 7 (Date) zurück; intern wird dieser Wert jedoch als Wert doppelter Genauigkeit gespeichert, der Werte zwischen 0 und 0,9999999999 zuläßt.

Im Gegensatz zur DateSerial- bzw. DateValue-Funktion, die fortlaufende Zahlen aus Datums-Angaben so errechnet, daß sich Tage relativ zu einem festen Datum ergeben, können Sie zwar mit den Werten rechnen, die die TimeValue-Funktion zurückliefert, diese aber nicht direkt auswerten.

Der Unterschied zur TimeSerial-Funktion ist, daß Sie dort die einzelnen Parameter (Stunde, Minute, Sekunde) getrennt als nummerische Ausdrücke übergeben. Hingegen übergeben Sie der TimeSerial-Funktion eine Zeichenfolge als Funktionsargument, die die Uhrzeit beinhaltet.

Beispiel:	Das folgende Beispielprogramm berechnet die Differenz aus zwei Zeiten, die der Anwender bestimmen kann und stellt sie in einer Dialogbox auf dem Bildschirm dar:
a$ = InputBox$ ("Bitte geben Sie die erste Zeit ein","Zeiteingabe")

b$ = InputBox$ ("Bitte geben Sie die zweite Zeit ein","Zeiteingabe")

' Zeiten berechnen

zeit1 = TimeValue(a$)

zeit2 = TimeValue(b$)

' Dreieckstausch, falls Zeit2 größer Zeit1

If zeit2 > zeit1 Then

    temp = zeit2

    zeit2 = zeit1

    zeit1 = temp

End If

Differenz = zeit2 - zeit1

Diff$ = LTrim$(Str$(Hour(Differenz))) + ":"

Diff$ = Diff$ + LTrim$(Str$(Minute(Differenz))) + ":"

Diff$ = Diff$ + LTrim$(Str$(Second(Differenz)))

Print "Die Differenz zwischen "; a$; " und "; b$; " beträgt "; Diff$

Siehe auch:	Datums- und Zeitfunktionen , Timer-Funktion


Datums- und Zeitfunktionen
WeekDay-Funktion

Funktion:	Liefert aus einer fortlaufenden Datumszahl, die mit DateSerial oder mit DateValue generiert wurde, die Nummer des Wochentags des Datums im entsprechenden Monat zurück.
Syntax:	WeekDay(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Ganzzahliger numerischer Ausdruck, der die fortlaufende Datumszahl enthält, aus der der Wochentag (0-7) im Monat eines Datums ermittelt werden soll.
Diese Funktion ermittelt aus der fortlaufenden Datumszahl, die mit der DateSerial-Funktion oder mit der DateValue-Funktion generiert wurde, den Wochentag innerhalb des Monats eines bestimmten Datums.

Beispiel:	Das folgende Beispielprogramm erlaubt die Eingabe eines Datums, und ruft anschließend die Funktion Wochentag auf, in der mit Hilfe der WeekDay-Funktion der Wochetag im Klartext ermittelt wird. Der Wochentagname wird anschließend ausgegeben.
Sub Main

    'Datum einlesen

    Input Bitte geben Sie ein Datum ein";Datum$

    'Wochentag ermitteln und ausgeben

    Print "Der " + Datum$ + " ist ein " + Wochentag$(DateValue(Datum$))

End Sub

Function Wochentag$ (SerialNumber)

    Static Wochentage(1 To 7)

    Wochentage(1) = "Sonntag"

    Wochentage(2) = "Montag"

    Wochentage(3) = "Dienstag"

    Wochentage(4) = "Mittwoch"

    Wochentage(5) = "Donnerstag"

    Wochentage(6) = "Freitag"

    Wochentage(7) = "Samstag"

    Wochentag$ = Wochentage(Weekday(SerialNumber))

End Function

Tip: Sie können natürlich die hier verwendete Funktion WOCHENTAG direkt in Ihren eigenen Programmen verwenden.

Siehe auch:	Datums- und Zeitfunktionen , Datums- und Zeitfunktionen , Datums- und Zeitfunktionen , Date-Funktion; Date-Anweisung , DateValue-Funktion , WeekDay-Funktion , TimeSerial-Funktion


Datums- und Zeitfunktionen
Year-Funktion

Funktion:	Liefert aus einer fortlaufenden Datumszahl, die mit DateSerial oder mit DateValue generiert wurde, die Jahreszahl zurück.
Syntax:	Year(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Ganzzahliger numerischer Ausdruck, der die fortlaufende Datumszahl enthält, aus der die Jahreszahl ermittelt werden soll.
Diese Funktion stellt quasi teilweise die Umkehrfunktion zur DateSerial-Funktion dar. Sie ermittelt aus der fortlaufenden Datumszahl, die mit der DateSerial-Funktion oder mit der DateValue-Funktion generiert wurde, wieder die Jahreszahl zurück. Der Ausdruck

Print Year(DateSerial(1994, 12, 20))

ergibt also den Wert 1994.

Beispiel:	Siehe DateSerial-Funktion

Siehe auch:	Datums- und Zeitfunktionen , Date-Funktion; Date-Anweisung , DateSerial-Funktion , DateValue-Funktion , Day-Funktion , Month-Funktion , WeekDay-Funktion , TimeValue-Funktion


DDE-Anweisungen und Funktionen

DDE (Dynamic Data Exchange) befähigt Programme Daten mit anderen Programmen auszutauschen, die zur selben Zeit aktiv sind. Mit Hilfe von DDE lassen sich ebenfalls Programme durch andere Programme „fernsteuern“, so sie beide mit diesem Feature ausgestattet sind. Die folgenden Abschnitt beschreiben die DDE-Befehle von StarBasic:

Folgende Befehle zur DDE-Steuerung  werden vom StarBasic unterstütz:

•	DDEExecute-Anweisung

•	DDEInitiate-Funktion

•	DDEPoke-Anweisung

•	DDERequest$-Funktion

•	DDETerminate-Anweisung

•	DDETerminateAll-Anweisung


DDE-Anweisungen und Funktionen
DDEExecute-Anweisung

Funktion:	Sendet einen Befehl oder mehrere Befehle per DDE an eine andere Applikation.
Syntax:	DDEExecute chanal%,Command$
	Parameter	Beschreibung
	channel%	Beliebiger Integerausdruck, der die Nummer des DDE-Kanals zur entsprechenden Applikation enthält. Die Nummer des Kanals erhalten Sie durch die DDEInitiate-Anweisung.
	Command$	Beliebiger Zeichenkettenausdruck, der den zur übergebenden Befehl an die empfangende Applikation enthält. Command$ muß ein DDE-Kommando enthalten, das der empfangenden Applikation bekannt ist. Mehrere Befehle können zugleich übergeben werden; jeder Befehl muß dabei in eckigen Klammern eingeschlossen sein.
Die DDEExecute-Anweisung erlaubt es Ihnen, mehrere Befehle zur gleichen Zeit zu senden. Durch die folgende Anweisung wird das Programm StarCalc z.B. angewiesen, eine Tabelle zu öffnen und sofort wieder zu schließen:

DDEExecute Kanal, "[Documents.Add][ActiveDocument.Close]"

Achtung: Beachten Sie, daß sich zwischen den in eckigen Klammern stehenden Befehlen kein Leerzeichen befindet, da das einen Laufzeitfehler hervorrufen würde.

Die obige Anweisung ist gleichbedeutend mit den beiden folgenden Anweisungen:

DDEExecute Kanal, "[Documents.Add]"

DDEExecute Kanal, "[ActiveDocument.Close]"

Die direkte Angabe von Zeichenkettenfolgen als Parameter erfordert, daß die Zeichenkette in Anführungszeichen eingeschlossen ist. Problematisch wird es in dem Moment, in dem ein Anführungszeichen, das ja Anfang und Ende der Zeichenfolge kennzeichnet, Bestandteil der Zeichenfolge sein sollen. Daher müssen Sie Anführungszeichen in Zeichenkettenfolgen mit Chr$(34) einfügen oder die Anführungsstriche direkt doppelt hintereinander angeben. Durch folgende Anweisung wird StarWriter angewiesen, die Datei BEISPIEL.SDW zu öffnen:

DDEExecute Kanal, "[Documents.Add("+Chr$(34)+"BEISPIEL.SDW"+Chr$(34)+")]"

Die andere Möglichkeit (Angabe eines Anführungszeichens durch zwei aufeinanderfolgende Anführungszeichen) ist:

DDEExecute Kanal, "[ Documents.Add(""BEISPIEL.SDW"")]"

Beispiel:	Siehe DDEInitiate-Funktion

Siehe auch:	DDE-Anweisungen und Funktionen , DDEInitiate-Funktion , DDEPoke-Anweisung  , DDERequest$-Funktion , DDETerminate-Anweisung , DDETerminateAll-Anweisung


DDE-Anweisungen und Funktionen
DDEInitiate-Funktion

Funktion:	Öffnet einen DDE-Kanal zur empfangenden Applikation, die von der sendenden Applikation Befehle entgegennehmen und ausführen kann und liefert die Kanalnummer zurück.
Syntax:	DDEInitiate(Application$, Object$)
Parameter	Beschreibung
Application$	Beliebiger Zeichenkettenausdruck, der den Dateinnamen der Applikation ohne die Endung „.EXE“ und ohne Pfad enthält. Wichtig: Die Applikation muß gestartet sein, damit die DDEInitiate-Funktion einen Kanal öffnen kann.
Object$	Der Name eines der Applikation bekannten Objektes. Das kann bei StarOffice-Programmen z.B. der Name eines geöffneten Dokumentes sein. Objekte müssen vorhanden sein; ist das Objekt beispielsweise ein Dokument, so muß das Dokument zuvor geöffnet werden.
Diese Funktion öffnet einen Kanal zur Applikation und liefert einen numerischen Ausdruck zurück, der der Nummer des Kanals entspricht. Mit dieser Kanalnummer können Sie über DDE-Anweisungen mit dem Objekt der Applikation kommunizieren und es dadurch beeinflussen.

Beispiel:	Das folgende StarCalc-Beispielprogramm baut eine Verbindung zum StarWriter auf. Per DDE fügt es die Zahlen von 1-10 in das StarWriter-Dokument ein, markiert sie durch Lesezeichen, liest den Inhalt der Lesezeichen aus und fügt diese in die StarCalc-Tabelle ein. Schließlich rechnet es die Werte der so übernommenen Daten in StarCalc zusammen.
Sub Main

‘DDE-Verbindung zu StaWriter 3, Dokument „unbenannt1“ aufbauen

Kanal = DDEInitiate( "swriter3", "unbenannt1")

‘Aufbau der Verbindung war erfolgreich, also

if Kanal <> 0 then

‘gesamten Text via DDE selektieren...

Befehl$ = "[ActiveWindow.Text.SelectAll]"

DDEExecute (Kanal, Befehl$)

‘...und löschen

Befehl$ = "[ActiveWindow.Text.Delete]"

DDEExecute (Kanal, Befehl$)

‘Das ganze 10 mal

for n = 1 to 10

‘...Zahlen von 1-10 ins Dokument einfügen

Befehl$ = "[ActiveWindow.Selection.Insert (""" + n + """)]"

DDEExecute (Kanal, Befehl$)

‘Zum Anfang der Zeile springen, dabei selektieren

Befehl$ = "[ActiveWindow.Text.GoToStartOfLine (TRUE)]"

DDEExecute (Kanal, Befehl$)

‘Lesezeichen „fetch“ einfügen

Befehl$ = "[ActiveWindow.Text.InsertBookmark (""fetch"")]"

DDEExecute (Kanal, Befehl$)

‘Inhalt des Lesezeichens auslesen

Value$ = DDERequest( Kanal, "fetch")

‘Lesezeichen wieder löschen

Befehl$ = "[ActiveWindow.Text.DeleteBookmark (""fetch"")]"

DDEExecute (Kanal, Befehl$)

‘Ausgelesenen Text des Lesezeichens in Zelle einfügen

ActiveCell.Insert Value$

‘Zur Zelle in nächster Zeile bewegen

ActiveWindow.GoDown

‘Cursor in StarCalc zum Zeilenende bewegen...

Befehl$ = "[ActiveWindow.Text.GoToEndOfLine]"

DDEExecute (Kanal, Befehl$)

‘...und dort Absatz einfügen

Befehl$ = "[ActiveWindow.Text.InsertPara]"

DDEExecute (Kanal, Befehl$)

next n

DDETerminateAll

else

‘DDE-Verbindung konnte nicht aufgebaut werden

MsgBox "Keine Verbindung zu StarWriter möglich"

end if

End Sub

Siehe auch:	DDE-Anweisungen und Funktionen , DDEExecute-Anweisung , DDEPoke-Anweisung  , DDERequest$-Funktion , DDETerminate-Anweisung , DDETerminateAll-Anweisung


DDE-Anweisungen und Funktionen
DDEPoke-Anweisung

Funktion:	Sendet Daten zu einem Element eines Objektes einer Applikation über einen geöffneten DDE-Kanal.
Syntax:	DDEPoke channel%, element$, dates$
	Parameter	Beschreibung
	channel%	Beliebiger Integerausdruck, der die Nummer des DDE-Kanals zur entsprechenden Applikation enthält. Die Nummer des Kanals erhalten Sie durch die DDEInitiate-Anweisung.
	element$	Name des Elements, daß sich auf das zuvor mit DDEInitiate angesprochene Objekt der empfangenden Applikation bezieht.
	date$	Daten, die dem Element des Objektes übermittelt werden sollen.
Beispiel:	Dieses Beispiel sendet den Befehl zum Drucken des angegebenen Dokumentes an StarWriter: PokeKanal% = DDEInitiate ("SWRITER3", <Dokumentname>) DDEPoke (PokeKanal%, "Print", <Dokumentname mit Dateipfad>)
Siehe auch:	DDE-Anweisungen und Funktionen , DDEExecute-Anweisung , DDEInitiate-Funktion , DDERequest$-Funktion , DDETerminate-Anweisung , DDETerminateAll-Anweisung


DDE-Anweisungen und Funktionen
DDERequest$-Funktion

Funktion:	Ermittelt ein Datum eines Elementes des durch DDEInitiate angesprochenen Objektes einer Applikation.
Syntax:	DDERequest$(channel%, element$)
	Parameter	Beschreibung
	channel%	Beliebiger Integerausdruck, der die Nummer des DDE-Kanals zur entsprechenden Applikation enthält. Die Nummer des Kanals erhalten Sie durch die DDEInitiate-Anweisung.
	element$	Name des Elements, daß sich auf das zuvor mit DDEInitiate angesprochene Objekt der empfangenden Applikation bezieht.
Beispiel:	StarOffice sowie andere DDE-Anwendungen unterstützen ein Objekt mit der Bezeichnung "System". Das Element „TOPICS“ im Objekt „System“ liefert eine Liste aller verfügbaren Objekte in der Anwendung. Diese Liste kann mit DDERequest ermittelt werden, wie das folgende Beispiel zeigt: Kanal = DDEInitiate ("SCALC3", "SYSTEM") Topics$ = DDERequest$(Kanal, "TOPICS") Beispiel 2: Das nachstehende Beispiel ermittelt die Bezeichnung des Lesezeichens des angegebenen Dokumentes: Kanal% = DDEInitiate ("SWRITER3", <Dokumentname>) a$ = DDERequest (Kanal%, "Lesezeichen")
Siehe auch:	DDE-Anweisungen und Funktionen , DDEExecute-Anweisung , DDEInitiate-Funktion , DDEPoke-Anweisung , DDETerminate-Anweisung , DDETerminateAll-Anweisung


DDE-Anweisungen und Funktionen
DDETerminate-Anweisung

Funktion:	Schließt einen bestimmten DDE-Kanal, der zuvor mit DDEInitiate geöffnet wurde.
Syntax:	DDETerminate channal%
Parameter	Beschreibung
channel%	Beliebiger Integerausdruck, der die Nummer des DDE-Kanals zur entsprechenden Applikation enthält. Die Nummer des Kanals erhalten Sie durch die DDEInitiate-Anweisung.
Beispiel:	Kanal = DDEInitiate("SWRITER3","System") a$ = DDERequest$(Kanal, "Topics") ActiveWindow.Text.Insert a$ DDETerminate Kanal
Siehe auch:	DDE-Anweisungen und Funktionen , DDEExecute-Anweisung , DDEInitiate-Funktion , DDEPoke-Anweisung , DDERequest$-Funktion , DDETerminateAll-Anweisung


DDE-Anweisungen und Funktionen
DDETerminateAll-Anweisung

Funktion:	Schließt alle geöffneten DDE-Kanäle
Syntax:	DDETerminateAll
Siehe auch:	DDE-Anweisungen und Funktionen , DDEExecute-Anweisung , DDEInitiate-Funktion , DDEPoke-Anweisung , DDERequest$-Funktion , DDETerminate-Anweisung


Fehlerbehandlungsfunktionen

StarBasic bietet Ihnen verschiedene Möglichkeiten, auf Fehler zu reagieren, die während der Ausführung Ihres Programmes auftreten können. In Fehlerbehandlungsroutinen werten Sie diese Fehler aus und lassen Ihr Programm entsprechend darauf reagieren. Einem Programmabbruch nach einem Laufzeitfehler wird damit entgegengewirkt.

Folgende Funktionen und Anweisungen zur Fehlerbehandlung werden unterstützt:

•	Erl-Funktion

•	Err-Funktion

•	Error$-Funktion

•	Error-Anweisung

•	On Error GoTo...Resume-Anweisung


Fehlerbehandlungsfunktionen
Erl-Funktion

Funktion:	Gibt Aufschluß über die Zeilennummer, in der während der Programmausführung ein Fehler auftrat.
Syntax:	Erl
Die Erl-Funktion liefert nur Zeilennummern und keine Zeilenmarken zurück.

Beispiel:	siehe On Error GoTo...Resume-Anweisung
Siehe auch:	Fehlerbehandlungsfunktionen , Err-Funktion , Error$-Funktion , Error-Anweisung , On Error GoTo...Resume-Anweisung


Fehlerbehandlungsfunktionen
Err-Funktion

Funktion:	Liefert nach dem Auftreten eines Fehlers während der Programmausführung einen Laufzeitfehlercode zurück, der den Fehler kennzeichnet.
Syntax:	Err
Die Err-Funktion wird in Fehlerbehandlungsroutinen zur Bestimmung des aufgetretenen Fehlers verwendet. In der Fehlerbehandlungsroutine wird dann entsprechend den Anweisungen des Programmierers auf diesen Fehler reagiert und die Programmausführung anschließend fortgesetzt.

Beispiel:	siehe On Error GoTo...Resume-Anweisung
Siehe auch:	Fehlerbehandlungsfunktionen , Erl-Funktion , Error$-Funktion , Error-Anweisung , On Error GoTo...Resume-Anweisung


Fehlerbehandlungsfunktionen
Error$-Funktion

Funktion:	Liefert zu einem Fehlercode die Fehlermeldung.
Syntax:	Error$(ausdruck)
Parameter	Beschreibung
ausdruck	Beliebiger numerischer Ausdruck, der die Fehlernummer der Fehlermeldung enthält, die zurückgegeben werden soll.
Die Error$-Funktion ohne Parameter, liefert die Meldung des Fehlers zurück, der zuletzt während der Programmausführung auftrat.

Siehe auch:	Fehlerbehandlungsfunktionen , Erl-Funktion , Err-Funktion , Error-Anweisung , On Error GoTo...Resume-Anweisung


Fehlerbehandlungsfunktionen
Error-Anweisung

Funktion:	Simuliert das Auftreten eines Fehlers während der Programmausführung.
Syntax:	Error  fehlernummer%
Parameter	Beschreibung
fehlernummer%	Integer-Ausdruck, der die Nummer des Fehlers enthält, dessen Auftreten simuliert werden soll.
Die Error-Anweisung simuliert das Auftreten eines Fehlers während der Programmausführung. Ein Fehler, der von einer Fehlerbehandlungsroutine abgefangen wurde, wird nicht mehr gemeldet, gleichgültig, ob der Programmierer ihn berücksichtigt hat oder nicht. Die Error-Anweisung wird dazu verwendet, diese, vom Programmierer unberücksichtigten Fehler, die häufig zu einer inkorrekten Programmausführung oder zu Programmabstürzen führen, zu melden und die Programmausführung anschließend abzubrechen.

Beispiel:	siehe On Error GoTo...Resume-Anweisung

Siehe auch:	Fehlerbehandlungsfunktionen , Erl-Funktion , Err-Funktion , Error$-Funktion , On Error GoTo...Resume-Anweisung


Fehlerbehandlungsfunktionen
On Error GoTo...Resume-Anweisung

Funktion:	Verzweigt nach dem Auftreten eines Fehlers während der Programmausführung in eine Fehlerbehandlungsroutine oder setzt die Programmausführung fort.
Syntax:	On [Local] Error {GoTo marke | GoTo 0 | Resume Next }
Parameter	Beschreibung
Local	Kennzeichnet eine Fehlerbehandlungsroutine, speziell für eine Prozedur. Wird Local nicht angegeben, bezieht sich die Fehlerbehandlung auf das gesamte Modul.
GoTo marke	Verzweigt bei einem Fehler zu der Fehlerbehandlungsroutine, deren erste Zeile mit der Zeilenmarke marke versehen ist.
Resume Next	Tritt ein Fehler auf, wird die Programmausführung ab der Zeile fortgesetzt, die der fehlerverursachenden folgt.
GoTo 0	Schaltet die Fehlerbehandlung aus.
Die On Error GoTo-Anweisung ermöglicht eine Reaktion des Programmierers auf Fehler, die möglicherweise in seinem Programm auftreten können. Dabei ist zu beachten, daß die Anweisung, handelt es sich um eine lokale Fehlerbehandlung, am Anfang einer Prozedur oder wenn es sich um eine globale Fehlerbehandlung, am Anfang des Moduls stehen muß.

Beispiel:	Das nachfolgende Beispiel verdeutlicht die Fehlerbehandlung anhand eines Programms, das prüft, ob eine Datei mit einem von Ihnen eingegebenen Zugriffsweg und Dateinamen vorhanden ist.
On Error GoTo Fehlerbehandlung

Meldung$ = "Geben Sie bitte einen"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "vollständigen Zugriffsweg"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "mit Dateinamen für eine"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "Datei an. Es wird dann"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "geprüft, ob die Datei"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "vorhanden ist."

Eingabe$ = InputBox$(Meldung$)

ff% = FreeFile

Open Eingabe$ For Input As #ff%

Close #ff%

MsgBox "Programm wird korrekt beendet!"

Exit Sub

Fehlerbehandlung:

Fehler% = Err

If Fehler% = 53 Then

    Beep

    Meldung$ = "Achtung Fehler erkannt!"

    Meldung$ = Meldung$ + Chr$(13)

    Meldung$ = Meldung$ + "Fehlernummer:" + Str$(Fehler%)

    Meldung$ = Meldung$ + Chr$(13)

    Meldung$ = Meldung$ + "Fehlerbezeichnung: "

    Meldung$ = Meldung$ + Error$(Fehler%)

    Meldung$ = Meldung$ + Chr$(13)

    Meldung$ = Meldung$ + "Datei ist nicht vorhanden!"

MsgBox Meldung$

    Resume Next

Else

    Beep

    MsgBox Error$(Fehler%)

    Exit Sub

End If

Geben Sie nach dem Programmstart einen Zugriffsweg mit Dateinamen ein. Die Fehlerbehandlungsroutine des Programms reagiert nur auf den Fehler „Datei nicht vorhanden“. Wenn dieser Fehler auftritt, informiert Sie das Programm darüber, daß die Datei fehlt und setzt die Ausführung fort. Andere Fehler, die beispielsweise darauf beruhen, daß kein Dateiname angegeben wurde, werden lediglich über die Error$-Funktion angezeigt und verursachen anschließend einen Programmabbruch.

Siehe auch:	Fehlerbehandlungsfunktionen , Erl-Funktion , Err-Funktion , Error$-Funktion , Error-Anweisung


Logische Operatoren

Logische Operatoren verknüpfen bitweise den Inhalt zweier Ausdrücke oder Variablen. Sie werden beispielsweise verwendet, um zu prüfen, ob bestimmte Bits gesetzt sind oder nicht.

Diese Logischen Operatoren unterstützt StarBasic:

•	And-Operator

•	Eqv-Operator

•	Imp-Operator

•	Not-Operator

•	Or-Operator

•	Xor-Operator


Logische Operatoren
And-Operator

Funktion:	Führt eine logische UND-Verknüpfung zwischen zwei Ausdrücken durch.
Syntax:	ergebnis = ausdruck1 And ausdruck2
Parameter	Beschreibung
ergebnis	Eine beliebige numerische Variable, die das Ergebnis der Verknüpfung aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander verknüpft werden sollen.
Diese Funktion ermöglicht eine logische UND-Verknüpfung zweier Ausdrücke.

Bei einer UND-Verknüpfung werden nur die Bits gesetzt, die auch in beiden angegebenen Ausdrücken gesetzt worden sind.

Beispiel:		Dezimal	Dual
		254	11111110
	And	111	01101111
		110	01101110
Siehe auch:	Logische Operatoren , Eqv-Operator , Imp-Operator , Not-Operator , Or-Operator , Xor-Operator


Logische Operatoren
Eqv-Operator

Funktion:	Führt eine logische Äquivalenz-Verknüpfung zwischen zwei Ausdrücken durch.
Syntax:	ergebnis = ausdruck1 Eqv ausdruck2
Parameter	Beschreibung
ergebnis	Eine beliebige numerische Variable, die das Ergebnis der Verknüpfung aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander verknüpft werden sollen.
Diese Funktion ermöglicht eine logische Äquivalenz-Verknüpfung zweier Ausdrücke.

Bei einer Äquivalenz-Verknüpfung ist ein Bit im Ergebnis gesetzt, wenn entweder beide Bits in den Ausdrücken gesetzt oder gelöscht sind. Ansonsten ist das Bit im Ergebnis gelöscht.

Beispiel:		Dezimal	Dual
		214	11010110
	Eqv	103	01100111
		78	01001110
Siehe auch:	Logische Operatoren , And-Operator , Imp-Operator , Not-Operator , Or-Operator , Xor-Operator


Logische Operatoren
Imp-Operator

Funktion:	Führt eine logische Implikationsverknüpfung zwischen zwei Ausdrücken durch.
Syntax:	ergebnis = ausdruck1 Imp ausdruck2
Parameter	Beschreibung
ergebnis	Eine beliebige numerische Variable, die das Ergebnis der Verknüpfung aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander verknüpft werden sollen.
Diese Funktion ermöglicht eine logische Implikationsverknüpfung zweier Ausdrücke.

Bei einer Implikationsverknüpfung ist ein Bit im Ergebnis nur dann gelöscht, wenn das entsprechende Bit im ersten Ausdruck gesetzt und das entsprechende Bit im zweiten Ausdruck gelöscht worden ist.

Beispiel:		Dezimal	Dual
		254	11111110
	Imp	103	01100111
		103	01100111
Siehe auch:	Logische Operatoren , And-Operator , Eqv-Operator , Not-Operator , Or-Operator , Xor-Operator


Logische Operatoren
Not-Operator

Funktion:	Negiert einen Ausdruck durch Vertauschen der Bitzustände.
Syntax:	ergebnis = Not ausdruck
Parameter	Beschreibung
ergebnis	Eine beliebige numerische Variable, die das Ergebnis der Negation aufnimmt.
ausdruck	Beliebiger numerischer Ausdruck, der negiert werden soll.
Bei einer Negation werden nicht, wie bei allen anderen logischen Operationsbefehlen, zwei Ausdrücke logisch miteinander verknüpft, sondern ein einzelner verändert. Dieser Ausdruck wird dahingehend geändert, daß er nach der Negation den gegenteiligen Zustand seines ursprünglichen Inhaltes besitzt.

Beispiel:		Dezimal	Dual
		103	01100111
	Not	103	10011000
Siehe auch:	Logische Operatoren , And-Operator , Eqv-Operator , Imp-Operator , Or-Operator , Xor-Operator


Logische Operatoren
Or-Operator

Funktion:	Führt eine logische ODER-Verknüpfung zwischen zwei Ausdrücken durch.
Syntax:	ergebnis = ausdruck1 Or ausdruck2
Parameter	Beschreibung
ergebnis	Eine beliebige numerische Variable, die das Ergebnis der Verknüpfung aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander verknüpft werden sollen.
Diese Funktion ermöglicht eine logische ODER-Verknüpfung zweier Ausdrücke.

Bei einer ODER-Verknüpfung wird schon dann ein Bit gesetzt, wenn ein Bit in einem der Ausdrücke gesetzt worden ist.

Beispiel:		Dezimal	Dual
		211	11010011
	Or	123	01111011
		251	11111011
Siehe auch:	Logische Operatoren , And-Operator , Eqv-Operator , Imp-Operator , Not-Operator , Xor-Operator


Logische Operatoren
Xor-Operator

Funktion:	Führt eine logische Exklusiv-Oder-Verknüpfung zwischen zwei Ausdrücken durch.
Syntax:	ergebnis = ausdruck1 Xor ausdruck2
Parameter	Beschreibung
ergebnis	Eine beliebige numerische Variable, die das Ergebnis der Verknüpfung aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander verknüpft werden sollen.
Diese Funktion ermöglicht eine logische Exklusiv-Oder-Verknüpfung zweier Ausdrücke.

Bei einer Exklusiv-Oder-Verknüpfung ist ein Bit im Ergebnis gesetzt, wenn das entsprechende Bit bei nur einem der beiden Ausdrücke gesetzt ist.

Beispiel:		Dezimal	Dual
		214	11010110
	Xor	103	01100111
		177	10110001
Siehe auch:	Logische Operatoren , And-Operator , Eqv-Operator , Imp-Operator , Not-Operator , Or-Operator


Mathematische Operatoren

Dieses Kapitel zeigt Ihnen in einer kurzen Übersicht alle arithmetischen Operatoren, die Sie für Berechnungen innerhalb Ihrer Programme verwenden können.

Diese Mathematischen Operatoren finden Sie im StarBasic:

•	"-" Operator

•	"*" Operator

•	"+" Operator

•	"/" Operator

•	"^" Operator


Mathematische Operatoren
„–“ Operator

Funktion:	Subtrahiert zwei Werte.
Syntax:	ergebnis = ausdruck1 - ausdruck2
Parameter	Beschreibung
ergebnis	Beliebiger numerischer Ausdruck, der das Ergebnis der Subtraktion aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die voneinander subtrahiert werden sollen.
Siehe auch:	Mathematische Operatoren , "*" Operator , "+" Operator , "/" Operator , "^" Operator


Mathematische Operatoren
„*“ Operator

Funktion:	Multipliziert zwei Werte.
Syntax:	ergebnis = ausdruck1 * ausdruck2
Parameter	Beschreibung
ergebnis	Beliebiger numerischer Ausdruck, der das Ergebnis der Multiplikation aufnimmt.
Ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander multipliziert werden sollen.
Siehe auch:	Mathematische Operatoren , "-" Operator , "+" Operator , "/" Operator , "^" Operator


Mathematische Operatoren
„+“ Operator

Funktion:	Addiert zwei Werte.
Syntax:	ergebnis = ausdruck1 + ausdruck2
Parameter	Beschreibung
ergebnis	Beliebiger numerischer Ausdruck, der das Ergebnis der Addition aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die miteinander addiert werden sollen.
Siehe auch:	Mathematische Operatoren , "-" Operator , "*" Operator , "/" Operator , "^" Operator


Mathematische Operatoren
„/“ Operator

Funktion:	Dividiert zwei Werte.
Syntax:	ergebnis = ausdruck1 / ausdruck2
Parameter	Beschreibung
ergebnis	Beliebiger numerischer Ausdruck, der das Ergebnis der Division aufnimmt.
ausdruck1, ausdruck2	Beliebige numerische Ausdrücke, die dividiert werden sollen.
Siehe auch:	Mathematische Operatoren , "-" Operator , "*" Operator , "+" Operator , "^" Operator


Mathematische Operatoren
„^“ Operator

Funktion:	Potenziert einen Wert
Syntax:	ergebnis = ausdruck ^ exponent
Parameter	Beschreibung
ergebnis	Beliebiger numerischer Ausdruck, der das Ergebnis der Potenzierung aufnimmt.
ausdruck	Wert, der potenziert werden soll.
exponent	Die Hochzahl, mit der ausdruck potenziert werden soll.
Siehe auch:	Mathematische Operatoren , "-" Operator , "*" Operator , "+" Operator , "/" Operator


Numerische Funktionen

In diesem Kapitel finden Sie alle Funktionen, mit deren Hilfe Sie numerische Berechnungen durchführen können. Nicht einzeln aufgeführt sind dabei die sogenannten mathematischen und Booleschen Operatoren, denen ein eigenes Kapitel gewidmet ist. Funktionen unterscheiden sich von Operatoren, insofern, als daß Ihnen ein Funktionsargument übergeben wird, und sie ein Ergebnis zurückliefern. Operatoren hingegen liefern ein Ergebnis zurück, in dem Sie zwei numerische Ausdrücke miteinander verknüpfen. Sie finden in diesem Kapitel folgende mathemtische Funktionen beschrieben:

Trigonometrische Funktionen:

•	Atn-Funktion

•	Cos-Funktion

•	Sin-Funktion

•	Tan-Funktion

Logarithmus-Funktionen

•	Exp-Funktion

•	Log-Funktion

Zufallszahl-Generierung

•	Randomize-Anweisung

•	Rnd-Funktion

Quadratwurzelberechnung

•	Sqr-Funktion

Funktionen zur Ganzzahlermittlung

•	Fix-Funktion

•	Int-Funktion

Funktion zur Absolutwertermittlung

•	Abs-Funktion

Funktion zur Ermittlung des Vorzeichen eines Ausdrucks

•	Sgn-Funktion

Funktionen zur Zahlenumwandlung von einem Zahlensystem in ein anderes

•	Hex$-Funktion

•	Oct$-Funktion


Numerische Funktionen
Abs-Funktion

Funktion:	Ermittelt den Absolutwert eines numerischen Ausdrucks.
Syntax:	Abs(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, dessen Absolutwert (vor-zeichenloser Wert) ermittelt werden soll. Das bedeutet: Jede positive Zahl und 0 werden original zurückgeliefert, jede negative Zahl wird in eine positive Zahl verwandelt.
Beispiel:	Das folgende Beispiel berechnet die Differenz zweier eingegebener Beträge mit Hilfe der Abs-Funktion. Dabei ist es ganz egal, ob Sie zuerst den größeren oder den kleineren Betrag eingeben – die Abs-Funktion korrigiert ein etwaiges negatives Ergebnis.
w1 = Int(InputBox$ ("Bitte geben Sie den ersten Betrag ein","Werteingabe"))

w2 = Int(InputBox$ ("Bitte geben Sie den zweiten Betrag ein","Werteingabe"))

Print "Die Differenz beträgt "; Abs(w1 - w2)

Siehe auch:	Numerische Funktionen , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Atn-Funktion

Funktion:	Trigonometrische Funktion, die den Arkus-Tangens (die Umkehrung des Tangens) eines numerischen Ausdrucks ermittelt.
Syntax:	Atn(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Beliebiger numerischer Ausdruck, dessen Arkus-Tangens ermittelt werden soll. Der Arkus-Tangens wird beispielsweise benötigt, um das Seitenverhältnis zwischen Ankathete und Gegenkathete in einem rechtwinkligen Dreick zu berechnen. Das Ergebnis wird in Radiant (im Bogenmaß) zurückgeliefert.
Mit Hilfe dieser Funktion können Sie den Winkel Alpha in einem rechtwinkligen Dreieck berechnen, wenn Sie die Länge der Gegenkathete und die der Ankathete  kennen.

Die Formel zur Berechnung des Winkels dafür lautet:

Atn(Alpha)=Ankathete/Gegenkathete

Die Angabe des Winkels erfolgt hier, wie auch bei allen Winkelfunktionen, in Radiant (im Bogenmaß). Zur Umrechnung der Werte von Grad in Radiant und umgekehrt können Sie sich folgender Formeln bedienen:

grad=(radiant*180)/pi

radiant=(grad*pi)/180

Pi ist hierbei die feste Kreiskonstante mit dem Wert von 3.141592657... .

Beispiel:	Das folgende Beispielprogramm erlaubt die Eingabe der beiden Katheten und berechnet daraus den entsprechenden Winkel Alpha in einem rechtwinkligem Dreieck:
pi# = 3.141592654

Ank = Int(InputBox$ ("Bitte geben Sie die Länge der Ankathete ein: ","Ankathete"))

Gek = Int(InputBox$ ("Bitte geben Sie die Länge der Gegenkathete ein: ","Gegenkathete"))

Print "Der Winkel Alpha beträgt"; Atn(ANK / GEK); " im Bogenmaß"

Print "Der Winkel Alpha beträgt"; (180 * Atn(ANK / GEK)) / pi; " in Grad"

Siehe auch:	Numerische Funktionen , Abs-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Cos-Funktion

Funktion:	Trigonometrische Funktion, die den Cosinus eines numerischen Ausdrucks ermittelt.
Syntax:	Cos(NumAusdruck)
Parameter	Beschreibung
NumAusdruck	Beliebige numerischer Ausdruck, dessen Cosinus ermittelt werden soll. Der Cosinus wird z.B. dazu verwendet, um das Seitenverhältnis zwischen Ankathete und Hypotenuse in einem rechtwinkligen Dreick zu berechnen. Das Ergebnis wird in Radiant (im Bogenmaß) zurückgeliefert.
Mit Hilfe dieser Funktion können Sie den Winkel Alpha in einem rechtwinkligen Dreieck berechnen, wenn Sie die Länge der Ankathete und die der Hypotenuse kennen.

Die Formel zu Berechnung des Winkels dafür lautet:

Cos(Alpha)=Ankathete/Hypotenuse

Die Angabe des Winkels erfolgt hier, wie auch bei allen Winkelfunktionen, im Radiant (im Bogenmaß). Zur Umrechnung der Werte von Grad in Radiant und umgekehrt können Sie sich folgender Formeln bedienen:

grad=(radiant*180)/pi

radiant=(grad*pi)/180

Pi ist hierbei die feste Kreiskonstante mit dem Wert von 3.141592657... .

Beispiel:	Das folgende Beispielprogramm erlaubt die Eingabe von Ankethete und Hypotenuse und berechnet daraus den entsprechenden Winkel Alpha in einem rechtwinkligen Dreieck:
pi# = 3.141592654

Ank = Int(InputBox$ ("Bitte geben Sie die Länge der Ankathete ein: ","Ankathete"))

Hyp = Int(InputBox$ ("Bitte geben Sie die Länge der Hypothenuse ein: ","Hypothenuse"))

Print "Der Winkel Alpha beträgt"; Cos(Ank / Hyp); " im Bogenmaß"

Print "Der Winkel Alpha beträgt"; (180 * Cos(Ank / Hyp)) / pi; " in Grad"

Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Exp-Funktion

Funktion:	Potenziert die Basis des natürlichen Logarithmus (die sogenannte Eulersche Zahl, e=2,718282) um die angegebene Potenz.
Syntax:	Exp(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, der die Potenz angibt, mit der die Eulersche Zahl e (die Basis des natürlichen Logarithmus) berechnet werden soll. Die Potenz muß für: Zahlen einfacher Genauigkeit <=88,02969 und für Zahlen doppelter Genauigkeit <=709,782712893 sein, da StarBasic sonst einen Überlauffehler meldet (der maximal darstellbare Zahlenbereich wurde dabei überschritten).
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Fix-Funktion

Funktion:	Liefert die Vorkommazahl eines numerischen Ausdrucks durch Abschneiden des Nachkommateils zurück.
Syntax:	Fix (IntAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Integer-Ausdruck, dessen Vorkommateil zurückgeliefert wer-den soll. Fix(3.14159) ergibt den Wert 3. Int(0) ergibt den Wert 0. Fix(-3.14159) ergibt den Wert -3. Fix kann nur Integer-Zahlen, d.h. im Bereich von -32.768 bis 32.767 (inclusive) verarbeiten.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Hex$-Funktion

Funktion:	Liefert das Ergebnis der Umrechnung einer Zahl in das Hexadezimalformat.
Syntax:	Hex$(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, der in eine Hexadezimalzahl umgewandelt werden soll.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Int-Funktion

Funktion:	Liefert die Vorkommazahl eines numerischen Ausdrucks durch Abrunden zurück.
Syntax:	Int(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Integer-Ausdruck, dessen Vorkommateil durch Abrunden ermittelt werden soll. Int(3.14159) ergibt den Wert 3. Int(0) ergibt den Wert 0. Int(-3.14159) ergibt den Wert -4. Int kann nur Integer-Zahlen, daß heißt im Bereich von -32.768 bis 32.767 (inclusive) verarbeiten.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Log-Funktion

Funktion:	Liefert den natürlichen Logarithmus eines numerischen Ausdrucks.
Syntax:	Log(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, dessen natürlicher Logarithmus berechnet werden soll. Der Logarithmus ist die Zahl mit der man in der Gleichung a^b=c die Basis (also die Zahl a) potenzieren muß, um die Zahl c zu erhalten. In der höheren Mathematik werden durchweg die natürlichen Logarithmen mit der Basis e=2,718282... benutzt.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Oct$-Funktion

Funktion:	Liefert das Ergebnis der Umrechnung einer Zahl in das Oktalformat.
Syntax:	Oct$(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, der in eine Oktalzahl umgewandelt werden soll.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Randomize-Anweisung

Funktion:	Initialisiert den Zufallsgenerator.
Syntax:	Randomize [NumAusdruck]
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, der den Zufallesgenerator initialisiert. Wird NumAusdruck nicht mit angegeben, wird der Zufallsgenerator mit dem Wert des System-Timers initialisiert.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Rnd-Funktion

Funktion:	Ermittelt einen Zufallswert zwischen 0 und 1.
Syntax:	Rnd[(IntAusdruck)]
	Parameter	Beschreibung
	IntAusdruck	Integer-Ausdruck, der bestimmt, auf welche Art und Weise Zufallszahlen generiert werden sollen.
Die Rnd-Funktion liefert grundsätzlich nur Funktionen zwischen 0 und 1. Um Zufallszahlen ohne Nachkommastellen in bestimmten Zahlenbereichen zu generieren, können Sie sich folgender Formel bedienen:

Zufallszahl=Int((OberBereich-UnterBereich+1)*Rnd(Argument)+UnterBereich

Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Sgn-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Sgn-Funktion

Funktion:	Liefert einen ganzzahligen Wert zwischen -1 und 1, der anzeigt, ob der der Funktion übergebende Ausdruck positiv oder negativ ist.
Syntax:	Sgn(NumAusdruck)
	Parameter	Beschreibung
	IntAusdruck negativ 0 positiv	Integer-Ausdruck, der bestimmt, auf welche Art und Weise Zufallszahlen generiert werden sollen. Folgende Regeln gelten dabei für NumAusdruck: Sgn liefert -1 zurück. Sgn liefert 0 zurück. Sgn liefert 1 zurück.
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sin-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Sin-Funktion

Funktion:	Trigonometrische Funktion, die den Sinus eines numerischen Ausdrucks ermittelt.
Syntax:	Cos(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, dessen Sinus ermittelt werden soll. Der Sinus wird beispielsweise dann verwendet, um das Seitenverhältnis zwischen Gegenkathete und Hypotenuse in einem rechtwinkligen Dreieck zu berechnen. Das Ergebnis wird in Radiant (im Bogenmaß) zurückgeliefert.
Mit Hilfe dieser Funktion können Sie den Winkel Alpha in einem rechtwinkligen Dreieck berechnen, wenn Sie die Länge der Gegenkathete und die der Hypotenuse kennen.

Die Formel zur Berechnung des Winkels dafür lautet:

Sin(Alpha)=Ankathete/Hypotenuse

Die Angabe des Winkels erfolgt hier, wie auch bei allen Winkelfunktionen, in Radiant (im Bogenmaß). Zur Umrechnung der Werte von Grad in Radiant und umgekehrt können Sie sich folgender Formeln bedienen:

grad=(radiant*180)/pi

radiant=(grad*pi)/180

Pi ist hierbei die feste Kreiskonstante mit dem Wert von 3.141592657... .

Beispiel:	Das folgende Beispielprogramm erlaubt die Eingabe von Gegenkathete und Hypotenuse und berechnet daraus den entsprechenden Winkel Alpha in einem rechtwinkligen Dreieck:
pi# = 3.141592654

Gek = Int(InputBox$ ("Bitte geben Sie die Länge der Gegenkathete ein: ","Gegenkathete"))

Hyp = Int(InputBox$ ("Bitte geben Sie die Länge der Hypothenuse ein: ","Hypothenuse"))

Print "Der Winkel Alpha beträgt"; Sin(Gek / Hyp); " im Bogenmaß"

Print "Der Winkel Alpha beträgt"; (180 * Sin(Gek / Hyp)) / pi; " in Grad"

Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sqr-Funktion , Tan-Funktion


Numerische Funktionen
Sqr-Funktion

Funktion:	Ermittelt die Quadratwurzel des angegebenen numerischen Ausdrucks

Syntax:	Sqr(NumAusdruck)

	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, dessen Quadratwurzel berechnet werden soll. Die Quadratwurzel ist die Zahl, die man in der Gleichung a^2=c mit 2 potenzieren muß, um die Zahl c zu erhalten (6^2 ist beispielsweise 36; die Quadratwurzel aus 36 ist folglich 6).
Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Tan-Funktion


Numerische Funktionen
Tan-Funktion

Funktion:	Trigonometrische Funktion, die den Tangens eines numerischen Ausdrucks ermittelt.
Syntax:	Tan(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, dessen Tangens ermittelt werden soll. Der Tangens wird beispielsweise benötigt, um das Seitenverhältnis zwischen Gegenkathete und Ankathete in einem rechtwinkligen Dreieck zu berechnen. Das Ergebnis wird in Radiant (im Bogenmaß) zurückgeliefert.
Mit Hilfe dieser Funktion können Sie den Winkel Alpha in einem rechtwinkligen Dreieck berechnen, wenn Sie die Länge der Gegenkathete und die der Ankathete kennen.

Die Formel zur Berechnung des Winkels dafür lautet:

Tan(Alpha)=Gegenkathete/Ankathete

Die Angabe des Winkels erfolgt hier, wie auch bei allen Winkelfunktionen, in Radiant (im Bogenmaß). Zur Umrechnung der Werte von Grad in Radiant und umgekehrt können Sie sich folgender Formeln bedienen:

grad=(radiant*180)/pi

radiant=(grad*pi)/180

Pi ist hierbei die feste Kreiskonstante mit dem Wert von 3.141592657... .

Beispiel:	Das folgende Beispielprogramm erlaubt die Eingabe der beiden Katheten und berechnet daraus den entsprechenden Winkel Alpha in einem rechtwinkligen Dreieck:
pi# = 3.141592654

Gek = Int(InputBox$ ("Bitte geben Sie die Länge der Gegenkathete ein: ","Gegenkathete"))

Ank = Int(InputBox$ ("Bitte geben Sie die Länge der Ankathete ein: ","Ankathete"))

Print "Der Winkel Alpha beträgt"; Tan(GEK/ANK); " im Bogenmaß"

Print "Der Winkel Alpha beträgt"; (180 * Tan(GEK/ANK)) / pi; " in Grad"

Siehe auch:	Numerische Funktionen , Abs-Funktion , Atn-Funktion , Cos-Funktion , Exp-Funktion , Fix-Funktion , Hex$-Funktion , Int-Funktion , Log-Funktion , Oct$-Funktion , Randomize-Anweisung , Rnd-Funktion , Sgn-Funktion , Sin-Funktion , Sqr-Funktion


Programmablaufsteuerungsfunktionen

StarBasic kennt Anweisungen, die den Programmablauf steuern. Normalerweise wird ein Programm von oben nach unten, Befehl für Befehl nacheinander abgearbeitet. In vielen Fällen ist es jedoch notwendig, bestimmte Programmteile nur dann auszuführen, wenn bestimmte Bedingungen erfüllt sind. Oder aber Sie müssen innerhalb einer Funktion (Function) oder Unterroutine (Sub) einen bestimmten Programmteil  mehrfach ausführen. Eine weitere Möglichkeit ist, daß Sie Teile des Programms in sogenannten Schleifen sooft wiederholen lassen, bis oder solange wie bestimmte Bedingungen erfüllt sind. Diese Anweisungen zur Programmsteuerung gliedern sich in die Unterkategorien Entscheidungsanweisungen, Schleifen und Sprunganweisungen.

Sie finden in diesem Kapitel die folgende Anweisungen beschrieben:

Entscheidungsanweisungen

•	If...Then... ElseIf...Else...EndIf -Anweisung

•	Select...Case...End Select-Anweisung

•	IIf-Anweisung

Schleifen

•	Do...Loop-Anweisung

•	For...Next-Anweisung

•	While...Wend -Anweisung

Sprunganweisungen

•	GoSub...Return-Anweisung

•	GoTo-Anweisung

•	On...GoSub-Anweisung; On...GoTo-Anweisung


Programmablaufsteuerungsfunktionen
Call-Anweisung

Funktion:	Übergibt die Programmsteuerung einer Sub, einer Function oder einer DLL.
Syntax:	[Call] Name [argumentliste]
Parameter	Beschreibung
Name	Name der Sub, der Function oder der DLL
argumentliste	Parameter, die die aufgerufene Routine erwartet. Die Typen der Parameter sowie deren Anzahl sind dabei von der aufgerufenen Routine abhängig.
Hinweis: Das Schlüsselwort kann beim Aufruf einer Routine weggelassen werden. Wird eine Function als Ausdruck gerufen, so müssen die Parameter an der Function eingeklammert sein. Wird eine DLL gerufen, so muß diese zuvor durch die Declare-Anweisung deklariert worden sein.

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Choose-Funktion

Funktion:	Gibt aus einer Argumentliste den gewählten Wert zurück.
Syntax:	Choose(Index, Auswahl1[, Auswahl2, ... [,Auswahl_n]])
Die Choose-Funktion gibt den Wert aus der Ausdruckliste zurück, auf den der übergebene Index verweist. Ist Index der Wert 1 zugewiesen, gibt die Funktion den ersten Auswahlwert der Liste zurück. Ist Index der Wert 2 zugewiesen, wird der zweite Auswahlwert zurückgegeben usw.

Die Choose-Funktion gibt Null zurück, wenn Index kleiner als 1 oder größer als die Anzahl der aufgeführten Auswahlmöglichkeiten ist.

Parameter	Beschreibung
Index	Ein numerischer Ausdruck, der auf den Wert verweist, der zurückgegeben werden soll.
Auswahlt	Ein beliebiger Ausdruck, der einen der möglichen Auswahlwerte enthält.
Beispiel:	Das nachstehende Beispiel verwendet die Choose-Funktion, um eine Zeichenfolge aus mehreren zu wählen, die zusammen ein Menü ergeben:
Function AuswahlMenü(Index As Integer)

AuswahlMenü =  Choose(Index, "Quick-Format", "Save-Format", "System-Format")

End Function

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Declare-Anweisung

Funktion:	Deklariert und definiert eine Unterroutine aus einer DLL (Dynamic Link Library) für den Aufruf aus StarBasic heraus.
Syntax:	Declare {Sub|Function} Name Lib „Libname“ [Alias „Ersatzname“] [argumentliste] [As Type]
Parameter/ Element	Beschreibung
Name	Name der Unterroutine, so wie sie in der DLL mit Namen definiert ist.
Libname	Datei- oder Systemname der Dynamic Link Library. Diese Library wird automatisch geladen, sobald die Funktion das erste Mal benötigt wird.
Ersatzname	Name, der zwar nicht dem Namen der Unterroutine in der DLL entspricht, unter dem sie aber von Basic aus aufgerufen werden soll.
Argumentliste	Parameter, die die aufgerufene Routine erwartet. Die Typen der Parameter sowie deren Anzahl sind dabei von der aufgerufenden Routine abhängig.
Typ	Bestimmt bei Funktionsdeklarationen, welchen Rückgabetyp die Funktion liefert. Kann ausgelassen werden, wenn hinter Name – wie bei Variablen – ein Typendeklarationszeichen angegeben wird.
Achtung: Parameter müssen durch das Schlüsselwort ByVal gekennzeichnet werden, damit sie nicht als Referenz sondern als Wert an die Unterroutine übergeben werden.

Beispiel:	Declare Function Testaufruf Lib „test.dll“ Alias NeuerName%(ByVal Param1%, ByVal Param2%)
Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Do...Loop-Anweisung

Funktion:	Schleifenstruktur, die dafür sorgt, daß die zwischen beiden Anweisungen stehenden Befehle solange wie oder solange bis eine bestimmte Bedingung erfüllt ist, ausgeführt werden.
Syntax:	Do [While|UNTIL bedingung=TRUE] Befehlsblock [Exit Do] Befehlsblock Loop [While|UNTIL bedingung=TRUE]
Mit der Do...Loop Schleifenstruktur können Sie die innerhalb der beiden Schlüsselwörter stehenden Befehle solange ausführen, wie oder bis eine bestimmte Bedingung erfüllt ist. Um eine Schleife zu konstruieren, die solange durchlaufen wird, bis eine bestimmte Bedingung erfüllt ist, oder solange wie eine bestimmte Bedingung erfüllt ist. Die Abbruchkriterien müssen entweder hinter der Do-Anweisung oder hinter der Loop-Anweisung angegeben werden; beides kombiniert ist nicht statthaft. Folgende vier Kombinationen sind also möglich.

Syntax	Ergebnis
Do While bedingung=TRUE Befehlsblock Loop	Das Programm überprüft, ob die Bedingung wahr ist. Ist sie falsch, geht es mit der Programmausführung direkt hinter Loop weiter. Ist die Bedingung wahr, wird die Schleife durchlaufen, das Programm trifft auf Loop und springt zurück zur Do-Anweisung. Ist die Bedingung jetzt immer noch wahr, wird die Schleife abermals durchlaufen, ansonsten fährt das Programm mit der Ausführung des hinter der Loop-Anweisung stehenden Befehls fort. Kurz zusammengefaßt: Die Schleife wird nur dann und nur solange, wie die Bedingung wahr ist, ausgeführt.
Do UNTIL bedingung=TRUE Befehlsblock Loop	Das Programm überprüft, ob die Bedingung wahr ist. Ist sie es, geht es mit der Programmausführung direkt hinter Loop weiter. Ist die Bedingung nicht wahr, wird die Schleife durchlaufen, das Programm trifft auf Loop, springt zurück zur Do-Anweisung. Ist die Bedingung jetzt immer noch nicht wahr, wird die Schleife abermals durchlaufen, ansonsten fährt das Programm mit der Ausführung der hinter der Loop-Anweisung stehenden Anweisung fort. Kurz zusammengefaßt: Die Schleife wird nur dann, wenn die Bedingung zunächst falsch und dann solange bis die Bedingung wahr ist ausgeführt.
Do Befehlsblock Loop While bedingung=TRUE	Das Programm tritt sofort in die Schleife ein. Trifft es auf Loop, überprüft es, ob die Bedingung wahr ist. Ist sie es, geht es mit der Programmausführung bei Do weiter – die Schleife wird wiederholt. Erst, wenn die Bedingung hinter Loop falsch wird, tritt das Programm aus der Schleife aus. Kurz zusammengefaßt: Die Befehle innerhalb der Schleife werden in jedem Fall einmal und solange wie die Bedingung wahr ist, ausgeführt.
Do Befehlsblock Loop UNTIL bedingung=TRUE	Das Programm tritt sofort in die Schleife ein. Trifft es auf Loop, überprüft es, ob die Bedingung wahr ist. Ist sie es nicht, geht es mit der Programmausführung bei Do weiter – die Schleife wird wiederholt. Erst, wenn die Bedingung hinter Loop wahr wird, tritt das Programm aus der Schleife aus. Kurz zusammengefaßt: Die Befehle innerhalb der Schleife werden in jedem Fall einmal und solange bis die Bedingung wahr wird, ausgeführt.
Wichtigster Unterschied zwischen den ersten beiden und den letzten beiden Konstruktionen: Bei den ersten beiden Konstruktionen wird die Schleife nicht unbedingt, also nur in Abhängigkeit von der Bedingung ausgeführt. Bei den letzten beiden Konstruktionen werden die zwischen Do und Loop stehenden Befehle wenigstens ein einziges Mal ausgeführt.

Mit Hilfe der Anweisung Exit Do kann die Schleife unbedingt verlassen werden. Dieser Befehl befindet sich innerhalb eines Befehlsblocks, der durch Do und Loop umschlossen ist. In der Regel konstruieren Sie hier mit Hilfe der If...Then-Struktur eine Abbruchbedingung im Sinne von:

Do...

    Befehle

    If bedingung=TRUE Then Exit Do

    Befehle

Loop...

Beispiel:	Das folgende Beispiel nutzt zwei ineinander geschachtelte Do...Loop-Schleifen, um ein Zeichenfolgefeld mit 10 Elementen ( a$() ) zu sortieren:
a$(1) = "Klaus"

a$(2) = "Uwe"

a$(3) = "Thorsten"

a$(4) = "Manfred"

a$(5) = "Erwin"

a$(6) = "Timo"

a$(7) = "Karsten"

a$(8) = "Regina"

a$(9) = "Christiane"

a$(10) = "Uta"

z% = 1

Do

    z2% = z% + 1

    Do

        If a$(z%) > a$(z2%) Then

            temp$ = a$(z%)

            a$(z%) = a$(z2%)

            a$(z2%) = temp$

        End If

        z2% = z2% + 1

    Loop Until z2% = 11

    z% = z% + 1

Loop Until z% = 10

For z% = 1 To 10

    Print a$(z%)

Next z%

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
End-Anweisung

Funktion:	Beendet das Programm.
Syntax:	End
Siehe auch:	Programmablaufsteuerungsfunktionen , Stop-Anweisung


Programmablaufsteuerungsfunktionen
For...Next-Anweisung

Funktion:	Schleifenstruktur, die dafür sorgt, daß die zwischen beiden Anweisungen stehenden Befehle und Funktionen so oft wiederholt werden, wie durch die For...Next-Parameter festgelegt.
Syntax:	For counter=start TO end [STEP step] Befehlsblock [Exit For] Befehlsblock Next [counter [counter2,[...]]]
	Variablen	Aufgabe
	counter	Zählvariable, der zunächst der Wert rechts des Gleichheitszeichens (start) zugewiesen wird. Erlaubt sind nur numerische Variablen. Diese Variable dient als Zähler und wird solange hochgezählt bis sie end über- (bei Hochzählungen) bzw. unterschritten (bei Herunterzählungen) hat.
	Start	Numerische Variable, die bestimmt, mit welchem Startwert die Schleife beginnen soll.
	End	Numerische Variable, die angibt, bis zu welchem Grenzwert counter hoch- bzw. runtergezählt wird, bevor die Schleife beendet ist.
	Step	Bestimmt, in welchen Schritten die Zählvariable counter hoch bzw. heruntergezählt wird. Wird step nicht mitangegeben, erhöht sich counter jeweils um den Wert 1. end muß in diesem Fall natürlich größer als start sein. Möchten Sie counter herunterzählen, muß end größer als start angegeben werden. In diesem Fall muß step ein negativer Wert zugewiesen und die Step-Anweisung kann dann auch nicht weggelassen werden.
Mit Hilfe der For...Next-Schleife lassen sich alle Anweisungen, die innerhalb eines Programmabschnittes durch diese beiden Schlüsselwörter eingekesselt sind, sooft wiederholen, wie es aus den Übergabeparametern hervorgeht.

Beim Herunterzählen der Zählervariable überprüft StarBasic zur Laufzeit eine Bereichsunter- bzw. Überschreitung. Sie brauchen selber nicht dafür Sorge zu tragen, daß counter genau den Wert erreicht, der durch end bestimmt wurde. Die Abbruchbedingung ist in dem Moment gegeben, in dem end durch counter über- (beim Heraufzählen durch positives step) oder unterschritten (beim Herunterzählen durch negatives step) wird.

For...Next-Schleifen lassen sich ineinander verschachteln. Geben Sie keine Variable hinter einer Next-Anweisung an, bezieht sich das Next immer automatisch auf das zuletzt aufgetretene For.

Bestimmen Sie eine Schrittweite von 0, dann werden die Anweisungen zwischen For und Next endlos ausgeführt.

Nachdem die Schleife das letzte Mal durchlaufen wurde, erhöht bzw. erniedrigt die Next-Anweisung die Variable count ein letztes Mal. Bei einem Schleifendurchlauf von 1 bis 10 (For counter=1 TO 10 [STEP 1]) mit einer Schrittweite von 1 geht counter mit dem Wert 11 aus der Schleife heraus.

Mit Hilfe der Exit For-Anweisung kann die Schleife unbedingt verlassen werden. Dieser Befehl befindet sich innerhalb eines Befehlsblocks, der durch For und Next umschlossen wird. In der Regel konstruieren Sie hier mit Hilfe der If...Then-Struktur eine Abbruchbedingung im Sinne von:

For...

   Befehle

   If bedingung=TRUE Then Exit For

   Befehle

Next

Hinweis für die Verschachtelung von For...Next-Schleifen: Beim unbedingten Verlassen einer Schleife durch Exit For wird grundsätzlich nur eine Schleife beendet.

Beispiel:	Das folgende Beispiel nutzt zwei ineinander verschachtelte Schleifen, um ein Zeichenfolgefeld mit 10 Elementen ( a$() ), die zunächst mit verschiedenen Namen vorbelegt werden, zu sortieren:
a$(1) = "Klaus"

a$(2) = "Uwe"

a$(3) = "Thorsten"

a$(4) = "Manfred"

a$(5) = "Erwin"

a$(6) = "Timo"

a$(7) = "Karsten"

a$(8) = "Regina"

a$(9) = "Christiane"

a$(10) = "Uta"

For z% = 1 To 9

    For z2% = z% + 1 To 10

        If a$(z%) > a$(z2%) Then

            temp$ = a$(z%)

            a$(z%) = a$(z2%)

            a$(z2%) = temp$

        End If

    Next z2%

Next z%

For z% = 1 To 10

    Print a$(z%)

Next z%

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Function...Exit Function...End Function-Anweisung

Funktion:	Definiert eine Unterroutine, die als Ausdruck verwendet werden kann, also einen Rückgabetypen liefert.
Syntax:	Function Name[(VarName1 [As Typ] [,VarName2 [as Typ][,...]) [As Typ] . [Exit Sub] . End Sub
Parameter	Beschreibung
Name	Name der Unterroutine.
VarName	Parameter, den die Unterroutine erwartet.
Typ	Typendeklarationsschlüsselwort.
Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
GoSub...Return-Anweisung

Funktion:	Ruft innerhalb einer Unterroutine (Sub) oder einer Funktion (Function) einen Programmteil auf, der durch eine Marke gekennzeichnet ist. Die dort nachfolgenden Befehle werden bis zur Return-Anweisung abgearbeitet; die Programmausführung wird danach hinter der GoSub-Anweisung fortgesetzt.
Syntax:	Sub/Function befehle GoSub marke befehle GoSub marke Exit Sub/Function marke: befehle Return End Sub/Function
Mit Hilfe der GoSub-Anweisung rufen Sie innerhalb einer Unterroutine (Sub) oder einer Funktion (Function) eine sogenannte „lokale Unterroutine“ auf. Der Beginn einer derartigen Unterroutine wird mit einer Marke markiert. Um eine Marke zu setzen, benennen Sie sie beliebig und schließen Sie mit einem Doppelpunkt („:“) ab. Das Programm fährt mit der Programmausführung , nachdem es auf eine GoSub-Anweisung gestoßen ist, direkt mit dem Programmtext fort, der nach der Marke folgt. Die dort folgenden Anweisungen und Funktionen werden solange abgearbeitet, bis das Programm auf die Return-Anweisung trifft. In diesem Moment kehrt das Programm zur GoSub-Anweisung zurück, und fährt mit der Abarbeitung der Befehle hinter der GoSub-Anweisung fort.

Achtung: Trifft das Programm auf eine Return-Anweisung, ohne daß zuvor ein GoSub erfolgte, meldet StarBasic eine Fehlermeldung. Sie müssen selber dafür Sorge tragen, daß Ihr Programm ein Unterprogramm oder eine Funktion mit der Exit Sub- bzw. Exit Function-Anweisung (siehe dort) verläßt, bevor es auf einen Programmteil stößt, der mit Return abgeschlossen ist.

Tip: Eigentlich sind GoSub und Return Relikte älterer Basicdialekte, die nur aus Kompatiblitätsgründen erhalten geblieben sind. Verwenden Sie GoSub und Return sehr häufig, wird Ihr Programm für Sie, aber auch für andere Programmierer schwer lesbar. Sie erreichen eine viel größere Ordnung und auch einen sehr viel saubereren Programmierstil, wenn Sie Unterroutinen in Subs oder Functions (siehe dort) anordnen.

Beispiel:	Das folgende Beispielprogramm demonstriert die Anwendung von GoSub und Return. Es fordert den Benutzer auf, zweimal hintereinander eine Zahl einzugeben und berechnet mit Hilfe eines Programmteils, der zweimal verwendet wird,  jeweils die Quadratwurzel aus der angegebenen numerischen Zahl.
Sub Main()

   a = Int(InputBox$ ("Bitte geben Sie Zahl ein: ","Zahleneingabe"))

   b = Int(InputBox$ ("Bitte geben Sie eine weitere Zahl ein: ","Zahleneingabe"))

   c=a

   GoSub Quadratwurzel

   Print "Die Quadratwurzel aus";a;" ist";c

   c=b

   GoSub Quadratwurzel

   Print "Die Quadratwurzel aus";b;" ist";c

   Exit Sub

   Quadratwurzel:

   c=sqr(c)

   Return

End Sub

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
GoTo-Anweisung

Funktion:	Sorgt dafür, daß das Programm innerhalb einer Unterroutine (Sub) oder einer Funktion (Function) mit der Abarbeitung des Programmteils fortfährt, der durch eine Marke gekennzeichnet ist.
Syntax:	Sub/Function befehle GoTo marke marke2: befehle Exit Sub marke: befehle GoTo marke2 End Sub/Function
Mit Hilfe der GoTo-Anweisung weisen Sie StarBasic an, mit der Programmausführung an einem ganz anderen Teil des StarBasic-Programms innerhalb einer Unterroutine (Sub) oder Funktion (Function) fortzufahren. Die Stelle, an der das Programm mit der Ausführung fortfahren soll, ist mit einer Marke gekennzeichnet. Um eine Marke zu setzen, benennen Sie sie beliebig und schließen Sie mit einem Doppelpunkt („:“) ab.

Achtung: Bitte beachten Sie, daß Sie mit der GoTo-Anweisung niemals aus einem Unterprogramm oder einer Funktion hinausspringen dürfen.

Tip: Die GoTo-Anweisung ist ein Relikt älterer Basicdialekte, die nur aus Kompatibilitätsgründen erhalten geblieben sind. Verwenden Sie GoTo sehr häufig, wird Ihr Programm für Sie, aber auch für andere Programmierer schwer lesbar. Versuchen Sie sich daher einen Programmstil anzueignen, der möglichst wenig, am besten gar keinen Gebrauch der GoTo-Anweisung macht. Einzige Ausnahmen sind On...GoTo und On Error GoTo (siehe dort).

Beispiel:	Das folgende Beispielprogramm demonstriert die Anwendung von GoSub und Return. Es fordert den Benutzer auf, zweimal hintereinander eine Zahl einzugeben und berechnet mit Hilfe eines Programmteils, der zweimal verwendet wird,  jeweils die Quadratwurzel aus der angegebenen numerischen Zahl.
Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
If...Then... ElseIf...Else...EndIf -Anweisung

Funktion:	Definiert einen oder mehrere Befehlsblöcke, die jeweils nur dann ausgeführt werden, wenn eine bestimmte Bedingung wahr ist.
Syntax:	If bedingung=wahr Then befehle [ElseIf bedingung=wahr Then] befehle [Else] befehle EndIf
Mit Hilfe dieser Struktur-Befehle, können Sie die Ausführung von Teilen Ihres Programms abhängig von bestimmten Bedingungen machen. Trifft StarBasic auf eine If-Anweisung, prüft es zunächst, ob die nachstehende Bedingung wahr ist. Ist sie es, werden alle direkt nachstehenden Befehle bis zur nächsten Else- oder ElseIf-Anweisung ausgeführt. Ist die Bedingung nicht wahr, und es folgt im Programm eine ElseIf-Anweisung, prüft StarBasic wiederum die Bedienung, die dahinter steht und führt die nachstehenden Befehle aus, falls die Bedingung wahr gewesen ist. Falls nicht, geht die Programmausführung entweder beim nächsten ElseIf oder – falls vorhanden – beim nächsten Else weiter. Die unter Else stehenden Befehle werden nur in dem Fall ausgeführt, wenn keine der vorher abgefragten Bedingungen (also hinter If, oder hinter allen vorhandenen ElseIf-Anweisungen stehenden) zutraf. Sind alle Bedingungen entsprechend ihres Wahrheitsgehaltes ausgewertet und ist der entsprechende Programmteil abgearbeitet worden, fährt StarBasic mit dem Programm hinter der EndIf-Anweisung fort.

If...Then-Abfragen können verschachtelt werden. D.h. innerhalb eines If...Then-Blocks dürfen weitere If...Then-Blöcke eingeschachtelt werden.

Else und ElseIf-Statements brauchen nicht mit angegeben zu werden, sind also optional.

Achtung: Ihr Programm darf zwar mit Hilfe von GoTo und GoSub aus einer If...Then-Konstruktion herausspringen, jedoch nicht in eine If...Then-Struktur hineinspringen.

Beispiel:	Das folgende Beispielprogramm läßt Sie das Verfalldatum eines Produktes eingeben und gibt aus, ob das Verfalldatum abgelaufen oder noch nicht abgelaufen ist oder am heutigen Tage abläuft.
Input "Bitte geben Sie das Verfalldatum ein (TT.MM.JJJJ)";datum$

datum$ = Right$(datum$, 4) + Mid$(datum$, 4, 2) + Left$(datum$, 2)

heutedatum$ = Date$

heutedatum$ = Right$(heutedatum$, 4) + Mid$(heutedatum$, 4, 2) + Left$(heutedatum$, 2)

If datum$ > heutedatum$ Then

   MsgBox "Das Verfalldatum ist abgelaufen"

ElseIf datum$ < heutedatum$ Then

   MsgBox "Das Verfalldatum ist noch nicht abgelaufen"

Else

   MsgBox "Das Verfalldatum läuft heute ab"

End If

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
IIf-Anweisung

Funktion:	Liefert eines zweier möglicher Funktionsergebnisse zurück, abhängig vom Wahrheitsgehalt eines zu überprüfenden Ausdrucks.
Syntax:	IIf(Ausdruck, WahrZurueck, FalschZurueck)
Parameter	Beschreibung
Ausdruck	Beliebiger Ausdruck, der überprüft werden soll. Ist dieser TRUE, liefert die Funktion das Ergebnis des Ausdrucks WahrZurueck, ansonsten das Ergebnis des Ausdrucks FalschZurueck.
WahrZurueck, FalschZurueck	Beliebige Ausdrücke, von denen einer in Abhängigkeit der Wahrheitsprüfung als Funktionsergebnis zurückgeliefert wird.
Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
On...GoSub-Anweisung; On...GoTo-Anweisung

Funktion:	Verzweigt an eine von mehreren angegebenen anderen Stellen des Programms in Abhängigkeit eines numerischen Ausdrucks.
Syntax:	On NumAusdruck GoSub Label1[, Label2[, Label3[,...]]] On NumAusdruck GoTo Label1[, Label2[, Label3[,...]]]
Parameter	Beschreibung
NumAusdruck	Beliebiger numerischer Ausdruck zwischen 0 und 255, der bestimmt, zu welcher der angegebenen Sprungmarken gesprungen werden soll. Ist NumAusdruck 0, wird der Befehl ausgelassen. Ist er größer 0, wird zum entsprechenden Label gesprungen dessen, Positionsnummer in der Liste dem Ausdruck entspricht (1=1. Label wird verwendet; 2=2. Label wird verwendet, etc.)
Label	Sprung-Label gemäß GoTo- bzw. GoSub-Konvention.
Hinweis: Es gelten die Konventionen für GoTo- bzw. GoSub.

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Rem-Anweisung

Funktion:	Erlaubt die Definition einer Programmzeile als Kommentar. Die Programmzeile wird ignoriert.
Syntax:.	Rem Text
Parameter	Beschreibung
Text	Beliebiger Text der reine dokumentierende Wirkung hat.
Tip: Anstelle von Rem können Sie auch das „ ‘ “-Zeichen zum Auskommentieren verwenden. Dieses Zeichen kann auch direkt rechts neben einer Programmzeile stehen.


Programmablaufsteuerungsfunktionen
Select...Case...End Select-Anweisung

Funktion:	Definiert einen oder mehrere Befehlsblöcke die in Abhängigkeit von dem Ergebnis eines bestimmten Ausdrucks stehen.
Syntax:	Select PruefAusdruck Case ausdruck1 befehle1 [Case ausdruck2 befehle2] [Case Else] befehle End Select
Parameter	Beschreibung
PruefAusdruck	Beliebiger Ausdruck, von dessen Ergebnis die Abarbeitung der jeweiligen hinter Case stehenden Befehlsblöcke abhängig ist.
Ausdruck	Beliebiger Ausdruck, der typkompatibel zu PruefAusdruck sein muß. Ein hinter Case stehender Befehlsblock wird dann abgearbeitet, wenn PruefAusdruck und ausdruck gleich sind.
Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Stop-Anweisung

Funktion:	Bricht die Ausführung eines Programms ab. Das Programm kann, wenn es von der IDE aus gestartet wurde, mit dem entsprechenden Symbol der Objektleiste an der Stelle fortgesetzt werden, an der es durch die Stop-Anweisung unterbrochen wurde.
Syntax:	Stop
Tip: Diese Anweisung ist lediglich ein Relikt aus älteren Basic-Dialekten und nur aus Kompatibilitätsgründen implementiert. Es diente vorwiegend zum Testen von Programmen. Verwenden Sie in StarBasic die ungleich komfortableren Haltepunkte – ein Feature, das die IDE anbietet –, um Programme zu testen.

Siehe auch:	Programmablaufsteuerungsfunktionen , End-Anweisung


Programmablaufsteuerungsfunktionen
Sub...Exit Sub...End Sub-Anweisung

Funktion:	Definiert eine Unterroutine.
Syntax:	Sub Name[(VarName1 [As Typ] [,VarName2 [as Typ][,...]) . [Exit Sub] . End Sub
Parameter	Beschreibung
Name	Name der Unterroutine.
VarName	Parameter, die die Unterroutine erwartet.
Typ	Typendeklarationsschlüsselwort.
Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
Switch-Funktion

Funktion:	Wertet eine Argumentliste mit Ausdrücken und Werten aus, in der jeweils ein Wert einem Ausdruck folgt. Ein Ausdruck und ein Wert bilden eine Zuordnungseinheit. Die Switch-Funktion gibt den Wert zurück, der dem Ausdruck zugeordnet ist, der dieser Funktion übergeben wurde.
Syntax:	Switch(Ausdruck1, Wert1[, Ausdruck2, Wert2 . . . [, Ausdruck_n, Wert_n]])
Die Ausdrücke der Argumentliste der Switch-Funktion werden in der Reihenfolge ihrer Anordnung von links nach rechts ausgewertet. Es wird der Wert zurückgegeben, der dem der Funktion übergebenen Ausdruck zugeordnet ist. Werden die Zuordnungseinheiten nicht paarweise angegeben, tritt ein Laufzeitfehler auf.

Parameter	Beschreibung
Ausdruck	Der Ausdruck, dem ein Wert zugewiesen ist, der zurückgegeben werden kann.
Wert	Der Wert, der zurückgegeben wird, sofern er dem Ausdruck zugeordnet ist, der dem der Funtion übergebenen Ausdruck entspricht.
Beispiel:	Das nachstehende Beispiel verwendet die Switch-Funktion, um dem der Funktion übergebenen Namen den entsprechenden Genus zuzuordnen:
Function GenusZuordnen (Name As String)

Zuordnen = Switch(Name = "Elfriede", "weiblich", Name = "Willi", "männlich", Name = "Haus", "sächlich")

End Function

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
While...Wend -Anweisung

Funktion:	Schleifenstruktur, die dafür sorgt, daß die zwischen beiden Anweisungen stehenden Befehle solange wie eine bestimmte Bedingung erfüllt ist, ausgeführt werden.
Syntax:	While bedingung=TRUE] Befehlsblock Wend
Trifft das Programm auf eine While-Anweisung, wird überprüft, ob die Bedingung wahr ist. Ist Sie falsch, geht es mit der Programmausführung direkt hinter Wend weiter. Ist die Bedingung wahr, wird die Schleife durchlaufen, das Programm trifft auf Wend und springt zurück zur While-Anweisung. Ist die Bedingung jetzt immer noch wahr, wird die Schleife abermals durchlaufen, ansonsten fährt das Programm mit der Ausführung der hinter der Wend-Anweisung stehenden Anweisung fort. Kurz zusammengefaßt: Die Schleife wird nur dann und nur solange wie die Bedingung wahr ist, ausgeführt.

Anders als bei Do...Loop kann eine While...Wend-Schleife nicht mit Exit verlassen werden. Sie sollten ebenfalls davon Abstand nehmen, eine While...Wend-Schleife mit GoTo zu verlassen, da dies zu Laufzeitfehlern führen kann.

In jedem Fall ist die Verwendung von Do...Loop flexibler und damit empfehlenswert.

Siehe auch:	Programmablaufsteuerungsfunktionen


Programmablaufsteuerungsfunktionen
With-Anweisung

Funktion:	Bestimmt ein Objekt zum Vorgabeobjekt, auf das sich alle Eigenschaften oder Methoden bis zur End-With-Anweisung beziehen, solange keine weiteren Objektnamen angegeben werden.
Syntax:	With Objekt befehle End With
Verwenden Sie diese Strukturanweisungen, wenn Sie viele Eigenschaften oder Methoden für ein bestimmtes Objekt verwenden.

Beispiel:	Das folgende Beispiel soll das verdeutlichen. Anstelle mehrere Eigenschaften z.B. mit folgenden Befehlen zu definieren... CheckBoxBeispielobjekt.Enabled=True CheckBoxBeispielobjekt.Value=True CheckBoxBeispielobjekt.Visible=True CheckBoxBeispielobjekt.Caption=“Lustig“ CheckBoxBeispielobjekt.Refresh ...definieren Sie ein einziges Mal ein „Default“-Objekt, auf das sich innerhalb des durch With- und End With begrenzten Blocks alle Eigenschaften bzw. Methoden beziehen: With CheckBoxBeispielobjekt Enabled=True Value=True Visible=True Caption=“Lustig“ Refresh End With


Sonstige Befehle

In diesem Kapitel finden Sie alle „übrigen“ Anweisungen und Funktionen, die sich nicht eindeutig kathegorisieren lassen.

Sie finden in diesem Kapitel folgende Funktionen und Anweisungen:

•	Beep-Anweisung

•	GetGUIType-Funktion

•	GetGUIVersion-Funktion

•	GetSystemType-Funktion

•	Shell-Funktion

•	Wait-Anweisung


Sonstige Befehle
Beep-Anweisung

Funktion:	Gibt einen Ton über die Computer-Lautsprecher aus. Der ausgegebene Ton ist systemabhängig und in der Regel in Lautstärke und Tonhöhe nicht beeinflußbar.
Syntax:	Beep
Siehe auch:	Sonstige Befehle


Sonstige Befehle
GetGUIType-Funktion

Funktion:	Gibt einen numerischen Wert zurück, der angibt, welches grafische Benutzer-Interface gegenwärtig verwendet wird.
Syntax:	GetGUIType()
	Rückgabewert	Beschreibung
	1	Windows.
	2	Presentation Manager.
	3	Macintosh.
	4	Motif.
	5	Open Window.
Siehe auch:	Sonstige Befehle , GetGUIVersion-Funktion , GetSystemType-Funktion


Sonstige Befehle
GetGUIVersion-Funktion

Funktion:	Gibt einen numerischen Wert zurück, der die Versionsnummer des gegenwärtig verwendeten grafischen Benutzer-Interface angibt.
Syntax:	GetGUIVersion()
	Rückgabewert	Beschreibung
	311	Windows 3.11
	400	Windows 95
Siehe auch:	Sonstige Befehle , GetGUIType-Funktion , GetSystemType-Funktion


Sonstige Befehle
GetSystemType-Funktion

Funktion:	Gibt einen numerischen Wert zurück, der das System beschreibt, auf dem die Applikation ausgeführt wird.
Syntax:	GetSystemType()
	Rückgabewert	Beschreibung
	1	Personal Computer.
	2	Macintosh.
	3	Sun.
	4	RS6000.
	5	Alpha.
	6	Alpha Personal Computer.
	7	HP9000.
	8	AVION.
	9	VAX.


Sonstige Befehle
Shell-Funktion

Funktion:	Startet ein anderes Anwendungsprogramm und bestimmt bei Bedarf dessen Darstellungsform.
Syntax:	Shell(PfadName$, [Fensterstil%], [Param$], [bSync])
	Parameter	Beschreibung
	PfadName$	Kompletter Pfad und Programmname des zu startenden Programms.
	Fensterstil%	Optionaler beliebiger Integer-Ausdruck, der die Darstellungsart des Programms bestimmt. Es gilt:
	Fensterstil%	Darstellungsart
	0	Das Programmfenster ist versteckt, und der Fokus liegt auf dem versteckten Fenster
	1	Das Programmfenster wird in der ursprünglichen Größe angezeigt und ist fokussiert.
	2	Das Programmfenster wird als Symbol angezeigt und ist fokussiert.
	3	Das Programmfenster wird in Maximalgröße angezeigt und ist fokussiert.
	4	Das Programmfenster wird in der ursprünglichen Größe angezeigt, ist aber nicht fokussiert.
	6	Das Programmfenster wird als Symbol angezeigt; das aktuelle Fenster behält den Fokus.
	10	Gesamtbildschirm öffnen
Param$	Beliebiger Zeichenkettenausdruck, der die Übergabe der Komadozeile erlaubt
bSync	Booleanscher Ausdruck, der bestimmt, ob zu der Applikation direkt nach dem Start eine DDE-Verbindung aufgebaut werden kann (True) oder nicht (False)
Siehe auch:	Sonstige Befehle


Sonstige Befehle
Wait-Anweisung

Funktion:	Unterbricht die Programmausführung für die Dauer der angegebenen Anzahl an Millisekunden.
Syntax:	Wait millisek
	Parameter	Beschreibung
	millisek	Numerischer Ausdruck, der Zeitdauer in Millisekunden aufnimmt, für die die Programmausführung unterbrochen werden soll.


Variablenfunktionen

In diesem Kapitel finden Sie die Referenz aller Anweisungen und Funktionen, mit denen Sie Variablen verwalten können – sie beispielsweise deklarieren oder definieren, Variablen von einem Typ in den anderen umwandeln, ihren Typ feststellen, etc.

Dies Funktionen und Anweisungen stehen zur Manipulation und Prüfung von Variablen zur Verfügung:

•	CBool-Funktion

•	CByte-Funktion

•	CDate-Funktion

•	CDbl-Funktion

•	CInt-Funktion

•	CLng-Funktion

•	Const-Anweisung

•	CreateObject-Funktion

•	CSng-Funktion

•	CStr-Anweisung

•	DefBool-, DefByte-, DefDate-, DefDbl-, DefInt-, DefLng-, DefObj-, DefSng-

•	Dim-Anweisung

•	IsArray-Funktion

•	IsDate-Funktion

•	IsEmpty-Funktion

•	IsError-Funktion

•	IsNull-Funktion

•	IsNumeric-Funktion

•	IsObject-Funktion

•	LBound-Funktion; UBound-Funktion

•	Let-Anweisung

•	Option Base-Anweisung

•	Option Explicit

•	Public-Anweisung

•	ReDim-Anweisung

•	Static-Anweisung

•	TypeName-Funktion; VarType-Funktion


Variablenfunktionen
CBool-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen Zeichenkettenausdruck in einen Bool-Typ.
Syntax:	CBool(NumAusdruck)
	Parameter	Beschreibung
	NumAusdruck	Beliebiger numerischer Ausdruck, der konvertiert werden soll. Intern wird nur das rechte Bit der internen Darstellung des Originalausdrucks verwendet. Das Ergebnis kann entweder TRUE oder FALSE sein. Wird ein Zeichenkettenausdruck umgewandelt, so muß die Zahl im Klartext vorliegen (also z.B. „123,5“). Bitte beachten Sie dabei, daß die jeweilige Zahlennotation gemäß der Landeseinstellung Ihres Computers (im Gegensatz zur Val-Funktion; dort müßte es „123.5“ heißen) berücksichtigt wird.
Siehe auch:	Variablenfunktionen , Asc-Funktion , CByte-Funktion , CDate-Funktion , CDbl-Funktion , CInt-Funktion , CLng-Funktion , CSng-Funktion , Str$-Funktion


Variablenfunktionen
CByte-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen Zeichenkettenausdruck in einen Byte-Typ.
Syntax:	CByte(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck, der konvertiert werden soll. Überschreitet der Ausdruck den Wertebereich zwischen 0 und 255, meldet StarBasic einen Überlauffehler. Wird ein Zeichenkettenausdruck umgewandelt, so muß die Zahl im Klartext vorliegen (also z.B. „123,5“). Bitte beachten Sie dabei, daß die jeweilige Zahlennotation gemäß der Landeseinstellung Ihres Computers (im Gegensatz zur Val-Funktion; dort müßte es „123.5“ heißen) berücksichtigt wird. Eventuell vorhandene Nachkommastellen bleiben bei der Konvertierung unberücksichtigt und fallen weg.
Siehe auch:	Variablenfunktionen , Asc-Funktion , CBool-Funktion , CDate-Funktion , CDbl-Funktion , CInt-Funktion , CLng-Funktion , CSng-Funktion , Str$-Funktion


Variablenfunktionen
CDate-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen Zeichenkettenausdruck in einen Date-Typ .
Syntax:	CDate(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck oder Zeichenkettenausdruck, der konvertiert werden soll.
Werden Zeichenkettenausdrücke umgewandelt, muß die zu konvertierende Zeiteingabe im Klartext vorliegen, so wie es die Konventionen zur DateValue- bzw. TimeValue-Funktion vorsehen. Werden numerische Ausdrücke umgewandelt, beschreiben die Vorkommastellen des Wertes das Datum, die Nachkommastellen die Uhrzeit.

Siehe auch:	Variablenfunktionen , Asc-Funktion , Variablenfunktionen , CBool-Funktion , CDate-Funktion , CDbl-Funktion , CreateObject-Funktion


Variablenfunktionen
CDbl-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen String-Ausdruck in einen Double-Typ.
Syntax:	CDbl(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck oder Zeichenkettenausdruck, der konvertiert werden soll. Wird ein Zeichenkettenausdruck umgewandelt, so muß die Zahl im Klartext vorliegen (also z.B. „123,5“). Bitte beachten Sie dabei, daß die jeweilige Zahlennotation gemäß der Landeseinstellung Ihres Computers (im Gegensatz zur Val-Funktion; dort müßte es „123.5“ heißen) berücksichtigt wird.
Siehe auch:	Variablenfunktionen , Asc-Funktion , CBool-Funktion , CByte-Funktion , CDate-Funktion , CInt-Funktion , CLng-Funktion , CSng-Funktion , Str$-Funktion


Variablenfunktionen
CInt-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen Zeichenkettenausdruck in einen Integer-Typ.
Syntax:	CInt(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck, der konvertiert werden soll. Überschreitet der Ausdruck den Wertebereich zwischen -32768 und 32767, meldet StarBasic einen Überlauffehler. Wird ein Zeichenkettenausdruck umgewandelt, so muß die Zahl im Klartext vorliegen (also z.B. „123,5“). Bitte beachten Sie dabei, daß die jeweilige Zahlennotation gemäß der Landeseinstellung Ihres Computers (im Gegensatz zur Val-Funktion; dort müßte es „123.5“ heißen) berücksichtigt wird. Eventuell vorhandene Nachkommastellen bleiben bei der Konvertierung unberücksichtigt und fallen weg.
Siehe auch:	Variablenfunktionen , Asc-Funktion , CBool-Funktion , CByte-Funktion , CDate-Funktion , CDbl-Funktion , CLng-Funktion , CSng-Funktion , Str$-Funktion , Val-Funktion


Variablenfunktionen
CLng-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen Zeichenkettenausdruck in einen Long-Integer-Typ.
Syntax:	CLng(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck, der konvertiert werden soll. Überschreitet der Ausdruck den gültigen Long-Int-Wertebereich zwischen -2.147.483.648 und 2.147.483.647, meldet StarBasic einen Überlauffehler. Wird ein Zeichenkettenausdruck umgewandelt, so muß die Zahl im Klartext vorliegen (also z.B. „123,5“). Bitte beachten Sie dabei, daß die jeweilige Zahlennotation gemäß der Landeseinstellung Ihres Computers (im Gegensatz zur Val-Funktion; dort müßte es „123.5“ heißen) berücksichtigt wird. Eventuell vorhandene Nachkommastellen bleiben bei der Konvertierung unberücksichtigt und fallen weg.
Siehe auch:	Variablenfunktionen , Asc-Funktion , CBool-Funktion , CByte-Funktion , CDate-Funktion , CDbl-Funktion , CInt-Funktion , CSng-Funktion , Str$-Funktion , Val-Funktion


Variablenfunktionen
Const-Anweisung

Funktion:	Definiert eine Zeichenkette als Konstante.
Syntax:	Const zeichenkette=Ausdruck
Parameter	Beschreibung
zeichenkette	Beliebiger Konstantenname; es gelten für die Benennung eines Konstantennamens die gleichen Konventionen wie für Variablen.
Konstanten sind eine „Abart“ von Variablen und dienen nur der besseren Lesbarkeit eines Programms. Konstanten werden nicht als bestimmter Typ definiert, sondern werden als reiner Programmcodeplatzhalter verwendet. Eine Konstante kann nur ein einziges Mal im Programm definiert und dann nie wieder umdefiniert werden. Sie definieren eine Konstante mit folgender Befehlszeile:

CONST ConstName=Ausdruck

Dabei ist es völlig egal, um was für einen Ausdruck es sich handelt. Wird ein Programm gestartet, so wird StarBasic-intern den Programm-Code so umarbeiten, daß jedesmal, wenn eine Konstante verwendet wurde, der zuvor festgelegte Ausdruck dafür eingesetzt wird. Im Prinzip wird intern ein „Suchen/Ersetzen“ durchgeführt. Der Konstantenname, wann immer er im Basic-Programm-Code verwendet wurde, wird durch den Ausdruck ersetzt. Aus diesem Grund spielt der Typ, der einer Konstanten zugewiesen wird, auch überhaupt keine Rolle, da intern sowieso nur der Ausdruck als solcher verwendet wird.

Siehe auch:	Variablenfunktionen , Let-Anweisung , Public-Anweisung , ReDim-Anweisung , Static-Anweisung


Variablenfunktionen
CreateObject-Funktion

Funktion:	Erstellt ein OLE-Objekt.
Syntax:	CreateObject(Klasse)
Parameter	Beschreibung
Klasse	Die der Funktion zu übergebende Klasse setzt sich aus den Argumenten  Applikationsname.Objekttyp zusammen. Die Funktion liefert das Objekt zurück, die mit dem Set-Befehl einer Objektvariablen zugewiesen werden muß.
Beispiel:	Dim StarCalcApp As Object ' Variable deklarieren. ‘Objekt erzeugen Set StarCalcApp = CreateObject("starcalc.application") ‘Applikation darstellen, in dem die Eigenschaft auf die Objekt ‘Variable angewendet wird. StarCalcApp.Visible = True ‘Applikation schließen, wenn nicht mehr benötigt StarCalcApp.Quit


Variablenfunktionen
CSng-Funktion

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck oder einen String-Ausdruck in einen Single-Typ.
Syntax:	CSng(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck oder Zeichenkettenausdruck, der konvertiert werden soll. Wird ein Zeichenkettenausdruck umgewandelt, so muß die Zahl im Klartext vorliegen (also z.B. „123,5“). Bitte beachten Sie dabei, daß die jeweilige Zahlennotation gemäß der Landeseinstellung Ihres Computers (im Gegensatz zur Val-Funktion; dort müßte es „123.5“ heißen) berücksichtigt wird.
Siehe auch:	Variablenfunktionen , Asc-Funktion , CBool-Funktion , CByte-Funktion , CDate-Funktion , CDbl-Funktion , CInt-Funktion , CLng-Funktion , Str$-Funktion , Val-Funktion ,


Variablenfunktionen
CStr-Anweisung

Funktion:	Konvertiert einen beliebigen numerischen Ausdruck in einen Zeichenkettenausdruck.
Syntax:	CStr(Ausdruck)
Parameter	Beschreibung
Ausdruck	Beliebiger numerischer Ausdruck oder Zeichenkettenausdruck, der konvertiert werden soll. Es gilt:
Typ	Konvertierung ergibt...
Boolean	...eine Zeichenkette, die entweder „True“ oder „False“ lautet.
Date	...eine Zeichenkette, die das Datum und die Zeit in der normalen Schreibweise enthält.
Null	...einen Laufzeitfehler.
Empty	...eine leere Zeichenkette (Null-String).
beliebiger numerischer Ausdruck	...die entsprechende Zahl als Zeichenkette in der jeweils üblichen Landesnotation.
Siehe auch:	Asc-Funktion , Variablenfunktionen , CBool-Funktion , CDate-Funktion , CDbl-Funktion , CreateObject-Funktion


Variablenfunktionen
DefBool-, DefByte-, DefDate-, DefDbl-, DefInt-, DefLng-, DefObj-, DefSng-, DefStr-, DefVar-Anweisung

Funktion:	Legt den Vorgabevariablentypen für verschiedene Anfangsbuchstabenbereiche für die Fälle von Variablendeklarationen fest, bei denen kein Typendeklarationszeichen oder Typendeklarationsschlüsselwort angegeben wurde.
Syntax:	Defxxx Buchstabenbereich1 [,Buchstabenbereich2 [,...]]
	Parameter	Beschreibung
	Buchstaben- bereich	Zeichen, die den Buchstabenbereich festlegen, für die Variablennamen, die voreingestellt für den angegebenen Variablentypen deklariert werden sollen.
	xxx	Schlüsselwort, daß den voreinzustellenden Variablentypen definiert. Es gilt:
Schlüsselwort	voreingestellter Variablentyp
DefBool	Boolean
DefByte	Byte
DefDate	Date
DefDbl	Double
DefInt	Integer
DefLng	Long
DefObj	Object
DefSng	Single
DefStr	String
DefVar	Variant


Variablenfunktionen
Dim-Anweisung

Funktion:	Deklariert eine Variable oder ein Array
Syntax:	[Re]Dim Varname[(start To ende)] [As VarTyp], Varname2[(start To ende)] [As VarTyp], ...
Parameter	Beschreibung
VarName	Beliebiger Variablen- oder Arrayname.
start, ende	Numerische Werte oder Konstanten, die numerische Werte beinhalten zwischen -32768 und 32767, die die Anzahl der Elemente (AnzahlElemente=(ende-start)+1) und den Indexbereich definieren. start und ende können numerische Ausdrücke sein, wenn ReDim (siehe unten) auf Prozeduren-Ebene verwendet wurde.
VarTyp	Variablendeklarationsschlüsselwort. Es gelten:
	Schlüsselwort	Variablentyp
	Bool	Boolean-Variable (True, False)
	Byte	Byte-Variable (0-255)
	Date	Date-Variable
	Double	Double-Fließkommavariable (1,79769313486232 x 10308  - 4,94065645841247 x 10-324)
	Integer	Integer-Variable (-32768 - 32767)
	Long	Long-Integervariable (-2.147.483.648  - 2.147.483.647)
	Object	Object-Variable (Achtung: kann später nur mit Set definiert werden!)
	[Single]	Single-Fließkommavariable (3,402823 x 1038  - 1,401298 x 10-45). Wird kein Schlüsselwort angegeben, wird eine Variable automatisch als Single-Typ definiert, es sei denn, DEFXXX (siehe dort) ist zuvor verwendet worden.
	String	Zeichenkettenvariable. Nimmt beliebige Zeichen gemäß des ASCII auf. Zeichenketten können maximal 64.000 Zeichen umfassen.
	Variant	Variant-Variablentyp (kann alle Typen beinhalten und wird bei der und durch die Definition typisiert).
Variablen brauchen in StarBasic nicht explizit deklariert zu werden, wie Sie es vielleicht von anderen Programmiersprachen her kennen. Lediglich Arrays müssen vor Verwendung deklariert werden (siehe nächster Absatz). Eine Variablendeklaration erfolgt mit dem DIM-Befehl; mehrere Deklarationen können mit Komma getrennt erfolgen. Um den Typen für eine Variable bei einer Deklaration festzulegen, verwendet man entweder ein spezielles Typendeklarationszeichen, das hinter dem Namen angegeben wird oder ein entsprechendes Schlüsselwort.

StarBasic kennt ein- oder mehrdimensionale Arrays (Felder), denen ein bestimmter angebbarer Variablentyp zugrunde liegt. Arrays werden immer dann verwendet, wenn im Programm Listen oder Tabellen verarbeitet werden sollen. Der Vorteil von Arrays ist, daß man die einzelnen Elemente über sogenannte Indizes ansprechen kann, die selbst ebenfalls in Form von numerischen Ausdrücken oder Variablen formuliert werden können.

Arrays werden mit dem DIM-Befehl deklariert. Es gibt dabei zwei Möglichkeiten festzulegen, in welchem Bereich die Indizes angesprochen werden können:

DIM text$(20)	‘20 Elemente, von 1 bis 20 durchnummeriert

DIM text$(5 to 25)	‘20 Elemente, von 5 bis 25 durchnummeriert

DIM text$(-15 to 5)	‘21 Elemente (das 0. ebenfalls!), von -15 bis 5 durchnummeriert

Variablenfelder gleich welchen Typs können dynamisch gehalten werden, wenn Sie auf Prozeduren-Ebene (also in Subs oder Functions) mit der REDIM-Anweisung dimensioniert werden. Normalerweise können die Grenzen eines Arrays nur ein einziges Mal definiert werden, und bleiben dann unveränderbar. Innerhalb einer Prozedur kann ein Array mit ReDim deklariert werden; Bei REDIM können die Grenzen hier durch numerische Ausdrücke bestimmt werden, so daß die Felder nur so groß wie tatsächlich benötigt gehalten werden.

Siehe auch:	Variablenfunktionen , Let-Anweisung , Public-Anweisung , ReDim-Anweisung , Static-Anweisung


Variablenfunktionen
IsArray-Funktion

Funktion:	Stellt fest, ob es sich bei einer Variablen um eine normale oder eine Array-Variable handelt.
Syntax:	IsArray(Variable)
	Parameter	Beschreibung
	Variable	Beliebige Variable, die überprüft werden soll, ob sie als Array (Rückgabewert ist True) oder normale Variable (False) deklariert wurde.
Siehe auch:	Variablenfunktionen , IsDate-Funktion , IsEmpty-Funktion , IsError-Funktion , IsNull-Funktion , IsNumeric-Funktion , IsObject-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
IsDate-Funktion

Funktion:	Überprüft, ob ein angegebener numerischer Ausdruck oder ein Zeichenkettenausdruck in den Variablentypen Date umwandelbar ist, oder nicht.
Syntax:	IsDate(Ausdruck)
	Parameter	Beschreibung
	Ausdruck	Beliebiger numerischer Ausdruck oder Zeichenkettenausdruck der überprüft werden soll. Ist der Ausdruck in einen Date-Typen umwandelbar, liefert die Funktion den Wert TRUE anderenfalls den Wert FALSE zurück.
Siehe auch:	Variablenfunktionen , IsArray-Funktion , IsEmpty-Funktion , IsError-Funktion , IsNull-Funktion , IsNumeric-Funktion , IsObject-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
IsEmpty-Funktion

Funktion:	Überprüft, ob eine Variable den Wert EMPTY (Leer) enthält. Das kann entweder eine nichtinitialisierte Variable oder eine Variable sein, der man ausdrücklich den Wert EMPTY zugewiesen hat.
Syntax:	IsEmpty(Variable)
	Parameter	Beschreibung
	Variable	Beliebige Variable, die überprüft werden soll.
Siehe auch:	Variablenfunktionen , IsArray-Funktion , IsDate-Funktion , IsError-Funktion , IsNull-Funktion , IsNumeric-Funktion , IsObject-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
IsError-Funktion

Funktion:	Liefert True oder False zurück und zeigt an, ob der übergebene Ausdruck ein gültiger Ausdruck des Typs Error war.
Syntax:	IsError(Variable)
	Parameter	Beschreibung
	Variable	Variable, die überprüft werden soll. Wird TRUE zurückgeliefert, handelt es sich um einen Error-Typ.
Siehe auch:	Variablenfunktionen , IsArray-Funktion , IsDate-Funktion , IsEmpty-Funktion , IsNull-Funktion , IsNumeric-Funktion , IsObject-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
IsNull-Funktion

Funktion:	Überprüft, ob eine Variable den Wert Null („Nichts“) enthält. Dieser Zustand liegt beispielsweise dann vor, wenn eine Variable des Typs Variant keinen gültigen Inhalt aufweist.
Syntax:	IsNull(Variable)
	Parameter	Beschreibung
	Variable	Beliebige Variable, die überprüft werden soll. Liefert die Funktion den Wert zurück, handelt es sich bei der Variablen um einen Null-Ausdruck.
Siehe auch:	Variablenfunktionen , IsArray-Funktion , IsDate-Funktion , IsEmpty-Funktion , IsError-Funktion , IsNumeric-Funktion , IsObject-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
IsNumeric-Funktion

Funktion:	Stellt fest, ob eine Variable einen gültigen numerischen Ausdruck oder Wert beinhaltet.
Syntax:	IsNumeric(Variable)
	Parameter	Beschreibung
	Variable	Beliebige Variable, die überprüft werden soll. Liefert die Funktion True zurück, handelt es sich um einen gültigen numerischen Ausdruck.
Siehe auch:	Variablenfunktionen , IsArray-Funktion , IsDate-Funktion , IsEmpty-Funktion , IsError-Funktion , IsNull-Funktion , IsObject-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
IsObject-Funktion

Funktion:	Stellt fest, ob es sich bei der angegebenen Objektvariable um ein OLE-Objekt handelt.
Syntax:	IsNumeric(ObjectVariable)
	Parameter	Beschreibung
	ObjectVariable	Beliebige Variable, die überprüft werden soll. Beinhaltet die Objektvariable ein OLE-Objekt, lautet der Rückgabewert TRUE .
Siehe auch:	Variablenfunktionen , IsArray-Funktion , IsDate-Funktion , IsEmpty-Funktion , IsError-Funktion , IsNull-Funktion , IsNumeric-Funktion , TypeName-Funktion; VarType-Funktion , TypeName-Funktion; VarType-Funktion


Variablenfunktionen
LBound-Funktion; UBound-Funktion

Funktion:	Ermittelt die Unter- bzw. Obergrenze eines Arrays
Syntax:	LBound(ArrayName) bzw UBound(ArrayName)
	Parameter	Beschreibung
	ArrayName	Name des Arrays, dessen Ober- (UBOUND) bzw. Untergrenze (LBOUND) ermittelt werden soll.
Siehe auch:	Variablenfunktionen


Variablenfunktionen
Let-Anweisung

Funktion:	Weist einer Variablen einen Wert zu.
Syntax:	[Let] VarName=Ausdruck
	Parameter	Beschreibung
	VarName	Variable beliebigen Typs, der ein Ausdruck zugewiesen wird. Bitte beachten Sie, daß Ausdruck und Variablentyp miteinander kompatibel sind.
Hinweis: Wie in nahezu allen Basic-Dialekten ist die Angabe des Schlüsselwortes LET optional.

Siehe auch:	Variablenfunktionen , Public-Anweisung , ReDim-Anweisung , Static-Anweisung


Variablenfunktionen
Option Base-Anweisung

Funktion:	Definiert die voreingestellte Untergrenze für Arrays als 0 bzw. 1
Syntax:	Option Base { 0 | 1}
Achtung: Diese Anweisung muß vor dem ersten ausführbaren Programm-Code innerhalb eines Moduls stehen.

Siehe auch:	Variablenfunktionen , LBound-Funktion; UBound-Funktion


Variablenfunktionen
Option Explicit

Funktion:	Bestimmt, daß jede im Programm-Code verwendete Variable explizit mit der Dim-Anweisung deklariert werden muß.
Syntax:	Option Explicit
Achtung: Diese Anweisung muß vor dem ersten ausführbaren Programm-Code innerhalb eines Moduls stehen.

Siehe auch:	Variablenfunktionen , LBound-Funktion; UBound-Funktion , Let-Anweisung , Public-Anweisung , ReDim-Anweisung , Static-Anweisung


Variablenfunktionen
Public-Anweisung

Funktion:	Dimensioniert eine Variable oder ein Array auf Modulebene (also außerhalb einer Sub oder einer Function), damit die Variable und das Array in allen Bibliotheken und Modulen Gültigkeit hat.
Syntax:	Public Varname[(start To ende)] [As VarTyp], Varname2[(start To ende)]          [As VarTyp], ...
Parameterbeschreibung siehe DIM-Anweisung.

Siehe auch:	Variablenfunktionen , Let-Anweisung , ReDim-Anweisung , Static-Anweisung


Variablenfunktionen
ReDim-Anweisung

Siehe Dim-Anweisung


Variablenfunktionen
Static-Anweisung

Funktion:	Dimensioniert eine Variable oder ein Array auf Prozedurebene (also innerhalb einer Sub oder einer Function), damit die Werte der Variablen oder des Arrays beim Verlassen der Sub oder der Function erhalten bleiben. Es gelten ansonsten die Konventionen der DIM-Anweisung.
Syntax:	Static Varname[(start To ende)] [As VarTyp], Varname2[(start To ende)]         [As VarTyp], ...
Parameterbeschreibung siehe DIM-Anweisung.

Siehe auch:	Variablenfunktionen , Let-Anweisung , Public-Anweisung , ReDim-Anweisung


Variablenfunktionen
TypeName-Funktion; VarType-Funktion

Funktion:	Liefert eine Zeichenkette (TYPENAME) oder einen numerischen Wert (VARTYPE) zurück, der oder die Informationen über eine Variable gibt.
Syntax:	VarType(Variable)
	Parameter	Beschreibung
	Variable	Variable, deren Typ ermittelt werden soll. Es gelten folgende Rückgabeergebnisse:
Schlüsselwort	VarType	Variablentyp
Boolean	11	Boolean-Variable
Byte	17	Byte-Variable
Date	7	Date-Variable
Double	5	Double-Fließkommavariable
Integer	2	Integer-Variable
Long	3	Long-Integervariable
Object	13	Object-Variable
Single	4	Single-Fließkommavariable
String	8	Zeichenkettenvariable. Nimmt beliebige Zeichen gemäß des ASCII auf. Zeichenketten können maximal 64.000 Zeichen umfassen.
Variant	12	Variant-Variabletyp (kann alle Typen beinhalten und wird bei der und durch die Definition typisiert).
Empty	0	Variable ist nicht initialisiert
Null	1	Keine gültigen Daten
S iehe auch:	IsArray-Funktion IsDate-Funktion IsEmpty-Funktion IsError-Funktion IsNull-Funktion IsNumeric-Funktion IsObject-Funktion


Vergleichsoperatoren

Vergleichsoperatoren basieren auf der Booleschen Algebra, die einen wesentlichen Aspekt des Computers darstellt. Mit der Booleschen Algebra ist es dem Computer erst möglich, bestimmte Bedingungen zu erkennen und entsprechend darauf zu reagieren. Wie beinahe jede Arithmetik kennt die Boolesche Algebra nur ein Ergebnis, das jedoch nur zwei Werte annehmen kann, den Wert 0 für ein falsches Ergebnis und den Wert -1 für ein wahres Ergebnis. In diesem Kapitel finden Sie alle Vergleichsoperatoren erklärt:

Sie finden in diesem Kapitel folgende Operatoren:

•	=, <, >, <=, >=, <> - Operatoren


Vergleichsoperatoren
=, <, >, <=, >=, <> - Operatoren

Funktion:	Werden zum Vergleich zweier Ausdrücke herangezogen
Syntax:	ergebnis = ausdruck1 { = | < | > | <= | >= } ausdruck2
Parameter	Beschreibung
ergebnis	Boolescher Ausdruck, der das Ergebnis des Vergleichs aufnimmt. Das Ergebnis kann nur den Wert -1 für einen Vergleich, der zutrifft, oder den Wert 0, für einen Vergleich der nicht zutrifft, annehmen.
Ausdruck1, ausdruck2	Beliebige numerische Werte, die miteinander verglichen werden sollen.
Die Bedeutung der Vergleichsoperatoren finden Sie in der folgenden Tabelle erklärt:

Vergleichsoperator	Bedeutung
= < > <= >= <>	gleich kleiner als größer als kleiner gleich größer gleich ungleich


Zeichenfolgenfunktionen

Mit Hilfe von Zeichenfolgen können Texte innerhalb eines StarBasic-Programms verarbeitet werden. Die hier beschriebenen Funktion helfen, Zeichenfolgen zu untersuchen oder auf unterschiedlichste Art und Weise zu manupulieren.

Sie finden in diesem Kapitel folgende Funktionen und Anweisungen:

Wandlung von ASCII/ANSI in Zeichenfolgen und umgekehrt

•	Asc-Funktion

•	Chr$-Funktion

•	Str$-Funktion

Vervielfachen von Zeichenfolgeninhalten

•	Space$-Funktion

•	String$-Funktion

Manipulieren, Formatieren und Ausrichten von Zeichenfolgeninhalten

•	Format$-Funktion

•	LCase$-Funktion

•	Left$-Funktion

•	LSet-Anweisung

•	LTrim$-Funktion

•	Mid$-Funktion, Mid$-Anweisung

•	Right$-Funktion

•	RSet-Anweisung

•	RTrim$-Funktion

•	UCase$-Funktion

Ermitteln einer Zeichenfolgelänge und vergleichen Zeichenfolge

•	InStr-Funktion

•	Len-Funktion

•	StrComp-Funktion


Zeichenfolgenfunktionen
Asc-Funktion

Funktion:	Gibt den ASCII-Wert (American Standard for Information Interchange) eines Zeichenfolgeausdrucks zurück.
Syntax:	Asc(zeichenfolgen-ausdruck$)
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck. Relevant dafür ist jedoch nur das erste Zeichen, der Rest der Zeichenfolge wird unberücksichtigt gelassen.
Die Asc-Funktion wird häufig verwendet, um Eingaben von der Tastatur abzufragen. Sie bildet quasi die Umkehrfunktion von der Chr$-Funktion. Wird der Asc-Funktion ein Leerstring (Zeichenfolge ohne Inhalt) übergeben, meldet StarBasic einen Fehler. Neben den reinen druckbaren ASCII-Zeichen (Codes 32-255), kann die ASCII-Funktion ebenfalls dazu herhalten, bestimmte Tastencodes, die ebenfalls im ASCII kodiert sind, abzufangen (siehe Beispiel).

Beispiel:	Das folgende Beispiel verwendet die Asc-Funktion zur Erkennung der Betätigung der Rückschrittaste.
Do

   in$=INKEY$	‘ Aufnahme der von der Tastatur kommenden

   	‘ Sequenzen in in$.

Loop UNTIL Asc(in$)<>8	‘ Wert für die Rückschrittaste.

Print “Die Rückschrittaste wurde betätigt.“

Siehe auch:	Zeichenfolgenfunktionen , Asc-Funktion , Variablenfunktionen , CBool-Funktion , CDate-Funktion , CDbl-Funktion , CreateObject-Funktion


Zeichenfolgenfunktionen
Chr$-Funktion

Funktion:	Liefert das Zeichen, das dem angegebenen ASCII-Wert entspricht.
Syntax:	Chr$(ausdruck%)
	Parameter	Beschreibung
	ausdruck%	Numerische Variable, die gültigen ASCII-Wert aufnimmt (0-255).
Die Chr$-Funktion wird oft verwendet, um spezielle Steuersequenzen an den Drucker oder ein anderes Ausgabegerät zu senden, aber auch, um beispielsweise Anführungszeichen in einen Zeichenfolgeausdruck einzufügen, was in der Programmierumgebung direkt nur sehr schwer zu realisieren ist, da das Anführungszeichen selbst den Start einer Zeichenfolge im StarBasic-Quelltext kennzeichnet.

Beispiel:	Dieses Beispiel fügt ein Anführungszeichen (ASCII-Wert 34) in eine Zeichenfolge ein.
MsgBox “Der “+ Chr$(34)+“kleine“ + Chr$(34)+“ Riese.“

Bei der Ausgabe erscheint im Dialogfeld:

Der “kleine“ Riese.

Siehe auch:	Zeichenfolgenfunktionen , Asc-Funktion , Variablenfunktionen , CBool-Funktion , CDate-Funktion , CDbl-Funktion , CreateObject-Funktion


Zeichenfolgenfunktionen
Format$-Funktion

Funktion:	Wandelt eine Zahl in eine Zeichenkette um, die einer Anweisung entsprechend formatiert wird.
Syntax:	Format$(numausdruck [,zeichenfolge-ausdruck$])
Parameter	Beschreibung
numausdruck	Der numerische Ausdruck, der in einer Zeichenkette formatiert abgelegt werden soll.
zeichenfolgen- ausdruck$	Ein Zeichenfolgeausdruck, der bestimmt, wie die Zahl als Zeichenkette abgelegt werden soll. Die folgende Tabelle beschreibt die Zeichen des Zeichenfolgeausdrucks, die Sie zur Zuweisung der Formatierung einer Zahl verwenden können:
Wird die Zeichenfolge, die die Anweisungen zur Formatierung der Zahl enthält, nicht angegeben, verhält sich die Format$-Funktion wie die Str$-Funktion. Eine Formatierungsanweisung kann in drei, durch Semikoli getrennte, Abschnitte unterteilt werden. Der erste Abschnitt nimmt die Anweisung zur Formatierung positiver, der zweite die zur Formatierung negativer Zahlen auf und der dritte formatiert Nullzeichenfolgen. Wird nur eine Zeichenfolge mit Formatierungsanweisungen angegeben, gilt diese für alle Zahlen.

Beispiel:	Das nachstehende Programm verdeutlicht die Format$-Funktion anhand eines einfachen Beispiels.
Eingabe$ = InputBox$("Geben Sie bitte eine Zahl ein:")

Wert = Val(Eingabe$)

If Wert >= 1000 Then

    Eingabe$ = InputBox$("Wünschen Sie Tausender-Punkte? (J/N)")

    If UCase$(Left$(Eingabe$, 1)) = "J" Then

        TausenderFlag = -1

    Else

        TausenderFlag = 0

    End If

End If

Eingabe$ = InputBox$("Wieviele Stellen sollen vor dem Komma angezeigt werden?")

VorKomma = Val(Eingabe$)

Eingabe$ = InputBox$("Wieviele Stellen sollen nach dem Komma angezeigt werden?")

NachKomma = Val(Eingabe$)

If TausenderFlag Then

    For z% = 1 To Int((VorKomma - 1) / 3)

        VorZahl$ = VorZahl$ + ",000"

    Next z%

    VorZahl$ = String$((VorKomma + z% - 1 - Len(VorZahl$)), "0") + VorZahl$

Else

    VorZahl$ = String$(VorKomma, "0")

End If

Ausgabeform$ = VorZahl$ + "." + String$(NachKomma, "0")

Zahl$ = Format$(Wert, Ausgabeform$)

Meldung$ = "Die Zeichenfolge, die angibt wie"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "die Zahl als Zeichenkette abgelegt"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "werden soll, lautet:"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + Ausgabeform$

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "Die Anweisung hat dann folgende Syntax:"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "Format$(Zahl, " + Chr$(34)

Meldung$ = Meldung$ + Ausgabeform$ + Chr$(34) + ")" + Chr$(13)

Meldung$ = Meldung$ + "Ausgabe:" + Zahl$

MsgBox Meldung$


Zeichenfolgenfunktionen
InStr-Funktion

Funktion:	Liefert die Position einer in einem Zeichenfolgeausdruck vorhandenen Zeichenfolge.
Syntax:	InStr([anfang%,] zeichenfolgeausdruck1$, zeichenfolgeausdruck2$[, vergleich])
	Parameter	Beschreibung
	anfang%	Beliebiger numerischer Ausdruck, der festlegt, ab welcher Position innerhalb eines Zeichenfolgeausdrucks die Suche nach einer bestimmten Zeichenfolge einsetzen soll. Wird diese Angabe ausgelassen, beginnt die Suche beim ersten Zeichen.
	zeichenfolge- ausdruck1	Zu durchsuchender Zeichenfolgeausdruck.
	zeichenfolge- ausdruck2$	Zu suchender Zeichenfolgeausdruck.
	vergleich	Optionaler, numerischer Ausdruck, der die Art des Zeichenfolgenvergleichs bestimmt. Dem Parameter kann der Wert 0 oder 1 zugewisen werden. Die Voreinstellung 0 führt zu einem binären Vergleich, der Wert 1 zu einem textuellen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.
Beispiel:	Das nachstehende Programm verdeutlicht die InStr-Funktion anhand einer Suchen und Ersetzen Routine.
eingabe$=InputBox$(“Bitte geben Sie einen längeren Satz ein:“)

suche$=InputBox$(“Bitte geben Sie das zu suchende Wort ein:“)

ersetze$=InputBox$(“Bitte geben Sie das zu ersetzende Wort ein:“)

Do

   If InStr(eingabe$, suche$)<>0 then   ‘Ist die zu suchende Zeichenfolge noch

                                        ‘in der Zeichenfolge vorhanden?

                                        ‘Wenn ja, dann

     zeichen_pos% = InStr(eingabe$, suche$)          ‘Position merken,

     haelfte1$ = Left$(eingabe$, zeichen_pos% - 1)   ‘zu untersuchende

                                                     ‘Zeichenfolge aufteilen

     haelfte2$ = Right$(eingabe$, len(eingabe$) - len(haelfte1$) - len(suche$))

     eingabe$ = satzhaelfte1$ + ersetze$ + satzhaelfte2$  ‘und zu ersetzendes

                                                          ‘Wort einfügen.

   Else

      Exit Do                                      ‘ Andernfalls Suche beenden.

   EndIf

Loop

MsgBox eingabe$

Siehe auch:	Zeichenfolgenfunktionen , FileDateTime-Funktion


Zeichenfolgenfunktionen
LCase$-Funktion

Funktion:	Wandelt alle Zeichen einer Zeichenfolge in Kleinbuchstaben um.
Syntax:	LCase(zeichenfolgeausdruck)
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck, der bearbeitet werden soll.
Die LCase-Funktion wandelt alle Zeichen einer Zeichenfolge in Kleinbuchstaben um. Angetastet werden dabei natürlich nur die großgeschriebenen Buchstaben des Alphabets, die sich in der Zeichenfolge befinden. Kleinbuchstaben und alle sonstigen Zeichen bleiben unverändert.

Siehe auch:	Zeichenfolgenfunktionen


Zeichenfolgenfunktionen
Left$-Funktion

Funktion:	kürzt einen Zeichenfolgeausdruck auf eine angegebene Anzahl von Zeichen. Den Ausgangspunkt hierfür bildet das erste linke Zeichen.
Syntax:	Left$(zeichenfolge-ausdruck$, n%)
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck, der bearbeitet werden soll.
	n%	Integer-Ausdruck, der die Anzahl der Zeichen bestimmt, auf die der Zeichenfolgeausdruck verkürzt werden soll. Wird n%=0, wird eine leere Zeichenfolge (Nullstring) zurückgegeben.
Beispiel:	Dieses Beispiel verwendet die Date$-Funktion, die das Datum im englischen Format zur Verfügung stellt (MM-TT-JJJJ), um einen Zeichenfolgeausdruck zu erstellen, der das Datum im deutschen Format aufnimmt (TT.MM.JJJJ).
ge_date$ = Mid$(Date$, 4, 2)

ge_date$ = ge_date$ + “.“

ge_date$ = ge_date$ + Left$(Date$, 2)

ge_date$ = ge_date$ + “.“

ge_date$ = ge_date$ + Right$(Date$, 4)

MsgBox ge_date$

Siehe auch:	Zeichenfolgenfunktionen


Zeichenfolgenfunktionen
Len-Funktion

Funktion:	Liefert die Anzahl der Zeichen in einer Zeichenfolge oder, wenn Variablen angegeben werden, die nicht vom Typ String (Zeichenfolge) sind, die Anzahl der Bytes, die benötigt werden, um den Inhalt der Variablen zu speichern.
Syntax:	Len(zeichenfolgen-ausdruck$) oder Len(AnyVarType)
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Ein beliebiger Zeichenfolgeausdruck
	AnyVarType	Eine Nicht String-Variable beliebigen Typs. Wird diese anstelle einer Zeichenfolge angegeben, gibt die Len-Funktion als Rückgabewert den Speicherplatzbedarf der Variablen in Byte an.
Beispiel:	Das folgende Programm verwendet die Len-Funktion zur Abfrage der Zeichenfolgenlänge bei der Eingabe von Postleitzahlen.
eingabe$ = InputBox$(“Geben Sie die Postleitzahl einer deutschen Stadt ein.“)

eingabe$ = LTrim$(eingabe$)	‘ Entfernt mögliche führende Leerzeichen.

eingabe$ = RTrim$(eingabe$)	‘ Entfernt mögliche nachstehende

‘ Leerzeichen.

If Len(eingabe$) <> 5 Then	‘ Wenn die Länge der eingegebenen

‘ Zeichenfolge ungleich 5 ist, dann:

meldung$ = “Keine deutsche Postleitzahl!“

meldung$ = meldung$ + “Diese Postleitzahl hat nur“

meldung$ = meldung$ + Str$(Len(eingabe$))

meldung$ = meldung$ + “Stellen!“

MsgBox meldung$

EndIf

Siehe auch:	Zeichenfolgenfunktionen


Zeichenfolgenfunktionen
LSet-Anweisung

Funktion:	Ordnet eine Zeichenkette linksbündig innerhalb einer Zeichenfolgevariablen an oder kopiert einen benutzerdefinierten Variablentyp in einen anderen.
Syntax:	LSet zeichenfolgevariable$ = zeichenkette oder LSet variable1 = variable2
Parameter	Beschreibung
zeichenfolgevariable$	Beliebige Zeichenfolgevariable.
Zeichenkette	Zeichenkette, die linksbündig in der Zeichenfolgevariable angeordnet werden soll.
variable1	Benutzerdefinierte Variable, in die eine andere kopiert werden soll.
variable2	Benutzerdefinierte Variable, die in eine andere kopiert werden soll.
Ist die Zeichenkette kürzer als die Zeichenfolgevariable, ordnet die LSet-Anweisung die Zeichenkette linksbündig in der Zeichenfolgevariable an. Die freien Stellen der Zeichenfolgevariable werden mit Leerzeichen aufgefüllt. Ist die Zeichenkette länger, werden nur soviele Zeichen der Zeichenkette linksbündig in der Zeichenfolgevariable angeordnet, wie diese aufnehmen kann.

Außerdem ist es mit der LSet-Anweisung möglich, eine benutzerdefinierte Variable einer anderen zuzuweisen.

Beispiel:	Das folgende Beispiel kopiert den Inhalt eines benutzerdefinierten Datensatzes in einen anderen.
Type 3ByteZeichenkette

Datenfeld1 As String * 3

End Type

Type 4ByteZeichenkette

Datenfeld2 As String * 4

End Type

Dim DatSatz1 As 3ByteZeichenkette, DatSatz2 As 4ByteZeichenkette

LSet DatSatz1 = DatSatz2

Die Länge von DatSatz1 beträgt 3 Byte und 4 Byte bei DatSatz2. Bei der Zuweisung von DatSatz2 an DatSatz1 werden deshalb auch nur die ersten drei Bytes von DatSatz2 an DatSatz1 übergeben.

Siehe auch:	Zeichenfolgenfunktionen


Zeichenfolgenfunktionen
LTrim$-Funktion

Funktion:	Schneidet alle führenden Leerzeichen eines Zeichenfolgeausdrucks ab.
Syntax:	LTrim$(zeichenfolge-ausdruck$).
Parameter	Beschreibung
zeichenfolge- ausdruck$	Ein beliebiger Zeichenfolgeausdruck
Verwenden Sie diese Funktion, um Leerzeichen vor einem Zeichenfolgeausdruck zu entfernen.

Beispiel:	Dieses Beispiel realisiert vereinfacht die bündige Darstellung eines Textes.
spalte$ = InputBox$(“Geben Sie die Spaltenbreite einer Textzeile an (40, 80)“)

spaltenbreite% = Val(spalte$)

If spaltenbreite% = 40 Or spaltenbreite% = 80 Then   ‘Spaltenbreite im

                                                     ‘geforderten Bereich?

   DIM breite AS StrING * spaltenbreite%             ‘Zeichenfolge, die die

                                                     ‘Spaltenbreite aufnimmt.

   meldung$ = “|“ + breite + “|“

   eingabe$ = InputBox$(“Geben Sie ein beliebiges Wort ein.“)

   RSet breite = eingabe$                            ‘Rechtsbündige Anordnung

                                                     ‘der Eingabe mit RSet.

   meldung$ = meldung$ + Chr$(13) + “RSet Methode“ + Chr$(13)

   meldung$ = meldung$ +“|“ + eingabe$ + “|“

   eingabe$ = LTrim$(eingabe$)                       ‘Linksbündige Anordnung

                                                     ‘der Eingabe, durch Ent-
                                                     ‘fernen der vorangehenden

                                                     ‘Leerzeichen.

   meldung$ = meldung$ + Chr$(13) + “LTrim$ Methode“ + Chr$(13)

   meldung$ = meldung$ +“|“ + eingabe$ + “|“

   LSet breite = eingabe$                            ‘Linksbündige Anordnung

                                                     ‘der Eingabe mit LSet

   meldung$ = meldung$ + Chr$(13) + “LSet Methode“ + Chr$(13)

   meldung$ = meldung$ +“|“ + eingabe$ + “|“

   eingabe$ = RTrim$(eingabe$)                       ‘Rechtsbündige Anordnung

                                                     ‘der Eingabe durch Entfer-
                                                     ‘nen der nachstehenden
                                                     ‘Leerzeichen.

   meldung$ = meldung$ + Chr$(13) + “RTrim$ Methode“ + Chr$(13)

   meldung$ = meldung$ +“|“ + eingabe$ + “|“

   MsgBox meldung$

EndIf

Siehe auch:	Zeichenfolgenfunktionen


Zeichenfolgenfunktionen
Mid$-Funktion, Mid$-Anweisung

Funktion:	Ergibt einen Teilbereich eines Zeichenfolgeausdrucks (Mid$-Funktion) oder ersetzt einen Teilbereich eines Zeichenfolgeausdrucks (Mid$-Anweisung).
Syntax:	Mid$(zeichenfolge-ausdruck$, anfang% [,laenge%]) oder Mid$(zeichenfolge-ausdruck$, anfang% [, laenge%]) = zeichenfolgevariable$
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck.
	anfang%	Numerischer Ausdruck, der die Position des ersten Zeichens innerhalb der Zeichenfolge aufnimmt.
	laenge%	Numerischer Ausdruck, der die Anzahl der Zeichen, die ermittelt oder ersetzt werden sollen bezeichnet.
	zeichenfolgen- variable$	Die Zeichenfolge, die den Zeichenfolgeausdruck ersetzen soll (Mid$-Anweisung).
Entfällt bei der Mid$-Funktion die Angabe zu laenge%, werden alle Zeichen ab der angegebenen Position bis zum letzten Zeichen der Zeichenfolge ermittelt. Wird laenge% bei der Mid$-Anweisung nicht angegeben, wird der gesamte zu ersetzende Text in die Zeichenfolge eingefügt. Ist laenge% bei der Mid$-Anweisung kleiner als die Länge des zu ersetzenden Textes, wird dieser auch nur in dem angegebenen Ausmaß ersetzt.

Beispiel:	siehe InStr-Funktion , siehe Left$-Funktion ,

Siehe auch:	Zeichenfolgenfunktionen , Left$-Funktion , Right$-Funktion


Zeichenfolgenfunktionen
Right$-Funktion

Funktion:	Kürzt einen Zeichenfolgeausdruck auf eine angegebene Anzahl von Zeichen. Den Ausgangspunkt hierfür bildet das erste rechte Zeichen der Folge.
Syntax:	Right$(zeichenfolge-ausdruck$, n%)
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	beliebiger Zeichenfolgeausdruck
	n%	Beliebiger Integer-Ausdruck, der die Anzahl der Zeichen bestimmt, auf die der Zeichenfolgeausdruck verkürzt werden soll.
Beispiel:	siehe Left$-Funktion

Siehe auch:	Zeichenfolgenfunktionen , Left$-Funktion , Mid$-Funktion, Mid$-Anweisung


Zeichenfolgenfunktionen
RSet-Anweisung

Funktion:	Ordnet eine Zeichenkette rechtsbündig innerhalb einer Zeichenfolgevariable an oder kopiert einen benutzerdefinierten Variablentyp in einen anderen.
Syntax:	RSet zeichenfolgevariable$ = zeichenkette oder RSet variable1 = variable2
Parameter	Beschreibung
zeichenfolgevariable$	Beliebige Zeichenfolgevariable.
zeichenkette	Zeichenkette, die rechtsbündig in der Zeichenfolgevariable angeordnet werden soll.
variable1	Benutzerdefinierte Variable, in die eine andere kopiert werden soll.
variable2	Benutzerdefinierte Variable, die in eine andere kopiert werden soll.
Ist die Zeichenkette kürzer als die Zeichenfolgevariable, ordnet die RSet-Anweisung die Zeichenkette rechtsbündig in der Zeichenfolgevariable an. Die freien Stellen der Zeichenfolgevariable werden mit Leerzeichen aufgefüllt. Ist die Zeichenkette länger, werden nur soviele Zeichen der Zeichenkette rechtsbündig in der Zeichenfolgevariable angeordnet, wie diese aufnehmen kann.

Außerdem ist es mit der RSet-Anweisung möglich, eine benutzerdefinierte Variable einer anderen zuzuweisen.

Beispiel:	Das folgende Programm erläutert die RSet- und LSet-Anweisung anhand der rechts- und linksbündigen Anordnung einer Zeichenkette in eine andere Anordnung. Geben Sie dazu bitten nach dem Programmstart einen kurzen Satz ein:
Eingabe$ = InputBox$("Bitte geben Sie einen kurzen Satz ein:")

Dim z_folg_var As String * 100	‘ Definition der Größe der

‘ Zeichenfolgenvariable, die

‘ die Zeichenkette bündig auf-

‘ nehmen soll.

Meldung$ = "Normale Zeichenkettendarstellung:"

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + Eingabe$

Meldung$ = Meldung$ + Chr$(13)

Meldung$ = Meldung$ + "Darstellung nach Anwendung von RSet:"

Meldung$ = Meldung$ + Chr$(13)

RSet z_folg_var = Eingabe$	‘ Rechtsbündige Anordnung

‘ der Zeichenkette.

Meldung$ = Meldung$ + z_folg_var

Meldung$ = Meldung$ + Chr$(13)

    Meldung$ = Meldung$ + "Darstellung nach Anwendung von LSet:"

Meldung$ = Meldung$ + Chr$(13)

LSet z_folg_var = Eingabe$	‘ Linksbündige Anordnung

‘ der Zeichenkette.

Meldung$ = Meldung$ + z_folg_var

MsgBox Meldung$

Siehe auch:	Zeichenfolgenfunktionen ,


Zeichenfolgenfunktionen
RTrim$-Funktion

Funktion:	Entfernt alle Leerzeichen am Ende eines Zeichenfolgeausdrucks.
Syntax:	RTrim$(zeichenfolge-ausdruck$)
Parameter	Beschreibung
zeichenfolge- ausdruck$	Beliebiger Zeichenfolgeausdruck
Verwenden Sie diese Funktion, um Leerzeichen hinter einem Zeichenfolgeausdruck zu entfernen.

Beispiel:	siehe LTrim$-Funktion

Siehe auch:	Zeichenfolgenfunktionen , LTrim$-Funktion


Zeichenfolgenfunktionen
Space$-Funktion

Funktion:	Ergibt eine Zeichenfolge, bestehend aus Leerzeichen
Syntax:	Space$(n%)
	Parameter	Beschreibung
	n%	Numerischer Ausdruck, der die Anzahl der Leerzeichen in der Zeichenfolge festlegt.
Siehe auch:	Zeichenfolgenfunktionen , String$-Funktion


Zeichenfolgenfunktionen
Str$-Funktion

Funktion:	Wandelt einen numerischen Ausdruck in eine Zeichenfolge um.
Syntax:	Str$(ausdruck)
	Parameter	Beschreibung
	ausdruck	Ein beliebiger numerischer Ausdruck
Mit der Str$-Funktion ist es möglich, Rechenergebnisse oder den Inhalt numerischer Variablen in Zeichenfolgen umzuwandeln und bei Bedarf einzubinden. Negativen numerischen Ausdrücken wird dabei ein Minuszeichen vorangestellt. Beachten Sie aber bitte, daß die Str$-Funktion bei einem positiven numerischen Ausdruck ein Leerzeichen (anstelle des Plus-Zeichens) vor die zurückgegebene Zeichenfolge setzt.

Siehe auch:	Zeichenfolgenfunktionen , Asc-Funktion , Variablenfunktionen , CBool-Funktion , CDate-Funktion , CDbl-Funktion , CreateObject-Funktion


Zeichenfolgenfunktionen
StrComp-Funktion

Funktion:	Vergleicht zwei Zeichenfolgeausdrücke miteinander und liefert als Ergebnis zurück, ob sie gleich waren, ob ein Leerstring dabei war, oder ob der eine Ausdruck länger bzw. kürzer war als der andere.
Syntax:	StrComp(zeichenfolgeausdruck1$,zeichenfolgeausdruck2$ [,compare])
Parameter	Beschreibung
zeichenfolge- ausdruck1$	Beliebiger Zeichenfolgeausdruck, der mit dem im folgendenen übergebenen verglichen werden soll.
Zeichenfolge- ausdruck1$	Beliebiger Zeichenfolgeausdruck, der mit dem zuvor übergebenen verglichen werden soll.
Compare	Bestimmt die Vergleichsmethode. Dieses Argument ist optional. Wenn compare 0 ist, wird die Groß-/Kleinschreibung beim Vergleich berücksichtigt. Ist compare 1, wird sie hingegen nicht berücksichtigt (d.h., daß beispielsweise ein „K“ genaueso wie ein „k“ behandelt wird).
Mit Hilfe dieser Funktion vergleichen Sie zwei Zeichenfolgen miteinander. Verglichen werden dabei die Wertigkeiten der Buchstaben nach den Telefonbuch-Sortierregeln, bzw. nach denen durch das Argument compare bestimmten Konventionen.

Die Funktion liefert Ganzzahlenwerte zwischen -1 und 1, sowie Null zurück, um das Ergebnis des Vergleichs anzuzeigen.

	Rückgabewert	Beschreibung
	-1	Die erste Zeichenfolge ist kleiner als die zweite (z.B. „Maier“ und „Müller“)
	0	Die erste Zeichenfolge entspricht der zweiten (z.B. „Maier“ und „Maier“).
	1	Die erste Zeichenfolge ist größer als die zweite (z.B. „Müller“ und „Maier“)
	Null	Einer der beiden Zeichenfolge war ein Leerstring („“, Null-String), z.B. „Peters“ und „“.
Beispiel:	Das folgende Beispiel sortiert ein Zeichenfolgefeld, dem zuvor 10 Nachnamen zugewiesen wurden, mit Hilfe der StrComp-Funktion.
Static a$(10), z%, z2%, temp$

a$(1) = "Klaus"

a$(2) = "Uwe"

a$(3) = "Thorsten"

a$(4) = "Manfred"

a$(5) = "Erwin"

a$(6) = "Timo"

a$(7) = "Karsten"

a$(8) = "Regina"

a$(9) = "Christiane"

a$(10) = "Uta"

z% = 1

Do

    z2% = z% + 1

    Do

        If StrComp(a$(z%), a$(z2%)) = 1 Then

            temp$ = a$(z%)

            a$(z%) = a$(z2%)

            a$(z2%) = temp$

        End If

        z2% = z2% + 1

    Loop Until z2% = 11

    z% = z% + 1

Loop Until z% = 10

For z% = 1 To 10

    Print a$(z%)

Next z%

Siehe auch:	Zeichenfolgenfunktionen


Zeichenfolgenfunktionen
String$-Funktion

Funktion:	Ergibt eine Zeichenfolge der angegebenen Länge, bestehend aus dem angegebenen Zeichen.
Syntax:	String$(laenge%, {ausdruck% | zeichenfolgen-ausdruck$})
	Parameter	Beschreibung
	ausdruck%	Numerischer Ausdruck, bezeichnet den ASCII-Code des Zeichens, aus dem die Zeichenfolge bestehen soll.
	zeichenfolge- ausdruck$	Zeichen oder Zeichenfolge, aus dem die Zeichenfolge bestehen soll.
Siehe auch:	Space$-Funktion , Zeichenfolgenfunktionen


UCase$-Funktion

Funktion:	Wandelt alle Zeichen einer Zeichenfolge in Großbuchstaben um.
Syntax:	UCase$(zeichenfolge-ausdruck)
	Parameter	Beschreibung
	zeichenfolge- ausdruck$	Beliebiger Zeichenfolgenausdruck, der bearbeitet werden soll.
Die UCase-Funktion wandelt alle Zeichen einer Zeichenfolge in Großbuchstaben um. Angetastet werden dabei natürlich nur die kleingeschriebenen Buchstaben des Alphabets, die sich in der Zeichenfolge befinden. Großbuchstaben und alle sonstigen Zeichen bleiben unverändert.

Siehe auch:	Zeichenfolgenfunktionen


Val-Funktion

Funktion:	Wandelt eine Zeichenfolge in einen numerischen Ausdruck um.
Syntax:	Val(zeichenfolge-ausdruck$)
Parameter	Beschreibung
zeichenfolge- ausdruck$	Eine Zeichenfolge, die eine Zahl darstellt
Mit der Val-Funktion ist es möglich, Zeichenfolgen, die Zahlen darstellen, in numerische Ausdrücke umzuwandeln. Sie bildet damit das Gegenstück zur Str$-Funktion. Besteht die Zeichenfolge nur teilweise aus in numerischen Ausdrücken umwandelbaren Zeichen, werden nur die ersten möglichen Zeichen der Zeichenfolge umgewandelt. Handelt es sich bei der Zeichenfolge um einen gar nicht übersetzbaren Ausdruck, liefert die Val-Funktion das Ergebnis 0 zurück.

Siehe auch:	Zeichenfolgenfunktionen ,Asc-Funktion , Variablenfunktionen , CBool-Funktion , CDbl-Funktion , CreateObject-Funktion


Dialogbox-Referenz
 Dialogboxelemente, -eigenschaften, -ereignisse und -methoden

A

Activate-Ereignis

AddItem-Methode

Alignment-Eigenschaft

Auto3D-Eigenschaft

B

BackColor-Eigenschaft

BackStyle-Eigenschaft

Border-Eigenschaft

C

Cancel-Eigenschaft

Caption-Eigenschaft

Change-Eigenschaft

Change-Ereignis

CheckBox-Steuerelement

Clear-Methode

Click-Ereignis

Cls-Methode

ComboBox-Steuerelement

CommandButton-Steuerelement

CurrentStep-Eigenschaft

CurrentX-Eigenschaft; CurrentY-Eigenschaft

D

DblClick-Ereignis

Deactivate-Ereignis

Default-Eigenschaft

Dialog-Objekt

DrawBox-Methode

DrawEllipse-Methode

DrawLine-Methode; DrawLineTo-Methode

DrawMode-Eigenschaft

DrawPicture-Methode

DrawPoint-Methode

DrawStyle-Eigenschaft

DrawText-Methode

DrawWidth-Eigenschaft

E

Enabled-Eigenschaft

F

FillStyle-Eigenschaft

FontBold-Eigenschaft

FontItalic-Eigenschaft

FontName-Eigenschaft

FontSize-Eigenschaft

FontUnderline-Eigenschaft

ForeColor-Eigenschaft

FrameControl-Steuerelement

G

GetPoint-Methode

GetTextHeight-Methode; GetTextWidth-Methode

GotFocus-Ereignis

H

Height-Eigenschaft

HelpContextId-Eigenschaft

HelpText-Eigenschaft

Hide-Methode

HScrollBar-Steuerelement

I

ItemData-Eigenschaft

K

KeyDown-Ereignis

KeyPress-Ereignis

KeyUp-Ereignis

L

Label-Steuerelement

LargeChange-Eigenschaft; SmallChange-Eigenschaft

Left-Eigenschaft

ListBox-Steuerelement

ListCount-Eigenschaft

List-Eigenschaft

ListIndex-Eigenschaft

Load-Ereignis

Load-Methode

LostFocus-Ereignis

M

Max-Eigenschaft

MaxLength-Eigenschaft

Min-Eigenschaft

MouseDown-Ereignis

MouseMove-Ereignis

MousePointer-Eigenschaft

MouseUp-Ereignis

Move-Methode

MultiLine-Eigenschaft

MultiSelect-Eigenschaft

N

Name-Eigenschaft

NewIndex-Eigenschaft

O

OptionButton-Steuerelement

P

Paint-Ereignis

PasswordChar-Eigenschaft

Preview-Steuerelement

R

ReadOnly-Eigenschaft

Refresh-Methode

RemoveItem-Methode

Resize-Ereignis

S

ScrollBars-Eigenschaft

Scroll-Ereignis

Selected-Eigenschaft

SelLength-Eigenschaft

SelStart-Eigenschaft

SelText-Eigenschaft

SetFocus-Methode

SmallChange-Eigenschaft

Sorted-Eigenschaft

SpinButton-Steuerelement

SpinDown-Ereignis; SpinUp-Ereignis

Step-Eigenschaft

StrikeOut-Eigenschaft

StrikeThrough-Eigenschaft

Style-Eigenschaft

T

TabIndex-Eigenschaft

TabStop-Eigenschaft

Tag-Eigenschaft

TextBox-Steuerelement

Text-Eigenschaft

Top-Eigenschaft

TopIndex-Eigenschaft

U

Underline-Eigenschaft

UseMnemonic-Eigenschaft

V

Value-Eigenschaft (CheckBox|OptionButton|CommandButton)

Value-Eigenschaft (HScrollBar|VScrollBar|SpinButton}

Visible-Eigenschaft

VScrollBar-Steuerelement

W

Width-Eigenschaft

WordWrap-Eigenschaft


Dialogbox-Referenz
Activate-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn der aktuelle Dialog fokussiert wird.
Sub-Definition:	Sub DialogName_Activate
Für DialogElement:	Dialog
Das Activate-Ereignis wird dann ausgelöst, wenn der betreffende Dialog den Fokus erhält. Das ist der Fall, wenn der Dialog das erste Mal aufgerufen wurde oder aber wenn der aktuell angezeigte Dialog den Fokus verloren hat (z.B. weil ein anderes Fenster oder eine andere Applikation angeklickt und damit fokussiert wurde) und der Dialog anschließend wieder aktiviert wurde.

Siehe auch:	Dialogbox-Referenz , CurrentStep-Eigenschaft,  CurrentX-Eigenschaft; CurrentY-Eigenschaft,  Deactivate-Ereignis,  Hide-Methode,  Load-Ereignis,  Load-Methode,  Step-Eigenschaft,  UseMnemonic-Eigenschaft


Dialogbox-Referenz
AddItem-Methode

Funktion:	Fügt einen Eintrag einem Listenfeld oder einem Kombinationslistenfeld hinzu.
Syntax:	ListBoxName.AddItem String$[,Position%]
Für Dialog-Element:	ListBox, ComboBox
	Parameter	Beschreibung
	String$	Beliebiger Zeichenkettenausdruck, der den hinzuzufügenden Text enthält.
	Position%	Optionaler Integer-Ausdruck, der bestimmt, an welcher Position der neue Eintrag eingefügt werden soll.
Wird der Ausdruck Position% mit angegeben, so wird ein Eintrag an der sich aus dem Ausdruck ergebenden Position eingefügt. Die Nummerierung der Einträge findet von 0 bis n statt, wobei n die Anzahl aller vorhandenen Einträge -1 beschreibt. Die Anzahl der vorhandenen Einträge läßt sich mit der .LISTCOUNT-Eigenschaft ermitteln.

Beispiel:	Das folgende Beispiel finden Sie in der StarWriter-Tutor-Datei „LISTBOX.SDW“ im Tutorverzeichnis. Es demonstriert die Möglichkeiten von ListBoxen und sortierten ListBoxen.
'Programm generiert 20 Zufallszahlen und überträgt sie

'in zwei ListBoxen. Eine ListBox ist sortiert, die an-

'dere nicht. Wird ein Element der sortierten angeklickt,

'wird das selbe Element der anderen angewählt.

option explicit

dim IntArray(1 to 20) as Integer	'Hier werden die Werte generiert

Sub ListBoxDemo

ListBoxDemoDialog.Show	'Dialog aufrufen

End Sub

Sub WerteGenerieren

dim z%	'Zählvariable

for z%=1 to 20

'Werte zwischen 1000 und 2000 erzeugen

IntArray(z%)=int(Rnd(1)*1000)+1000

next z%

for z%=1 to 20

'In ListBoxen übertragen

ListBox1.AddItem Str$(IntArray(z%)),ListBox1.ListCount

ListBox2.AddItem Str$(IntArray(z%)),ListBox2.ListCount

'Und von StarBasic sortierten Index generieren

ListBox2.ItemData(ListBox2.NewIndex)=(z%-1)

next z%

End Sub

Sub ListBoxDemoDialog_Load

'Wenn Dialog dargestellt wird,

'Werte generieren und in ListBoxen

'übertragen

WerteGenerieren

End Sub

Sub CommandButton2_Click

'Wenn "Neue Werte" angeklickt wird,

'Inhalte der ListBoxen löschen

ListBox1.Clear

ListBox2.Clear

'und mit neuen Werten füllen

WerteGenerieren

End Sub

Sub ListBox2_Click

'Wenn Eintrag in sortierter Box angeklickt, dann

'durch das ItemData-Index korrelierenden Eintrag

'in unsortierter ListBox anwählen

ListBox1.ListIndex=ListBox2.ItemData(ListBox2.ListIndex)

End Sub

Sub CommandButton1_Click

'Wenn OK, dann Programm beenden,

'indem Dialog geschlossen wird.

ListBoxDemoDialog.Hide

End Sub

Siehe auch:	Dialogbox-Referenz , Clear-Methode, ItemData-Eigenschaft, List-Eigenschaft, ListCount-Eigenschaft, ListIndex-Eigenschaft, MultiSelect-Eigenschaft, NewIndex-Eigenschaft, RemoveItem-Methode, Selected-Eigenschaft, SelLength-Eigenschaft, Sorted-Eigenschaft, Style-Eigenschaft, TopIndex-Eigenschaft


Dialogbox-Referenz
Alignment-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Textausrichtung innerhalb des aufgezogenes Rahmens eines Label- oder TextBox-Dialogboxelementes.
Syntax:	TextElementName.Alignment [=Align%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Label, TextBox
	Parameter	Beschreibung
	Align%	Beliebiger Integer-Ausdruck, der bestimmt, ob der Text linksbündig (Align%=0), zentriert (Align%=1) oder rechtsbündig (Align%=2) im vorgegebenen Rahmen angeordnet werden soll.
Achtung: Die Alignment-Eigenschaft funktioniert für das TextBox-Steuerelement, wenn die MultiLine-Eigenschaft aktiviert ist.

Beispiel:	Das folgende Beispiel finden Sie in der StarWriter-Tutor-Datei „ALIGN.SDW“ im Tutorverzeichnis. Es demonstriert die verschiedenen Möglichkeiten, Text im TextBox- und Label-Dialogboxelement auszurichten.


Dialogbox-Referenz
Auto3D-Eigenschaft

Funktion:	Definiert, ob der StarDivision 3D-Look & Feel in Dialogboxen verwendet werden soll oder nicht.
Syntax:	DialogName.Auto3D=TRUE
Lesezugriff:	Lese- und Schreibzugriff nur bei der Dialogerstellung.
Achtung: Die Auto3D-Eigenschaft ist voreingestellt auf TRUE gesetzt. Bitte beachten Sie, daß die BackColor- und ForeColor- sowie die BackStyle- und Border-Eigenschaft keine sichtbaren Auswirkungen haben, wenn die Auto3D-Eigenschaft eingeschaltet (=TRUE) ist.

Für Dialog-Element:	Dialog


Dialogbox-Referenz
BackColor-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Hintergrundfarbe des entsprechenden Dialogboxelementes.
Syntax:	ElementName.BackColor [=Color&]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	Color&	Beliebiger Long-Integer-Ausdruck, der die Farbe bestimmt. Der Wert wird mit Hilfe der RGB-Funktion (siehe Basic-Referenz) berechnet und setzt sich aus prozentual verschiedenen Rot-, Grün- und Blau-Anteilen zusammen.
Achtung: Bitte beachten Sie, daß das Verändern dieser Eigenschaft keine Auswirkungen hat, solange die Auto3D-Eigenschaft auf TRUE gesetzt ist.

Siehe auch:	Dialogbox-Referenz , BackStyle-Eigenschaft , ForeColor-Eigenschaft


Dialogbox-Referenz
BackStyle-Eigenschaft

Funktion:	Bestimmt oder ermittelt für das Label-Element, ob der Hintergrund „durchscheint“  oder nicht.
Syntax:	LabelName.BackStyle [=Style%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Label
	Parameter	Beschreibung
	Style%	Beliebiger Integer-Ausdruck, der bestimmt, ob der Hintergrund durchscheinen soll (0 - Tranparent) oder nicht (1 - Opaque).
Achtung: Bitte beachten Sie, daß das Verändern dieser Eigenschaft keine Auswirkungen hat, solange die Auto3D-Eigenschaft auf TRUE gesetzt ist.

Siehe auch:	Dialogbox-Referenz , BackColor-Eigenschaft , ForeColor-Eigenschaft


Dialogbox-Referenz
Border-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob das entsprechende Element einen sichtbaren Rahmen hat oder nicht.
Syntax:	ElementName.Border [=BorderStyle]
Lesezugriff:	Lese- und Schreibzugriff zur Dialogerstellung.
Für Dialog-Element:	TextBox, Label, Preview
	Parameter	Beschreibung
	BorderStyle	Boolscher Ausdruck, der bestimmt, ob ein Rahmen um das Element gezeichnet sein soll (BorderStyle=TRUE) oder nicht (BorderStyle=FALSE).


Dialogbox-Referenz
Cancel-Eigenschaft

Funktion:	Definiert oder ermittelt, ob eine bestimmte Schaltfläche eines Dialogs „Abbruchcharakter“ haben soll oder nicht.
Syntax:	CommandButtonName.Cancel[=Cancel]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CommandButton
	Parameter	Beschreibung
	Cancel	Boolscher Ausdruck, der bestimmt, ob die Schaltfläche Abbruchcharakter hat (Cancel=TRUE, anderenfalls FALSE).
Hat eine Schaltfläche in einem Dialog Abbruchcharakter, wird das Click-Ereignis der Schaltfläche ausgelöst, wenn der Dialog über die SCHLIEßEN-Schaltfläche in der Titelzeile des Dialogs geschlossen wird. Vor dem Schließen wird dann das CLICK-Ereignis der Schaltfläche ausgeführt. Da jeder Dialog mit (Esc) geschlossen werden kann, wird das CLICK-Ereignis der betroffenen Schaltfläche auch dann ausgeführt, wenn diese Taste gedrückt wird und die CANCEL-Eigenschaft der Schaltfläche zuvor auf TRUE gesetzt wurde.

Achtung: Die CANCEL-Eigenschaft darf nur einer Schaltfläche im Dialog zugewiesen werden. Wird die CANCEL-Eigenschaft einer Schaltfläche gesetzt, wird die einer eventuell gesetzten anderen Schaltfläche gelöscht. Gleichzeitig wird die eventuell eingeschaltete DEFAULT-Eigenschaft des gleichen COMMANDBUTTONS ausgeschaltet.

Siehe auch:	Dialogbox-Referenz , Default-Eigenschaft, Cancel-Eigenschaft, Default-Eigenschaft


Dialogbox-Referenz
Caption-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Beschriftung eines Dialogboxelementes. Bei der Definition werden zusätzlich Acceleratoren (Kurztasten) für die entsprechenden oder im TABINDEX nachfolgenden Elemente zur Bedienung über die Tastatur festgelegt.
Syntax:	ElementName.Caption[=String$]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, Dialog, TextBox, Label, FrameControl, CommandButton, OptionButton
	Parameter	Beschreibung
	String$	Beliebiger Stringausdruck, der 255 Zeichen nicht überschreiten darf, und der den Beschriftungstext festlegt.
Mit der CAPTION-Eigenschaft definieren Sie die Beschriftung des entsprechenden Dialogelementes. Die CAPTION-Eigenschaft leistet allerdings noch etwas anderes: Innerhalb des Beschriftungstextes können Sie einen sogenannten Shortcur definieren, mit dessen Hilfe der Anwender später, beim Ablauf und der Bedienung Ihres Programms direkt per Tastenkürzel ein Element Ihres Dialoges anwählen kann. Um ein Element mit der Tastatur anwählbar zu machen, muß sich innerhalb des Beschriftungstextes der Buchstabe wenigstens einmal befinden, mit dessen Hilfe der Anwender die Bedienung vornehmen kann. Vor dem Buchstaben muß ferner das Kaufmannsundzeichen („&“) gesetzt werden. Anstelle dieses Kaufmannsund erscheint im Dialog der entsprechende Buchstabe als Hinweis auf die Tastaturbedienbarkeit unterstrichen.

Hinweis: Einige Kontrollelemente – wie zum Beispiel Listenfelder – besitzten keine CAPTION-Eigenschaft. In diesem Falle muß die Beschriftung durch ein zusätzliches Label-Element erfolgen. Dieses Label-Element muß in der TABINDEX-Reihenfolge (siehe TABINDEX-Eigenschaft) direkt vor dem entsprechenden Element positioniert sein. Da das Label-Element zwar eine CAPTION-Eigenschaft hat, aber selber nicht fokussiert werden kann, fokussiert StarBasic automatisch das in der TABINDEX-Reihenfolge am nächsten liegende und fokussierbare Dialogboxelement.

Beispiel:	Verwenden Sie zum Nachvollziehen der Caption-Eigenschaft den Dialog-Aufbau des Programms, das sich in der Datei „LISTBOX.SDW“ befindet. Dieses Beispiel dient zwar in erster Linie zur Demonstration von Listenfeldern und deren Möglichkeiten, bedient sich aber zur Steuerung des Dialoges über die Tastatur der hier besprochenen Sachverhalte.
Siehe auch:	Dialogbox-Referenz , Text-Eigenschaft


Dialogbox-Referenz
Change-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Schrittweite des Werte-Inkrementierens oder Dekrementierens für das SpinButton-Element.
Syntax:	SpinButtonName.Change[=Step%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	SpinButton
	Parameter	Beschreibung
	Step%	Beliebiger Integer-Ausdruck, der definiert, um welchen Wert die VALUE-Eigenschaft des entsprechenden SpinButtons erhöht bzw. vermindert wird, wenn der Anwender eine der Pfeil-Schaltflächen betätigt.


Dialogbox-Referenz
Change-Ereignis

Zeitpunkt:	Wird ausgelöst, sobald sich der Text eines Eingabefeldes (TextBox, ComboBox, Label) oder die Position eines Schiebebalkens (HScrollBar, VSCrollBar) ändert.
Sub-Definition:	Sub ElementName_Change
Für DialogElement	ComboBox, TextBox, Label, HScrollBar, VScrollBar
Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
CheckBox-Steuerelement

Funktion:	Ermöglicht dem Anwender die Auswahl einer oder mehrere Optionen einer Gruppe.
Eigenschaften:	BackColor, Border, Caption, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Parent, Step, TabIndex, TabStop, Tag, Top, Value, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	Click, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, MouseDown, MouseMove, MouseUp
Beispiel:	Das folgende Beispiel demonstriert einige Font-Darstellungsmöglichkeiten von StarBasic in Dialogen mit Hilfe von CheckBox-Dialogelementen.
Sub FontTest

FontTestDialog.Show

End Sub

'OptionButton-Click-Event

Sub Linksbuendig_Click

Label.Alignment=0

End Sub

'OptionButton-Click-Event

Sub Zentriert_Click

Label.Alignment=1

End Sub

'OptionButton-Click-Event

Sub Rechtsbuendig_Click

Label.Alignment=2

End Sub

'CheckBox Click Event

Sub Fettschrift_Click

'Zustände eines Buttons kann direkt zugewiesen werden...

Label.FontBold=Fettschrift.Value

End Sub

'CheckBox Click Event

Sub Kursivschrift_Click

Label.FontItalic=Kursivschrift.Value

End Sub

'CheckBox Click Event

Sub Unterstrichen_Click

'...man kann das Programmverhalten natürlich

'auch vom Zustand abhängig machen.

'In diesem Fall macht das natürlich nicht

'unbedingt sinn, da der Zustand des OptionButtons

'genau dem Zustand der entsprechenden Schrift

'entspricht (TRUE oder FALSE)

if Unterstrichen.Value=TRUE then

Label.FontUnderline=TRUE

else

Label.FontUnderLine=FALSE

endif

End Sub

'CheckBox Click Event

Sub Durchgestrichen_Click

End Sub

Sub Schliessen_Click

Hide

End Sub


Dialogbox-Referenz
Clear-Methode

Funktion:	Löscht den Inhalt der Zwischenablage oder den Inhalt eines Listenfeldes bzw. Kombinationslistenfeldes.
Syntax:	ElementName.Clear
Für Dialog-Element:	Clipboard, ComboBox, ListBox
Siehe auch	AddItem-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft , MultiSelect-Eigenschaft , NewIndex-Eigenschaft , RemoveItem-Methode , Selected-Eigenschaft , SelLength-Eigenschaft , Sorted-Eigenschaft , Style-Eigenschaft , TopIndex-Eigenschaft


Dialogbox-Referenz
Click-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn der Anwender das entsprechende Dialogboxelement anklickt.
Sub-Definition:	Sub ElementName_Click
Für DialogElement:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
Siehe auch:	Dialogbox-Referenz , DblClick-Ereignis , MouseDown-Ereignis , MouseMove-Ereignis , MousePointer-Eigenschaft , MouseUp-Ereignis


Dialogbox-Referenz
Cls-Methode

Funktion:	Löscht den Inhalt der Preview
Syntax:	PreviewElementName.Cls
Für Dialog-Element:	Preview
Beispiel:	Siehe Preview-Beispiel
Siehe auch:	Dialogbox-Referenz , DrawBox-Methode , DrawEllipse-Methode , DrawLine-Methode; DrawLineTo-Methode , DrawPicture-Methode , DrawPoint-Methode , DrawText-Methode , DrawWidth-Eigenschaft , FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
ComboBox-Steuerelement

Funktion:	Ermöglicht dem Anwender, aus einer herunterklappbaren Liste einen oder mehrere Einträge auszuwählen. Durch die STYLE-Eigenschaft ist das grundsätzliche Aussehen und Verhalten einer ComboBox veränderbar.
Eigenschaften:	BackColor, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, ItemData, Left, List, ListCount, ListIndex, ListRange, MousePointer, Name, NewIndex, Parent, SelLength, SelStart, SelText, Sorted, Step, Style, TabIndex, TabStop, Tag, Text, Top, Visible, Width
Methoden:	AddItem, Clear, Move, Refresh, RemoveItem, SetFocus
Ereignisse:	Change, Click, DblClick, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus


Dialogbox-Referenz
CurrentStep-Eigenschaft

Funktion:	Bestimmt bzw. ermittelt die Nummer des angezeigten Teildialoges für „Assistentendialogtypen“.
Syntax:	DialogName.CurrentStep=StepNo%
Für Dialog-Element:	Dialog
	Parameter	Beschreibung
	StepNo%	Beliebiger Intgerausdruck, der die Nummer des Teildialoges bestimmt.
StarBasic erlaubt es, sogenannte Assistenzdialoge zu erstellen. Ein Assistenzdialog ist ein Dialogtyp, der fest auf dem Bildschirm bestehen bleibt, aber sein Aussehen je nach Abarbeitung verschiedener Optionen durch den Anwender verändert. Der jeweils nächste Schritt eines Assistenzdialogs wird in der Regel mit einer [WEITER]-Schaltfläche aufgerufen.

In StarBasic wird ein solcher Dialog folgendermaßen realisiert. Der eigentliche Dialog-Container nimmt die Dialogelemente eines jeden „Teildialogs“ aufeinmal auf. Dabei kann es natürlich vorkommen, daß sich Dialogelemente zur Dialogerstellung überlagen – was aber keine weiteren Auswirkungen hat. Bestimmte Dialogelemente erhalten durch die STEP-Eigenschaft unterschiedliche Werte. Es gilt: Dialogelemente, die zu einem bestimmten Zeitpunkt gleichzeitig angezeigt werden sollen, erhalten denselben Wert.

Zur Laufzeit sorgt der Programmierer dafür, daß der jeweils nächste Schritt durch entsprechende Maßnahmen des Anwenders (in der Regel einen Klick auf die [WEITER]-Schaltfläche) angezeigt wird. Dazu ist es lediglich notwendig, die CURRENTSTEP-Eigenschaft des Dialoges auf den jeweils nächsten Wert zu erhöhen. Dialogelemente, die diesen Wert nicht besitzen, werden ausgeblendet, Dialogelemente, die diesem Wert jetzt entsprechen, werden dabei automatisch eingeblendet. Wurde die Bestimmung eines Wertes für die STEP-Eigenschaft ausgelassen, wird das entsprechende Dialogelement unabhängig von der CURRENTSTEP-Eigenschaft immer angezeigt.

Ist CURRENTSTEP = 0, werden alle Elemente unabhängig von ihrer STEP-Eigenschaft angezeigt.

Siehe auch:	Dialogbox-Referenz , Activate-Ereignis , CurrentX-Eigenschaft; CurrentY-Eigenschaft, Deactivate-Ereignis,  Hide-Methode,  Load-Ereignis,  Load-Methode,  Step-Eigenschaft,  UseMnemonic-Eigenschaft


Dialogbox-Referenz
CurrentX-Eigenschaft; CurrentY-Eigenschaft

Funktion:	Ermittelt bzw. Bestimmt die aktuelle X- bzw. Y-Position der nächsten Ausgabeposition in der Preview.
Syntax:	PreviewName.CurrentX[=PosX%] bzw. PreviewName.CurrentY[=PosX%]
Lesezugriff:	Lese- und Schreibzugriff nur zur Laufzeit.
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	PosX%, PosY%	Beliebige Integer-Ausdrücke, die die neue Position des Cursors definieren.
Siehe auch:	Dialogbox-Referenz ,  Activate-Ereignis,  CurrentStep-Eigenschaft,  Deactivate-Ereignis,  Hide-Methode,  Load-Ereignis,  Load-Methode,  Step-Eigenschaft,  UseMnemonic-Eigenschaft


Dialogbox-Referenz
DblClick-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn der Anwender einen Doppelklick auf das entsprechende Dialogboxelement ausführt.
Sub-Definition:	Sub ElementName_DblClick
Für DialogElement	ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, OptionButton
Siehe auch:	Dialogbox-Referenz , Click-Ereignis,  MouseDown-Ereignis,  MouseMove-Ereignis,  MousePointer-Eigenschaft,  MouseUp-Ereignis


Dialogbox-Referenz
Deactivate-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn der aktuelle Dialog den Fokus verliert.
Sub-Definition:	Sub DialogName_Deactivate
Für DialogElement	Dialog
Das Activate-Ereignis wird dann ausgelöst, wenn der betreffende Dialog den Fokus verliert. Das ist der Fall, wenn der Dialog das erste Mal aufgerufen und anschließend ein anderes Fenster oder eine andere Applikation per Maus in den Vordergrund geholt und damit fokussiert wurde. Fokussieren eines Fensters oder einer Applikation bedeutet automatisch, daß das Fenster den Fokus verliert, so es ihn zuvor besaß.

Siehe auch:	Dialogbox-Referenz , Activate-Ereignis,  CurrentStep-Eigenschaft, CurrentX-Eigenschaft; CurrentY-Eigenschaft,  Hide-Methode,  Load-Ereignis,  Load-Methode,  Step-Eigenschaft,  UseMnemonic-Eigenschaft


Dialogbox-Referenz
Default-Eigenschaft

Funktion:	Bestimmt eine Schaltfläche zu der „Default“-Schaltfläche eines Dialoges, d.h., zu der Schaltfläche, die ausgelöst wird, wenn der Anwender den Dialog mit (¢) bestätigen und alle Änderungen übernehmen möchte.
Syntax:	CommandButtonName.Default[=Default]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CommandButton
Diese Eigenschaft bildet das Gegenstück zur CANCEL-Eigenschaft. Wird die DEFAULT-Eigenschaft auf TRUE gesetzt, kann das CLICK-Ereignis der entsprechenden Schaltfläche vom Anwender auch mit (¢) ausgelöst werden.

Achtung: Die DEFAULT-Eigenschaft darf nur einer Schaltfläche im Dialog zugewiesen werden. Wird die DEFAULT-Eigenschaft einer Schaltfläche gesetzt, wird die einer eventuell gesetzten anderen Schaltfläche gelöscht. Gleichzeitig wird die eventuell eingeschaltete CANCEL-Eigenschaft des gleichen COMMANDBUTTONS ausgeschaltet.

Siehe auch:	Dialogbox-Referenz ,  Cancel-Eigenschaft


Dialogbox-Referenz
Dialog-Objekt

Funktion:	Bildet den Container für alle weiteren Dialogboxsteuerelemente
Eigenschaften:	Auto3D, BackColor, Caption, CurrentStep, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Tag, Top, Visible, Width
Methoden:	Hide, Load, Move, Refresh, SetFocus, Show, Unload
Ereignisse:	Activate, Click, DblClick, Deactivate, GotFocus, KeyDown, KeyPress, KeyUp, Load, LostFocus, MouseDown, MouseMove, MouseUp, Resize, Unload
Beispiel:	Jedes der in diesem Referenzbuch gezeigten Beispiele hat einen Dialog zur Basis. Eine spezielles Beispiel sollte daher nicht notwendig sein.


Dialogbox-Referenz
DrawBox-Methode

Funktion:	Zeichnet ein Rechteck oder ein Quadrat im PREVIEW-Dialogelement. Die Koordinaten werden in der Maßeinheit Twips angegeben.
Syntax:	PreviewName.DrawBox Left%, Top%, Right%, Bottom%
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	Left%	Beliebiger Integer-Ausdruck, der die Position der linken Seite des Rechtecks definiert.
	Top%	Beliebiger Integer-Ausdruck, der die Position der oberen Seite des Rechtecks definiert.
	Right%	Beliebiger Integer-Ausdruck, der die Position der rechten Seite des Rechtecks definiert.
	Bottom%	Beliebiger Integer-Ausdruck, der die Position der unteren Seite des Rechtecks definiert.
Beim Positionieren eines Rechtecks im PREVIEW-Element werden die Attribute berücksichtigt, die durch die DRAWMODE-, die DRAWSTYLE-, die DRAWWIDTH- und FILLSTYLE-Eigenschaften bestimmt werden können.

Tip: Sie erhalten ein exaktes Quadrat, wenn Sie die Koordinaten so wählen, daß die Differenz zwischen Bottom% und Top% und zwischen Right% und Left% die gleiche ist.

Siehe auch:	Dialogbox-Referenz , Cls-Methode,  DrawEllipse-Methode,  DrawLine-Methode; DrawLineTo-Methode,  DrawPicture-Methode, DrawPoint-Methode,  DrawText-Methode,  DrawWidth-Eigenschaft,  FillStyle-Eigenschaft,  GetPoint-Methode,  GetTextHeight-Methode; GetTextWidth-Methode,  Paint-Ereignis,  DrawMode-Eigenschaft,  DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawEllipse-Methode

Funktion:	Zeichnet eine Ellipse oder einen Kreis im PREVIEW-Dialogelement. Der Funktion werden zwei Koordinatenpaare übergeben, welche die Ausmaße eines Rechtecks bestimmen, die die zu zeichnende Ellipse exakt definieren. Die Koordinaten werden in der Maßeinheit Twips angegeben.
Syntax:	PreviewName.DrawEllipse Left%, Top%, Right%, Bottom%
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	Left%	Beliebiger Integer-Ausdruck, der die Position der linken Seite des Rechtecks definiert, das die zu zeichnende Ellipse begrenzt.
	Top%	Beliebiger Integer-Ausdruck, der die Position der oberen Seite des Rechtecks definiert.
	Right%	Beliebiger Integer-Ausdruck, der die Position der rechten Seite des Rechtecks definiert.
	Bottom%	Beliebiger Integer-Ausdruck, der die Position der unteren Seite des Rechtecks definiert.
Beim Positionieren einer Ellipse im Preview-Element werden die Attribute berücksichtigt, die durch die DRAWMODE-, die DRAWSTYLE-, die DRAWWIDTH- und FILLSTYLE-Eigenschaften bestimmt werden können.

Tip: Sie erhalten einen exakten Kreis, wenn Sie die Koordinaten so wählen, daß die Differenz zwischen Bottom% und Top% und zwischen Right% und Left% die gleiche ist.

Siehe auch:	Dialogbox-Referenz , Cls-Methode,  DrawBox-Methode,  DrawLine-Methode; DrawLineTo-Methode,  DrawPicture-Methode,  DrawPoint-Methode,  DrawText-Methode,  DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawLine-Methode; DrawLineTo-Methode

Funktion:	Zeichnet eine Linie oder Linienstrahlen im Preview-Dialogelement.  Die Koordinaten werden in der Maßeinheit Twips angegeben.
Syntax:	PreviewName.DrawLine X1%, Y1%, X2%, Y2% oder PreviewName.DrawLineTo X2%, Y2%
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	X1%, Y1%	Beliebige Integerausdrücke, die die Koordinaten des Startpunktes der Linie beschreiben. Bei der DRAWLINETO-Methode ergeben sich diese Koordinaten aus der CURRENTX- und CURRENTY-Eigenschaft.
	X2%, Y2%	Beliebige Integerausdrücke, die die Koordianten des Endpunktes der Linie beschreiben.
Beim Zeichnen einer Linie im PREVIEW-Element werden die Attribute berücksichtigt, die durch die DRAWMODE-, die DRAWSTYLE-, die DRAWWIDTH- und FILLSTYLE-Eigenschaften bestimmt werden können.

Siehe auch:	Dialogbox-Referenz ,  Cls-Methode, DrawBox-Methode, DrawEllipse-Methode, DrawPicture-Methode,  DrawPoint-Methode, DrawText-Methode, DrawWidth-Eigenschaft, FillStyle-Eigenschaft,  GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis,  DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawMode-Eigenschaft

Funktion:	Legt den Zeichenmodus für das Zeichnen mit den Preview-Zeichenmethoden fest.
Syntax:	PreviewName.DrawMode=Modus%
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	Modus%	Beliebiger Integer-Ausdruck, dessen Wert den Zeichenmodus festlegt. Es gilt:
	Wert	Bedeutung
	6	INVERT – vorhandene Farben werden durch deren Komplimentärfarben ersetzt.
	7	XOR – mit dem Bitmuster eines Pixels an jeder Position wird eine logische Exclusive-Oder-Verknüpfung (XOR) durchgeführt.
	9	AND – Mit dem Bitmuster eines Pixels an jeder Position wird eine logische Und-Verknüpfung ( AND) durchgeführt.
	10	NXOR – Mit dem Bitmuster eines Pixels an jeder Position wird eine logische Not-Exclusive-Oder-Verknüpfung (NXOR) durchgeführt.
	13	OVERPAINT – Vorhandene Pixel werden gemäß der Attributeinstellungen durch die DRAWMODE-, die DRAWSTYLE-, die DRAWWIDTH- und FILLSTYLE-Eigenschaften überschrieben.
Siehe auch:	Dialogbox-Referenz ,  Cls-Methode,  DrawBox-Methode,  DrawEllipse-Methode,  DrawLine-Methode; DrawLineTo-Methode,  DrawPicture-Methode,  DrawPoint-Methode, DrawText-Methode,  DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis,  DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawPicture-Methode

Funktion:	Lädt eine Bitmap-Datei in ein Preview-Steuerelement.
Syntax:	PreviewName.DrawPicture pict, x1, y1, x2, y2
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	pict	Object, daß durch LOADPICTURE und SET initialisiert wurde.
	y1, y1	Position an die die im pict-Objekt gespeicherte die Bilddatei im Preview-Element positioniert werden soll. Bezugspunkt ist die linke obere Ecke der Grafik.
	Y2, y2	Diese Koordinaten bestimmen die Ausmaße der Grafik.
Beispiel:	Dim pict as Object Set pict=LoadPicture(„Bilddat“) PreviewName.DrawPicture pict, 10,10,100,100
Siehe auch:	Dialogbox-Referenz ,  Cls-Methode,  DrawBox-Methode,  DrawEllipse-Methode,  DrawLine-Methode; DrawLineTo-Methode,  DrawPoint-Methode, DrawText-Methode,  DrawWidth-Eigenschaft,  FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode,  Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawPoint-Methode

Funktion:	Zeichnet einen einzelnen Pixel.
Syntax:	Preview.DrawPoint X%,Y%
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	X%,Y%	Beliebige Integerausdrücke, die die Koordinaten beschreiben, an denen der Pixel gezeichnet werden soll.
Siehe auch:	Dialogbox-Referenz , Cls-Methode, DrawBox-Methode, DrawEllipse-Methode,  DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawText-Methode, DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawStyle-Eigenschaft

Funktion:	Bestimmt die „Linienstrichelung“ die beim Zeichnen von Linien, Linienstrahlen, Rechtecken oder Ellipsen berücksichtigt werden soll.
Syntax:	PreviewName.DrawStyle=Modus%
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	Modus%	Beliebiger Integer-Ausdruck, der durch seinen Wert den Linienzeichenmodus definiert. Es gilt:
	Wert	Bedeutung
	0	SOLID – Es werden durchgezogene Linien gezeichnet.
	1	DASH – Es werden gestrichelte Linien gezeichnet
	2	DOT – Es werden gepunktete Linien gezeichnet
	3	DASHDOT – Es werden wechselnd gestrichelt-gepunktete Linien gezeichnet.
	4	DASHDOT – wie 2
	5	NULL – Es werden keine Linien gezeichnet; bei Flächenoperationen wie DrawBox, DrawEllipse oder DrawPolygone wird das entsprechende Element nicht mit einer Linie umrandet.
Siehe auch:	Dialogbox-Referenz , Cls-Methode, DrawBox-Methode, DrawEllipse-Methode, DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawPoint-Methode, DrawText-Methode, DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetPoint-Methode,GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft


Dialogbox-Referenz
DrawText-Methode

Funktion:	Positioniert eine Zeichenkette als Grafiktext im Preview-Fenster
Syntax:	Preview.DrawText X%,Y%,text$
Für Dialog-Element:	Preview
In vielen Fällen ist es notwendig, die Ausmaße der auszugebenen Zeichenkette zu kennen. Sie können in diesen Fällen die GETTEXTHEIGHT- und GETTEXTWIDTH-Eigenschaft verwenden, um die Ausmaße einer zu positionierenden Zeichenkette zu ermitteln.

	Parameter	Beschreibung
	X%, Y%	Beliebiger Integerausdrücke, die die Koordinaten repräsentieren, an denen der erste Buchstabe der Zeichenkette ausgegeben werden soll. Es gilt als Richtlinie die Unterseite des ersten Buchstabens.
	text$	Beliebiger Zeichenkettenausdruck, der im Preview-Fenster ausgegeben werden soll.
Siehe auch:	Dialogbox-Referenz ,  Cls-Methode, DrawBox-Methode, DrawEllipse-Methode, DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawPoint-Methode, DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
DrawWidth-Eigenschaft

Funktion:	Bestimmt die Linienstärke für alle Preview-Zeichenfunktionen.
Syntax:	PreviewName.DrawWidth=Width%
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	Width%	Beliebiger Integer-Ausdruck, der die Linienstärke von Linien, Linienstrahlen, Rechtecken oder Ellipsen bestimmt. Die Linienstärke wird in Twips angegeben.
Siehe auch:	Dialogbox-Referenz , Cls-Methode, DrawBox-Methode, DrawEllipse-Methode, DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawPoint-Methode, DrawText-Methode, FillStyle-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
TextBox-Steuerelement

Funktion:	Ermöglicht den Anwender einen Text – optional auch verschlüsselt – einzugeben.
Eigenschaften:	Alignment, BackColor, Border, Caption, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MaxLength, MousePointer, MultiLine, Name, Parent, PasswordChar, ReadOnly, ScrollBars, SelLength, SelStart, SelText, Step, TabIndex, TabStop, Tag, Text, Top, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	Change, Click, DblClick, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, MouseDown, MouseMove, MouseUp
Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
Enabled-Eigenschaft

Funktion:	Bestimmt, ob eines der unter Für Dialog-Elemente aufgeführten Elemente auf ein vom Anwender erzeugtes Ereignis reagiert.
Syntax:	ElementName.Enabled[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, TextBox, Label, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob eines der unter Dialog-Elemente aufgeführten Elemente auf ein vom Anwender erzeugtes Ereignis reagiert. Bool kann wie folgt gesetzt sein:
	Wert	Bedeutung
	TRUE	Das Element reagiert auf ein vom Anwender erzeugtes Ereignis.
	FALSE	Das Element reagiert nicht auf ein vom Anwender erzeugtes Ereignis.
Ein vom Anwender erzeugtes Ereignis wird beispielsweise durch die Betätigung einer Schaltfläche mit einem Mausklick ausgelöst.

Siehe auch:	Dialogbox-Referenz , Visible-Eigenschaft


Dialogbox-Referenz
FillStyle-Eigenschaft

Funktion:	Bestimmt die Schraffierung, die beim Zeichnen von Rechtecken, Ellipsen oder Polygonen berücksichtigt werden soll.
Syntax:	PreviewName.FillStyle=Modus%
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Preview
	Parameter	Beschreibung
	Modus%	Beliebiger Integer-Ausdruck, der durch seinen Wert die Art der Schraffierung definiert. Es gilt:
	Wert	Bedeutung
	0	SOLID – Flächen werden komplett ausgefüllt.
	1	NULL – Flächen werden gelöscht.
	2	HORZ – Die Schraffierung findet in Form von horizontalen Linien statt.
	3	VERT – Die Schraffierung findet in Form von vertikalen Linien statt.
	4	UPDIAG – Die Schraffierung findet in Form von diagonal aufsteigenden Linien statt.
	5	DOWNDIAG – Die Schraffierung findet in Form von diagonal abfallenden Linien statt.
	6	CROSS – Die Schraffierung findet in Form von sich horizontal und vertikale kreuzenden Linien statt.
	7	DIACROSS – Die Schraffierung findet in Form von sich diagonal kreuzenden Linien statt.
Siehe auch:	Dialogbox-Referenz , Cls-Methode,  DrawBox-Methode, DrawEllipse-Methode, DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawPoint-Methode, DrawText-Methode, DrawWidth-Eigenschaft, GetPoint-Methode, GetTextHeight-Methode; GetTextWidth-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
Label-Steuerelement

Funktion:	Zeigt einen dokumentierenden Text im Dialog an.
Eigenschaften:	Alignment, BackColor, BackStyle, Border, Caption, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Parent, Step, TabIndex, Tag, Top, UseMnemonic, Visible, Width, WordWrap
Methoden:	Move, Refresh
Ereignisse:	Change, Click, DblClick, MouseDown, MouseMove, MouseUp


Dialogbox-Referenz
FontBold-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der Text eines unter Dialog-Elemente aufgeführten Elementes fett dargestellt werden soll.
Syntax:	ElementName.FontBold[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob der Text eines Elementes fett dargestellt werden soll. Bool kann wie folgt gesetzt sein:
	Wert	Bedeutung
	TRUE	Der Text wird fett dargestellt.
	FALSE	Der Text wird nicht fett dargestellt.
Siehe auch:	Dialogbox-Referenz , FontItalic-Eigenschaft, FontName-Eigenschaft, FontSize-Eigenschaft, StrikeOut-Eigenschaft, StrikeThrough-Eigenschaft, Underline-Eigenschaft


Dialogbox-Referenz
FontItalic-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der Text eines unter Dialog-Elemente aufgeführten Elementes kursiv dargestellt werden soll.
Syntax:	ElementName.FontItalic[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob der Text eines Elementes kursiv dargestellt werden soll. Bool kann wie folgt gesetzt sein:
	Wert	Bedeutung
	TRUE	Der Text wird kursiv dargestellt.
	FALSE	Der Text wird nicht kursiv dargestellt.
Siehe auch:	Dialogbox-Referenz , FontBold-Eigenschaft, FontName-Eigenschaft, FontSize-Eigenschaft, StrikeOut-Eigenschaft, StrikeThrough-Eigenschaft, Underline-Eigenschaft


Dialogbox-Referenz
StrikeOut-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der Text eines unter Dialog-Elemente aufgeführten Elementes durchgestrichen dargestellt werden soll.
Syntax:	ElementName.StrikeOut[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob der Text eines Elementes durchgestrichen dargestellt werden soll. Bool kann wie folgt gesetzt sein:
	Wert	Bedeutung
	TRUE	Der Text wird durchgestrichen dargestellt.
	FALSE	Der Text wird nicht durchgestrichen dargestellt.
Siehe auch:	Dialogbox-Referenz , FontBold-Eigenschaft, FontItalic-Eigenschaft, FontName-Eigenschaft, FontSize-Eigenschaft, StrikeOut-Eigenschaft, FontUnderline-Eigenschaft,


Dialogbox-Referenz
FontUnderline-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der Text eines unter Dialog-Elemente aufgeführten Elementes unterstrichen dargestellt werden soll.
Syntax:	ElementName.FontUnderline[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob der Text eines Elementes unterstrichen dargestellt werden soll. Bool kann wie folgt gesetzt sein:
	Wert	Bedeutung
	TRUE	Der Text wird unterstrichen dargestellt.
	FALSE	Der Text wird nicht unterstrichen dargestellt.
Siehe auch:	Dialogbox-Referenz , FontBold-Eigenschaft, FontItalic-Eigenschaft, FontName-Eigenschaft, FontSize-Eigenschaft, StrikeOut-Eigenschaft, StrikeThrough-Eigenschaft, Underline-Eigenschaft


Dialogbox-Referenz
FontName-Eigenschaft

Funktion:	Definiert oder ermittelt den Zeichensatznamen eines für ein Dialogelement bestimmten Font.
Syntax:	ElementName.FontName[=Name$]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Name$	Zeichenkettenausdruck, der den Zeichensatz des Dialogelementes bezeichnet.
Siehe auch:	Dialogbox-Referenz , FontBold-Eigenschaft, FontItalic-Eigenschaft, FontSize-Eigenschaft, StrikeOut-Eigenschaft, StrikeThrough-Eigenschaft, FontUnderline-Eigenschaft , Underline-Eigenschaft


Dialogbox-Referenz
FontSize-Eigenschaft

Funktion:	Definiert oder ermittelt die Größe eines für ein Dialogelement bestimmten Fonts.
Syntax:	ElementName.FontSize[=Size]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Size	Ausdruck vom Typ Long, der die Größe des Fonts eines Dialogelementes beschreibt.
Siehe auch:	Dialogbox-Referenz , FontBold-Eigenschaft, FontItalic-Eigenschaft, FontName-Eigenschaft, StrikeOut-Eigenschaft, StrikeThrough-Eigenschaft, FontUnderline-Eigenschaft , Underline-Eigenschaft


Dialogbox-Referenz
ForeColor-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Vordergrundfarbe des entsprechenden Dialogboxelementes
Syntax:	ElementName.ForeColor [=Color&]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	Color&	Beliebiger Long-Integer-Ausdruck, der die Farbe bestimmt. Der Wert wird mit Hilfe der RGB-Funktion (siehe Basic-Referenz) berechnet, und setzt sich aus prozentual verschiedenen Rot-, Grün- und Blau-Anteilen zusammen.
Siehe auch:	Dialogbox-Referenz , BackColor-Eigenschaft, BackStyle-Eigenschaft


Dialogbox-Referenz
GetPoint-Methode

Funktion:	Ermittelt die Farbe eines Pixels an einer bestimmten Koordinate
Syntax:	PreviewName.GetPoint(X%, Y%)
Für Dialog-Element:	Preview
Parameter	Beschreibung
X%, Y%	Die Koordinaten des Pixels in Twips, dessen Farbwert ermittelt werden soll.
Siehe auch:	Dialogbox-Referenz , Cls-Methode, DrawBox-Methode, DrawEllipse-Methode,  DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawPoint-Methode, DrawText-Methode, DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetTextHeight-Methode; GetTextWidth-Methode,  Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
GetTextHeight-Methode; GetTextWidth-Methode

Funktion:	Ermittelt die Höhe bzw. die Länge eines Textes, die in einem Preview-Steuerelement ausgegeben werden soll.
Syntax:	PreviewName.GetTextHeight(text$) oder PreviewName.GetTextWidth(text$)
Für Dialog-Element:	Preview
Parameter	Beschreibung
text$	Beliebiger Zeichenkettenausdruck, dessen Ausmaße ermittelt werden sollen.
Mit Hilfe dieser Funktionen ermitteln Sie entweder die Höhe oder die Breite eines Textes, den Sie in ein Preview-Dialogelement ausgeben möchten. Die Breite bzw. Höhe des Textes richtet sich dabei nach verwendeter Schriftart, der eingestellten Schriftgrößesowie der verwendeten Schriftattribute. Die Ausmaße des Textes werden Twips zurückgeliefert.

Siehe auch:	Dialogbox-Referenz , Cls-Methode, DrawBox-Methode, DrawEllipse-Methode, DrawLine-Methode; DrawLineTo-Methode, DrawPicture-Methode, DrawPoint-Methode, DrawText-Methode, DrawWidth-Eigenschaft, FillStyle-Eigenschaft, GetPoint-Methode, Paint-Ereignis, DrawMode-Eigenschaft, DrawStyle-Eigenschaft


Dialogbox-Referenz
GotFocus-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn eines der unter Dialog-Elemente aufgeführten Elemente die Fokussierung erhält. Achtung: Dieses Ereignis übergibt einen Parameter an die Ereignis-Sub!
Sub-Definition:	Sub Dialog_GotFocus()
Für DialogElement	Dialog, CheckBox, ListBox, ComboBox, TextBox, HScrollBar, VScrollBar, Preview, CommandButton, OptionButton, SpinButton
Siehe auch:	Dialogbox-Referenz , LostFocus-Ereignis, SetFocus-Methode


Dialogbox-Referenz
FrameControl-Steuerelement

Funktion:	Faßt mehrere Steuerelemente funktional und optisch zu einer Gruppe zusammen. Dieses Steuerelement wird gerade bei OptionButton-Steuerelementen zur „Eingrenzung“ der möglichen Optionen verwendet.
Eigenschaften:	BackColor, Caption, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Parent, Step, TabIndex, Tag, Top, Visible, Width
Methoden:	Move, Refresh
Ereignisse:	Click, DblClick, MouseDown, MouseMove, MouseUp
Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
Height-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Höhe eines der unter Dialog-Elemente aufgeführten Elemente.
Syntax:	ElementName.Height[=ElemHeight]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	ElemHeight	Ausdruck vom Typ Long, der die Höhe des Elementes angibt.
Ist die Style-Eigenschaft eines Kombinationslistenfeldes auf 0 oder 2 gesetzt, kann die Höhe dieses Elementes nicht verändert werden.

Siehe auch:	Dialogbox-Referenz ,  Left-Eigenschaft, Top-Eigenschaft, Width-Eigenschaft


Dialogbox-Referenz
HelpContextId-Eigenschaft

Funktion:	Bestimmt oder ermittelt einen Index, der auf die kontextsensitive Hilfe für eines der unter Dialog-Elemente aufgeführten Elemente verweist.
Syntax:	ElementName.HelpContextId[=Index]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	Index	Numerischer Ausdruck, der als Index dient und auf die kontextsensitive Hilfe für ein Element verweist.
Um einem Element Ihrer Applikation eine kontextsensitive Hilfe zuzuordnen, müssen Sie dem Element und dem Hilfe-Thema den Index zuweisen, der auf die Hilfe verweist, bevor Sie die Hilfe-Datei kompilieren.

Siehe auch:	Dialogbox-Referenz , HelpText-Eigenschaft


Dialogbox-Referenz
HelpText-Eigenschaft

Funktion:	Bestimmt eine Zeichenkette als Hilfetext für eine Dialogboxelement, die wie die „Aktive Hilfe“ aller StarOffice-Programme, angezeigt wird, wenn der Anwender zur Laufzeit mit der rechten Maustaste darauf klickt.
Syntax:	ElementName.HelpText=text$
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, ComboBox, Dialog, TextBox, Label, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	text$	Beliebiger Zeichenkettenausdruck, der den Hilfetext bestimmt.
Siehe auch:	Dialogbox-Referenz , HelpContextId-Eigenschaft


Dialogbox-Referenz
Hide-Methode

Funktion:	Entfernt einen Dialog vom Bildschirm, jedoch nicht aus dem Arbeitsspeicher.
Syntax:	Dialog.Hide
Für Dialog-Element:	Dialog
Auf den Dialog kann weiterhin über den dynamischen Datenaustausch (DDE) zugegriffen werden, da dieser lediglich vom Bildschirm, nicht aber aus dem Arbeitsspeicher entfernt wurde. Möchten Sie den Dialog ganz aus dem Arbeitsspeicher entfernen, verwenden Siebitte die UNLOAD-Methode.

Siehe auch:	Dialogbox-Referenz , Activate-Ereignis, CurrentStep-Eigenschaft, CurrentX-Eigenschaft; CurrentY-Eigenschaft,  Deactivate-Ereignis, Load-Ereignis, Load-Methode, Step-Eigenschaft, UseMnemonic-Eigenschaft


Dialogbox-Referenz
HScrollBar-Steuerelement

Funktion:	Ermöglicht dem Anwender die Wertebestimmung in einem vorgegebenen Wertebereich durch einen horizontalen Schiebebalken
Eigenschaften:	Enabled, Height, HelpContextID, HelpText, LargeChange, Left, Max, Min, MousePointer, Name, Parent, SmallChange, Step, TabIndex, TabStop, Tag, Top, Value, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	Change, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, Scroll


Dialogbox-Referenz
ItemData-Eigenschaft

Funktion:	Bestimmt oder ermittelt zusätzliche numerische Informationen zu einem Eintrag eines Listenfeldes oder Kombinationslistenfeldes.
Syntax:	{ComboBoxName|ListBoxName}.ItemData(Index)[=NumInfo]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	ComboBox, ListBox
	Parameter	Beschreibung
	Index	Numerischer Ausdruck, der den Index des Eintrages eines Listenfeldes oder Kombinationslistenfeldes angibt, dem zusätzliche numerische Informationen zugewiesen oder dessen Informationen ermittelt werden sollen.
	NumInfo	Numerischer Ausdruck, der die numerischen Informationen aufnimmt, die dem Eintrag eines Listenfeldes oder Kombinationslistenfeldes zugewiesen werden.
Diese Eigenschaft stellt ein Array mit Feldern aus Long-Integer-Werten zur Verfügung, dessen Einträge mit den Einträgen eines Kombinationslistenfeldes oder eines Listenfeldes korrespondieren.

Wird einem Listenfeld oder einem Kombinationslistenfeld ein Eintrag hinzugefügt, wird das ItemData-Array automatisch um ein Feld erweitert.

Siehe auch:	Dialogbox-Referenz , AddItem-Methode, Clear-Methode, List-Eigenschaft, ListCount-Eigenschaft, ListIndex-Eigenschaft, MultiSelect-Eigenschaft, NewIndex-Eigenschaft,  RemoveItem-Methode, Selected-Eigenschaft,  SelLength-Eigenschaft, Sorted-Eigenschaft, Style-Eigenschaft,  TopIndex-Eigenschaft


Dialogbox-Referenz
KeyDown-Ereignis; KeyUp-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn eine bestimmte Taste gedrückt (KEYDOWN) oder losgelassen (KEYUP) wird und der Fokus auf dem entsprechenden Objekt liegt. Achtung: Dieses Ereignis übergibt Parameter an die Ereignis-Sub!
Sub-Definition:	Sub Element_KeyDown(KeyCode%, Shift%) bzw. Sub Element_KeyUp(KeyCode%, Shift%)
Für DialogElement	CheckBox, ComboBox, Dialog, TextBox, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	Keycode%	Der Tasten-Code.
	Shift%	Dieses Argument zeigt an, ob eine oder mehrere der Tasten (ª), (Strg) und (Alt) während der Betätigung der eigentlichen Taste zusätzlich gedrückt waren. Jeder dieser Tasten ist ein Bit zugewiesen:
	Bit	Bedeutung
	0	Taste (ª) war gedrückt.
	1	Taste (Strg) war gedrückt.
	2	Taste (Alt) war gedrückt.
Siehe auch:	Dialogbox-Referenz ,  KeyPress-Ereignis


Dialogbox-Referenz
KeyPress-Ereignis

Zeitpunkt:	Wird dann ausgelöst, wenn der Fokus auf dem jeweiligen Dialogboxelement liegt, und der Anwender eine Taste drückt. Achtung: Dieses Ereignis übergibt einen Parameter an die Ereignis-Sub!
Sub-Definition:	Sub Element_KeyPress(Key%)
Für DialogElement	CheckBox, ComboBox, Dialog, TextBox, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	Key%	Integervariable, die den standard-nummerische ANSI-Keycode der gedrückten Taste zurückliefert.
Siehe auch:	Dialogbox-Referenz ,  KeyDown-Ereignis; KeyUp-Ereignis


Dialogbox-Referenz
LargeChange-Eigenschaft; SmallChange-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Wert, um den das Bildlauffeld einer Bildlaufleiste verschoben wird.
Syntax:	{HScrollBar|VScrollBar}.LargeChange[=Step%] bzw. {HScrollBar|VScrollBar}.SmallChange[=Step%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	HScrollBar, VScrollBar
	Parameter	Beschreibung
	Step%	Integer-Ausdruck, um den die Value-Eigenschaft einer Bildlaufleiste verändert wird.
Die LargeChange-Eigenschaft bestimmt den Wert, um den die Value-Eigenschaft vermindert oder erhöht wird, wenn auf die Bildlaufleiste zwischen einem der Bildlaufpfeile und dem Bildlauffeld geklickt wird. Wird die Bildlaufleiste über, respektive links von dem Bildlauffeld angeklickt, vermindert sich der Wert der Value-Eigenschaft, während ein Klick unter oder rechts von dem Bildlauffeld den Wert erhöht. Die SmallChange-Eigenschaft verändert den Wert der Value-Eigenschaft, wenn auf einen der Bildlaufpfeile der entsprechenden Bildlaufleisten geklickt wird.

Siehe auch:	Dialogbox-Referenz ,  Max-Eigenschaft, Min-Eigenschaft, Scroll-Ereignis


Dialogbox-Referenz
Left-Eigenschaft

Funktion:	Bestimmt oder Ermittelt die x-Position eines Elementes, das in einem anderen Element angeordnet ist, wie zum Beispiel ein Listenfenster in einem Dialog.
Syntax:	Element.Left[=xPos]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Dialog, CheckBox, ListBox, ComboBox, FrameControl, TextBox, Label, Preview, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	xPos	Ausdruck vom Typ Long, der die x-Position eines Elementes im Container (das umgebende Element) bezeichnet.
Die Left-Eigenschaft bestimmt den Abstand zwischen dem linken Rand des Elementes und dem linken Rand seines Containers, also des umgebenden Elementes.

Siehe auch:	Dialogbox-Referenz ,  Height-Eigenschaft, Top-Eigenschaft, Width-Eigenschaft


Dialogbox-Referenz
ListBox-Steuerelement

Funktion:	Ermöglicht dem Anwender die Auswahl eines Eintrags aus einer Liste.
Eigenschaften:	BackColor, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, ItemData, Left, List, ListCount, ListIndex, ListRange, MousePointer, MultiSelect, Name, NewIndex, Parent, Selected, Sorted, Step, TabIndex, TabStop, Tag, Text, Top, TopIndex, Visible, Width, Height, Type, Width
Methoden:	AddItem, Clear, Move, Refresh, RemoveItem, SetFocus
Ereignisse:	Click, DblClick, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, MouseDown, MouseMove, MouseUp


Dialogbox-Referenz
ListCount-Eigenschaft

Funktion:	Ermittelt die Anzahl aller vorhandenen Einträge eines Listen- oder Kombinationslistenfeldes.
Syntax:	ListBoxName.ListCount
Lesezugriff:	Nur zur Laufzeit lesbar; nicht schreibbar.
Für Dialog-Element:	ListBox, ComboBox
Mit dieser Funktion ermitteln Sie die Anzahl aller vorhandenen Einträge eines Listen-oder Kombinationslistenfeldes. Es sind keine Einträge vorhanden, wenn der Wert 0 zurückgeliefert wird.

Beispiel:	Siehe  AddItem-Methode

Siehe auch:	Dialogbox-Referenz , AddItem-Methode, Clear-Methode, ItemData-Eigenschaft, List-Eigenschaft, ListIndex-Eigenschaft, MultiSelect-Eigenschaft, NewIndex-Eigenschaft,  RemoveItem-Methode, Selected-Eigenschaft, SelLength-Eigenschaft, Sorted-Eigenschaft,  Style-Eigenschaft, TopIndex-Eigenschaft


Dialogbox-Referenz
ListIndex-Eigenschaft

Funktion:	Ermittelt oder bestimmt den Index des gegenwärtig ausgewählten Eintrags eines Listenfeldes oder Kombinationslistenfeldes.
Syntax:	{ListBox|ComboBox}.ListIndex [=Index]
Lesezugriff:	Nur zur Laufzeit lesbar und schreibbar
Für Dialog-Element:	ListBox, ComboBox
	Parameter	Beschreibung
	Index	Beliebiger numerischer Ausdruck, der den gegenwärtig ausgewählten Eintrag eines Listenfeldes oder Kombinationslistenfeldes kennzeichnet.
Wird die Auswahl aus einem Kombinationslistenfeld (ComboBox) über dessen Eingabefeld vorgenommen, gibt die ListIndex-Eigenschaft den Wert -1 zurück.

Siehe auch:	Dialogbox-Referenz , AddItem-Methode, Clear-Methode, ItemData-Eigenschaft, List-Eigenschaft, ListCount-Eigenschaft, MultiSelect-Eigenschaft, NewIndex-Eigenschaft, RemoveItem-Methode, Selected-Eigenschaft, SelLength-Eigenschaft, Sorted-Eigenschaft, Style-Eigenschaft, TopIndex-Eigenschaft


Dialogbox-Referenz
List-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einträge eines Listenfeldes oder Kombinationslistenfeldes.
Syntax:	{ListBox|ComboBox}.List(Index) [=Eintrag$]
Lesezugriff:	Nur zur Laufzeit lesbar und schreibbar
Für Dialog-Element:	ListBox, ComboBox
	Parameter	Beschreibung
	Index	Beliebiger numerischer Ausdruck, der die Position des Eintrages angibt, der in einem Listenfeld oder Kombinationslistenfeld bestimmt oder ermittelt werden soll.
	Eintrag$	Zeichenfolgenausdruck, der den Eintrag aufnimmt, der dem Listenfeld oder Kombinationslistenfeld zugewiesen werden soll.
Siehe auch:	Dialogbox-Referenz ,  AddItem-Methode, Clear-Methode, ItemData-Eigenschaft, List-Eigenschaft, ListCount-Eigenschaft, MultiSelect-Eigenschaft, NewIndex-Eigenschaft, RemoveItem-Methode, Selected-Eigenschaft, SelLength-Eigenschaft, Sorted-Eigenschaft, Style-Eigenschaft, TopIndex-Eigenschaft


Dialogbox-Referenz
Load-Ereignis

Zeitpunkt:	Dieses Ereignis wird ausgelöst, wenn ein Dialog geladen wird, also kurz vor dem ersten Anzeigen des Dialogs.
Sub-Definition:	Sub Dialog_Load
Für DialogElement	Dialog
Tip: Verwenden Sie dieses Ereignis für den „Programmstart“ eines Dialog, z.B. um im Dialog enthaltene List- oder ComboBox-Kontrollelemente mit Daten zu füllen oder andere Eigenschaften zur Laufzeit zu definieren.

Siehe auch:	Dialogbox-Referenz ,  Activate-Ereignis, CurrentStep-Eigenschaft, CurrentX-Eigenschaft; CurrentY-Eigenschaft, Deactivate-Ereignis, Hide-Methode, Load-Methode, Step-Eigenschaft, UseMnemonic-Eigenschaft


Dialogbox-Referenz
Load-Methode

Funktion:	Lädt einen Dialog in den Arbeitsspeicher.
Syntax:	Dialog.Load
Für Dialog-Element:	Dialog
Hinweis: Die LOAD-Methode wird automatisch aufgerufen, wenn ein Dialog durch die SHOW-Methode angezeigt wird. Sie können auf die Eigenschaften und Elemente eines Dialoges erst dann zugreifen und diese verändern, wenn der Dialog durch die LOAD-Methode geladen wurde. Verwenden Sie daher die LOAD-Methode,um den Dialog zu laden, wenn Sie Modifizierungen am Dialog vornehmen möchten, noch bevor der Dialog durch die SHOW-Methode dargestellt wird.

Siehe auch:	Dialogbox-Referenz , Activate-Ereignis, CurrentStep-Eigenschaft, CurrentX-Eigenschaft; CurrentY-Eigenschaft, Deactivate-Ereignis, Hide-Methode, Load-Ereignis, Step-Eigenschaft, UseMnemonic-Eigenschaft


Dialogbox-Referenz
LostFocus-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn eines der unter Dialog-Elemente aufgeführten Elemente die Fokussierung verliert.
Sub-Definition:	Sub Dialog_LostFocus()
Für DialogElement	Dialog, CheckBox, ListBox, ComboBox, TextBox, HScrollBar, VscrollBar, Preview, CommandButton, OptionButton, SpinButton
Siehe auch:	Dialogbox-Referenz ,  GotFocus-Ereignis, SetFocus-Methode


Dialogbox-Referenz
Max-Eigenschaft

Funktion:	Bestimmt oder ermittelt den maximalen Wert für die Value-Eigenschaft einer Bildlaufleiste oder eines SpinButtons.
Syntax:	{HScrollBar|VscrollBar}.Max[=Limit%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	HScrollBar, VscrollBar, SpinButton
	Parameter	Beschreibung
	Limit%	Integer-Ausdruck, der den maximalen Wert kennzeichnet, den die Value-Eigenschaft einer Bildlaufleiste oder eines SpinButtons annehmen kann.
Der höchstmögliche Wert der VALUE-Eigenschaft kennzeichnet die unterste Position des Bildlauffeldes einer vertikalen oder die äußerst rechte Position des Bildlauffeldes einer horizontalen Bildlaufleiste. Die Voreinstellung beträgt 32767.

Siehe auch:	Dialogbox-Referenz , LargeChange-Eigenschaft , Min-Eigenschaft, Scroll-Ereignis, SmallChange-Eigenschaft


Dialogbox-Referenz
MaxLength-Eigenschaft

Funktion:	Bestimmt oder ermittelt die höchtsmögliche Anzahl der Zeichen, die ein Textfeld aufnehmen kann.
Syntax:	TextBox.MaxLength[=Limit]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	TextBox
	Parameter	Beschreibung
	Limit	Numerischer Ausdruck, der die Kapazität eines Textfeldes in Zeichen angibt.
Die Voreinstellung der MaxLength-Eigenschaft beträgt 0. Dieser Wert zeigt an, daß keine Beschränkung bei der Eingabe von Zeichen besteht, abgesehen von dem den Anwender zur Verfügung stehenden Arbeitsspeicher für einzeilige Textfelder und 32 Kilobyte für mehrzeilige Textfelder. Jeder der MaxLength-Eigenschaft zugewiesene Wert, der größer als 0 ist, kennzeichnet die Anzahl der Zeichen, die der Anwender in dem Textfeld eingeben kann.

Siehe auch:	Dialogbox-Referenz , MultiLine-Eigenschaft, PasswordChar-Eigenschaft, ReadOnly-Eigenschaft, ScrollBars-Eigenschaft, SelLength-Eigenschaft, SelStart-Eigenschaft, SelText-Eigenschaft, WordWrap-Eigenschaft


Dialogbox-Referenz
Min-Eigenschaft

Funktion:	Bestimmt oder ermittelt den kleinsten Wert, der der Value-Eigenschaft einer Bildlaufleiste oder eines SpinButtons zugewiesen werden kann.
Syntax:	{HScrollBar|VScrollBar}.Min[=Limit%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	HScrollBar, VScrollBar, SpinButton
	Parameter	Beschreibung
	Limit%	Integer-Ausdruck, der den kleinsten Wert kennzeichnet, den die Value-Eigenschaft einer Bildlaufleiste oder eines SpinButtons annehmen kann.
Der kleinste Wert der Value-Eigenschaft kennzeichnet die oberste Position des Bildlauffeldes einer vertikalen oder die äußerst linke Position des Bildlauffeldes einer horizontalen Bildlaufleiste. Die Voreinstellung beträgt 0.

Siehe auch:	Dialogbox-Referenz , LargeChange-Eigenschaft; SmallChange-Eigenschaft , Max-Eigenschaft, Scroll-Ereignis


Dialogbox-Referenz
MouseDown-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn eine der Maustasten betätigt wird. Achtung: Dieses Ereignis übergibt Parameter an die Ereignis-Sub!
Sub-Definition:	Sub Element_MouseDown (Button%, Shift%, X, Y)
Für DialogElement	CheckBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Button%	Bezeichnet die Maustaste, die betätigt wurde. Lediglich eine Maustaste kann zu einer Zeit dieses Ereignis auslösen. Die folgenden Werte können zurückgegeben werden:
	Wert	Bedeutung
	0	Die linke Maustaste wurde gedrückt.
	1	Die rechte Maustaste wurde gedrückt.
	2	Die mittlere Maustaste wurde gedrückt.
	Shift%	Dieses Argument zeigt an, ob eine oder mehrere der Tasten (ª), (Strg) und (Alt) während der Betätigung der Maustaste gedrückt waren. Jeder dieser Tasten ist ein Bit zugewiesen:
	Bit	Bedeutung
	0	Taste (ª) war gedrückt.
	1	Taste (Strg) war gedrückt.
	2	Taste (Alt) war gedrückt.
		Wurden mehrere Tasten gleichzeitig während des Ereignisses gedrückt, werden die Bits dieser Tasten mit einer And-Verknüpfung zusammengefügt und das Ergebnis in Shift abgelegt.
	X, Y	Diese Parameter geben an, wo der Mauszeiger während des Mausklicks positioniert war.
Beachten Sie bitte, daß ein MouseDown-Ereignis die folgenden, die Maus betreffenden Ereignisse an das Element bindet, über dem eine Maustaste gedrückt wurde. Wird beispielsweise der Mauszeiger, nachdem eine Maustaste gedrückt und somit das MouseDown-Ereignis ausgelöst wurde, von einem Dialog auf einen anderen bewegt und die Maustaste dort wieder losgelassen, so wird das MouseUp-Ereignis des ersten und nicht des zweiten Dialoges aufgerufen.

Siehe auch:	Dialogbox-Referenz , Click-Ereignis, DblClick-Ereignis, MouseMove-Ereignis, MousePointer-Eigenschaft, MouseUp-Ereignis


Dialogbox-Referenz
MouseMove-Ereignis

Zeitpunkt:	Dieses Ereignis wird ausgelöst, wenn der Mauszeiger bewegt wird. Achtung: Dieses Ereignis übergibt Parameter an die Ereignis-Sub!
Sub-Definition:	Sub Element_MouseMove (Button% , Shift%, X, Y)
Für DialogElement	CheckBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Button%	Bezeichnet die Maustasten, die gegenwärtig gedrückt sind. Mehrere Maustasten können gleichzeitig gedrückt sein, wobei jede Maustaste durch ein Bit dargestellt wird:
	Bit	Bedeutung
	0	Die linke Maustaste ist gedrückt.
	1	Die rechte Maustaste ist gedrückt.
	2	Die mittlere Maustaste ist gedrückt.
	Shift%	Dieses Argument zeigt an, ob eine oder mehrere der Tasten (ª), (Strg) und (Alt) zum Zeitpunkt des Ereignisses gedrückt waren. Jeder dieser Tasten ist ein Bit zugewiesen:
	Bit	Bedeutung
	0	Taste (ª) war gedrückt.
	1	Taste (Strg) war gedrückt.
	2	Taste (Alt) war gedrückt.
		Wurden mehrere Tasten gleichzeitig während des Ereignisses gedrückt, werden die Bits dieser Tasten mit einer And-Verknüpfung zusammengefügt und das Ergebnis in Shift abgelegt.
	X, Y	Diese Parameter geben an, wo der Mauszeiger positioniert ist.
Das MouseMove-Ereignis wird immer für das Element ausgelöst, über dem sich der Mauszeiger gegenwärtig befindet. Dieses Ereignis ist somit nicht wie das MouseDown- oder MouseUp-Ereignis an ein Element gebunden.

Siehe auch:	Dialogbox-Referenz , Click-Ereignis , DblClick-Ereignis , MouseDown-Ereignis , MousePointer-Eigenschaft , MouseUp-Ereignis


Dialogbox-Referenz
MousePointer-Eigenschaft

Funktion:	Bestimmt die Form des Mauszeigers über einem der unter Dialog-Elemente aufgeführten Elemente.
Syntax:	Element.MousePointer[=Form%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung. Diese Eigenschaft kann nur für Elemente eines Containers bestimmt werden.
Für Dialog-Element:	CheckBox, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton, HScrollBar, VScrollBar, SpinButton
	Parameter	Beschreibung
	Form	Integer-Ausdruck, der die Gestalt des Mauszeigers kennzeichnet. Die folgenden Möglichkeiten der Gestaltung des Mauszeigers sind möglich:
	Wert	Gestalt
	0	Voreinstellung. Die Form des Mauszeigers wird durch das Element bestimmt, über dem sich der Mauszeiger gegenwärtig befindet.
	1	Gewöhnliche Pfeilform.
	2	Fadenkreuz.
	3	Texteingabemarke.
	4	Ausgefülltes Viereck in einem Rahmen.
	5	Richtungskreuz.
	6	Diagonaler Pfeil in beide Richtungen, von links unten nach rechts oben.
	7	Senkrechter Pfeil in beide Richtungen.
	8	Diagonaler Pfeil in beide Richtungen, von rechts unten nach links oben.
	9	Horizontaler Pfeil in beide Richtungen.
	10	Pfeil nach oben.
	11	Sanduhr.
	12	Verbotsschild.
Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
MouseUp-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn eine zuvor betätigte Maustaste losgelassen wird. Achtung: Dieses Ereignis übergibt Parameter an die Ereignis-Sub!
Sub-Definition:	Sub Element_MouseUp (Button%, Shift%,  X, Y)
Für DialogElement	CheckBox, Dialog, TextBox, Label, FrameControl, ListBox, Preview, CommandButton, OptionButton
	Parameter	Beschreibung
	Button%	Bezeichnet die Maustaste, die losgelassen wurde. Lediglich eine Maustaste kann zu einer Zeit dieses Ereignis auslösen. Die folgenden Werte können zurückgegeben werden:
	Wert	Bedeutung
	0	Die linke Maustaste wurde losgelassen.
	1	Die rechte Maustaste wurde losgelassen.
	2	Die mittlere Maustaste wurde losgelassen.
	Shift%	Dieses Argument zeigt an, ob eine oder mehrere der Tasten (ª), (Strg) und (Alt) gedrückt waren, während die Maustaste losgelassen wurde. Jeder dieser Tasten ist ein Bit zugewiesen:
	Bit	Bedeutung
	0	Taste (ª) war gedrückt.
	1	Taste (Strg) war gedrückt.
	2	Taste (Alt) war gedrückt.
		Wurden mehrere Tasten gleichzeitig während des Ereignisses gedrückt, werden die Bits dieser Tasten mit einer And-Verknüpfung zusammengefügt und das Ergebnis in Shift abgelegt.
	X, Y	Diese Parameter geben an, wo der Mauszeiger positioniert war, während die Maustaste losgelassen wurde.
Beachten Sie bitte, daß ein MouseDown-Ereignis die folgenden, die Maus betreffenden Ereignisse an das Element bindet, über dem eine Maustaste gedrückt wurde. Wird beispielsweise der Mauszeiger, nachdem eine Maustaste gedrückt und somit das MouseDown-Ereignis ausgelöst wurde, von einem Dialog auf einen anderen bewegt und die Maustaste dort wieder losgelassen, so wird das MouseUp-Ereignis des ersten und nicht des zweiten Dialoges aufgerufen.

Siehe auch:	Dialogbox-Referenz , Click-Ereignis, DblClick-Ereignis, MouseDown-Ereignis, MouseMove-Ereignis,  MousePointer-Eigenschaft


Dialogbox-Referenz
Move-Methode

Funktion:	Positioniert oder weist den unter Dialog-Elemente aufgeführten Elmenten eine bestimmte Größe zu.
Syntax:	Element.Move X [, Y[, Breite[, Höhe]]]
Für Dialog-Element:	CheckBox, Dialog, TextBox, Label, FrameControl, ListBox, ComboBox, Preview, CommandButton, OptionButton, HScrollBar, VScrollBar, SpinButton
	Parameter	Beschreibung
	X	Ausdruck vom Typ Single. Dieser Parameter gibt die x-Koordinate der linken, oberen Begrenzung des Elementes an.
	Y	Ausdruck vom Typ Single. Dieser Parameter gibt die y-Koordinate der linken, oberen Begrenzung des Elementes an.
	Breite	Ausdruck vom Typ Single, der die Breite des Objektes kennzeichnet.
	Höhe	Ausdruck vom Typ Single, der die Höhe des Objektes kennzeichnet.
Die oben aufgeführten Parameter müssen grundsätzlich in der Maßeinheit Twips übergeben werden.

Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
MultiLine-Eigenschaft

Funktion:	Ermöglicht oder verhindert die mehrzeilige Eingabe von Text in ein Textfeld.
Syntax:	TextBox.MultiLine[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	TextBox
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der anzeigt, ob eine mehrzeilige Eingabe von Text in ein Textfeld möglich ist oder nicht. Bool können die folgenden Werte zugewiesen sein:
Wert	Bedeutung
TRUE	Die Eingabe von mehrzeiligem Text ist möglich.
FALSE (Voreinstellung)	Die Eingabe von mehrzeiligem Text ist nicht möglich. Der eingegebene Text wird in einer Zeile dargestellt.
Ist ein Textfeld, dessen MultiLine-Eigenschaft auf TRUE gesetzt ist, in einem Dialog angeordnet, der keine Default-Schaltfläche enthält, wird nach der Betätigung der Taste (¢)  ein Zeilenvorschub durchgeführt.

Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft, PasswordChar-Eigenschaft, ReadOnly-Eigenschaft, ScrollBars-Eigenschaft, SelLength-Eigenschaft, SelStart-Eigenschaft, SelText-Eigenschaft, WordWrap-Eigenschaft


Dialogbox-Referenz
MultiSelect-Eigenschaft

Funktion:	Diese Eigenschaft bestimmt, ob und wie mehrere Einträge eines Listenfeldes ausgewählt werden können.
Syntax:	ListBox.MultiSelect[=Setting%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	ListBox
	Parameter	Beschreibung
	Setting%	Integer-Ausdruck, der angibt, ob mehrere Einträge ausgewählt werden können. Setting% können die folgenden Werte zugewiesen sein:
	Wert	Beschreibung
	0	Kein Eintrag eines Listenfeldes kann ausgewählt werden.
	1	Ein einzelner Eintrag eines Listenfeldes kann mit der Taste (Strg) oder einem Mausklick markiert und somit ausgewählt werden.
	2	Mehrere Einträge eines Listenfeldes können ausgewählt werden.
Sie markieren einen zusammenhängenden Block untereinander angeordneter Einträge, indem Sie den ersten Eintrag anklicken, die Taste (ª) drücken und halten und im Anschluß daran den letzten Eintrag dieses Blocks anklicken. Um mehrere auseinanderliegende Einträge auszuwählen, drücken und halten Sie die Taste (Strg) und markieren nacheinander die gewünschten Einträge.

Siehe auch:	Dialogbox-Referenz , AddItem-Methode, Clear-Methode, ItemData-Eigenschaft, List-Eigenschaft, ListCount-Eigenschaft, ListIndex-Eigenschaft,  NewIndex-Eigenschaft,  RemoveItem-Methode, Selected-Eigenschaft, SelLength-Eigenschaft, Sorted-Eigenschaft,  Style-Eigenschaft, TopIndex-Eigenschaft


Dialogbox-Referenz
Name-Eigenschaft

Funktion:	Diese Eigenschaft bezeichnet die unter Dialog-Elemente aufgeführten Elemente.
Lesezugriff:	Kann nur während der Dialogerstellung bestimmt werden.
Für Dialog-Element:	CheckBox, Dialog, TextBox, Label, Font, FrameControl, ListBox, ComboBox, Preview, CommandButton, OptionButton, HScrollBar, VScrollBar, SpinButton
	Parameter	Beschreibung
	String$	Zeichenkette, die das Element eindeutig bezeichnet.
Die Bezeichnung eines Elementes muß eindeutig sein und mit einem Buchstaben beginnen. Die Länge der Bezeichnung darf 40 Zeichen nicht überschreiten. Satz- und Leerzeichen sind ebensowenig zulässig wie deutsche Umlaute. Es gelten desweiteren dieselben Konventionen wie bei der Vergabe von Variablennamen.

Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
NewIndex-Eigenschaft

Funktion:	Bestimmt den Index des Eintrages, der zuletzt einem Listenfeld oder einem Kombinationslistenfeld hinzugefügt wurde.
Syntax:	Index% = {ListBox|ComboBox}.NewIndex
Lesezugriff:	Lesezugriff nur während der Laufzeit, jedoch nicht während der Dialogerstellung.
Für Dialog-Element:	ListBox, ComboBox
	Parameter	Beschreibung
	Index%	Zurückgegebener Integer-Ausdruck, der den Index des Eintrages bezeichnet, der zuletzt einem Listenfeld oder Kombinationslistenfeld hinzugefügt wurde.
Diese Eigenschaft ist besonders für sortierte Listen geeignet, sofern Sie eine Liste mit Werten benötigen, die jedem Feld des Arrays der ItemData-Eigenschaft  entsprechen. Fügen Sie einen Eintrag einer sortierten Liste hinzu, wird dieser alphabetisch geordnet eingegliedert. Die NewIndex-Eigenschaft gibt Aufschluß darüber, wo der Eintrag in diesem Listenfeld oder Kombinationslistenfeld angeordnet wurde, so daß ein entsprechender Wert an dieselbe Stelle im ItemData-Array aufgenommen werden kann.

NewIndex gibt den Wert -1 zurück, wenn keine Einträge in der Liste vorhanden sind oder ein Eintrag gelöscht wurde nachdem der Liste ein neuer Eintrag hinzugefügt wurde.

Siehe auch:	Dialogbox-Referenz , AddItem-Methode , Clear-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft ,  MultiSelect-Eigenschaft , RemoveItem-Methode , Selected-Eigenschaft , SelLength-Eigenschaft , Sorted-Eigenschaft , Style-Eigenschaft ,


Dialogbox-Referenz
Paint-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn ein Bereich eines Preview-Fensters oder das gesamte Fenster dargestellt wird.
Sub-Definition:	Sub Preview_Paint
Für DialogElement	Preview
Der Inhalt eines Preview-Fenster wird ganz oder teilweise neu dargestellt, nachdem es verschoben, in der Größe verändert oder ein Fenster, das über diesem Element lag, geschlossen oder an eine andere Position verschoben wurde. In diesen Situationen und wenn das Preview-Fenster erstmals dargestellt wird, wird das Paint-Ereignis ausgelöst.

Siehe auch:	Dialogbox-Referenz , Cls-Methode , DrawBox-Methode , DrawEllipse-Methode , DrawLine-Methode; DrawLineTo-Methode , DrawPicture-Methode , DrawPoint-Methode , DrawText-Methode , DrawWidth-Eigenschaft , FillStyle-Eigenschaft , GetPoint-Methode , GetTextHeight-Methode; GetTextWidth-Methode , DrawMode-Eigenschaft


Dialogbox-Referenz
PasswordChar-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob die vom Anwender eingegebenen Zeichen oder lediglich Platzhalter für diese Zeichen im Textfenster dargestellt werden.
Syntax:	TextBox.PasswordChar[=String$]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	TextBox
	Parameter	Beschreibung
	String$	Zeichenkette mit einer Länge von einem Zeichen, die den Platzhalter bezeichnet, der für ein eingegebenes Zeichen dargestellt werden soll.
Verwenden Sie diese Eigenschaft, um ein Passwort-Feld in einem Dialog zu erstellen. Die PasswordChar-Eigenschaft verändert nicht den Inhalt des Textfeldes. Weisen Sie String$ eine leere Zeichenkette (““) oder CHR$(0) zu, um den vom Anwender eingegebenen Text darstellen zu lassen.

Achtung: Diese Eigenschaft ist nur bei einzeiligen Eingaben anwendbar (siehe MULTILINE-Eigenschaft).

Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , ReadOnly-Eigenschaft , ScrollBars-Eigenschaft , SelLength-Eigenschaft , SelStart-Eigenschaft , SelText-Eigenschaft


Dialogbox-Referenz
Preview-Steuerelement

Funktion:	Dient dem Programmierer als Ausgabefenster zur freien Gestaltung vom Programm aus mit bestimmten Eigenschaften und Methoden.
Eigenschaften:	BackColor, Border, CurrentX, CurrentY, DrawMode, DrawStyle, DrawWidth, Enabled, FillStyle, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Parent, Step, TabIndex, TabStop, Tag, Top, Visible, Width
Methoden:	Cls, DrawBox, DrawEllipse, DrawLine, DrawLineTo, DrawPicture, DrawPoint, DrawPolygon, DrawText, GetPoint, GetTextHeight, GetTextWidth, Move, Refresh
Ereignisse:	Click, DblClick, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, MouseDown, MouseMove, MouseUp, Paint, Resize


Dialogbox-Referenz
CommandButton-Steuerelement

Funktion:	Ermöglicht dem Anwender die Bestätigung einer Aktion durch eine Schaltfläche.
Eigenschaften:	BackColor, Cancel, Caption, Default, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Parent, Step, TabIndex, TabStop, Tag, Top, Value, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	Click, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, MouseDown, MouseMove, MouseUp


Dialogbox-Referenz
OptionButton-Steuerelement

Funktion:	Ermöglicht dem Anwender die Auswahl nur einer Option von mehreren möglichen Optionen. Wird eine Option gewählt, wird eine andere zu dieser Zeit noch eingeschaltete Option dadurch gleichzeitig ausgeschaltet.
Eigenschaften:	BackColor, Border, Caption, Enabled, Font, FontBold, FontItalic, FontName, FontSize, StrikeOut, FontUnderline, ForeColor, Height, HelpContextID, HelpText, Left, MousePointer, Name, Parent, Step, TabIndex, TabStop, Tag, Top, Value, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	Click, DblClick, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, MouseDown, MouseMove, MouseUp


Dialogbox-Referenz
ReadOnly-Eigenschaft

Funktion:	Definiert, ob der Inhalt eines TextBox-Dialogboxelementes vom Anwender verändert werden kann oder nicht.
Syntax:	EditName.ReadOnly=Bool
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	TextBox
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob Eingaben in ein TextBox-Feld zur Laufzeit vom Anwender vorgenommen werden können (Bool=FALSE) oder nicht (Bool=TRUE).
Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , PasswordChar-Eigenschaft , ScrollBars-Eigenschaft , SelLength-Eigenschaft , SelStart-Eigenschaft , SelText-Eigenschaft


Dialogbox-Referenz
Refresh-Methode

Funktion:	Stellt das angegebene Element neu dar und löst ein Paint-Ereignis aus.
Syntax:	Element.Refresh
Für Dialog-Element:	Dialog, TextBox, Label, CheckBox, ComboBox, FrameControl, HScrollBar, ListBox, VScrollBar, Preview, CommandButton, OptionButton, SpinButton
Verwenden Sie diese Methode, um ein aktualisiertes Element, wie zum Beispiel ein Listenfeld, dem neue Einträge hinzugefügt wurden, neu darstellen zu lassen.

Siehe auch:	Dialogbox-Referenz , Paint-Ereignis


Dialogbox-Referenz
RemoveItem-Methode

Funktion:	Entfernt einen Eintrag aus einem Listenfeld oder einem Kombinationslistenfeld.
Syntax:	{ListBox|ComboBox}.RemoveItem Index
Für Dialog-Element:	ListBox, ComboBox
	Parameter	Beschreibung
	Index	Numerischer Ausdruck, der den Index des zu löschenden Eintrages angibt. Dem ersten Listeneintrag ist der Wert 0 zugewiesen.
Siehe auch:	Dialogbox-Referenz , AddItem-Methode , Clear-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft ,  MultiSelect-Eigenschaft , NewIndex-Eigenschaft , Selected-Eigenschaft , SelLength-Eigenschaft , Sorted-Eigenschaft , Style-Eigenschaft


Dialogbox-Referenz
Resize-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn die Größe eines Dialoges oder eines Preview-Fensters verändert wird oder diese Elemente erstmals dargestellt werden.
Sub-Definition:	Sub {Dialog|Preview}_Resize ()
Für DialogElement	Dialog, Preview
Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
Scroll-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn der Schieber eines HScrollBar- oder VScrollBar-Dialogelementes verschoben wird.
Sub-Definition:	Sub ScrollBarName_Scroll
Für DialogElement	HScrollBar, VScrollBar
Dieses Ereignis wird ausgelöst, sobald der Schieber eines Schiebebalkens vom Anwender verschoben wird. Im Gegensatz zum CHANGE-Ereignis werden solange SCROLL-Ereignisse ausgelöst, wie der Anwender einen Schieber bewegt. Die neue Position eines Schiebebalkens kann durch die VALUE-Eigenschaft des Schiebebalkens ermittelt werden.

Siehe auch:	Dialogbox-Referenz , LargeChange-Eigenschaft; SmallChange-Eigenschaft , Max-Eigenschaft , Min-Eigenschaft


Dialogbox-Referenz
ScrollBars-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob einem Textfenster Bildlaufleisten zugewiesen sind.
Syntax:	TextBox.ScrollBars[=Bool]
Lesezugriff:	Zugriff nur während der Dialogerstellung.
Für Dialog-Element:	TextBox
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob einem Textfenster Bildlaufleisten zugewiesen sind. Bool können die folgenden Ausdrücke zugewiesen sein:
	Wert	Bedeutung
	TRUE	Dem Textfenster ist eine horizontale und eine vertikale Bildlaufleiste zugewiesen.
	FALSE (Default)	Dem Textfenster sind keine Bildlaufleisten zugewiesen.
Ein Textfenster kann nur dann mit Bildlaufleisten versehen werden, wenn die MultiLine-Eigenschaft dieses Fensters auf TRUE gesetzt ist. Eine Bildlaufleiste wird erst dann am Textfenster angeordnet, wenn der Inhalt dieses Fensters dessen Ausmaße überschreitet. Ist keine vertikale Bildlaufleiste am Textfenster angeordnet und die MultiLine-Eigenschaft auf TRUE gesetzt, wird eingegebener Text auch dann umgebrochen, wenn die WordWrap-Eigenschaft auf FALSE gesetzt ist.

Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , PasswordChar-Eigenschaft , ReadOnly-Eigenschaft , SelLength-Eigenschaft , SelStart-Eigenschaft , SelText-Eigenschaft , WordWrap-Eigenschaft


Dialogbox-Referenz
Selected-Eigenschaft

Funktion:	Bestimmt den Status der Markierung eines Eintrages in einem Listenfeld oder ermittelt diesen Status.
Syntax:	ListBox.Selected (Index) [=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit, aber nicht während der Dialogerstellung.
Für Dialog-Element:	ListBox
	Parameter	Beschreibung
	Index	Numerischer Ausdruck, der den Eintrag kennzeichnet, dessen Markierungszustand bestimmt oder ermittelt werden soll.
	Bool	Booleanscher Ausdruck, der den Status der Markierung angibt:
	Belegung	Beschreibung
	TRUE	Der entsprechende Eintrag im Listenfeld ist markiert.
	FALSE (Default)	Der entsprechende Eintrag im Listenfeld ist nicht markiert.
Die Selected-Eigenschaft verwendet ein Array, das ebensoviele Einträge wie das korrespondierende Listenfeld aufweist. Das Array nimmt die booleanschen Werte auf, die den Status der Markierung eines Eintrages wiedergeben.

Siehe auch:	Dialogbox-Referenz , AddItem-Methode , Clear-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft ,  MultiSelect-Eigenschaft , NewIndex-Eigenschaft , RemoveItem-Methode , SelLength-Eigenschaft , Sorted-Eigenschaft , Style-Eigenschaft , TopIndex-Eigenschaft ,


Dialogbox-Referenz
SelLength-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Länge einer markierten Zeichenkette in einem Textfenster oder dem Eingabefeld eines Kombinationslistenfeldes.
Syntax:	{TextBox|ComboBox}.SelLength[=Length%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit, aber nicht während der Dialogerstellung.
Für Dialog-Element:	TextBox, ComboBox
	Parameter	Beschreibung
	Length%	Integer-Ausdruck, dem die Länge der markierten Zeichenkette zugewiesen ist.
Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , PasswordChar-Eigenschaft , ReadOnly-Eigenschaft , ScrollBars-Eigenschaft , SelStart-Eigenschaft , SelText-Eigenschaft , WordWrap-Eigenschaft


Dialogbox-Referenz
SelStart-Eigenschaft

Funktion:	Ermittelt oder bestimmt die Position des ersten Zeichens einer markierten Zeichenkette in einem Textfenster oder dem Eingabefeld eines Kombinationslistenfeldes. Ist keine Zeichenkette markiert, ermittelt die SelStart-Eigenschaft die Position der Schreibmarke.
Syntax:	{TextBox|ComboBox}.SelStart[=Position%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit, aber nicht während der Dialogerstellung.
Für Dialog-Element:	TextBox, ComboBox
	Parameter	Beschreibung
	Position%	Integer-Ausdruck, der die Position des ersten Zeichens einer markierten Zeichenkette oder der Schreibmarke aufnimmt.
Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , PasswordChar-Eigenschaft , ReadOnly-Eigenschaft , ScrollBars-Eigenschaft , SelLength-Eigenschaft , SelText-Eigenschaft , WordWrap-Eigenschaft


Dialogbox-Referenz
SelText-Eigenschaft

Funktion:	Weist die in in einem Textfenster oder dem Eingabefeld eines Kombinationslistenfeldes markierte Zeichenfolge einem Zeichenkettenausdruck zu oder ersetzt den markierten Text durch einen Zeichenkettenausdruck.
Syntax:	{TextBox|ComboBox}.SelText[=String$]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit, aber nicht während der Dialogerstellung.
Für Dialog-Element:	TextBox, ComboBox
	Parameter	Beschreibung
	String$	Zeichenkettenausdruck, dem die markierte Zeichenfolge zugewiesen ist.
Wird markierter Text mit der SelText-Eigenschaft durch einen Zeichenkettenausdruck ersetzt, wird der Wert der SelLength-Eigenschaft automatisch auf 0 gesetzt.

Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , PasswordChar-Eigenschaft , ReadOnly-Eigenschaft , ScrollBars-Eigenschaft , SelLength-Eigenschaft , SelStart-Eigenschaft , WordWrap-Eigenschaft


Dialogbox-Referenz
SetFocus-Methode

Funktion:	Setzt den Fokus für eines der unter Dialog-Elemente aufgeführten Elemente.
Syntax:	Element.SetFocus
Für Dialog-Element:	ComboBox, ListBox, CheckBox, Dialog, TextBox, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
Nachdem ein Element fokussiert wurde, beziehen sich alle Eingaben vom Anwender auf dieses Element.

Der Fokus kann nur für solche Elemente gesetzt werden, die sichtbar sind (Visible-Eigenschaft ist auf TRUE gesetzt) und auf die zugegriffen werden kann (Enabled-Eigenschaft ist auf TRUE gesetzt). Die SetFocus-Methode kann daher nicht in der Unterroutine eines Load-Ereignisses für einen Dialog verwendet werden, da der Dialog erst dann angezeigt wird, nachdem das Ereignis ausgeführt wurde.

Siehe auch:	Dialogbox-Referenz , GotFocus-Ereignis , LostFocus-Ereignis


Dialogbox-Referenz
SmallChange-Eigenschaft

Siehe LargeChange-Eigenschaft


Dialogbox-Referenz
Sorted-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob die Einträge eines Listenfeldes oder eines Kombinationslistenfeldes sortiert angeordnet werden.
Syntax:	{ListBox|ComboBox}.Sorted[=Bool]
Lesezugriff:	Lese- und Schreibzugriff nur zur Dialogerstellung.
Für Dialog-Element:	ListBox, ComboBox
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob die Einträge eines Listenfeldes oder eines Kombinationslistenfeldes sortiert angeordnet werden. Bool kann wie folgt gesetzt werden:
	Ausdruck	Beschreibung
	TRUE	Listeneinträge werden sortiert im Listenfeld oder Kombinationslistenfeld angeodnet.
	FALSE	Listeneinträge werden nicht sortiert im Listenfeld oder Kombinationslistenfeld angeodnet.
Ist diese Eigenschaft auf TRUE gesetzt, werden die Einträge eines Listen- oder Kombinationslistenfeldes automatisch sortiert angeordnet und mit neuen Indizes versehen. Einträge, die eingefügt oder gelöscht werden, können daher die Anordnung stören.

Siehe auch:	AddItem-Methode , Clear-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft ,  MultiSelect-Eigenschaft , NewIndex-Eigenschaft , RemoveItem-Methode , Selected-Eigenschaft , SelLength-Eigenschaft , Style-Eigenschaft , TopIndex-Eigenschaft


Dialogbox-Referenz
SpinDown-Ereignis; SpinUp-Ereignis

Zeitpunkt:	Wird ausgelöst, wenn ein SpinButton mit einem Pfeil nach unten oder nach links (SpinDown-Ereignis), oder mit einem Pfeil nach oben oder nach rechts (SpinUp-Ereignis) betätigt wird. Achtung: Dieses Ereignis übergibt Parameter an die Ereignis-Sub!
Sub-Definition:	Sub SpinButton_SpinDown Sub SpinButton_SpinUp
Für DialogElement	SpinButton
Wird innerhalb der Routine für das SpinDown- bzw. SpinUp-Ereignis der Wert oder Inhalt eines Elementes verändert, muß die Refresh-Methode für dieses Element aufgerufen werden, um die Änderungen zu aktualisieren.

Siehe auch:	Dialogbox-Referenz, SpinButton-Steuerelement


Dialogbox-Referenz
SpinButton-Steuerelement

Funktion:	Ermöglicht dem Anwender die Bestimmung eines Wertes durch Erhöhungs- bzw. Verminderungsschaltflächen um vorgebbare Schrittweiten in einem bestimmten Wertebereich. In der Regel werden diese Schaltflächen zusammen mit einem TextBox-Steuerelement verwendet, in dem der aktuelle Wert sowohl angezeigt als auch manuell bestimmt werden kann.
Eigenschaften:	BackColor, Change, Enabled, Height, HelpContextID, HelpText, Left, Max, Min, MousePointer, Name, Parent, Step, TabIndex, TabStop, Tag, Top, Value, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, SpinDown, SpinUp


Dialogbox-Referenz
Step-Eigenschaft

Funktion:	Definiert, welche Elemente eines „Assistenzdialoges“ zu welchem Bearbeitungsschritt gehören. Lesen Sie dazu bitte auch die Ausführungen der CURRENTSTEP-Eigenschaft.
Syntax:	ElementName.Step=StepNr%
Lesezugriff:	Schreibbar – nur zur Dialogerstellung
Für Dialog-Element:	CheckBox, ComboBox, TextBox, Label, FrameControl, HScrollBar, ListBox, Preview, CommandButton, OptionButton, SpinButton, VScrollBar
	Parameter	Beschreibung
	StepNr%	Beliebiger Integer-Ausdruck, der die Nummer des Schrittes bestimmt. Entspricht der Wert der STEP-Eigenschaft zur Laufzeit des Programms der CURRENTSTEP-Eigenschaft des Dialoges, wird das entsprechende Dialogelement angezeigt, ansonsten nicht.
Wird diese Eigenschaft nicht definiert, so wird das Dialogelement grundsätzlich angezeigt, wenn der dazugehörige Dialog angezeigt wird. Das gleiche gilt, wenn als Wert 0 definiert wird.

Siehe auch:	Dialogbox-Referenz , Activate-Ereignis , CurrentStep-Eigenschaft , CurrentX-Eigenschaft; CurrentY-Eigenschaft , Deactivate-Ereignis , Hide-Methode , Load-Ereignis , Load-Methode , UseMnemonic-Eigenschaft


Dialogbox-Referenz
StrikeThrough-Eigenschaft

Siehe Bold-Eigenschaft


Dialogbox-Referenz
Style-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Typ eines Kombinationslistenfeldes
Syntax:	ComboBox.Style[=Typ%]
Lesezugriff:	Lese- und Schreibzugriff nur während der Dialogerstellung.
Für Dialog-Element:	ComboBox
	Parameter	Beschreibung
	Typ%	Integer-Ausdruck, der den Typ eines Kombinationslistenfeldes angibt. Typ% können die folgenden Werte zugewiesen sein:
	Wert	Bedeutung
	0	(Default) Drop-Down-Kombinationslistenfeld. Ein Eingabefeld, daß mit einem Listenfeld kombiniert ist. Das Listenfeld wird geöffnet, sobald der Anwender die Schaltfläche mit dem nach unten weisenden Pfeil betätigt. Die Auswahl eines Eintrages erfolgt über das Eingabefeld oder über das Listenfeld.
	1	Einfaches Kombinationslistenfeld. Ein Eingabefeld, daß mit einem Listenfeld kombiniert ist, das immer angezeigt wird. Die Auswahl eines Eintrages erfolgt über das Eingabefeld oder über das Listenfeld. Die Größe eines einfachen Kombinationslistenfeldes umfaßt immer das Eingabefeld einschließlich des Listenfeldes. Die Voreinstellung der Größe ist so gewählt, daß lediglich das Eingabefeld und nicht das Listenfeld angezeigt wird. Erhöhen Sie daher die Height-Eigenschaft, um das einfache Kombinationslistenfeld zu vergrößern.
	2	Drop-Down-Listenfeld. Ein Eingabefeld, daß mit einem Listenfeld kombiniert ist. Die Auswahl erfolgt jedoch nur über das Listenfeld.
Siehe auch:	Dialogbox-Referenz , AddItem-Methode , Clear-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft ,  MultiSelect-Eigenschaft , NewIndex-Eigenschaft , RemoveItem-Methode , Selected-Eigenschaft , SelLength-Eigenschaft , Sorted-Eigenschaft , TopIndex-Eigenschaft


Dialogbox-Referenz
TabIndex-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Position eines der unter Dialog-Elemente aufgeführten Elemente innerhalb der Reihenfolge der Fokussierung aller Elemente eines Dialoges.
Syntax:	Element.TabIndex[=Index%]
Lesezugriff:	Kann nur während der Dialogerstellung zugewiesen werden.
Für Dialog-Element:	ComboBox, ListBox, CheckBox, FrameControl, TextBox, Label, Preview, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	Index%	Integer-Ausdruck, der die Position eines Elementes innerhalb der Reihenfolge der Fokussierung aller Elemente eines Dialoges angibt.
Sind in einem Dialog mehrere Elemente angeordnet, bewegt ein Druck auf die Taste () den Fokus auf das jeweils nächste Element. Die Reihenfolge, in der dies geschieht, wird mit der TabIndex-Eigenschaft bestimmt. Der Index des ersten Elementes, das den Fokus erhalten soll, muß 0 sein. Bei der Erstellung eines Dialoges wird den Elementen, die diesem Dialog hinzugefügt werden, automatisch ein Index in der Reihenfolge ihrer Anordnung zugewiesen. Wird die TabIndex-Eigenschaft eines Elementes geändert, werden die Indizes der restlichen Elemente aktualisiert. Den Elementen, die nicht sichtbar sind, auf die nicht zugegriffen werden kann oder die nicht fokussiert werden können, wird ebenfalls ein TabIndex zugewiesen. Diese Elemente werden jedoch bei einer Betätigungder Taste () übersprungen.

Siehe auch:	Dialogbox-Referenz , TabStop-Eigenschaft


Dialogbox-Referenz
TabStop-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob eines der unter Dialog-Elemente aufgeführten Elemente über die Taste () fokussiert werden kann.
Syntax:	Element.TabStop[=Bool]
Lesezugriff:	Kann nur während der Dialogerstellung zugewiesen werden.
Für Dialog-Element:	CheckBox, ComboBox, ListBox, TextBox, Preview, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob eines der unter Dialog-Elemente aufgeführten Elemente über die Taste () fokussiert werden kann, und der die folgenden Einstellungen zuläßt:
	Einstellung	Beschreibung
	TRUE	Das Element kann über die Taste () fokussiert werden.
	FALSE	Das Element wird bei einer Betätigung der Taste () übersprungen, behält jedoch seinen Index. Das Element kann außerdem weiterhin über die Maus und den Accelerator gewählt werden.
Siehe auch:	Dialogbox-Referenz , TabIndex-Eigenschaft


Dialogbox-Referenz
Tag-Eigenschaft

Funktion:	Mit Hilfe dieser Eigenschaft können zusätzliche Daten zu einem der unter Dialog-Elemente aufgeführten Elemente in Form einer Zeichenkette abgelegt werden.
Syntax:	Element.Tag[=AddData$]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Dialog, CheckBox, ListBox, ComboBox, FrameControl, TextBox, Label, Preview, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	AddData$	Zeichenkette, die zusätzliche Informationen zum Element enthält.
Verwenden Sie diese Eigenschaft, um einem Element bestimmte Informationen zuzuweisen, die es beispielsweise identifizieren, oder die Ihnen als Anmerkung zu diesem Element dienen.

Siehe auch:	Dialogbox-Referenz , Name-Eigenschaft


Dialogbox-Referenz
Text-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Text, der in einem der unter Dialog-Elemente aufgeführten Elemente angezeigt wird.
Syntax:	Element.Text[=Text$]
Lesezugriff:	Kann für das Element ListBox nur zur Laufzeit ermittelt werden. Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung. für die Elemente ComboBox und TextBox.
Für Dialog-Element:	ComboBox, ListBox, TextBox
	Parameter	Beschreibung
	Text$	Zeichenkette, die aus dem Text besteht, der einem Eingabefeld bzw. einem Kombinationslistenfeld zugewiesen, oder der aus einem der unter Dialog-Elemente aufgeführten Elemente ermittelt werden soll.
Die Text-Eigenschaft dient der Ermittlung eines in einem Listenfeld markierten Eintrages. Einem Textfenster (Element TextBox) und dem Eingabefeld eines Kombinationslistenfeldes kann zusätzlich Text über diese Eigenschaft zugewiesen werden. Die Länge des Textes eines einzeiligen Textfeldes darf 2048 Zeichen nicht überschreiten. In einem mehrzeiligen Textfenster sind 32768 Zeichen zulässig.

Siehe auch:	Dialogbox-Referenz , Caption-Eigenschaft , SelLength-Eigenschaft , SelStart-Eigenschaft , SelText-Eigenschaft , Value-Eigenschaft (HScrollBar|VScrollBar|SpinButton}, Value-Eigenschaft (CheckBox|OptionButton|CommandButton)


Dialogbox-Referenz
Top-Eigenschaft

Funktion:	Bestimmt oder ermittelt die y-Position eines der unter Dialog-Elemente aufgeführten Elemente innerhalb seines Containers.
Syntax:	Element.Top[=yPos]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Dialog, CheckBox, ListBox, ComboBox, FrameControl, TextBox, Label, Preview, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	yPos	Ausdruck vom Typ Long, der die y-Position des Elementes angibt.
Die Top-Eigenschaft gibt Aufschluß über den Abstand zwischen dem oberen Rand des Elementes und dem oberen Rand des Containers, der dieses Element umgibt (beispielsweise der Dialog, in dem das Element angeordnet ist).

Siehe auch:	Dialogbox-Referenz , Height-Eigenschaft , Left-Eigenschaft , Width-Eigenschaft


Dialogbox-Referenz
TopIndex-Eigenschaft

Funktion:	Bestimmt oder ermittelt den an erster Stelle in einem Listenfeld angeordneten Eintrag.
Syntax:	ListBox.TopIndex[=Index%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit, jedoch nicht während der Dialogerstellung.
Für Dialog-Element:	ListBox
	Parameter	Beschreibung
	Index%	Index des an erster Stelle des Listenfeldes angeordneten Eintrages.
Die Voreinstellung dieser Eigenschaft ist 0, für den ersten Eintrag.

Siehe auch:	Dialogbox-Referenz , AddItem-Methode , Clear-Methode , ItemData-Eigenschaft , List-Eigenschaft , ListCount-Eigenschaft , ListIndex-Eigenschaft ,  MultiSelect-Eigenschaft , NewIndex-Eigenschaft , RemoveItem-Methode , Selected-Eigenschaft , SelLength-Eigenschaft , Sorted-Eigenschaft , Style-Eigenschaft , TopIndex-Eigenschaft


Dialogbox-Referenz
Underline-Eigenschaft

Siehe Bold-Eigenschaft


Dialogbox-Referenz
UseMnemonic-Eigenschaft

Funktion:	Bestimmt, ob die CAPTION-Eigenschaft des Label-Dialogelementes zur Definition eines Accelerators herangezogen werden kann oder nicht.
Syntax:	LabelName.UseMnemonic=Bool
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Label
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der bestimmt, ob die Caption-Eigenschaft eines Label-Dialogelementes verwendet werden darf (TRUE) oder nicht (FALSE).
StarBasic erlaubt es, sogenannte Acceleratoren zu definieren, mit denen man dialogunterstützte Programme auch über die Tastatur bedienen kann. Es gilt dabei die Konvention, daß sich die Dialogelemente durch (Alt) und den in der Beschriftung des Dialogelementes unterstrichenen Buchstaben ansteuern lassen. Einige Dialogelemente beseitzten keine Beschriftungs- (CAPTION-) Eigenschaft. Man behilft sich in diesem Fall mit einem LABEL-Dialogelement, daß das Element beschriftet und ebenfalls einen Accelerator definieren kann. In diesem Fall muß das Element, daß über die Tastatur angesprochen werden soll, in der TABINDEX-Reihenfolge direkt dem Label-Element folgen. Der Buchstabe, der die Bedienung auslösen soll, muß im Beschriftungstext mit vorangestelltem „&“-Zeichen vorhanden sein. In diesem Fall ersetzt StarBasic das Kaufmannsund automatisch durch einen Unterstrich, der sich unterhalb des jeweiligen Buchstabens befindet und ihn dadurch als Tastaturkürzel kennzeichnet.

Die UseMnemonic-Eigenschaft bestimmt nun, ob die Tastenkürzel-Definition durch das „&“-Zeichen in einem Label-Dialogelement möglich ist (TRUE) oder nicht (FALSE). Wird sie auf FALSE gesetzt, werden „&“-Zeichen wie ganz normale Zeichen behandelt.

Siehe auch:	Dialogbox-Referenz , Activate-Ereignis , CurrentStep-Eigenschaft , CurrentX-Eigenschaft; CurrentY-Eigenschaft , Deactivate-Ereignis , Hide-Methode , Load-Ereignis , Load-Methode , Step-Eigenschaft


Dialogbox-Referenz
Value-Eigenschaft (HScrollBar|VScrollBar|SpinButton}

Funktion:	Bestimmt oder ermittelt die Position des Bildlauffeldes einer Bildlaufleiste, respektive den Index eines SpinButtons
Syntax:	{HScrollBar|VScrollBar|SpinButton}.Value[=Pos%]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	HScrollBar, VScrollBar, SpinButton
	Parameter	Beschreibung
	Pos%	Position des Bildlauffeldes einer Bildlaufleiste, bzw. Index eines SpinButtons
Wird Value ein Wert zugewiesen, der kleiner als die Min- oder größer als die Max-Eigenschaft des entsprechenden Elementes ist, wird dieser Wert der jeweiligen Eigenschaft angepaßt.

Siehe auch:	Dialogbox-Referenz , Min-Eigenschaft , Max-Eigenschaft


Dialogbox-Referenz
Value-Eigenschaft (CheckBox|OptionButton|CommandButton)

Funktion:	Bestimmt oder ermittelt, ob eine der unter Dialog-Elemente aufgeführten Schaltfläche aktiviert ist.
Syntax:	{CheckBox|OptionButton|CommandButton}.Value[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	CheckBox, OptionButton, CommandButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob eine der unter Dialog-Elemente aufgeführten Schaltflächen aktiviert ist:
	Wert	Bedeutung
	TRUE	Schaltfläche ist aktiviert.
	FALSE	Schaltfläche ist nicht aktiviert.
Ist die Value-Eigenschaft für eine Optionsschaltfläche auf TRUE gesetzt, wird diese Schaltfläche aktiviert und die Aktivierung durch ein Kreuz oder einen Punkt gekennzeichnet, das bzw. der in dem Feld vor der Schaltfläche gesetzt und dargestellt wird. Wird die Value-Eigenschaft für eine Befehlsschaltfläche auf TRUE gesetzt, erzeugt dies ein Click-Ereignis.

Siehe auch:	Dialogbox-Referenz


Dialogbox-Referenz
Visible-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob eines der unter Dialog-Elemente aufgeführten Elemente angezeigt wird oder nicht.
Syntax:	Element.Visible[=Bool]
Lesezugriff:	Kann nur während der Dialogerstellung zugewiesen werden.
Für Dialog-Element:	Dialog, CheckBox, ListBox, ComboBox, FrameControl, TextBox, Label, Preview, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der anzeigt, ob eines der unter Dialog-Elemente aufgeführten Elemente angezeigt wird oder nicht:
	Wert	Bedeutung
	TRUE	Element wird angezeigt.
	FALSE	Element wird nicht angezeigt.
Siehe auch:	Dialogbox-Referenz , Hide-Methode


Dialogbox-Referenz
Width-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Breite eines unter Dialog-Elemente aufgeführten Elementes.
Syntax:	Element.Width[=ElemWidth]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung. Nur Lesezugriff für das Element Picture. Kann für Element Label nur während der Dialogerstellung zugewiesen werden.
Für Dialog-Element:	Dialog, CheckBox, ListBox, ComboBox, FrameControl, TextBox, Label, Preview, Picture, HScrollBar, VScrollBar, CommandButton, OptionButton, SpinButton
	Parameter	Beschreibung
	ElemWidth	Ausdruck vom Typ Long, der die Breite eines unter Dialog-Elemente aufgeführten Elementes angibt.
Siehe auch:	Dialogbox-Referenz , Height-Eigenschaft , Left-Eigenschaft , Top-Eigenschaft , Width-Eigenschaft


Dialogbox-Referenz
VScrollBar-Steuerelement

Funktion:	Ermöglicht dem Anwender die Wertebestimmung in einem vorgegebenen Wertebereich durch einen vertikalen Schiebebalken
Eigenschaften:	Enabled, Height, HelpContextID, HelpText, LargeChange, Left, Max, Min, MousePointer, Name, Parent, SmallChange, Step, TabIndex, TabStop, Tag, Top, Value, Visible, Width
Methoden:	Move, Refresh, SetFocus
Ereignisse:	Change, GotFocus, KeyDown, KeyPress, KeyUp, LostFocus, Scroll


Dialogbox-Referenz
WordWrap-Eigenschaft

Funktion:	Bestimmt, ob der Text eines Bezeichnungsfeldes umgebrochen werden soll.
Syntax:	Label.WordWrap[=Bool]
Lesezugriff:	Lese- und Schreibzugriff zur Laufzeit und Dialogerstellung.
Für Dialog-Element:	Label
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob der Text eines Bezeichnungsfeldes umgebrochen werden soll. Bool kann wie folgt gesetzt werden:
	Wert	Bedeutung
	TRUE	Der Text des Bezeichnungsfeldes wird umgebrochen und paßt sich somit der Höhe an, die dem Bezeichnungsfeld zugewiesen ist.
	FALSE	Der Text des Bezeichnungsfeldes wird nicht umgebrochen und paßt sich somit der Breite an, die dem Bezeichnungsfeld zugewiesen ist.
Siehe auch:	Dialogbox-Referenz , MaxLength-Eigenschaft , MultiLine-Eigenschaft , PasswordChar-Eigenschaft , ReadOnly-Eigenschaft , ScrollBars-Eigenschaft , SelLength-Eigenschaft , SelStart-Eigenschaft , SelText-Eigenschaft


Das StarBasic Integrated Development Environment (IDE)

Einführung

Wozu benötigt man Makros und StarBasic?

Voraussetzungen

Das Konzept der Makroprogrammiersprache

Funktionsweise eines Makros

Aus welchen Elementen besteht ein Makro-Projekt

So werden Makros organisiert und ausgeführt, und so definieren Sie,

Besonderheiten bei Dokumentenvorlagen

Das erste Makro-Programm

So erstellen Sie ein neues Makro

So formulieren Sie den Code

So starten Sie das Makro

So ergänzen Sie Ihr Programm um einen Dialog

Eigenschaften definieren

Aufruf eines Dialogs vom Programmcode aus

Methoden

Ereignisse

Die wichtigsten Ereignisstypen

Laufzeiteigenschaften definieren und abfragen

Umsetzung von Eigenschaften, Methoden und Ereignissen im Beispielprojekt

Speichern des Projektes

Die „technischen Daten“ von StarBasic

Variablen

Konventionen bei der Vergabe von Variablennamen

Variablendeklarationen

Variablentypen

Definition von Variablen

Vordefinierte Systemvariablen

Arrays

Konstanten

Verwenden von Objekten

Anwenden von Objekten im Programm-Code

Diese Objekte gibt es

Objekt-Collection

Diese Collections gibt es

Prozeduren (SUBs) und Funktionen (FUNCTIONs)

Gültigkeit von Variablen innerhalb von Prozeduren und Modulen und

Bibliotheken, Module und Dialoge

Bibliotheken

Module

Dialogmodule

Das Integrated Development Environment (IDE)

Ein Überblick über die IDE

Anlegen und Verwalten von Bibliotheken und Modulen

Verwalten von Bibliotheken

Verwalten von Modulen und Dialogen

Organisieren von Projekten zwischen Dokumenten bzw. Dokumentvorlagen

Der Basic-Editor

Navigieren im Projekt

Speichern und Laden von Basic-Quelltexten

Fehlersuche in StarBasic-Programmen

Haltepunkte und Einzelschrittbearbeitung

Variablen-Beobachtung

Arbeiten mit dem Aufrufe-Fenster

Weitere Makro- und StarBasic-Möglichkeiten

Makros bzw. StarBasic-Projekte automatisch ausführen

Verknüpfung von Makros bzw. StarBasic-Projekten mit Symbolleisten, Tastatur oder Pull-Down-Menüs


Das StarBasic Integrated Development Environment (IDE)
Einführung

Je intensiver Sie mit einem StarOffice-Programm arbeiten, desto mehr werden Sie feststellen, daß sich die eigentliche Arbeit mit dem Programm dank der Objektorientiertheit von StarOffice auf immer wiederkehrende Handgriffe reduziert. Daher verlangt man irgendwann nach noch stärkerer Automatisierung. Um das Arbeiten mit StarOffice gänzlich zu perfektionieren, haben sich die StarOffice-Entwickler eine Besonderheit einfallen lassen: Die Makro-Programmiersprache von StarOffice – StarBasic.

Die einfachste Möglichkeit, von diesen Makros Gebrauch zu machen, ist, sie von der Applikation, in der Sie sie benötigen, aufzeichnen zu lassen. Sie starten den Makrorekorder, und das StarOffice-Programm, in dem Sie sich befinden, merkt von diesem Zeitpunkt an solange alle Aktionen, die Sie durchführen, bis Sie die Makroaufzeichnung beenden. Ein auf diese Art und Weise aufgezeichnetes Makro können Sie dann jederzeit wieder ablaufen lassen und damit Arbeitsgänge automatisieren.

Doch damit nicht genug: Wie der Name schon sagt, handelt es sich bei der Makroprogrammiersprache StarBasic um eine richtige Programmiersprache – nämlich Basic. Diese Programmiersprache ist so mächtig, daß man Sie schon als Programmentwicklungssystem bezeichnen kann. In diesem Handbuch möchten wir Ihnen dieses Programmentwicklungssystem StarBasic nahebringen.

Dieses Handbuch beschreibt Ihnen im ersten Kapitel zunächst das Konzept von StarBasic. Sie erfahren, was genau hinter der Makroaufzeichnung steckt und wie eine StarOffice-Applikation Makros als Basic-Programm speichert. Anhand eines ersten kleinen StarBasic-Projekts stellt Ihnen dieses Kapitel das grundsätzliche StarBasic-Konzept und seine Möglichkeiten vor.

Das zweite Kapitel geht auf alle notwendigen Fakten, die Sie für die Entwicklung eines StarBasic-Projektes benötigen, im Detail ein. Sie erfahren, wie man Projekte mit eigenen Dialogen erstellt und wie Sie mit dem StarBasic-Editor arbeiten. Das Kapitel beschreibt, wie Sie Basic-Projekte in Modulen und Bibliotheken strukturieren und auf welche Art und Weise Sie spezielle Funktionen der jeweiligen Applikation (StarWriter, StarCalc und StarDraw) aus Basic heraus nutzen können. Auch das Fehlerbereinigen von Programmen wird in diesem Kapitel beschrieben.

Der dritte Teil schließlich enthält sämtliche Befehle und Funktionen nach Themen gegliedert. Er bildet somit die Referenz.

Wozu benötigt man Makros und StarBasic?

Es gibt zwei Möglichkeiten, die Makroprogrammiersprache StarBasic zu nutzen. Zum einen können Sie, wie schon erwähnt, jede StarOffice-Applikation anweisen, ein Makro aufzuzeichnen und diese aufgezeichneten Arbeitsanweisungen jederzeit wiederholen zu lassen.

Schaut man dabei ein wenig hinter die Kulissen eines aufgezeichneten Makros, stellt man fest, daß die jeweilige Applikation bei jeder Makroaufzeichnung ein StarBasic-Programm schreibt, das den zuvor durchgeführten und protokollierten Anwenderaktionen entspricht, oder besser, dessen Ausführung bewirkt, daß nacheinander die den Anwenderaktionen entsprechenden StarBasic-Funktionen aufgerufen werden.

StarBasic nur für diese Aufgabe herzunehmen hieße jedoch, „mit Kanonen auf Spatzen schießen“. Denn zum anderen können Sie mit Hilfe von StarBasic und dessen Benutzerumgebung, dem sogenannten Integrated Development Environment – kurz IDE genannt –, wie in einer professionellen Basic-Entwicklerumgebung arbeiten. Sie entwickeln hier Ihre eigenen Basic-Projekte mit der professionellen Unterstützung einer Entwicklungsumgebung, die anderen Basic-Entwicklungssystemen in keiner Weise nachsteht – nur mit dem Unterschied, daß Sie die komplette Funktionsvielfalt einer jeden StarOffice-Applikation von Basic aus mitnutzen können.

Die Möglichkeiten, die sich hieraus ergeben, sind enorm: Sie können im Prinzip eine Office-Oberfläche aufbauen, die auf Ihre ganz bestimmten Bedürfnisse zugeschnitten ist. Oder gehen Sie noch einen Schritt weiter, und entwickeln Sie kommerzielle Anwendungen für den Vertrieb.

Welche Voraussetzungen sind nötig, um mit
StarBasic zu arbeiten?

Wenn Sie selber Hand anlegen und StarBasic für mehr als nur für die reine Makroaufzeichnung nutzen möchten, dann sollten Sie die Beherrschung eines Basic-Dialektes als Voraussetzung mitbringen. Dieses Handbuch soll Ihnen nicht als Einführung in diese Programmiersprache dienen, denn das würde den Rahmen dieses Buches eindeutig sprengen. Möchten Sie Basic lernen, erkundigen Sie sich im Fachhandel nach einschlägiger Literatur zu Basic – es gibt mehr als genug.

Beherrschen Sie jedoch einen Basic-Dialekt, und möchten Sie in die Entwicklung von StarBasic-Anwendungen einsteigen, dann ist das eine ausreichende Voraussetzung. Sicherlich gibt es hier und da einige Abweichungen von Ihnen bekannten Basic-Konzepten. Aber die finden Sie an den jeweiligen Stellen dieses Handbuches beschrieben. Sie werden nach kurzer Einarbeitungszeit feststellen, daß es ein Leichtes ist, eigene StarBasic-Applikationen zu entwerfen.

Das Konzept der Makroprogrammiersprache

Dieses Kapitel beschreibt Ihnen, welches Konzept sich hinter der Makroprogrammiersprache StarBasic verbirgt und insbesondere, wie das Zusammenspiel von Dokumenten, Dokumentenvorlagen und Basic-Projekten funktioniert.

Funktionsweise eines Makros –
Aufzeichnen und Ausführen eines Makros

In dem Moment, in dem Sie ein Makro aus einer StarOffice-Applikation aufzeichnen, passiert folgendes: Der Makrorekorder beobachtet eigentlich gar nicht, welche Windows-Elemente Sie bedienen, sondern lediglich, welchen Funktionsaufruf die Bedienung eines Elementes (Aufruf eines Pulldown-Menüs, Verlassen einer Dialogbox mit bestimmten Einstellungen, etc.) zur Folge hat. Diese Funktionsaufrufe, die sich hinter der Bedienung der Elemente verbergen, „merkt“ sich der Makrorekorder und macht daraus ein StarBasic-Programm. Beim Ablauf eines StarBasic-Programms werden diese „gemerkten“ Funktionen nacheinander aufgerufen. Das Ergebnis ist identisch zu Ihrer „manuellen“ Vorgehensweise.

Ein Beispiel anhand des Programms StarWriter soll das verdeutlichen. Oft genug kommen Buchstabendreher bei der Erfassung von Texten vor, daß also zwei Buchstaben innerhalb eines Wortes „vertaushct“ werden. In der Regel merkt man einen solchen Dreher sofort; das Korrigieren kostet aber Zeit. Der Cursor wird rückwärtsbewegt, beide werden Buchstaben gelöscht und neugeschrieben. Ein Makro könnte die Buchstaben tauschen. Dazu bräuchte es lediglich den einen Buchstaben auszuschneiden, den Cursor einen Schritt nach links zu bewegen, und den ausgeschnittenen Buchstaben wieder an der neuen Position einzufügen.

Zeichnen wir ein solches Makro einmal auf:

"	Starten Sie StarWriter und schreiben Sie direkt im Dokument ein Wort, daß einen Buchstabendreher enthält (z.B. „Bildschrim“). Positionieren Sie den Cursor hinter dem letzten der beiden vertauschten Zeichen.

"	Wählen Sie im Menü EXTRAS den Menüpunkt MAKRO. StarWriter zeigt Ihnen jetzt den folgenden Dialog:

Der Makro-Grund-Dialog

"	Geben Sie an dieser Stelle im Eingabefeld MAKRONAME den Namen „Test1“ ein. In dem Moment, in dem Sie diesen Namen eingegeben haben, sehen Sie, daß im Listenfeld MAKRO AUS der Eintrag MODUL1 selektiert wurde.

"	Klicken Sie nun auf die Schaltfläche [AUFZEICHNEN].

	Der Dialog verschwindet vom Bildschirm. Gleichzeitig sehen Sie einen kleinen Dialog – den Makrorekorder –, der Ihnen anzeigt, daß die Makroaufzeichnung aktiviert ist, und mit dem Sie auch die Makroaufzeichnung schließlich wieder beenden können. Das bedeutet: StarWriter merkt sich von jetzt an alle Funktionen, die Sie über die verschiedenen Kontrollelemente von Windows (Pull-Down-Menüs, Dialogelemente, etc.) aufrufen – „schreibt“ sie also quasi mit.
"	Bewegen Sie jetzt den Cursor zwei Zeichen nach links.

"	Halten Sie (ª) gedrückt und bewegen Sie den Cursor nach recht. Das erste „falsche“ Zeichen ist damit markiert. Betätigen Sie (ª)(Entf) um das Zeichen auszuschneiden.

"	Betätigen Sie (Æ) und fügen Sie das Zeichen an der richtigen Position mit (ª)(Einfg) ein. Der Buchstabendreher ist korrigiert.

"	Verlassen Sie den Dialog mit [OK] und klicken Sie nun auf die „Stop“-Schaltfläche des Makrorekorders. Die Makroaufzeichnung ist damit abgeschlossen.

Das Ergebnis dieser Aufzeichnung wollen wir nun im folgenden betrachten:

"	Wählen Sie wieder den Menüpunkt EXTRAS/MAKRO an.

"	In dem Moment, in dem Sie im Listenfeld MAKRO AUS auf den Eintrag „Modul1“ unterhalb des Eintrags „swriter3“ klicken, zeigt StarWriter den Makronamen des Makros, das wir gerade aufgezeichnet haben, im linken Listenfeld an. Da dieser Eintrag zunächst der einzige ist, ist er bereits selektiert. Sollten Sie bereits weitere Makronamen an dieser Stelle vorfinden, selektieren Sie bitte den Eintrag „test1“ durch Mausklick.

"	Klicken Sie jetzt auf die Schaltfläche [BEARBEITEN]. StarWriter ruft jetzt die sogenannte IDE auf, die StarBasic-Entwicklungsumgebung. Dort finden Sie unser aufgezeichnetes Makro als Programm wieder:

Sub ZeichenAustauschen

'Aufgezeichnetes Makro: Mittwoch, 13. Dezember 1995, 16:51

‘	ActiveWindow.Text.GoLeft( 2, FALSE)

ActiveWindow.Text.GoRight( 1, TRUE )

ActiveWindow.Text.Cut()

ActiveWindow.Text.GoRight( 1, FALSE )

ActiveWindow.Text.Paste()

End Sub

Sie können die Vorgehensweise zum Aufbau eines Makros sehr schön erkennen: Aus dem aufgezeichneten Makro ist eine Basic-Unterroutine geworden, die genau die Aufrufe der Befehle enthält, welche sich ebenfalls hinter den Aktionen verbergen, die wir benutzt haben, während das Makro aufgezeichnet wurde. Die meisten der im Programm verwendeten Anweisungen und Funktionen entpuppen sich beim genaueren Hinsehen als sogenannte Methoden, die sich auf ein bestimmtes Objekt beziehen – in diesem Falle auf das Objekt ACTIVEWINDOW, also auf das momentan aktive Dokument. Für die Verdeutlichung, wie Makros grundsätzlich funktionieren, mag das als Demonstration für den Moment genügen – genauere Hintergrundinformationen zur Vorgehensweise erfahren Sie später.

Mit diesem Aufbau von Makros sind gleich zwei Ansprüche erfüllt. Hinter nahezu allen Möglichkeiten, die eine StarOffice-Applikation bietet, stecken Basic-Äquivalente, die sich auf die hier vorgestellte Art und Weise aufzeichnen lassen. Dadurch, daß die meisten Befehle eines StarOffice-Programms auch im Basic enthalten sind, ergibt sich eine weitere Konsequenz: Fast alle Funktionen einer StarOffice-Applikation lassen sich durch Basic-Programme bedienen. Dieses Konzept erschliest dem Makro-Programmierer fast grenzenlose Welten: Die Programmierung maßgeschneideter Lösungen, natürlich mit Schwerpunkt auf der jeweiligen Stärke eines StarOffice-Programms Textverarbeitung, Tabellenkalkulation oder Präsentation und Gestaltung, wird zum Kinderspiel. Programmieren Sie sich Ihre eigene Benutzeroberfläche für die Berechnung und Darstellung komplizierter mathematischer Vorgänge, entwickeln Sie eigene Redaktions- oder Autorensysteme mit StarWriter als Textverarbeitungsbasis oder automatisieren Sie eine Multimediapräsentation für Ausstellungen mit interaktiver Benutzersteuerung – dank StarBasic ist all dies machbar.

Aus welchen Elementen besteht ein Makro-Projekt

Bisher haben wir lediglich einen kleinen Bestandteil dessen kennengelernt, was zu einem Makro-Projekt oder nennen wir es lieber: StarBasic-Projekt gehört – eine einzelne Unterroutine.

SUBs und FUNCTIONs

Wie jeder Basic-Dialekt kennt auch StarBasic Unterroutinen und Unterfunktionen, die sogenannten SUBs und FUNCTIONs als elementare Hilfe zum Aufbau strukturierter Programme, die alle unabhängig voneinander aufrufbar sind, sich aber auch gegenseitig aufrufen können.

Im Idealfall wird ein Basic-Projekt in verschiedene Teilprobleme zerlegt. Diese Teilprobleme werden abermals in Teilprobleme aufgegliedert, etc. Dieser Vorgang geschieht solange, bis innerhalb von SUBs und FUNCTIONs die „Lösung“ des kleinsten Problembausteins erfolgt. Erst hier finden sich spezielle Programmieralgorithmen und angewandtes Programmieren wieder. Ansonsten besteht ein Basic-Projekt im Idealfall nur aus dem Aufruf von SUBs und FUNCTIONs, die eine große Problemlösung in kleine Teile aufteilen.

Hinweis: Zeichnen Sie ein Makro in einer StarOffice-Applikation auf, wird das Ergebnis einer SUB zugeordnet, die als Funktionsnamen den Namen trägt, den Sie bei der Makroaufzeichnung bestimmt haben.

Bibliotheken und Module

SUBs und FUNCTIONs strukturieren ein Programm und machen es leichter lesbar – soviel haben wir bislang schon erfahren. Jedoch: In dem Moment, in dem Ihr Programmprojekt wirklich überdurchschnittlich umfangreich zu werden droht, kann selbst mit dieser Strukturierungstechnik die Übersicht noch verloren gehen, daher bietet StarBasic zwei weitere Strukturierungshilfen an: Die Anordnung von StarBasic-Unterroutinen in Modulen und in Bibliotheken.

Module können Bestandteile von Programmen – also SUBs und FUNCTIONs – aufnehmen und kathegorisieren. Mehrere Module selbst können wiederum in Bibliotheken zusammengefaßt werden. Diese Struktur können Sie sich durch den folgenden Dialog verdeutlichen:

Struktur eines StarBasic-Projektes

In der ersten Zeile des Listenfeldes erkennen Sie das Element, dem das gesamte StarBasic-Projekt zugeordnet ist, in diesem Fall der Applikation (StarWriter im Beispiel) selbst. Jedem Element, dem man ein StarBasic-Projekt zuordnen kann –wie im Beispiel der Applikation selbst, einem Dokument oder einer Dokumentenvorlage – ist wenigstens eine Bibliothek zugeordnet. Standardmäßig gibt StarBasic den Bibliotheksnamen STANDARD dafür selbst vor, und legt eine solche Bibliothek auch für jede Applikation oder für jedes neue Dokument oder  Dokumentenvorlage auch selbst an. Innerhalb dieser Bibliothek haben dann die verschiedenen Module Platz. Die Module selber schließlich nehmen die verschiedenen Unterprogramme, also die SUBs und FUNCTIONs, auf.

So werden Makros organisiert und ausgeführt, und so definieren Sie, wo Ihr Programm startet

Nun stellen sich Ihnen sicherlich gleich drei Fragen. Die erste: Wie kann ich ein Makro aufzeichnen, daß als SUB oder FUNCTION an einer „bestimmten Stelle“ auftaucht, und: Wie kann ich ein bestimmtes Makro ausführen, bzw. wo befindet sich überhaupt der für den Programmstart relevante Beginn eines StarBasic-Projektes.

So bestimmen Sie, welchem Element, welcher Bibliothek und welchem Modul ein Makro bei der Aufzeichnung zugeordnet wird

In dem Moment, in dem Sie ein Makro aufzeichnen, befinden Sie sich in einem bestimmten Dialog, direkt nachdem Sie das Menü EXTRAS/MAKRO aufgerufen haben. In diesem Dialog findet sich die Struktur der Makros wieder.

Bestimmen des Ziels beim Aufzeichnen eines Makros

Im Dialog erkennen Sie das Listenfeld MAKRO AUS. Vor der Aufzeichnung bestimmen Sie per Mausklick auf den entsprechenden Eintrag, welchem Modul innerhalb welcher Bibliothek und welchem übergeordneten Element (Applikation, Dokument oder Dokumentenvorlage) das Makro zugeordnet werden soll. Möchten Sie, daß das Makro einem Modul eines Dokumentes oder einer Dokumentenvorlage zugeordnet werden soll, müssen Sie die entsprechende Datei natürlich zuvor geöffnet haben. In der Liste  erscheinen dann alle Dokumentennamen bzw. Dokumentenvorlagennamen mit der vorgegebenen Bibliothek STANDARD, die direkt die Unterprogramme, sprich: die aufgezeichneten Makros, aufnehmen kann. Nachdem Sie das gewünschte Element ausgewählt haben, bestimmen Sie im Eingabefeld den Namen des Makros, und klicken anschließend auf die Schaltfläche [AUFZEICHNEN].

So bestimmen Sie, welches Makro aus welchem übergeordneten Element abgespielt werden soll

Genau das gleiche gilt für das Abspielen eines Makros: Hier bestimmen Sie im selben Dialog, welches Makro Sie abspielen lassen möchten. Sie wählen ebenfalls wieder per Mausklick  aus der Liste MAKRO AUS das gewünschte Makro aus, klicken dann jedoch nicht auf die Schaltfläche [AUFZEICHNEN] sondern auf die Schaltfläche [AUSFÜHREN].

Ein wenig anders verhält es sich, wenn Sie StarBasic-Projekte entwickeln, bei denen sich gezwungenermaßen Makroaufzeichnungen und „Eigenentwicklungen“ vermischen. Sobald Sie ein eigenes Projekt entwickeln, legen Sie als erstes ein neues Modul an, das Ihr „Projekt“ aufnimmt. In dem Moment, in dem Sie ein neues Modul anlegen, definiert StarBasic automatisch eine zunächst noch leere SUB namens MAIN, mit der das Programm startet.

Besonderheiten bei Dokumentenvorlagen

Dokumentenvorlagen dienen in der Regel dazu, bestimmte Inhalte zu speichern, die beim Erstellen eines neuen Dokuments automatisch mit in das neue Dokument übernommen werden. Das gilt für StarWriter, StarCalc und StarOffice für den jeweils gültigen Dokumententyp. Haben Sie beispielsweise in StarWriter eine Dokumentenvorlage angelegt, die den Text für einen FAX-Vordruck beinhaltet, und öffnen Sie ein neues Dokument auf deren Basis, wird diese FAX-Vorlage automatisch in das neue Dokument übernommen.

Bei allen drei Applikationen gilt das gleiche auch für Makros oder StarBasic-Projekte, die Sie innerhalb einer Dokumentenvorlage zugeordnet haben. Erstellen Sie beispielsweise ein neues Dokument auf Basis einer Dokumentenvorlage, die auch Makros enthält, werden Kopien dieser Makros oder StarBasic-Projekte als Kopie in Ihrem neuen Dokument angelegt.

Das erste Makro-Programm

In den folgenden Abschnitten stellen wir Ihnen die Makro-Programmierung an einem Beispiel vor. In diesem Kapitel erfahren Sie am Beispiel von StarWriter, wie Sie vorgehen, um ein neues Makro-Projekt zu erstellen, den Programm-Code ausformulieren, das Projekt um einen Dialog ergänzen, es an eine Dokumentenvorlage zu koppeln und schließlich auszuführen. Das Beispiel: Wir entwickeln ein Programm, mit dessen Hilfe sich in beliebigen Dateien nach einer bestimmten Zeichenkette suchen läßt.

So erstellen Sie ein neues Makro

In unserem Beispiel soll das Programm an eine Dokumentenvorlage gekoppelt werden. Das erste, was also zu tun ist, ist eine neue Dokumentenvorlage zu erstellen, die dann das Makro aufnimmt. Der Vorteil dabei: Wann immer ein neues Dokument auf Basis dieser Vorlage erstellt wird, steht das entwickelte Makro ebenfalls zur Verfügung. Um eine neue Dokumentenvorlage zu erstellen, öffnen Sie ein neues Dokument und speichern es als Dokumentenvorlage ab – für unser Beispiel unter dem Namen „Maktest“.

"	Fahren Sie dazu im Menü DATEI auf den Menüpunkt SPEICHERN UNTER.

"	Geben Sie im Textfeld Dateiname den Namen „Maktest“ ein, und bestimmen Sie im Kombinationsfeld DATEITYP „StarWriter 3.0 Vorlage/Template“ durch Auswahl aus der Liste.

"	Bestätigen Sie den Dialog mit [OK], um das Dokument als Vorlage zu speichern.

Als nächstes gilt es, die Hauptroutine des Programms zu entwerfen. Da wir später das Programm unter einem bestimmten Namen als Makro aufrufen möchten, benötigen wir als allererstes eine Unterroutine, mit der das Programm gestartet wird. Diese Unterroutine, eine SUB, kann dann auch später als Makro angesprochen und z.B. in Symbolleisten oder als Eintrag eines Pull-Down-Menüs konfiguriert werden. Das Makro soll den Namen „ErweiterteSuche“ tragen, und genau dieser Name wird daher auch der Name der SUB sein. Legen wir also ein solches Makro an:

"	Fahren Sie dazu im Menü EXTRAS auf den Eintrag MAKRO. Bestimmen Sie unter MAKRO AUS durch Mausklick auf den Eintrag STANDARD unterhalb des Eintrags MAKTEST, daß das Makroprojekt in der Dokumentenvorlage „Maktest“ abgespeichert werden soll.

Hinweis: In dem Moment, in dem Sie eine Dokumentenvorlage erstellt haben, die ein Makro oder Makro-Projekt aufnehmen soll, legt das jeweilige StarOffice-Programm automatisch eine Bibliothek mit dem Namen Standard an, die alle Dialoge oder weitere Module aufnimmt. SUBs oder FUNCTIONs werden grundsätzlich in Modulen gespeichert. Wenn Sie also explizit kein Modul anlegen, legt das StarOffice-Programm automatisch ein Modul namens „Modul1“ an, das die neue SUB aufnimmt.

"	Geben Sie nun den Makro-(SUB-) Namen „ErweiterteSuche“ im Textfeld MAKRONAME ein, und rufen Sie die BASIC-IDE – das ist die StarBasic-Entwicklerumgebung – durch die Schaltfläche [NEU] auf.

Die Entwicklerumgebung von StarBasic – die IDE (Integrated Developer Environment)

So formulieren Sie den Code

Sie erkennen, daß sich der Cursor im Editor befindet. Den Prozedurnamen „ErweiterteSuche“ hat die IDE an dieser Stelle schon vorgegeben. Den eigentlichen Code können Sie nun an dieser Stelle formulieren:

Möchten Sie den Programm-Code abschreiben, so geben Sie ihn laut untenstehendem Listing zeilenweise ein. Betätigen Sie (¢) nach jeder Zeile.

Farbgebung während der Code-Eingabe

Sie werden bei der Eingabe der Code-Zeilen feststellen, daß bestimmte Komponenten einer Befehlszeile zur optischen Hilfestellung direkt eingefärbt werden. Der Editor verfährt dabei nach folgenden Richtlinien:

"	Der Editor hat ein Basic-Schlüsselwort (wie PRINT oder BEEP) erkannt und färbt es blau ein.

"	Der Editor hat einen Kommentar (eingeleitet durch REM oder „  ‘ “) erkannt und färbt den gesamten Kommentar grau ein.

"	Der Editor hat einen Ausdruck erkannt und färbt diesen grün ein.

"	Der Editor hat eine Zeichenkette oder einen Wert erkannt und färbt diese rot ein.

Hinweis: Falls Sie bei der Installation von StarOffice angegeben haben, die Tutor-Dateien mit zu installieren, brauchen Sie das Programm nicht abzutippen, sondern können es direkt laden. Sie finden dieses Programm im Tutor-Verzeichnis unter dem Namen BASIC1.SDW. Laden Sie dieses Dokument, wählen Sie EXTRAS/MAKRO, klicken Sie auf den Eintrag MODUL1, der sich unterhalb von BASIC1 befindet, und klicken Sie anschließend auf [BEARBEITEN], um zum Programmtext zu gelangen.

Listing des Beispielprogramms

option explicit

Sub ErweiterteSuche

 dim DateiNamen$(1 to 100)

 dim Counter%

 dim Text$

 dim z%

 dim Pfad$

 dim Anzahl%

rem EingabeDialog.Show

Counter%=1

do

DateiNamen$(Counter%)=InputBox("Bitte geben Sie den Namen der Datei ein (* für Ende)","ErweiterteSuche","")

if DateiNamen$(Counter%)="*" then

Counter% = Counter% - 1

exit do

endif

 Counter% = Counter% + 1

loop

Text$ = inputbox("Bitte Suchtext eingeben","Erweiterte Suche", " ")

for z%=1 to Counter%

StarWriter.Documents.Open(DateiNamen$(z%))

Anzahl% = 0

do

   	ActiveWindow.Search(Text$)

Anzahl% = Anzahl%+1

loop until Selection.Value = ""

print "Der Suchbegriff trat im Dokument "; DateiNamen$(z%);" ";anzahl%-1;" mal auf."

ActiveDocument.Close("",False)

next z%

End Sub

Die Programmbeschreibung

Kommen wir zur Erklärung dieses kleinen Programms. Das Programm startet mit der SUB-Deklaration. In der Zeile „SUB...“ wird der Name des Makros bzw. der Basic-Routine definiert. Anschließend werden im DIM-Block nach gewohnter Basic-Manier die erforderlichen Variablen deklariert, die im weiteren Programm erforderlich sind. Die entsprechenden Bedeutungen können Sie aus den beistehenden Kommentaren ersehen.

In der ersten DO/LOOP-Schleife liest das Programm mit Hilfe des INPUTBOX-Befehls nacheinander die Namen der Dokumente ein, die es auf ein bestimmtes Schlüsselwort zu untersuchen gilt. Beachten Sie, daß der bekannte INPUT-Befehl selber bei Programmentwicklungssystemen, die unter einer grafischen Benutzeroberfläche wie Windows, Xwindows oder OS/2 laufen, nur für Dateioperationen verwendet werden sollte.

Die eingelesenen Namen werden zunächst in einem String-Array gespeichert. Die Schleife, die dieses Einlesen übernimmt, wird erst dann beendet, wenn der Anwender ein Sternchen („*“) als Abbruchkriterium angibt.

Anschließend wird der Anwender aufgefordert, den Text einzugeben, nach dem die Dokumente durchsucht werden sollen. Dies geschieht mit dem entsprechenden INPUTBOX-Befehl, der den Text in der Variablen TEXT$ aufnimmt.

Das eigentliche Problem löst das Makro im letzten Schleifenblock mit Hilfe einer FOR/NEXT-Schleife. Mit der entsprechenden Methode öffnet das Programm das Dokument (OPEN). Damit wird das geöffnete Dokument zum aktiven Fenster, und kann über das ACTIVEWINDOW-Objekt angesprochen werden. Genau das geschieht bei der Suche des Suchtextes im aktiven Fenster mit Hilfe der SEARCH-Methode. Diese Methode macht nichts anderes, als wenn Sie in einem StarOffice-Programm im Menü BEARBEITEN die Funktion SUCHEN UND ERSETZEN aufrufen und anschließend durch [OK] nach dem zuvor eingegebenen Suchtext suchen lassen – er sucht das durch den Zeichenfolgeparameter angegebene Wort im aktiven Dokument und selektiert dort die entsprechende Zeichenkette, sofern der Ausdruck gefunden wurde.

In unserem Falle sollen alle Dokumente durchsucht werden. Da uns die Namen der Dokumente bekannt sind, brauchen wir Sie lediglich in einer Schleife nacheinander zu öffnen (OPEN), zu untersuchen (DO/LOOP-Block) und dann wieder zu schließen (ACTIVEDOCUMENT.CLOSE).

Die Auswertung eines einzigen Dokumentes erfolgt über die DO/LOOP-Schleife. Der Suchvorgang wird durch SEARCH gestartet. War er erfolgreich, ist der gefundene Text im Dokument markiert. Jeder im Dokument markierte Text kann mit Hilfe der SELECTION-Funktion ermittelt werden. Auf diese Art und Weise können wir feststellen, ob ein Suchergebnis zutraf, denn in diesem Fall ergibt eine Abfrage des markierten Textes mit der SELECTION-Funktion keinen Leer-String. Folglich wird die DO/LOOP-Schleife solange durchlaufen, bis der Suchaufruf keine Markierung und damit auch kein Ergebnis (mehr) zur Folge hatte. Die Schleife wird dann durch die UNTIL-Anweisung verlassen. Solange jedoch Suchergebnisse aufgetreten sind, wird die Integervariable ANZAHL% heraufgezählt und enthält damit später die Trefferquote der Suche. Diese Trefferquoten werden nacheinander für jede Datei durch den PRINT-Befehl auf dem Bildschirm angezeigt.

So starten Sie das Makro

Sie haben jetzt die erste Version unseres Programms als sogenannten Source- (Quell-) Code vor Augen. Sie möchten als nächstes in den Genuß dieses Programms kommen. Um es zu starten, gibt es mehrere Möglichkeiten:

Starten eines StarBasic-Programms aus einem StarOffice-Programm heraus

Sollten Sie sich nicht innerhalb der IDE befinden, starten Sie ein StarBasic-Programm, in dem Sie im Menü Extras/Makro das entsprechende Makro (und damit die entsprechende SUB) bestimmen, und anschließend auf [AUSFÜHREN] klicken.

Starten eines StarBasic-Programms aus der IDE

Wählen Sie das AUSFÜHREN-Symbol aus der Objektleiste aus. StarBasic kompiliert das Programm und startet es anschließend. Kompilieren bedeutet, daß das Programm so für den Prozessor Ihres Computers aufbereitet wird, daß dieser die Befehle in „seiner Sprache“ versteht, um Sie damit zum gewünschten Ergebnis zu bringen. Das Programm wird dabei mit der Routine gestartet, die sich als „oberste“ SUB im Source-Code befindet, bzw. mit einer speziellen, sogenannten SUB Main, sofern diese vorhanden ist. In unserem Beispiel gibt es nur die SUB ERWEITERTESUCHE, die umgehend gestartet wird, sobald Sie das Ausführen-Symbol anklicken.

Sollten Sie den Programm-Code richtig übernommen, bzw. die entsprechende Tutor-Datei geladen haben, und sich in der BASIC-IDE befinden, passiert nach dem Programmstart folgendes:

Das Basic-Programm fragt Sie durch den INPUTBOX-Befehl nach den Dateinamen:

Abfrage eines Dokumentnamens durch INPUTBOX

"	Geben Sie hier nacheinander alle Dateinamen ein, und bestätigen Sie jede Eingabe mit [OK]. Haben Sie alle Dateinamen bestimmt, die untersucht werden sollen, geben Sie ein Sternchen („*“) ein.

"	Geben Sie im nächsten Schritt den Suchbegriff ein, und bestätigen Sie auch diesen INPUTBOX-Dialog mit [OK].

Sie können jetzt am Bildschirm mitverfolgen, wie das Basic-Programm alle angegebenen Dateien nacheinander öffnet, und die Dokumente auf das Schlüsselwort überprüft. Anschließend bekommen Sie die Auswertung der Prozedur durch den PRINT-Befehl mitgeteilt:

Ausgabe der Sucherfolgsstatistik durch Print

Unterbrechen des Programms

StarBasic erlaubt Ihnen das Abbrechen eines Programms auf unterschiedliche Art und Weise:

"	Grundsätzlich unterbrechen Sie den Programmablauf mit der Tastenkombination (Strg)(Alt)(S) oder (Strg)(Pause). Beim Abbrechen eines Programms durch (Strg)(Alt)(S) erhalten Sie grundsätzlich folgende „Fehlermeldung“.

Laufzeitfehlermeldung: Abbruch des Programms durch den Anwender

"	Haben Sie das Programm aus der IDE heraus gestartet, können Sie das Programm mit Hilfe des Stop-Symbols der Objektleiste unterbrechen.

"	In einem Dialog, der beispielsweise durch PRINT oder INPUTBOX auf den Bildschirm gebracht wurde, können Sie das Programm mit einem Klick auf [ABBRECHEN] oder mit der Tastenkombination (Strg)(Alt)(S) anhalten. Auch hierbei erhalten Sie die o.s. Abbruch-Fehlermeldung.

Fehlermeldungen

Ein ähnlicher Dialog wird ins Leben gerufen, wenn StarBasic während des Kompilierens auf einen Syntaxfehler im Programmcode oder während der Programmausführung auf ein unbekanntes „Element“ stößt. Das kann beispielsweise der Aufruf eines Befehls sein, der überhaupt nicht existiert, den Sie falsch geschrieben haben, oder Sie haben einen Fehler in der Anzahl der Parameter gemacht, die einem Befehl übergeben worden sind. In der Regel „sagt“ Ihnen der StarBasic-Compiler im Klartext, was Sie falsch gemacht haben; die Behebung eines Fehlers wird dadurch ein leichtes:

Ausgabe einer Fehlermeldung beim Übersetzen des Programmcodes

So ergänzen Sie Ihr Programm um einen Dialog

Unser Beispielprogramm hat bislang nur durch Dialoge mit dem Benutzer kommuniziert, die direkt durch Basic-Befehle wie PRINT oder INPUTBOX erzeugt worden sind. StarBasic kann aber noch eine ganze Menge mehr. Mit Hilfe von StarBasic können Sie, vergleichbar mit einem Zeichenprogramm, Ihre Dialoge entwerfen, und so Ihren eigenen Programmen eine ergonomische und professionelle Benutzeroberfläche schenken.

Wir wollen unser Beispielprogramm um einen Dialog erweitern. Ziel ist es, daß der Anwender das Verzeichnis, in dem die Dokumentdateien vorhanden sind, bestimmt, und er anschließend eine Auflistung aller dort vorhandenen „*.SDW“-Dateien in einem Listenfeld bekommt. Desweiteren kann er diese Dateien auswählen und in einer weiteren Listbox zusammenstellen.

So ergänzen Sie ein Projekt um einen Dialog

Als erstes muß dem Projekt ein zunächst noch „leerer“ Dialog hinzugefügt werden. Dazu verfahren Sie wie folgt:

"	Falls Sie sich nicht mehr in der IDE befinden, wechseln Sie dort hinein, indem Sie das Menü EXTRAS/MAKRO wählen, im Dialog, der jetzt erscheint, auf den Eintrag MODUL1 klicken, der sich unterhalb des Eintrags MAKTEST befindet, anschließend auf den Makronamen ERWEITERTESUCHE und schließlich auf [BEARBEITEN] klicken. Sie befinden sich anschließend in der IDE und können den bisherigen Programm-Code des Beispielprogramms erkennen.

"	Wählen Sie in der IDE das MODULE-Symbol aus. Daraufhin erscheint ein Dialog, mit dessen Hilfe Sie einen neuen Dialog anlegen können:

Verwalten von Modulen und Bibliotheken

"	Klicken Sie nun auf die Bibliothek, der Sie einen Dialog hinzufügen möchten. Das ist für unser Beispiel die Bibliothek STANDARD, die zum Dokument MAKTEST gehört.

"	Klicken Sie in diesem Dialog auf die Schaltfläche [NEUER DIALOG]. Die IDE hat der Bibliothek nun einen Dialog namens DIALOG1 hinzugefügt.

"	Um den Namen dieses Dialogs zu ändern, halten Sie die Taste (Alt) gedrückt, und klicken Sie auf den Namen DIALOG1. Sie können den Namen des Dialogs jetzt editieren.

"	Geben Sie den neuen Namen des Dialogs ein; für unser Beispiel wählen Sie den Dialognamen EINGABEDIALOG. Betätigen Sie anschließend (¢).

"	Klicken Sie anschließend auf [BEARBEITEN], wechseln Sie dadurch in den Dialogeditor der IDE.

Der Dialogeditor der IDE

Was Sie an dieser Stelle erkennen können, wirkt im Moment noch vergleichsweise „karg“. Sie sehen in der Mitte des Bildschirms lediglich den momentan noch leeren Dialog. Es fehlen die Hilfsmittel, mit denen Sie auf der einen Seite die Elemente der Dialogbox zusammenstellen und auf der anderen Seite die speziellen Eigenschaften der in der Dialogbox plazierten Elemente definieren können. Diese Elemente befinden sich in der Kontrollfelder-Abreißleiste, die Sie in der Objektleiste des Dialogeditors finden, und nach Belieben auf dem Bildschirm plazieren können.

So plazieren Sie ein Bedienungselement in einem Dialog

"	Klicken Sie für unser Beispiel auf das TEXTBOX-Symbol. Der Mauszeiger nimmt die Gestalt eines kleinen Fadenkreuzes an.

"	Im Dialogfenster ziehen Sie nun das Textfeld mit der Gummibandfunktion auf. Plazieren Sie es so, daß es in der linken, oberen Ecke steht.

Damit haben Sie das erste Bedienungselement im Dialog plaziert.

Komplettieren des Dialogs

Auf diese Art und Weise plazieren Sie alle weiteren Dialogelemente im Dialogfenster. Wir wollen zunächst alle benötigten Elemente in den Dialog bringen, und sie erst im nächsten Schritt richtig sortieren.

"	Wählen Sie aus der Abreißleiste das COMMANDBUTTON-Symbol an. Ziehen Sie damit fünf Schaltflächen im Dialog auf.

"	Wählen Sie aus der Abreißleiste das LISTBOX-Symbol aus, und ziehen Sie damit zwei Listenfelder im Dialog auf.

"	Wählen Sie aus der Abreißleiste das LABEL-Symbol aus, und ziehen Sie damit ein Beschriftungsfeld im Dialog oberhalb des Eingabefeldes auf.

So verschieben, vergrößern und verkleinern Sie ein Dialogboxelement

Im nächsten Schritt werden wir die Elemente so anordnen, daß die Dialogbox „aufgeräumt“ ist. Wählen Sie dazu in der Abreißleiste das SELEKTIEREN-Symbol aus.

"	Um ein Dialogboxelement zu verschieben, klicken Sie mit dem Mauszeiger auf den Rand, halten Sie die Maustaste gedrückt, und verschieben Sie so das Element an die gewünschte Position.

"	Um ein Dialogboxelement zu vergrößern oder zu verkleinern, klicken Sie mit dem Mauszeiger irgendwo in das Element hinein. Sie können erkennen, daß das entsprechende Element mit acht Anfaßpunkten ausgestattet wird, mit deren Hilfe Sie es in alle Himmelsrichtungen vergrößern und verkleinern, dehnen oder stauchen können.

Tip: Falls Ihnen der Platz innerhalb der Dialogbox nicht ausreicht, können Sie die Dialogbox selbst vergrößern, verkleinern oder umpositionieren. Klicken Sie dazu auf den Rand der Dialogbox, und verfahren Sie, wie in den vorherigen beiden Anleitungspunkten beschrieben.

Ordnen Sie die Elemente so an, daß Sie folgendes Bild vor Augen finden:

Tip: Sie finden das komplette Projekt in der Tutor-Datei Maktest2.SDW.

Anordnung der Dialogboxelemente

Hinweis: Sie erkennen, daß der Text in der Schaltfläche neben dem Eingabefeld nicht richtig in das Feld paßt. Diese Tatsache können Sie immer dann ignorieren, wenn Sie im Vorfeld wissen, daß der finale Text wesentlich kürzer als der Vorgabetext ist.

Eigenschaften definieren

Wie Sie in dieser Grafik sehen können, geht aus der Anordnung der Dialoge schon ungefähr hervor, wozu der Dialog gut sein soll: Im oberen Eingabefeld kann der Benutzer den Pfad bestimmen, in dem das Programm nach „*.SDW“-Dateien suchen soll. Klickt er anschließend auf das darunterstehende Listenfeld, sollen dort alle Dateien aufgelistet werden, die in dem angegebenen Verzeichnis vorhanden sind. Klickt er auf die obere Schaltfläche, die sich zwischen den Dialogen befindet, soll eine zuvor ausgewählte Datei dem zweiten Listenfeld hinzugefügt werden; klickt er auf die untere Schaltfläche, wird eine angegebene Datei wieder entfernt. Wählt er die Schaltfläche an, die sich rechts oben befindet, startet das eigentliche Programm und durchsucht alle Dokumente, die im rechten Listenfeld aufgelistet sind.

Was aber noch fehlt, ist die korrekte Beschriftung der einzelnen Elemente. Dazu folgendes:

Farben, Bezeichnungen, Größe und Verhalten von Dialogboxelementen unter bestimmten Situationen werden als Eigenschaften bezeichnet. Diese Eigenschaften lassen sich sowohl während des „Zusammenbauens“ eines Dialoges als auch zur Laufzeit des Programms verändern. Einige Eigenschaften lassen sich dabei nur während der Laufzeit, andere nur während der Dialogboxerstellung definieren.

Um die Eigenschaften von Elementen während der Dialogboxerstellung festzulegen, bietet uns der Dialogeditor ein besonderes Hilfsmittel an, das sogenannte Eigenschaften-Fenster. Probieren wir das am Beispiel aus:

"	Klicken Sie zunächst auf die Schaltfläche, mit der später, zur Laufzeit des Programms, der Dialog beendet werden soll, und anschließend auf das Browser-Symbol der Abreißleiste. Das Eigenschaftenfenster öffnet sich.

Das Eigenschaftenfenster des Dialogeditors

Dieses Eigenschaftenfenster enthält sämtliche Eigenschaften, die Sie für das zuvor selektierte Element bestimmen können. Sie finden dort auch die für uns zunächst wichtigen Eigenschaften NAME und CAPTION. Mit der NAME-Eigenschaft bestimmen Sie den Namen des Elementes. Das ist der Name, mit dessen Hilfe Sie das Element später, zur Laufzeit des Programms, ansprechen können. Die CAPTION-Eigenschaft dient zur Beschriftung des Elementes. Beide Eigenschaften haben nichts miteinander zu tun, auch wenn der Dialogeditor beiden Eigenschaften die gleiche Voreinstellung zuweist. Die CAPTION-Eigenschaft können Sie daher auch nur für die Elemente bestimmen, die irgendeine dokumentierende Aufgabe haben, z.B. die Beschriftung von Schaltflächen. Wir wollen im folgenden die Namen und die Beschriftungen der Dialogelemente ändern:

"	Beginnen wir mit der zukünftigen [OK]-Schaltfläche, die sich rechts oben im Dialog befindet. Normalerweise klicken wir das Element, dem wir eine Eigenschaft zuweisen wollen, zunächst einmal an. In diesem Falle ist das überflüssig, denn das haben wir im vorherigen Schritt schon gemacht.

"	Klicken Sie jetzt in das Feld im Eigenschaftenfenster, das sich links der Eigenschaft CAPTION befindet. Die Eigenschaft CAPTION wird farbig unterlegt. Klicken Sie abermals in dieses Feld, erscheint ein Cursor, und Sie können den vorhandenen Text löschen und dann die Zeichenfolge „OK“ eingeben. Betätigen Sie Ihre Eingabe anschließend mit(¢).

"	Selektieren Sie auf die gleiche Art und Weise die Eigenschaft NAME und ersetzen Sie den vorhandenen Text ebenfalls durch „Ok“.

"	Klicken Sie im Dialog auf die darunterstehende Schaltfläche, und bestimmen Sie sowohl als CAPTION- als auch als NAME-Eigenschaft „Abbruch“.

"	Klicken Sie im Dialog auf die obere Schaltfläche, die sich zwischen den Listenfeldern befindet, und bestimmen Sie als CAPTION-Eigenschaft „>>dazu“ und als NAME-Eigenschaft „dazu“.

"	Klicken Sie im Dialog auf die darunterstehende Schaltfläche, und bestimmen Sie „<<löschen“ als CAPTION und „loeschen“ als Name.

"	Benennen Sie als NAME- und CAPTION-Eigenschaft die letzte Schaltfläche neben der Eingabezeile als „Aktualisieren“.

Achtung: Für die Namensgebung von Dialogboxelementen gelten die gleichen Konventionen wie für Variablennamen. Sie dürfen keine Umlaute, keine Leerzeichen oder Satz- und Sonderzeichen enthalten!

"	Klicken Sie jetzt auf das Eingabefeld. Sie werden im Eigenschaftenfenster jetzt vergeblich nach einer CAPTION-Eigenschaft suchen, denn: Das Eingabefeld hat schlicht und ergreifend keine CAPTION-Eigenschaft, denn es gibt bei einem Eingabefeld nichts zu beschriften. Das gleiche gilt im übrigen für Listenfelder. Aus diesem Grund bestimmen wir für die übrigen Dialogelemente nur noch die NAME-Eigenschaft. Bestimmen Sie als NAME-Eigenschaft für das Eingabefeld den Text „Pfadname“.

"	Bestimmen Sie für die linke Listbox „Dateiliste“ als NAME-Eigenschaft.

"	Bestimmen Sie für die rechte Listbox „Dokumentenliste“ als NAME-Eigenschaft.

Die Definition der Eigenschaften ist damit abgeschlossen.

Hinweis: Natürlich gibt es für jedes Element eine Vielzahl von Eigenschaften, die an dieser Stelle nicht alle erklärt werden sollen. Bedienen Sie sich der Dialogreferenz, in der Sie alle Eigenschaften der existierenden Dialogelemente ausführlich beschrieben finden.

So bestimmen Sie die Titelzeile des Dialogs

Wie (fast) jedes Dialogboxelement, können Sie auch die Beschriftung des Dialogs selber bestimmen. In diesem Fall wird die Beschriftung in der Titelzeile positioniert. Um den Titel des Dialogs zu definieren, brauchen Sie lediglich den Dialog zu selektieren (einfach auf den Rand des Dialogs klicken) und die CAPTION-Eigenschaft zu bestimmen.

"	Bestimmen Sie den Text „Erweiterte Suche:“ als Dialog-CAPTION-Eigenschaft.

So testen Sie den Dialog

Der Dialogeditor bietet Ihnen die Möglichkeit, Ihren Dialog praxisnah zu testen. In der Abreißleiste finden Sie dazu das Symbol TESTMODUS AKTIVIEREN. Klicken Sie auf dieses Symbol, wechselt der Dialogeditor in den Testmodus, und Sie können zur Probe Eingaben vornehmen oder Schaltflächen anklicken, um festzustellen, ob die Anordnung der Elemente tatsächlich der entspricht, die Sie geplant hatten. Sie haben ebenfalls die Möglichkeit, mit () den Fokus auf die verschiedenen Dialogboxelemente zu setzen, so wie Sie es auch von Dialogboxen unter Ihrem Betriebssystem gewohnt sind.

Achtung: Sollten Sie Dialogbox-Elementen bereits Ereignisse zugewiesen haben, so werden diese auch im Test-Modus aufgerufen, wenn Sie die entsprechenden Elemente der Dialogbox bedienen.

So bestimmen Sie den TAB-Index

Dabei werden Sie möglicherweise feststellen, daß, wenn Sie () gedrückt haben, die Reihenfolge der Elemente, die als jeweils nächstes angesprungen werden, nicht korrekt ist. Der Fokus scheint zufällig auf das nächste Element gesetzt zu werden. In Wirklichkeit verhält es sich jedoch so, daß sich die Fokussier-Reihenfolge aus der Reihenfolge des Plazierens der Elemente ergibt. Mit anderen Worten, in der Reihenfolge, in der Sie die Elemente im Dialog plaziert haben, werden Sie auch mit () nacheinander angesteuert. Für die meisten Anwendungen ist das jedoch nicht wünschenswert.

Aus diesem Grund gibt es für jedes Kontrollelement eine TABINDEX-Eigenschaft. Diese Eigenschaft beinhaltet einen Wert, der die Reihenfolge des Ansteuerns durch () bestimmt. Um diese Eigenschaft zu definieren, verfahren Sie wie folgt:

"	Verlassen Sie den Testmodus zunächst durch (Esc).

"	Klicken Sie zunächst das „erste“ Element der TAB-Index-Reihenfolge an. Dieses Element ist auch gleichzeitig das Element, das standardmäßig fokussiert ist, wenn der Dialog aufgerufen wird. In unserem Beispiel sollte das das Eingabefeld sein.

"	Klicken Sie im Eigenschaftenfenster auf die Eigenschaft TABINDEX und tragen Sie dort den Wert „0“ ein.

"	Vergeben Sie für die linke Listbox den Wert „1“, für [>>DAZU] den Wert „2“, für [<<LÖSCHEN] den Wert „3“, für die rechte Listbox den Wert „4“ und für [OK] den Wert „5“.

Schalten Sie nun zurück in den Testmodus, können Sie die Änderungen feststellen, in dem Sie mit () zum jeweils nächsten Element springen – dieses Mal in der richtigen Reihenfolge.

Der Finale Dialog im Testmodus

Aufruf eines Dialogs vom Programmcode aus

Aussehen und Eigenschaften des Dialogs und der dazugehörigen Dialogelemente haben wir erfolgreich abgeschlossen. In den folgenden Abschnitten erfahren Sie, wie Sie einen Dialog von einem Programm heraus aufrufen.

So wechseln Sie zwischen Modulen und Dialogen

Sie können an der unteren Seite des Dialogbox-Editierfensters zwei Registerzungen erkennen, mit deren Hilfe Sie im Projekt zwischen dem Dialog und dem Modul hin- und herspringen können. Sollten Sie in späteren Projekten mehrere Module oder Dialoge verwenden, werden dort natürlich entsprechend mehr Zungen angezeigt, mit denen Sie gezielt zu einem Modul oder einem Dialog springen können. Klicken Sie für unser Beispiel auf MODUL1; Sie befinden sich jetzt wieder in der StarBasic-IDE.

Einbindung des Dialogaufrufes in das Beispielprogramm

Ergänzen Sie die SUB ERWEITERTESUCHE unterhalb des DIM-Blocks um die Befehlszeile:

EingabeDialog.Show

Starten Sie jetzt das Programm, erscheint als allererstes unser Dialog. Schließen Sie diesen Dialog mit der Schließen-Schaltfläche, fährt das Programm, wie bekannt, mit der ganz normalen Abarbeitung fort.

Methoden

Sie haben damit die erste sogenannte Methode kennengelernt. Auf jedes in StarBasic bekannte Objekt sind verschiedene Methoden anwendbar, die irgendeine Auswirkung auf das Objekt haben. Die Befehlszeile

DocName.Search...

bewirkte, daß in dem Objekt DOCNAME (eine zuvor geladene Ansicht eines Dokumentes) z.B. nach einer bestimmten Zeichenkette gesucht wurde.

Die Befehlszeile

EingabeDialog.Show

wendet die Methode SHOW auf das Objekt EINGABEDIALOG an: Mit Hilfe dieser Methode wird das Objekt auf dem Bildschirm dargestellt.

Hinweis: An dieser Stelle werden wir nicht im Detail auf alle möglichen Objektmethoden eingehen. Sie finden eine komplette Referenz aller Methoden im Referenzteil dieses Handbuches.

Ereignisse

Ihr grafisches Betriebssystem ist so ausgelegt, daß immer, wenn ein Benutzer ein Element der Benutzeroberfläche angewählt oder bestimmte Vorgänge mit diesem Element durchgeführt hat, eine bestimmte Aktion ausgelöst wird. Mit anderen Worten: Alle Programme, die ein Anwender verwendet, werden durch Ereignisse gesteuert, die durch den Anwender ausgelöst werden.

In StarBasic ist das nicht anders. Jedes Element, das Sie in einem Dialog plazieren, kann unterschiedliche Ereignisse ausführen. Sie selber als Programmierer haben lediglich dafür zu sorgen, daß eine bestimmte SUB existiert, die dann durchlaufen wird, wenn der Anwender während des Programmablaufes das entsprechende Element auf irgendeine Art und Weise „manipuliert“ hat.

Das wichtigste Element ist das CLICK-Ereignis. Klickt der Anwender auf eine Schaltfläche, löst Ihr Betriebssystem dieses Ereignis automatisch aus. StarBasic überprüft jetzt, ob Sie eine SUB mit diesem Ereignis verknüpft haben. Findet StarBasic eine derartige Verknüpfung, sorgt es dafür, daß diese SUB automatisch aufgerufen wird – Sie selber brauchen sich um diesen Ablauf überhaupt nicht zu kümmern.

So verknüpfen Sie eine SUB eines Moduls mit einem Ereignis

Die Vorgehensweise zur Verknüpfung einer SUB mit einem Ereignis ist denkbar einfach:

"	Wechseln Sie mit der entsprechenden Registerzunge an der Unterseite des IDE-Fensters zurück in den Dialogeditor.

"	Falls das Eigenschaftenfenster nicht mehr aktiviert ist, rufen Sie es mit dem Browser-Symbol der Abreißleiste auf.

"	Klicken Sie jetzt im Dialog das Element an, dem Sie ein Ereignis hinzufügen möchten. Wählen Sie für unser Beispiel die ABBRUCH-Schaltfläche an.

"	Klicken Sie im Eigenschaftenfenster auf die Registerzunge EREIGNISSE. Aus dem Eigenschaftenfenster wird jetzt das Ereignisfenster.

"	Wir möchten definieren, daß eine bestimmte SUB durchlaufen wird, sobald der Anwender auf die Schaltfläche klickt. Das dafür zuständige Ereignis ist CLICK.

"	Klicken Sie nun zweimal in das Feld neben Click. Wie bei Eigenschaften können Sie an dieser Stelle den Namen der SUB eingeben, die automatisch aufgerufen werden soll, sobald der Benutzer diese Schaltfläche anklickt. Für unser Beispiel bestimmen Sie den Namen ABBRUCH_CLICK.

Das Ereignis-Fenster

"	Schalten Sie zurück in die IDE, indem Sie die Registerzunge Modul1 anklicken. Ergänzen Sie das Programm um folgende SUB:

Sub Abbruch_Click

EingabeDialog.Hide

End Sub

Starten Sie jetzt das Programm, erscheint der Dialog. Sobald Sie auf [ABBRUCH] klicken, wird der Dialog beendet. In diesem Moment ruft StarBasic automatisch die SUB ABBRUCH_CLICK auf. Die Hide-Methode sorgt dafür, daß der Dialog geschlossen wird. Da der Dialog mit der SUB ERWEITERTESUCHE auf den Bildschirm gebracht wurde, fährt das Programm, nachdem es ABBRUCH_CLICK durchlaufen hat, mit dem nächsten Befehl der SUB ERWEITERTESUCHE fort. In unserem Beispiel gibt es keinen weiteren Befehl außer END SUB, so daß das Programm mit dieser Anweisung zu Ende ist.

Wichtige Informationen zu Ereignissen

"	Die SUBs, die mit bestimmten Ereignissen verknüpft werden, sollten in derselben Bibliothek wie der Dialog stehen.

"	Wird für ein Ereignis eine SUB definiert, die in keinem Modul existiert, gibt StarBasic eine entsprechende Fehlermeldung aus.

"	Eine FUNCTION darf kein Ereignis verarbeiten.

Tip: Grundsätzlich gibt es keine Konventionen zur Namensvergabe von Ereignissen, außer denen, die auch für „normale“ SUBs gelten. Sollten Sie jedoch umfangreiche Projekte mit vielen Dialogen entwickeln, verwenden Sie vorsorglich die Konvention
ELEMENTNAME_EREIGNISNAME
zur Namensvergebung, damit Sie schon im Programmtext erkennen können, ob es sich bei einer bestimmten SUB um eine Ereignis-SUB oder eine „ganz normale“ SUB handelt. In unserem Beispiel haben wir diese Konvention mit dem SUB-Namen ABBRUCH_CLICK ebenfalls beachtet.

Dialog-Ereignisse

Daß ein Dialog selbst bestimmte Eigenschaften haben kann, haben wir mit der CAPTION-Eigenschaft schon kennengelernt. Dialoge selbst können ebenfalls bestimmte Ereignisse auslösen. Möchten Sie ein Dialog-Ereignis definieren, klicken Sie im Dialogeditor auf den Rand des Dialoges. Im Ereignisfenster werden in dem Moment alle für den Dialog möglichen Ereignistypen aufgelistet, die auf bekannte Art und Weise bestimmt werden können.

Die wichtigsten Ereignisstypen

Im Referenzteil dieses Handbuches finden Sie die möglichen Ereignisse aller Dialogboxelemente und auch die Ereignisse eines Dialogs selbst ausführlich beschrieben. Wir möchten an dieser Stelle gesondert auf die wichtigsten Ereignistypen aufmerksam machen:

Das Load- und Activate-Ereignis des Dialogs

Das Load-Ereignis tritt immer dann ein, wenn der Dialog das erste Mal angezeigt wird. Innerhalb des Load-Ereignisses haben Sie die Möglichkeit, den Dialog initialisierende Schritte zu unternehmen. Sollen beispielsweise Eingabefelder mit bestimmten Texten vom Programm-Code aus vorbelegt werden, können Sie die SUB, die das vornimmt, als Load-Ereignis des Dialogs definieren.

Das Activate-Ereignis wird dann ausgelöst, wenn der Dialog durch den Anwender in den Vordergrund geholt wird. Das ist beispielsweise dann der Fall, wenn der Anwender von einem anderen Fenster durch Mausklick in den Dialog wechselt oder den Dialog auf Symbolgröße verkleinert hatte und ihn wieder auf Normalgröße bringt.

Das Click- und DblClick Ereignis eines Elements

Das Click-Ereignis wird ausgelöst, wenn der Anwender auf ein bestimmtes Element eines Dialoges (oder auch natürlich in den Dialog selbst) klickt.

Das DblClick wird ausgelöst, wenn der Anwender auf ein Dialogelement einen Doppelklick ausführt.

Laufzeiteigenschaften definieren und abfragen

Bestimmte Eigenschaften, die man Dialogelementen während der Dialogerstellung zuweisen kann, haben wir schon kennengelernt. StarBasic ermöglicht Ihnen aber ebenfalls, bestimmte Eigenschaften auch innerhalb eines StarBasic-Programms mit Hilfe entsprechender Befehlszeilen zu ändern oder zu definieren. Die Syntax dafür ist die folgende:

Objektname.Eigenschaft [=Ausdruck]

Möchten Sie beispielsweise den vordefinierten Text des Eingabefeldes namens PFADNAME mit dem Text „C:\*.TXT“ belegen, verwenden Sie dazu folgende Befehlszeile:

PfadName.Text=„C:\*.TXT“

Umgekehrt können Sie die Eigenschaft eines Objektes auch wie einen Ausdruck behandeln und das Ergebnis dieses Ausdrucks weiterverwenden, z.B. in eine Datei ausgeben oder einer Variablen zuweisen:

VarName=Objektname.Eigenschaft

Möchten Sie beispielsweise den in dem Eingabefeld namens Pfadname durch den Anwender eingegebenen Text auslesen und der Variablen text$ zuweisen, verwenden Sie dazu folgende Befehlszeile:

text$=PfadName.Text

Sie finden die Eigenschaften aller Dialogboxelemente im Referenzteil ausführlich erläutert.

Umsetzung von Eigenschaften, Methoden
und Ereignissen im Beispielprojekt

In der folgenden Tabelle finden Sie die Auflistung, welchem Ereignis und welchem Dialogboxelement welche Ereignis-SUB zugeordnet worden ist. Im Anschluß daran finden Sie das dazugehörige, kommentierte Listing.

Tip: Sie finden das komplette Projekt in der Tutor-Datei MakTest3.SDW.

Element	Ereignisname	Ereignisprozedur	Aufgabe
Dialog	Load	EINGABEDIALOG_LOAD	Wird ausgeführt, wenn Dialog das erste Mal dargestellt wird
[OK]	Click	OK_CLICK	Wird ausgeführt, wenn [OK] angeklickt.
[ABBRUCH]	Click	ABBRUCH_CLICK	Wird ausgeführt, wenn [ABBRUCH] angeklickt.
[>>DAZU]	Click	DAZU_CLICK	Wird ausgeführt, wenn [>>DAZU] angeklickt.
[<<LÖSCHEN]	Click	LOESCHEN_CLICK	Wird ausgeführt, wenn [<<LÖSCHEN] angeklickt.
[AKTUALISIEREN]	Click	AKTUALISIEREN_CLICK	Wird ausgeführt, wenn [AKTUALISIEREN] angeklickt.
Das dokumentierte Beispiellisting

option explicit

'Variable, zum Speichern des Pfades

Dim Pfad$	'Variable wird auch im Dialog benötigt,

'wird daher VOR den SUBs und FUNCTIONs

'deklariert, und ist damit Modul-Global

Sub ErweiterteSuche

pfad$="C:\"	'Definiert den "Ausgangspfad", in dem alle

'Dateien ausgelesen werden

EingabeDialog.Show	'Ruft den Dialog auf

End Sub

Diese SUB bildet den Programmstart. Sie setzt den Vorgabe-Pfad für das „Dateilistenfeld“ durch PFAD$ und macht sonst nichts weiter, als den Dialog mit der SHOW-Methode aufzurufen.

Sub EingabeDialog_Load

dim DokName$

PfadName.Text=Pfad$

DokName$=Dir$(Pfad$)

if DokName$<>"" then

DateiListe.AddItem DokName$,DateiListe.ListCount

do

DokName$=Dir$

if DokName$="" then

exit do

endif

DateiListe.AddItem DokName$, DateiListe.ListCount

loop

endif

end sub

Bei dieser SUB handelt es sich um ein Ereignis. Das Ereignis wird ohne weiteres Zutun des Programmierers dann aufgerufen, wenn der Dialog das erste Mal dargestellt – also geladen – wurde. Diese SUB setzt zunächst den zuvor in PFAD$ gespeicherten Vorgabepfad mit der TEXT-Eigenschaft des Eingabefeld-Elementes PFADNAME in das Eingabefeld ein. In der anschließenden DO/LOOP-Schleife liest die Routine mit Hilfe der DIR$-Funktion alle im Pfad vorhandenen Dateien ein und überstellt Sie mit der ADDITEM-Methode in die Dateiliste.

'Ereignisprozedur:

'Wird aufgerufen, wenn [Dazu] angeklickt wird

Sub Dazu_Click

If Dateiliste.ListIndex=-1 then

MsgBox "Kein Eintrag markiert"

else

DokumentListe.AddItem DateiListe.List(Dateiliste.ListIndex)

endif

End Sub

DAZU_CLICK ist ebenfalls ein Ereignis, das aufgerufen wird, wenn der Anwender die [DAZU]-Schaltfläche betätigt. Diese Routine überprüft zunächst, mit der LISTINDEX-Eigenschaft angewendet auf die Dateiliste, ob überhaupt ein Eintrag der Liste angeklickt ist. Ist dies der Fall, liest sie mit der LIST-Eigenschaft den Text des angeklickten Eintrags aus und stellt diesen, wiederum mit der ADDITEM-Methode, in die andere Listbox.

Hinweis: Listboxen erlauben es durch Methoden und Eigenschaften, die Liste mit Werten zu füllen (.ADDITEM EINTRAG$), mit der LISTINDEX-EIGENSCHAFT festzustellen, ob und welche Eintragsnummer (von 0-(n-1) durchnummeriert) der Anwender angeklickt hat (-1 als Funktionsergebnis bedeutet dabei, daß kein Eintrag selektiert ist), und einen bestimmten Eintrag mit Hilfe der LIST-Eigenschaft (.LIST EINTRAGSNUMMER%) auszulesen.

'Ereignisprozedur:

'Wird aufgerufen, wenn [Löschen] angeklickt wird

Sub Loeschen_Click

If DokumentListe.ListIndex=-1 then

MsgBox "Kein Eintrag markiert"

else

DokumentListe.RemoveItem(DokumentListe.ListIndex)

endif

End Sub

Mit Hilfe dieser Ereignisprozedur wird ein Eintrag aus der Dokumentliste gelöscht, falls der Anwender die Schaltfläche [<<LÖSCHEN] angeklickt und zuvor einen Eintrag selektiert hat. Mit Hilfe der RemoveItem-Methode (.REMOVEITEM EINTRAGSNUMMER%) wird der Eintrag aus der Dokumentliste entfernt.

'Ereignisprozedur:

'Wird aufgerufen, wenn auf Akutalisieren geklickt wird

Sub Aktualisieren_Click()

Dim DokName$

Pfad$=PfadName.Text

DateiListe.Clear

DokName$=Dir$(Pfad$)

if DokName$<>"" then

DateiListe.AddItem DokName$,DateiListe.ListCount

do

DokName$=Dir$

if DokName$="" then

exit do

endif

DateiListe.AddItem DokName$, DateiListe.ListCount

loop

endif

End Sub

Diese Ereignisprozedur sorgt dafür, daß die Liste neu „geladen“ wird, wenn der Benutzer im Eingabefeld einen neuen Pfad bestimmt und anschließend [AKTUALISIEREN] angeklickt hat. Das Verfahren ist dabei dasselbe wie beim Load-Ereignis des Dialogs, mit einem Unterschied: Damit die vorhandenen Einträge nicht um die neuen ergänzt werden, wird die Datei zuvor mit Hilfe der CLEAR-Eigenschaft gelöscht.

'Ereignisprozedur:

'Wird aufgerufen, wenn [OK] angeklickt wird

sub OK_Click

dim DateiNamen$(1 to 100)	'Speicher für die Dateinamen

dim counter%	'Zähler, wieviele Dateien durchsucht werden

dim text$	'String, in der den Suchtext aufnimmt

dim z%	'Zähler für FOR/NEXT

dim anzahl%	        'Variabel für die Anzahl der gefundenen Einträge

for Counter%=1 to Dokumentliste.ListCount

DateiNamen$(counter%) = Dokumentliste.List(Counter%-1)

next counter%

counter% = counter% - 1

 	text$=inputBox("Bitte Suchtext eingeben","Erweiterte Suche","")

for z%=1 to counter%

StarWriter.Documents.Open(DateiNamen$(z%))

anzahl%=0

do

ActiveWindow.Search(Text$)

anzahl%=anzahl%+1

loop until Selection.Value=""

print "Der Suchbegriff trat im Dokument ";DateiNamen$(z%);            " ";anzahl%;" mal auf."

ActiveDocument.Close("", False)

next z%

end sub

Diese Ereignisroutine bildet das ursprüngliche Hauptprogramm. Klickt der Anwender [OK], liest die Routine alle in der Dokumentenliste stehenden Dateien in ein String-Array ein. Anschließend wird der Programmteil ausgeführt, der den Suchbegriff einliest, und die angegebenen Dokumente darauf untersucht. Diese Schritte haben wir bereits im allerersten Beispielprogramm kennengelernt.

'Ereignisprozedur:

'Wird aufgerufen, wenn [Abbruch] angeklickt wird

Sub Abbruch_Click

EingabeDialog.Hide	'Dialog schließen,

'da ErweiterteSuche Basis-Routine

'war, ist das Programm damit beendet

End Sub

In dieser letzten Ereignisprozedur wird das Programm abgebrochen, sobald der Anwender [ABBRUCH] angeklickt hat. Mit der HIDE-Methode wird der Dialog geschlossen.

Speichern des Projektes

Sie haben bereits erfahren, daß Makros bzw. StarBasic-Programme fest mit einem Dokument bzw. einer Dokumentenvorlage verknüpft sind. Das bedeutet, daß die Speicherung eines Dokumentes auch gleichzeitig das mit ihm verbundene StarBasic-Projekt speichert.

So speichern Sie ein Basic-Projekt, das mit einem Dokument oder einer Dokumentenvorlage verbunden ist

Um ein Basic-Projekt zu speichern, daß mit einem Dokument oder einer Dokumentenvorlage verbunden ist, speichern Sie lediglich das Dokument bzw. die Dokumentenvorlage ab. Alle Bibliotheken, Module und damit auch SUBs und FUNCTIONs werden dabei automatisch mit abgespeichert. Um ein an eine Vorlage oder ein Dokument gebundenes Basic-Projekt zu speichern, verlassen Sie die IDE über die Schließen-Schaltfläche des Fensters oder das Menü DATEI/SCHLIEßEN und speichern das Dokument auf die bekannte Art und Weise mit DATEI/SPEICHERN bzw. DATEI/SPEICHERN UNTER.

	Möchten Sie die DIE nicht verlassen, sondern anschließend weiterprogrammieren, können Sie das aktuelle Dokument einschließlich aller Bibliotheken und Module über das Menü DATEI/SPEICHERN oder durch einen Mausklick auf das links abgebildete Symbol abspeichern.
So speichern Sie ein Basic-Projekt, das mit einem StarOffice-Programm verbunden ist

Hierbei brauchen Sie sich um überhaupt nichts zu kümmern. Sämtliche Module, Bibliotheken und damit auch SUBs und FUNCTIONs, die Sie der Applikation hinzugefügt haben, werden beim Verlassen des StarOffice-Programms automatisch mitgespeichert.

Die „technischen Daten“ von StarBasic

Bisher haben Sie schon einiges über die Möglichkeiten von StarBasic kennengelernt. An dieser Stelle möchten wir Ihnen einen Überblick über die Leistungsfähigkeit von StarBasic im Detail geben. Sie erfahren beispielsweise, welche Variablentypen StarBasic kennt, in welchen Bereichen sich Werte bestimmter Variablen bewegen dürfen, aber auch, welche Stukturierungsmöglichkeiten Ihnen durch Werkzeuge wie Module und Bibliotheken gegeben werden und welchen Konventionen die Anwendung dieser Werkzeuge unterliegen.

Variablen

Variablen sind das „A“ und „O“ bei der Programmierung von Basic. Variablen speichern zur Laufzeit bestimmte numerische Werte, Zeichenketten oder sogenannte Objekte. Man kann Variablen auslesen oder deren Inhalte verändern. In StarBasic müssen Variablen nicht gesondert deklariert werden. Sie sind gültig, sobald Sie das erste Mal verwendet werden. Mit Hilfe der Anweisung OPTION EXPLICIT kann man jedoch die Deklaration von Variablen mit Hilfe des DIM-Statements zwingend machen (siehe dort).

Konventionen bei der Vergabe von Variablennamen

Variablennamen dürfen bis zu 255 Zeichen lang sein und alle Zeichen des Alphabetes sowie Ziffern enthalten, solange der Variablenname nicht mit einer Ziffer beginnt. Die Verwendung von deutschen Umlauten sowie von Satz- und Sonderzeichen außer dem Unterstrich („_“) ist nicht erlaubt. StarBasic unterscheidet nicht zwischen der Groß- und Kleinschreibung von Variablen. Variablen dürfen Leerzeichen enthalten, müssen dann aber in eckigen Klammern eingeschlossen sein.

 Im folgenden ein paar Beispiele für das korrekte und nicht korrekte Vergeben von Variablennamen:

Vorname=5	‘Korrekt, keine unerlaubten Zeichen

Vorname5=15	‘Korrekt, Variable beginnt nicht mit einer Ziffer

Vorname_5=20	‘Korrekt, Unterstrich ist erlaubt

Vor Name=20	‘Nicht korrekt, Variable enthält Leerzeichen und

‘ist nicht in eckigen Klammern eingeschlossen

Müller=25	‘Nicht korrekt, Variable enthält Umlaut

5Vornamen=12	‘Nicht korrekt, Variable beginnt mit einer Ziffer

[Vor Name]=12	‘Korrekt trotz Leerzeichen, denn Variable steht

 in eckigen Klammern

Vor,Name=12	‘Nicht Korrekt, Variable enthält Satzzeichen

Variablendeklarationen

Variablen brauchen in StarBasic nicht explizit deklariert zu werden, wie Sie es vielleicht von anderen Programmiersprachen her kennen. Lediglich Arrays müssen vor Verwendung deklariert werden (siehe dort). Eine Variablendeklaration erfolgt mit dem DIM-Befehl; mehrere Deklarationen können mit Komma getrennt erfolgen. Um den Typen für eine Variable bei einer Deklaration festzulegen, verwendet man entweder ein spezielles Typendeklarationszeichen, das hinter dem Namen angegeben wird, oder ein entsprechendes Schlüsselwort. Beispiele:

DIM a$	‘Deklaration der Variable „a“ als String

DIM a as STRING	‘Deklaration der Variablen „a“ als String

DIM a$, b% as INTEGER	‘Deklaration eines Strings und eines Integers durch Komma getrennt

Wichtig bei der Deklaration von Variablen ist, daß das Typendeklarationszeichen immer wieder verwendet werden muß, wenn es auch bei der Deklaration anstelle des Schlüsselwortes verwendet wurde. Die folgenden Zeilen sind also nicht statthaft:

DIM a$	‘Deklaration als String

a=„Testzeichenkette“	‘Falsch, es müßte „a$=“ heißen

Achtung: Variablen mit einem bestimmten Namen, die einmal als bestimmter Typ deklariert wurden, dürfen unter dem gleichen Namen nicht nochmals als anderer Typ deklariert werden!

Erzwingung von Variablendeklarationen

StarBasic bietet Ihnen die Möglichkeit, jede Variable zwingend zu deklarieren, und zwar mit der Anweisung

OPTION EXPLICIT

die als erste Zeile im Programmcode eines Moduls, also noch vor der ersten SUB, stehen muß. Normalerweise braucht der Programmierer in StarBasic lediglich Arrays, also Felder, zu deklarieren. Andere Variablen werden in Abhängigkeit des Typendeklarationszeichens oder, falls keines angegeben ist, als SINGLE-Variablentyp deklariert, sobald Sie das erste Mal verwendet werden. Der gewollte Deklarationszwang einer jeden im Programm verwendeten Variable ist zwar ein wenig aufwendiger, hat aber folgenden Vorteil: Programmfehler, die durch Tippfehler in Variablennamen auftreten, werden damit ausgeschlossen. Ein Beispiel:

Sie verwenden die Variable „Datenspeicher$“ in einer SUB. Irgendwo im Programmtext arbeiten Sie mit der Variablen weiter und weisen ihr ein bestimmtes Ergebnis zu. Angenommen, Sie haben sich vertippt und weisen dieses Ergebnis mit der folgenden Zeile zu:

Datnespeicher$=Ausdruck$

StarBasic würde diesen Ausdruck anstandslos akzeptieren, da es davon ausgeht, daß Sie im folgenden eine neue Variable verwenden möchten. StarBasic murrt jedoch, wenn OPTION EXPLICIT definiert wurde, da der Variablenname nicht definiert wurde. Sie erkennen in diesem Fall den Programmfehler als Tippfehler beim Programmablauf, sobald die „falsche“ Variable das erste Mal verwendet wird.

Variablentypen

StarBasic kennt eine ganze Anzahl verschiedener sogenannter Variablentypen. Grundsätzlich werden Variablentypen in drei Typenkategorien unterteilt:

"	Numerische Variablen: Numerische Variablen nehmen Zahlen mit unterschiedlichen Wertebereichen auf. Es gibt Typen, die größere und andere, die kleinere Wertebereiche speichern. Man unterscheidet desweiteren zwischen Typen, die ganzzahlige Werte, also solche ohne Nachkommastellen, und Fließkommatypen, die auch gebrochene Zahlen speichern können. Alle Typen haben Vor- und Nachteile: Typen, die kleinere Wertebereiche und nur ganze Zahlen verarbeiten, benötigen vergleichsweise wenig Speicherplatz und beschleunigen die Bearbeitungsgeschwindigkeit. Fließkommatypen sind zwar rechenintensiver und benötigen mehr Speicherplatz, jedoch lassen sich mit ihnen sehr präzise Berechnungen durchführen.

"	String-Variablen: String-Variablen nehmen beliebige Zeichenketten auf.

"	Boolean-Variablen: Boolean-Variablen speichern nur die Zustände TRUE und FALSE (wahr und falsch).

"	Objekt-Variablen: Objekt-Variablen nehmen Objekte ganz unterschiedlicher Art auf. Objekte können beispielsweise Dokumente oder Tabellen innerhalb eines Dokuments sein. Mit Hilfe entsprechender Eigenschaften oder Methoden können diese Objekte dann vom Programm „bearbeitet“ werden.

Integervariablen

Integervariablen speichern ganzzahlige Werte zwischen -32768 und 32767. Bei der Zuweisung von Fließkommawerten an eine Integervariable werden die Nachkommastellen abgeschnitten. „%“ ist das Typendeklarationszeichen. Integervariablen lassen sich extrem schnell verarbeiten, und werden vorwiegend als Zählvariablen in Schleifen eingesetzt. Integervariablen haben einen internen Speicherbedarf von 2 Bytes.

Deklaration:

DIM Variable%

DIM Variable as INTEGER

Long-Integervariablen

Long-Integervariablen speichern ganzzahlige Werte zwischen -2.147.483.648 und 2.147.483.647. Bei der Zuweisung von Fließkommawerten an eine Integervariable werden die Nachkommastellen abgeschnitten. „&“ ist das Typendeklarationszeichen. Long-Integervariablen lassen sich sehr schnell verarbeiten und werden vorwiegend als Zählvariablen in Schleifen eingesetzt, die einen erweiterten Wertebereich benötigen. Long-Integervariablen haben einen internen Speicherbedarf von 4 Bytes.

Deklaration:

DIM Variable%

DIM Variable as LONG

Single-Variablen

Single-Variablen speichern Werte im Bereich zwischen 3,402823 x 1038  und 1,401298 x 10-45. Single-Variablen fallen unter die Kategorie der sogenannten Fließkomma- oder Float-Variablen. Diese Typen haben die Eigenschaft, daß die Genauigkeit der Darstellung hinter dem Komma abnimmt, je größer der Vorkommateil des darzustellenden Wertes wird. „!“ ist das Typendeklarationszeichen. Single-Variablen werden bei mathematischen Berechnungen eingesetzt, bei denen eine durchschnittliche Berechnungsgenauigkeit ausreicht. Sie werden langsamer als alle Integervariablen und Currency-Variablen, aber schneller als Double-Variablen verarbeitet. Intern werden sie durch 4 Bytes gespeichert.

DIM Variable!

DIM Variable as SINGLE

Double-Variablen

Double-Variablen speichern Werte im Bereich zwischen 1,79769313486232 x 10308  und 4,94065645841247 x 10-324. Double-Variablen fallen wie Single-Variablen unter die Kategorie der sogenannten Fließkomma- oder Float-Variablen, bei denen die Genauigkeit der Darstellung hinter dem Komma abnimmt, je größer der Vorkommateil des darzustellenden Wertes wird. „#“ ist das Typendeklarationszeichen. Double-Variablen werden bei mathematischen Berechnungen eingesetzt, bei denen eine extrem hohe Berechnungsgenauigkeit verlangt wird. Intern werden sie durch 8 Bytes gespeichert.

DIM Variable#

DIM Variable as DOUBLE

String-Variablen

String-Variablen speichern Zeichenketten von bis zu 64.000 Zeichen Länge. Ein Zeichen wird dabei durch ein Byte als ASCII-Code gespeichert. String-Variablen eignen sich hervorragend zur Textverarbeitung innerhalb von Programmen, können aber auch zur Zwischenspeicherung von beliebigen nicht druckbaren Zeichen bis zur Länge von 64 KByte verwendet werden. „$“ ist das Typendeklarationszeichen. Der verwendete Speicherplatz hängt von der Anzahl der Buchstaben bzw. Bytes ab, die in einer Variablen gespeichert werden.

DIM Variable$

DIM Variable as STRING

Boolean-Variablen

Boolean-Variablen speichern lediglich die Zustände WAHR und FALSCH. Wird der Inhalt einer Boolean-Variable z.B. durch den PRINT-Befehl ausgegeben, werden diese Zustände in -1 (TRUE, WAHR) und 0 (FALSE, FALSCH) ausgegeben. Boolean-Variablen eignen sich dazu, binäre Zustände zu speichern, z.B. das Ergebnis eines Vergleichs. Intern werden Boolean-Variablen durch einen 2 Byte-Integerwert dargestellt. Wird einer Boolean-Variable ein Wert zugewiesen, so wird dieser automatisch zu „falsch“ (0) konvertiert, solange er nicht genau -1 war. Boolean-Variablen haben kein spezielles Typendeklarationszeichen und können nur durch das entsprechende Schlüsselwort deklariert werden.

DIM Variable as BOOLEAN

Date-Variablen

Date-Variablen speichern ausschließlich Datumswerte und Zeitwerte in einem bestimmten, internen Format, daß den Programmierer jedoch nicht weiter interessieren muß. DATE-Variablen können Werte zugewiesen werden, die beispielsweise durch DATESERIAL, DATEVALUE, TIMESERIAL oder TIMEVALUE von der „normal lesbaren“ Darstellung in das interne Format umgewandelt werden. Die Zurückwandlung erfolgt mit den Funktionen DAY, MONTH und YEAR, bzw HOUR, MINUTE, SECOND. Date-Variablen haben den Sinn, Daten, die in Variablen gespeichert sind, durch die Umwandlung in eine ganze Zahl vergleichen und Differenzen berechnen zu können. Es gibt kein spezielles Typendeklarationszeichen – DATE-Variablen können nur durch das Schlüsselwort DATE deklariert werden.

DIM Variable as DATE

Error-Variablen

ERROR-Variablen nehmen ausschließlich Fehlercodes auf und werden beim StarBasic-Error-Handling benötigt, wie es durch ON ERROR GOTO in StarBasic realisiert werden kann. Es gibt kein spezielles Typendeklarationszeichen – DATE-Variablen können nur durch das Schlüsselwort DATE deklariert werden.

DIM Variable as ERROR

Definition von Variablen

Sobald eine Variable deklariert wird, ist Sie automatisch auf den „Null“-Wert zurückgesetzt, d.h., daß der Programmierer nicht darauf achten muß, daß eine Variable, die deklariert wurde, manuell auf einen Basis-Wert zurückgesetzt werden muß. Es gilt folgende Regel:

Numerischen Variablen wird automatisch der Wert 0 zugewiesen, sobald die Variable deklariert wurde.

DATE-Variablen wird intern der Wert 0 zugewiesen, das Ergebnis entspricht also einer entsprechenden Umwandlung des Wertes „0“ mit einer der Funktionen DAY, MONTH oder YEAR bzw. HOUR, MINUTE, SECOND.

String-Variablen wird direkt bei der Deklaration ein Leerstring („“) zugewiesen.

Vordefinierte Systemvariablen

StarBasic kennt eine Reihe vordefinierter Systemvariablen, die bei einer Abfrage immer ein bestimmtes Ergebnis liefern. Diese finden Sie im folgenden beschrieben:

TRUE und FALSE

Diese beiden Variablen sind vom Typ Boolean und liefern den Wert 0 (FALSE, Falsch) oder den Wert -1 (TRUE, Wahr) zurück. Man verwendet diese Variablen zum Beispiel in IF/THEN/ELSE-Abfragen, um den Wahrheitsgehalt eines Vergleichs zu testen. Wie in Basic üblich, werden Vergleiche durch die Vergleichsoperatoren („=“, „<“, „>“) abgefragt. Die Anweisung

PRINT 5=3

ergibt beispielsweise den Wert 0 (FALSE, Falsch), da der Ausdruck das Ergebnis „Aussage (Vergleich) unwahr“ hat. Die Anweisung

PRINT 5>3

ergibt hingegen den Wert -1 (TRUE, Wahr), da der Ausdruck das Ergebnis „Aussage (Vergleich) wahr“ hat. Die Verwendung der Systemvariablen bildet rein technisch keinen Unterschied zur Verwendung der direkten Zahlenwerte 0 und -1; Programmcode, der mit Hilfe dieser Variablen arbeitet, wird jedoch für Außenstehende leichter lesbar.

PI

PI ist eine mathematische Konstante und ergibt als numerisches Ergebnis stets die Kreiszahl π (3,141592657...).

Spezielle Systemkonstanten

StarBasic kennt einige Konstanten (siehe dort), die den Programmcode leichter lesbar und schreibbar machen sollen: Einige StarBasic-Funktionen erwarten Zahlen als Parameter, die, in Kombinationen addiert, bestimmte, aber immer andere Ereignisse auslösen. Anstatt sich für jeden Befehl entsprechende „Aktionszahlen“ merken zu müssen, verwendet man einfach die entsprechenden Konstanten und kann ein „Anliegen an einen Befehl“ damit quasi im Klartext formulieren.

Sie finden die Erklärung der Konstanten im Referenzteil dieses Handbuches bei der Erklärung des jeweils betroffenen Befehls.

Arrays

StarBasic kennt ein- oder mehrdimensionale Arrays (Felder), denen ein bestimmter angebbarer Variablentyp zugrunde liegt. Arrays werden immer dann verwendet, wenn im Programm Listen oder Tabellen verarbeitet werden sollen. Der Vorteil von Arrays ist, daß man die einzelnen Elemente über sogenannte Indizies ansprechen kann, die selbst ebenfalls in Form von numerischen Ausdrücken oder Variablen formuliert werden können.

Arrays werden mit dem DIM-Befehl deklariert. Es gibt dabei zwei Möglichkeiten festzulegen, in welchem Bereich die Indizies angesprochen werden können:

DIM text$(20)	‘20 Elemente, von 1 bis 20 durchnummeriert

DIM text$(5 to 25)	‘20 Elemente, von 5 bis 25 durchnummeriert

DIM text$(-15 to 5)	‘21 Elemente (das 0. ebenfalls!), von -15 bis 5 durchnummeriert

Der Bereich von Indizies ist von -32768 bis 32767 beschränkt.

Konstanten

Konstanten sind eine „Abart“ von Variablen und dienen nur der besseren Lesbarkeit eines Programms. Konstanten werden nicht als bestimmter Typ definiert, sondern werden als reiner Programmcode-Platzhalter verwendet. Eine Konstante kann nur ein einziges Mal im Programm definiert und dann nie wieder umdefiniert werden. Sie definieren eine Konstante mit folgender Befehlszeile:

CONST ConstName=Ausdruck

Dabei ist es völlig egal, um was für einen Ausdruck es sich handelt. Wird ein Programm gestartet, so wird StarBasic-intern der Programm-Code so umgearbeitet, daß jedesmal, wenn eine Konstante verwendet wurde, der zuvor festgelegte Ausdruck dafür eingesetzt wird. Im Prinzip wird intern ein „Suchen/Ersetzen“ durchgeführt. Der Konstantenname, wann immer er im Basic-Programm-Code verwendet wurde, wird durch den Ausdruck ersetzt. Aus diesem Grund spielt der Typ, der einer Konstanten zugewiesen wird, auch überhaupt keine Rolle, da intern sowieso nur der Ausdruck als solcher verwendet wird.

Verwenden von Objekten

Die Frage, die sich stellt, möchte man aus einer Programmiersprache ein Anwendungsprogramm bedienen, lautet „was ist der flexeibelste, effizienteste und dennoch unkomplizierteste Weg, bestimmte Elemente zu manupulieren?“.

StarBasic bedient sich dazu sogenannter Objekte und Objekt-Collections, um bestimmte, in der Regel StarOffice-Programmabhängige Problemlösungen realisieren zu können. Objekte haben einen großen Vorteil: Sie werden durch Einstellen von Eigenschaften oder Anwenden von Methoden auf immer die selbe Art und Weise bedient, unabhängig davon ob es sich bei einem Objekt z.B. um ein Dokument, eine Tabelle oder das Programm selbst handelt. Ferner erleichtern Sie durch ihre quasi selbstdukomentierende Struktur sowohl die Lesbarkeit als auch das Entwickeln eines Programms.

Die folgenden Abschnitte beschreiben Ihnen, wie Sie Anwendungsprogramme wie StarWriter, StarCalc oder StarDraw mit Hilfe von Objekten verwenden können.

StarBasic kennt Objekte, die „einfach vorhanden“ sind, und andere, die Sie mithilfe bestimmter Anweisungen erst erschaffen müssen. Das mag zunächst ein wenig abstrakt erscheinen, relativiert sich jedoch, sobald Sie sich die Dinge im Detail betrachten.

Anwenden von Objekten im Programm-Code

Betrachten wir zunächst die Syntax beim Ansprechen von Objekten, also wie sie in StarBasic verwendet werden. Dabei lernen wir gleichzeitig das erste Objekt kennen, das sogenannte Document-Objekt, das ein geöffnetes Dokument im StarWriter repräsentiert. Für ein erstes Beispiel soll es das Ziel sein, den Inhalt dieses Dokumentes zu sichern und das Dokument anschließend zu schließen. Die Syntax, um das Document-Objekt anzusprechen kennen Sie schon von der Anwendung von Methoden und der Definition von Eigenschaften von Dialogelementen (denn sie sind auch nichts anderes als Objekte).

[unbenannt1].Save „Dateiname“

[unbenannt1].Close

„[unbeannt1]“ bezeichnet hierbei das Objekt. SAVE und CLOSE sind Methoden, die auf dieses Objekt angewendet werden.

Anwenden von Methoden

Methoden werden auf Objekte angewendet, und haben irgend eine Aktion zur Folge. Die Syntax lautet dabei grundsätzlich

Objekt.Methode [Parameter]

Das bedeutet: „Wende die METHODE mit den folgenden PARAMETERN auf das OBJEKT an“. Sichbar wird das im oben stehenden Beispiel. Die SAVEAS-Methode, eine für das Document-Objekt gültige Methode, speichert beispielsweise den Inhalt das Dokumentes ab. Das Dokument selber spielt die Rolle des Objektes.

Zuweisen von Eigenschaften

Eigenschaften bestimmen das Aussehen oder zuknüftige Verhaltensweise eines Objektes. Um beim Document-Objekt zu bleiben betrachten wir uns beispielsweise die WindowStyle-Eigenschaft, die verschiedene Werte annimmt.

[unbenannt1:1].Maximized=True

a%=[unbenannt1:1].Maximized

Die erste Zeile bestimmt die Maximized-Eigenschaft des Fensters. Sie bestimmt, ob das Fenster voll vergrößertdargestellt werden soll oder nicht. Durch Zuweisen des Wertes an die Eigenschaft eine Objektes wird also das Objektverhalten oder -aussehen beeinfluß. Für die Definition einer Objekteigenschaft gilt grundsätzlich:

Objekt.Eigenschaft=Wert

Andersherum (2. Zeile des Beispiels) kann eine Eigenschaft auch als Ausdruck behandelt werden, so daß der Programmierer die Möglichkeit hat, eine Objekteigenschaft zu erfragen. Es gilt dabei grundsätzlich

ausdruck=Objekt.Eigenschaft

Eigenschaften, die Objekte zurückliefern

Bestimmte Eigenschaften liefern ihrerseits Objekte als Ergebnis zurück. Betrachten wir beispielsweise die ACTIVEWINDOW-Eigenschaft des Application-Objektes, die das aktive Fenster des angesprochenen Dokumentes als Window-Objekt zurückliefert.

msgbox Application.ActiveWindow.Name

Das WINDOW-Objekt enthält u.a. den Namen des Fensters eines Dokumentes. Die NAME-Eigenschaft filtert aus allen Informationen, die das WINDOW-Objekt speichert, genau den Namen des Fensters heraus. Die Reihenfolge der Eigenschaftenangabe ist damit klar. Im Klartext bedeudet die o.s. Anweisung: „Liefere mir den Namen des Fensters durch die NAME-Eigenschaft des Objektes, das durch die ACTIVEWINDOW-Eigenschaft des APPLICATION-Objektes ermittelt wurde, und speichere ihn in A$ ab“.

Diese Objekte gibt es

Document-Objekt

Dieses Objekt erlaubt den Zugriff auf ein geöffnetes Dokument eines StarOffice-Programms. Es gibt grundsätzlich mehrere Möglichkeiten Zugriff auf ein Dokument zu nehmen. Die erste Methode spricht das Dokument direkt per Namen an – beispielsweise:

[unbenannt1].SaveAs „Dateiname“

Eine weitere Möglichkeit ist das Ansprechen des Objektes über eine Eigenschaft, die, angewendet auf das Applikationsobjekt, ein Document-Objekt zurückliefert. Die ACTIVEDOKUMENT-Eigenschaft liefert beispielsweise das aktive Dokument als Document-Objekt zurück. Ein Beispiel für diese Art der Verwendung lautet z.B.:

Application.ActiveDocument.SaveAs „Dateiname“

Es gibt eine dritte Möglichkeit ein Document-Objekt anzusprechen – über eine sogenannte Objekt-Collection.

Window-Objekt

Dieses Objekt erlaubt den Zugriff auf ein Fenster eines geöffneten Dokumentes eines StarOffice-Programms. Es gibt mehrere Möglichkeiten, ein Windows-Objekt anzusprechen. Die erste Möglichkeit ist, das Objekt direkt über den Fensternamen anzusprechen. Da pro Dokument mehrere Fenster geöffnet sein können, müssen Dokumentenname und die Nummer der durch Doppelpunkt getrennt mitangegeben werden, z.B.:

[unbenannt1:1].Maximize=TRUE

Eine weitere Möglichkeit ist das Ansprechen des Objektes über eine Eigenschaft, die, angewendet auf das Applikationsobjekt, ein Window-Objekt zurückliefert. Z.B.:

Application.ActiveWindow.Maximized=True

Es gibt eine dritte Möglichkeit ein Window-Objekt anzusprechen – über eine sogenannte Objekt-Collection.

Application-Objekt

Beinhaltet die eigentliche Applikation als Objekt und erlaubt damit die Steuerung der Applikation durch Eigenschaften und Methoden. Beispiel:

Application.AboutDialog	‘Zeigt den About-Dialog an

Eine Variation das Application-Objekt vom Programm aus zu benutzen, ist, es direkt mit dem Namen der Applikation anzusprechen. Z.B:

StarWriter.AboutDialog

Objekt-Collection

Objekt-Collections sind, wie der Name schon andeutet, Objekt-Sammlungen. Strenggenommen ist eine Objekt-Collection nichts anderes als ein Objekt, daß verschiedene Objekte gleichen Typs aufnimmt. Am besten läßt sich eine Objekt-Collection mit einem Variablen-Array vergleichen, mit dem Unterschied, daß Objekt-Collections als eigener Typ vordefiniert sind, Variablen-Arrays nicht.

Ein Beispiel für eine Objekt-Collction ist beispielsweise die Documents-Collection. Man achte dabei auf das kleine, aber entscheidene „s“, daß den Unterschied zum Document-Objekt ausmacht. Die Hauptaufgabe einer Collection ist es, die Verwendung von Objekten allgemeingültig zu machen. Dazu ein Beispiel.

Sie entwickeln ein Programm, daß beispielsweise einen Begriff durch einen anderen ersetzt, und daß immer nur mit einem geöffneten Dokument arbeiten kann, denn Sie verwenden „lediglich“ ein Document-Objekt. Stellen Sie sich vor, der Anwender Ihres Programm sagt, „ich möchte diese Funktion auf alle geöffneten Dokumente anwenden, und nicht nur immer auf ein bestimmtes“. In diesem Falle strecken Sie die Waffen, denn Sie wissen nur, ob Ihr eines Objekt (Dokument) geöffnet ist oder nicht, die anderen jedoch kennen Sie nicht.

Bedienen Sie sich in diesem Fall der Documents-Collection, wird die ganze Sache einfacher. Sie stellen mit der COUNT-Eigenschaft fest, wie viele Document-Objekte es innerhalb der Documents-Collection gibt, und wenden Ihr Programm nacheinander (am besten innerhalb einer Schleife) auf jedes Dokument an:

anz%=Documents.Count	‘Wieviele gibt es?

For z%=1 to anz%	‘Alle Dokumente bearbeiten

   Documents(z%).Search...	‘Methoden und Eigenschaften,

‘also Ihr Programm anwenden

Next z%	‘Alle Dokumente wurden berücksichtigt

Hier erkennen wir schon, auf welche Art und Weise wir einer Objekt-Collection ein einziges Objekt entlocken können – wie indizieren es wie Variablen in Arrays. Andere Möglichkeiten sind beispielsweise die Angabe eines Namens, um das Objekt zurück zu liefern. In diesem Fall durchsucht StarBasic die gesamte Objekt-Collection nach dem Namen, und liefert, so gefunden, daß passende Objekt zurück:

Documents(„unbenannt1“).Close

Hinweis: Das über Eigenschaften und Methoden gesagte gilt natürlich auch für Objekte, die über eine Objekt-Collection angesprochen wurden.

Diese Collections gibt es

Windows-Collection

Die Windows-Collcetion beinhaltet alle in einem StarOffice-Programm geöffneten Fenster als Window-Objekt.

Durch Indizierung der Collection mit dem Namen des Fensters (include. View-Nummer, siehe Window-Objekt) oder mit der Fenster-Nummer (die Reihenfolge entspricht der, wie sie im Menü FENSTER aufgeführt ist) wird ein Window-Objekt zurückgeliefert. Beispiele:

Windows(3)

Windows(„unbenannt1:1“)

Documents-Collection

Die Documents-Collcetion beinhaltet alle in einem StarOffice-Programm geöffneten Dokumente als Document-Objekt.

Durch Indizierung der Collection mit dem Namen des Dokumentes oder mit der Dokument-Nummer (die Reihenfolge entspricht der, wie sie im Menü FENSTER aufgeführt ist) wird ein Dokument-Objekt zurückgeliefert. Beispiele:

Documents(3)

Documents(„unbenannt1“)

Prozeduren (SUBs) und Funktionen (FUNCTIONs)

Prozeduren und Funktionen helfen Ihnen, Ihr Programm in immer kleinere Teilproblemlösungen aufzuteilen und damit übersichtlich zu strukturieren. Sie erstellen sich bei der Programmentwicklung nach und nach einen immer größeren „Befehlsvorrat“; Ihr Hauptprogramm muß dann nur noch auf diese „Teilproblemlöser“ zurückgreifen, um das gesamte Problem zu „erschlagen“, das durch Ihr StarBasic-Projekt gelöst werden soll. Ein weiterer Vorteil von SUBs und FUNCTIONs ist die Tatsache, daß Sie das Rad nicht ständig neu erfinden müssen. Haben Sie einmal den Programmcode entwickelt, der eine kleine Teilaufgabe eines großen Problems löst, so können Sie diesen Code in Ihrem Projekt, aber auch in allen zukünftigen Projekten immer wieder verwenden. Ein Beispielprogramm soll das verdeutlichen:

Tip: Sie können dieses Programm nachvollziehen, indem Sie die Tutor-Datei „SUBEXMPL.SDW“ öffnen, und über EXTRAS/MAKRO durch Auswahl des Makros START im Modul MODUL1 und der Schaltfläche [BEARBEITEN] in die IDE wechseln. Möchten Sie das Programm abtippen, wählen Sie ebenfalls EXTRAS/MAKRO, geben unter MAKRONAME „Start“ ein und wählen die Schaltfläche [NEU], um zur IDE zu wechseln.

option explicit

Sub Start

dim text$

text$ = inputbox("Bitte geben Sie einen Text ein", "Eingabeaufforderung")

print "Dies Text enthält";WordCount%(Text$);" Worte"

End Sub

'*** Funktion zählt Leerzeichen in einem String, und

'*** damit die Worte.

function WordCount%(WortText$)

dim z%, count%

count%=1

for z%=1 to len(WortText$)

if mid$(WortText$,z%,1)=" " then

count%=count%+1

endif

next z%

WordCount%=count%+1	'+1, weil ein Leerzeichen=zwei Worte

end function

Starten Sie dieses Programm direkt aus der IDE, startet das Programm mit der SUB Start (einfach deswegen, weil Sie im Source-Code an erster Stelle steht). Innerhalb von Start wird der Anwender aufgefordert, einen Text einzugeben. Dieser Text wird der Funktion WordCount% übergeben, die die Anzahl der Leerzeichen und damit die Anzahl der Worte ermittelt, die im Text vorhanden sind.

Der Vorteil vom Einsatz einer solchen FUNCTION liegt auf der Hand. Innerhalb des „Hauptprogramms“ Start wird der „Lesefluß“ nicht durch den Programm-Code von WordCount belastet. Aus dem Namen geht hervor, welche Aufgabe die Funktion übernimmt. Ein weiterer, viel entscheidenderer Vorteil: Bräuchte man diese Funktion erneut, müßte man Sie lediglich ein weiteres Mal aufrufen. Der Code selber bleibt dabei aber nur ein einziges Mal im Programm vorhanden – ergo: Der Programmcode wird kompakter und übersichtlicher.

So fügen Sie ein SUB oder FUNCTION in den Programm-Code mit Hilfe des Objektkataloges ein

Gerade in größeren Projekten kann leicht der Überblick über die vorhandenen SUBs oder FUNCTIONs verloren gehen. Mit Hilfe des Objektkataloges können Sie den Namen einer SUB oder einer FUNCTION an der aktuellen Cursorposition einfügen lassen. Dazu verfahren Sie wie folgt:

"	Klicken Sie das OBJEKTKATALOG-Symbol aus der Objektleiste an. StarBasic ruft den Objektkatalog auf.

Der Objektkatalog der IDE

"	Der Dialog zeigt eine Liste aller verfügbaren Objekte. Viele Objekte (Dokumente, Vorlagen, die Applikation selbst und dort enthaltene Bibliotheken und Module) enthalten Unterobjekte, die Sie per Doppelklick ein- und ausblenden können. Ein Doppelklick auf einen Modul-Eintrag zeigt Ihnen beispielsweise alle dort enthaltenen SUBs und FUNCTIONs an.

"	Möchten Sie den Namen einer SUB oder einer FUNCTION in den Programm-Code an der aktuellen Cursorposition einfügen, klicken Sie auf den SUB- oder FUNCTION-Namen und anschließend auf [EINFÜGEN].

"	Schließen Sie den Objektkatalog durch Mausklick auf die gleichnamige Schaltfläche, wenn Sie ihn nicht mehr benötigen.

Übergabe von Variablen an SUBs oder FUNCTIONs

In diesem Beispiel können Sie eine weitere Eigenschaft von SUBs bzw. FUNCTIONs erkennen. Beiden Strukturen kann man Variablen übergeben und sie damit so verwenden, als wären sie ein fester Bestandteil der StarBasic-Programmiersprache. Voraussetzung dafür ist, daß die SUB oder FUNCTION, die aufgerufen wird, diese Parameter erwartet. Die Deklaration dafür ist denkbar einfach:

SUB SubName(Parameter1 as Typ, Parameter2 as Typ,...)

.

.

Programmcode

.

.

END SUB

Der Aufruf einer solchen SUB würde durch die folgende Befehlszeile vonstatten gehen:

SubName(Wert1, Wert2,...)

Sie selber brauchen dabei nur darauf zu achten, daß die Parameter, die Sie einer SUB übergeben, dieselben sind wie in der SUB-Deklaration angegeben.

Das gleiche gilt für die Verwendung von FUNCTIONs, nur mit dem Unterschied, daß Sie ein Funktionsergebnis zurückliefern. Dieses Funktionsergebnis bestimmen Sie am besten kurz vor Erreichen des Funktionsendes. Sie bestimmen das Funktionsergebnis, indem Sie den Wert, den die Funktion zurückliefern soll, dem Funktionsnamen wie einem Parameter zuweisen (vergleiche Beispiellisting).

FUNCTION FunctionName(Parameter1 as Typ, Parameter2 as Typ,...) as Typ

‘

‘

Programmcode

‘

‘

FunctionName=Funktionsergebnis

End Function

Der Aufruf einer solchen FUNCTION würde durch die folgende Befehlszeile vonstatten gehen:

Variable=FunctionName(Parameter1, Parameter2,...)

So bestimmen Sie den Rückgabetyp einer FUNCTION

Wie Sie in der oben stehenden Beispiel-FUNCTION-Definitionszeile erkennen können, muß bei FUNCTIONs definiert werden, welcher Art der Rückgabetyp ist, den die Funktion zurückliefern soll. Wie bei Variablen auch, gibt man dazu einfach hinter dem Funktionsnamen ein entsprechendes Typendeklarationszeichen oder hinter der Parameterliste den Typ mit dem Schlüsselwort AS und dem entsprechenden Typ-Schlüsselwort an. Die Definitionszeile unseres Beispielprogramms kann also in zwei Variationen lauten:

FUNCTION WordCount(WortText$) as Integer

FUNCTION WordCount%(WortText$)

Übergabe von Variablen als Wert und als Referenz

Sehr wichtig bei der Nutzung der Möglichkeit, FUNCTIONs oder SUBs Variablen übergeben zu können, ist das Wissen um den Unterschied, Variablen als sogenannte Referenz oder als Wert zu übergeben.

Solange nichts anderes gesagt wird, übergeben Sie einer FUNCTION oder SUB eine Variable immer als Referenz. Das bedeutet, daß, wenn Sie innerhalb einer SUB oder FUNCTION eine Variable verändern, die dieser SUB oder FUNCTION übergeben wurde, sich die Variable ebenfalls ändert, die im aufrufenden Code der SUB oder FUNCTION übergeben wurde. Dazu ein Beispiel: Ändern Sie das obige Beispielprogramm wie folgt ab.

Fügen Sie in der SUB Start hinter dem PRINT-Befehl eine weitere Befehlszeile ein:

PRINT text$

Fügen Sie vor der Zeile END FUNCTION der FUNCTION WORDCOUNT% eine weitere Befehlszeile ein:

WortText$=„Funktion beendet“

Starten Sie im folgenden das Programm, und geben Sie einen Text ein. StarBasic gibt Ihnen die Anzahl der Leerzeichen aus und direkt im Anschluß den Inhalt der Variablen text$: „Funktion beendet“. Der Inhalt dieser Variablen wurde augenscheinlich verändert, aber nicht durch das Hauptprogramm, sondern durch die FUNCTION WORDCOUNT%. Dadurch, daß der FUNCTION die Variable direkt übergeben wurde, konnte die FUNCTION den Inhalt der Variablen ändern, obwohl sie eigentlich nur im Hauptprogramm gültig war.

Wünschen Sie, daß diese Eigenschaft unterdrückt wird, stellen Sie vor die Übergabevariable beim Aufruf einer SUB oder FUNCTION einfach das Schlüsselwort BYVAL (By Value, Übergabe durch Wert). Ändern Sie die erste PRINT-Zeile in der SUB Start wie folgt ab:

print "Dies Text enthält";WordCount%(ByVal Text$);"Worte"

Starten Sie das Programm jetzt, wird genau der Text angezeigt, den Sie zum Überprüfen eingegeben haben; die Unterroutine konnte den Inhalt der Variablen nicht mehr verändern.

Hinweis: Wenn Sie ein neues Modul anlegen, richtet StarBasic automatisch eine SUB namens Main ein. Dieser Name ist lediglich ein Vorgabename und hat nichts mit dem Ablauf oder dem Startpunkt eines StarBasic-Projektes zu tun. Ändern Sie den Namen dieser Vorgabe-SUB nach Ihren Bedürfnissen.

Gültigkeit von Variablen innerhalb von Prozeduren und Modulen und außerhalb von Modulen

Wird eine Variable innerhalb einer SUB oder einer FUNCTION definiert, dann bleibt sie dort nur solange gültig, bis die Prozedur verlassen wird. Danach gibt es die Variable quasi nicht mehr, und sie wird neu „angelegt“, wenn die SUB oder FUNCTION abermals benötigt wird. Man sagt, die Variable wurde „lokal“ definiert. In vielen Fällen ist es aber notwendig, Variablen zu definieren, so daß sie in allen Prozeduren gültig sind. Teilweise ist es sogar nötig, daß Variablen in allen Modulen aller Bibliotheken gültig sind. Oder aber es wird gewünscht, daß Variablen erhalten bleiben, selbst wenn eine SUB oder FUNCTION verlassen wurde. Diese Eigenschaften können Sie gezielt durch bestimmte Schlüsselworte bei der Deklaration einer Variable durch DIM steuern. Es gelten folgende Richtlinien:

Deklaration von Variablen außerhalb einer SUB oder FUNCTION

DIM PUBLIC VarName as TYPENNAME

Die Variable hat in allen Modulen Gültigkeit.

DIM PRIVATE VarName as TYPENNAME

Die Variable hat nur im Modul Gültigkeit.

DIM VarName as TYPENNAME

Wie vorhergehende Anweisung.

Sichern von Variableninhalten nach Verlassen einer SUB oder FUNCTION

DIM STATIC VarName as TYPNAME

Die Variable behält ihren Wert bis zum nächsten Betreten der FUNCTION oder SUB. Beachten Sie bitte hierbei, daß die Deklaration selbstverständlich innerhalb einer SUB oder FUNCTION stattfinden muß.

Bibliotheken, Module und Dialoge

Damit Sie sich gerade beim Entwickeln von größeren StarBasic-Projekten besser organisieren können, stellt Ihnen StarBasic, wie eingangs schon erwähnt, spezielle Strukturierungswerkzeuge zur Verfügung, mit deren Hilfe Sie Projekte organisieren können.

StarBasic kennt mehrere „Einheiten“, in denen sich die einzelnen SUBs und FUNCTIONs, aus denen ein Basic-Projekt besteht, zusammenfassen lassen. Diese finden Sie im folgenden beschrieben.

Bibliotheken

Bibliotheken enthalten Module. Sie dienen quasi als zusätzliches, „übergeordnetes“ Organisierungswerkzeug und fassen die in ihnen enthaltenen Module lediglich zusammen. Bibliotheken können sowohl mit einem Dokument, als auch mit einer Dokumentenvorlage verbunden werden. Ist eine Bibliothek an eine Vorlage oder ein Dokument gebunden, und wird das Dokument bzw. die Dokumentenvorlage gespeichert, werden alle sich in der Bibliothek befindlichen Module und damit auch alle SUBs und FUNCTIONs, die in diesen Modulen vorhanden sind, automatisch mitgespeichert.

Rein theoretisch können sich bis zu 16.000 Module in einer Bibliothek befinden; in der Regel wird aber die mögliche Anzahl von Modulen eher durch den vorhandenen Speicherplatz begrenzt werden.

Module

Ein Modul enthält SUBs und FUNCTIONs sowie Variablendeklarationen für die Variablen, die entweder im gesamten Modul oder in allen Modulen gültig sein sollen. Die Länge des Programmtextes, der in einem Modul gespeichert werden kann, ist auf 64KByte beschränkt. Sollte dieser Platz nicht ausreichen, verteilt man ein StarBasic-Projekt einfach auf mehrere Module, die dann zusammen in einer Bibliothek gespeichert werden sollten.

Tip: Sie sollten für Einzel-Makros, die Sie in einem Dokument oder für die Applikation benötigen, ein einzelnes Modul reservieren. StarBasic-Projekte, die aus mehreren Makros (da aus mehreren SUBs) bestehen, sollten in einem eigenen Modul, sehr umfangreiche Projekte sogar in einer eigenen Bibliothek gespeichert werden, damit sich richtige Makros, die Sie zum Arbeiten in Ihrem StarOffice-Programm benötigen, nicht mit Ihrem StarBasic-Projekt „vermischen“.

Dialogmodule

Dialogmodule fassen den Aufbau einer Dialogbox, die Eigenschaften eines jeden Elementes innerhalb des Dialoges und die Zuordnung bestimmter Ereignisse zu SUBs in einem Modul zusammen. Da in einem Dialogmodul nur ein einziger Dialog gespeichert werden kann, spricht man überlicherweise auch nur vom „Dialog“.

Dialoge werden vom Programm-Code aus mit der .SHOW-Methode aufgerufen und mit der .HIDE-Methode wieder geschlossen. Die Überwachung der kompletten Bearbeitung eines Dialoges durch den Anwender wird ausschließlich von StarBasic übernommen, der Programmierer braucht lediglich bestimmte Ereignisse auszuwerten.

Die Vorgehensweise zur Programmierung von Modulen entnehmen Sie bitte dem im letzten Kapitel beschriebenen Beispielprojekt. Eine ausführliche Referenz aller vorhandenen Dialogboxelemente, eine Liste der Eigenschaften, die diese Elemente annehmen und welche Ereignisse diese Elemente auslösen können, finden Sie im Referenzteil dieses Handbuches beschrieben.

Das Integrated Development Environment (IDE)

Dieses Kapitel beschreibt Ihnen, welche Funktionen Ihnen die IDE bietet, um Sie beim Entwickeln eines Projektes zu unterstützen. Sie erfahren, wie Sie Module oder Bibliotheken verwalten, welche Funktionen Ihnen der Editor der IDE zur Verfügung stellt, und wie Sie die IDE bei der Fehlersuche von Programmen – dem sogenannten Debugging – unterstützen kann.

Ein Überblick über die IDE

Sie erreichen die IDE, sobald Sie ein Makro zur Bearbeitung aufgerufen haben.

Die Integrated Development Environment von StarBasic

Die IDE verfügt über eine besondere Objektleiste, die für das Bearbeiten und Testen von Programmen verschiedene Funktionssymbole bereit hält. Die Erklärung dieser Symbole finden Sie bei der Beschreibung der jeweiligen Themen in den folgenden Abschnitten. Direkt unter der Objektleiste befindet sich das große Editor-Fenster. In diesem Fenster können Sie den Basic-Programm-Code bearbeiten. Rechts vom Editorfenster erkennen Sie eine kleine Spalte, die Haltepunkte aufnimmt und Ihnen während der Einzelschrittbearbeitung eines Programms anzeigt, welche Programmzeile aktuell abgearbeitet wird.

Unterhalb des Editorfensters auf der linken Seite befindet sich der Beobachter. Mit seiner Hilfe können Sie sich während einer Einzelschrittbearbeitung die Inhalte von Variablen, Objekten oder Arrays anzeigen lassen.

Rechts davon befindet sich das Aufrufe-Fenster. Es gibt Ihnen Aufschluß über die Aufrufhierarchie von SUBs und FUNCTIONs.

Die Möglichkeiten, die Ihnen diese Benutzeroberfläche bei der Entwicklung von Programmen bietet, finden Sie ausführlich in den folgenden Abschnitten beschrieben.

Anlegen und Verwalten von Bibliotheken und Modulen

In diesem Kapitel lernen Sie, wie Sie verfahren, um neue Bibliotheken oder Module anzulegen, wie Sie sie löschen und wie Sie StarBasic-Projekte zwischen Dokumenten, Dokumentenvorlagen oder der Applikation verschieben.

Hinweis: Sie sollten gerade für größere StarBasic-Projekte grundsätzlich ein eigenes Modul einrichten, und nicht mehrere Projekte in einem Modul speichern. Diese Vorgehensweise wird um so nötiger, als daß Variablen, die für das gesamte Modul gültig sein sollen, wirklich nur projektspezifisch verwendet werden sollten und sich nicht mit denen von anderen Projekten oder aufgezeichneten Makros „vermischen“ dürfen. Daher: Legen Sie für jedes neue Projekt wenigstens ein eigenes Modul, am besten sogar eine ganze Bibliothek an. Legen Sie für SUBs, die Sie als Makro aufzeichnen möchten, ebenfalls eine eigene Bibliothek an, damit sich die verschiedenen Komponenten nicht „vermischen“.

Verwalten von Bibliotheken

So legen Sie eine neue Bibliothek an

"	Sollten Sie sich nicht in der IDE befinden, wählen Sie aus dem Menü EXTRAS den Menüpunkt MAKRO und klicken im Dialog, der jetzt erscheint, auf die Schaltfläche [VERWALTEN]. Das Programm zeigt Ihnen jetzt einen Dialog, mit dessen Hilfe Sie eine neue Bibliothek anlegen können.

"	Sollten Sie sich bereits in der IDE befinden, erreichen Sie den entsprechenden Dialog ebenfalls über das MODULE-Symbol.

"	Klicken Sie auf das Register BIBLIOTHEKEN.

Verwalten von Bibliotheken

"	Wählen Sie aus dem Kombinationsfeld BIBLIOTHEK das Objekt aus, mit dem die Bibliothek verknüpft werden soll. Das kann entweder das StarOffice-Programm selbst sein oder ein beliebiges Dokument oder eine Dokumentenvorlage, das oder die jedoch geöffnet sein muß.

"	Klicken Sie anschließend auf die Schaltfläche [NEU].

StarBasic hat jetzt eine neue Bibliothek angelegt.

So benennen Sie eine Bibliothek

Möchten Sie den Vorgabenamen ändern, verfahren Sie wie folgt:

"	Klicken Sie den Vorgabenamen der Bibliothek bei gedrückter Taste [Alt] an.

"	Ein Cursor erscheint hinter dem Vorgabenamen, den Sie jetzt editieren können. Beenden Sie die Benennung mit (¢).

So bestimmen Sie, ob eine Bibliothek geladen sein soll oder nicht

Gerade wenn Sie viele Bibliotheken mit einem Dokument oder einer Vorlage oder, was noch häufiger der Fall sein kann, mit der Applikation selbst verbunden haben, kann die Menge an vorhandenen Modulen leicht dazu führen, daß die Übersicht verloren geht. StarBasic erlaubt es daher, jede Bibliothek ein- bzw. auszublenden. Sie finden im oben gezeigten Dialog vor jeder Bibliothek ein Markierungsfeld. Wenn Sie eine Bibliothek abwählen, wird Sie aus dem Arbeitsspeicher entfernt. Ihnen stehen grundsätzlich nur die Bibliotheken zur Verfügung, vor deren Namen ein angewähltes Markierungsfeld steht.

So löschen Sie eine Bibliothek

"	Wählen Sie aus dem Kombinationsfeld BIBLIOTHEK des oben gezeigten Dialogs das Objekt aus, mit dem die Bibliothek verknüpft ist, die gelöscht werden soll. Das kann entweder das StarOffice-Programm selbst sein oder ein beliebiges Dokument oder eine Dokumentenvorlage das oder die jedoch geöffnet sein muß.

Achtung: Bevor Sie den Vorgang vollenden, bedenken Sie bitte: Sobald Sie eine Bibliothek löschen, gehen damit alle in ihr vorhandenen Module und sämtliche SUBs und FUNCTIONs unwiderruflich verloren.

"	Klicken Sie anschließend auf die Schaltfläche [LÖSCHEN], und bestätigen Sie die Sicherheitsabfrage mit [JA].

Verwalten von Modulen und Dialogen

So legen Sie ein neues Modul oder einen Dialog an

"	Wählen Sie aus dem Menü EXTRAS den Menüpunkt MAKRO und klicken im Dialog, der jetzt erscheint, auf die Schaltfläche [VERWALTEN]. Das Programm zeigt Ihnen jetzt einen Dialog, mit dessen Hilfe Sie neue Module oder Dialoge anlegen können.

Verwalten von Modulen und Dialogen

"	Sollten Sie sich in der IDE befinden, erreichen Sie den entsprechenden Dialog ebenfalls über das MODULE-Symbol.

"	Klicken Sie auf das Register MODULE und im Dialog, der jetzt erscheint, auf die Schaltfläche [NEUES MODUL]. StarBasic legt darauf ein neues Modul an. Klicken Sie auf [NEUER DIALOG], wird ein neuer, leerer Dialog angelegt.

So benennen Sie ein Modul oder einen Dialog

Möchten Sie den Vorgabenamen ändern, verfahren Sie wie folgt:

"	Klicken Sie den Vorgabenamen des Moduls oder des Dialogs bei gedrückter Taste [Alt] an.

"	Ein Cursor erscheint hinter dem Vorgabenamen, den Sie jetzt editieren können. Beenden Sie die Benennung mit (¢).

So löschen Sie ein Modul oder einen Dialog

"	Wählen Sie per Mausklick aus dem Listenfeld das Modul oder den Dialog aus, der gelöscht werden soll.

Achtung: Für das Löschen eines Moduls gilt: Bevor Sie den Vorgang vollenden, bedenken Sie bitte: Sobald Sie ein Modul löschen, gehen damit alle in ihm vorhandenen SUBs und FUNCTIONs unwiderruflich verloren!

"	Klicken Sie anschließend auf die Schaltfläche [LÖSCHEN], und bestätigen Sie die Sicherheitsabfrage mit [JA].

Organisieren von Projekten zwischen Dokumenten bzw. Dokumentenvorlagen

Wenn Sie ein Programm bzw. Programmprojekt mit StarBasic entwickelt haben, so möchten Sie Teile des Programms bzw. das ganze Makro-Projekt möglicherweise an andere Dokumente oder Dokumentenvorlagen verschieben. StarBasic bietet Ihnen diese Möglichkeit.

Hinweis: Bitte beachten Sie, daß ein StarBasic-Programm in der Regel aus mehr als nur einem Makro, sprich: aus nur einer SUB besteht. Sollten Sie also ein Projekt entwickelt haben, das mehrere SUBs und FUNCTIONs verwendet, die sich gegenseitig aufrufen, so sollten Sie darauf achten, daß Sie alle benötigten Elemente mitkopieren, da ansonsten Ihr Programm an ein anderes Dokument oder eine andere Vorlage gebunden nicht mehr lauffähig ist.

So verschieben oder kopieren Sie Module, Dialoge oder Bibliotheken zwischen Dokumenten, Vorlagen und der Applikation

"	Öffnen Sie zunächst alle Dokumente bzw. Vorlagen, zwischen denen Sie Objekte (Module, Bibliotheken, Dialoge) verschieben wollen.

"	Wählen Sie aus dem Menü EXTRAS den Menüpunkt MAKRO und klicken im Dialog, der jetzt erscheint, auf die Schaltfläche [VERWALTEN].

"	Um ein Objekt an eine andere Stelle (anderes Dokument, Applikation) zu verschieben, halten Sie es durch Drücken der Maustaste fest, und ziehen Sie es zur gewünschten neuen Position. Durch eine Linie zeigt Ihnen StarBasic dabei an, zwischen welchen Objekten das verschobene Objekt eingefügt werden soll.

"	Um ein Objekt zu kopieren, verfahren Sie auf die gleiche Art und Weise; Sie halten dabei lediglich die Taste (Strg) gedrückt.

Der Basic-Editor

Der Basic-Editor selbst hält die Standard-Editierungsfunktionen bereit, die Sie auch vom StarWriter kennen. Er kennt alle bekannten Funktionen des Bearbeiten-Menüs (Ausschneiden, Löschen, Einfügen), die Markierungsmöglichkeiten mit (ª) sowie alle Cursor-Positionierungsfunktionen (z.B. wortweise springen mit (Strg) und den Cursortasten, etc.), wie Sie auch vom StarWriter her bekannt sind.

Navigieren im Projekt

StarBasic hält einige Funktionen bereit, die Sie beim Navigieren gerade in größeren StarBasic-Projekten unterstützen. Die folgenden Abschnitte beschreiben diese Hilfsmittel:

So verwenden Sie die Kombinationsliste „Bibliothek“ der StarBasic-Objektleiste

Standardmäßig finden Sie auf der linken Seite oberhalb des eigentlichen Editor-Fensters das Bibliothek-Kombinationslistenfeld, mit dessen Hilfe Sie durch Anklicken auf den entsprechenden Eintrag in das erste Modul einer Bibliothek wechseln können.

So verwenden Sie den Objektkatalog zum Bewegen im StarBasic-Projekt

Um sich in größeren Projekten zu bewegen, die aus mehreren Bibliotheken und damit in der Regel aus noch mehr Modulen bestehen, verwenden Sie den Navigator. Verfahren Sie dazu wie folgt.

"	Klicken Sie das Objektkatalog-Symbol aus der Objektleiste an. StarBasic ruft nun den Objektkatalog auf.

Der Objektkatalog der IDE

Hinweis: Dieser Objektkatalog hat die Eigenschaft, daß er wie eine Werkzeugleiste auch dann bestehen bleibt, wenn Sie mit der Maus das Programm-Code-Fenster wieder aktivieren.

"	Der Dialog zeigt eine Liste aller verfügbaren Objekte. Viele Objekte (Dokumente, Vorlagen, die Applikation selbst und dort enthaltene Bibliotheken und Module) enthalten Unterobjekte, die Sie per Doppelklick ein- und ausblenden können.

"	Um ein bestimmtes Modul im Editor anzeigen zu lassen oder den Cursor direkt auf einer bestimmten SUB oder FUNCTION eines Moduls zu positionieren, klicken Sie den entsprechenden Eintrag an und anschließend auf [ZEIGEN].

"	Schließen Sie den Objektkatalog durch Mausklick auf die gleichnamige Schaltfläche, wenn Sie ihn nicht mehr benötigen.

Speichern und Laden von Basic-Quelltexten

StarBasic erlaubt es, Basic-Programm-Code für andere Programmiersysteme zu exportieren oder Basic-Programm-Code, der im ASCII-Format vorliegt, aus anderen Programmiersystemen zu übernehmen.

So speichern Sie den Programm-Code eines Modules als ASCII-Text ab

"	Rufen Sie mit dem Objektkatalog den Programm-Code des Moduls auf, den Sie als ASCII-Text exportieren möchten.

"	Klicken Sie auf das Speichern-Symbol der IDE-Objektleiste. StarBasic öffnet eine Dateiauswahl, in der Sie einen Dateinamen bestimmen können.

"	Bestimmen Sie in diesem Dialog Pfad und Dateinamen auf bekannte Art und Weise, und starten Sie den Speichervorgang mit [OK].

So fügen Sie ASCII-Programm-Code an der aktuellen Cursorposition ein

"	Rufen Sie mit dem Objektkatalog den Programm-Code des Moduls auf, in den Sie Programm-Code als ASCII-Text importieren möchten.

"	Positionieren Sie den Cursor an der Stelle, an der Sie den Programm-Code einfügen möchten.

"	Klicken Sie auf das Laden-Symbol der IDE-Objektleiste, wählen Sie im Dialog, der jetzt erscheint, Pfad und Namen der einzufügenden Programm-Code-Datei aus, und starten Sie den Vorgang mit [OK].

Fehlersuche in StarBasic-Programmen

Gerade größere Projekte, die Sie mit Hilfe von StarBasic entwickeln, werden nicht von Beginn an fehlerfrei funktionieren. StarBasic bietet zum Finden von Fehlern einige Hilfsmittel, mit denen Sie in Ihren Programmen Fehler finden können. Diese Hilfsmittel finden Sie in den folgenden Abschnitten beschrieben.

Haltepunkte und Einzelschrittbearbeitung

Mit Hilfe der Einzelschrittbearbeitung können Sie ein Programm Befehl für Befehl  abarbeiten lassen. Fehler lassen sich auf diese Art und Weise vergleichsweise schnell lokalisieren, da Sie direkt am Bildschirm nachvollziehen können, welchen Weg ein Programmablauf nimmt. Die entsprechende Zeile, die dabei abgearbeitet wird, zeigt die IDE im Editor durch einen Pfeil in der Haltepunktespalte besonders gekennzeichnet an. Möchten Sie, daß ein Programm gezielt an bestimmen Stellen unterbrochen wird, erlaubt Ihnen die IDE dort Haltepunkte zu setzen.

So setzen Sie Haltepunkte vor Programmzeilen

Neben dem Editorfenster sehen Sie eine Spalte, in der Sie per Doppelklick neben eine betroffene Zeile Haltepunkte per Doppelklick hinzufügen oder, falls schon ein Haltepunkt gesetzt wurde, per Doppelklick ebenfalls wieder löschen können. Trifft ein Programm auf einen Haltepunkt, wird die Programmausführung unterbrochen, und Sie haben mit dem Einzelschritt-Symbol die Möglichkeit, das Programm schrittweise „weiterlaufen“ zu lassen.

Trifft das Programm während der Einzelschrittbearbeitung auf einen SUB-Aufruf, so verzweigt es bei der Verwendung des Einzelschritt-Symbols in die SUB. Möchten Sie hingegen, daß ein SUB-Aufruf lediglich durchgeführt, also so, wie ein ganz normaler Basic-Befehl behandelt wird, dann vollziehen Sie die Einzelschritt-Bearbeitung mit dem Prozedurschritt-Symbol.

So definieren Sie die Eigenschaften eines Haltepunktes

Öffnen Sie das Kontextmenü eines Haltepunktes durch Mausklick mit der rechten Maustaste auf einen Haltepunkt, erlaubt Ihnen die IDE durch einen weiteren Mausklick auf den Menüeintrag AKTIV, den Haltepunkt zu aktivieren bzw. zu deaktivieren. Beim Deaktivieren bleibt der Haltepunkt zwar nach wie vor vorhanden, jedoch unterbricht er den Programmablauf nicht mehr. Klicken Sie auf den Eintrag Eigenschaften, öffnet sich ein Dialog, und Sie können dort weitere Optionen bestimmen:

Bestimmung der Haltepunkteeigenschaften

Sie sehen im Listenfeld HALTEPUNKTE eine Liste aller Haltepunkte. Die entsprechenden Nummern geben die Zeilennummern im Programmtext an. Die Zeilennummer, an deren Stelle der Haltepunkt definiert war, bevor Sie den Dialog geöffnet haben, ist in der Liste selektiert. Mit dem Optionsfeld AKTIV bestimmen Sie, ob der Haltepunkt weiterhin aktiv sein soll oder nicht. Im Textfeld DURCHLAUF legen Sie fest, wie oft ein Haltepunkt beim Programmablauf passiert werden muß, bevor der Programmablauf unterbrochen wird. Tragen Sie hier den Wert 0 (das ist die Voreinstellung) ein, wird der Programmablauf grundsätzlich unterbrochen, sobald das Programm auf die Zeile mit dem gesetzten Haltepunkt trifft. Jeder Wert größer als 0 gibt an, wie oft das Programm die entsprechende Stelle passiert haben muß, bis der Programmablauf beim nächsten Erreichen der Zeile mit dem gesetzten Haltepunkt unterbrochen wird.

Klicken Sie auf LÖSCHEN, können Sie in diesem Dialog ebenfalls den Haltepunkt ganz entfernen.

Variablen-Beobachtung

Während einer Einzelschrittbearbeitung haben Sie die Möglichkeit, sich bestimmte Variablen im BEOBACHTER-Fenster anzeigen zu lassen. Um eine Variable in das BEOBACHTER-Fenster aufzunehmen, führen Sie entweder im Programmtext selbst einen Doppelklick auf den Variablennamen aus und klicken anschließend auf das BEOBACHTER ANZEIGEN-Symbol, oder Sie geben den Variablennamen direkt in das BEOBACHTER-Eingabefeld ein und schließen die Eingabe mit (¢) ab.

Die Werte der Variablen, die in der aktuellen SUB oder FUNCTION gültig sind – also die Variablen, die dort lokal deklariert sind und alle global deklarierten Variablen – werden im BEOBACHTER-Fenster angezeigt. Werden Variablen im Beobachter-Fenster angezeigt, die zur Zeit keine Gültigkeit haben, da Sie für die SUB bzw. FUNCTION, die derzeit abgearbeitet wird, nicht lokal definiert sind, wird anstelle des Wertes nur der Hinweis „<Out of Scope>“ (sinngemäß: „momentan nicht erreichbar“) ausgegeben.

Sie können auch Arrays zur Beobachtung aufnehmen. Geben Sie direkt in die Beobachter-Eingabezeile den Namen der Array Variablen ohne Index an, so wird der Inhalt des gesamten Array angezeigt (also beispielsweise TEXT$, wenn das Array als TEXT$(1 TO 10) deklariert wurde).

Arbeiten mit dem Aufrufe-Fenster

Das Aufrufe-Fenster ist bei der Einzelschrittbearbeitung grundsätzlich aktiv. Es informiert Sie über die „Aufruf“-Hierarchie von SUBs bzw. FUNCTIONs. Sie können durch die Reihenfolge der SUB- und FUNCTION Anordnung feststellen, welche SUB welche nächste SUB aufgerufen hat, und damit gleichzeitig erkennen, zu welcher SUB das Programm zurückspringt, wenn die aktuelle SUB beendet wurde.

Weitere Makro- und StarBasic-Möglichkeiten

So bestimmen Sie, daß ein Makro bzw. StarBasic-Projekt automatisch ausgeführt wird, wenn ein bestimmtes Programmereignis eintritt

Jede StarOffice-Applikation erlaubt es, ein Makro und damit eine SUB automatisch ausführen zu lassen, wenn ein bestimmtes Ereignis eintritt. Die möglichen Ereignisse sind dabei in allen StarOffice-Programmen dieselben. Die folgende Tabelle gibt Ihnen Aufschluß darüber, welche Ereignisse es gibt und wann sie eintreten.

Ereignisname	Makro (SUB) wird automatisch aufgerufen, ...
Programmstart	...direkt nachdem das StarOffice-Programm startet.
Programmende	...kurz bevor das StarOffice-Programm beendet wird.
Dokument erzeugen	...direkt nachdem ein neues Dokument mit DATEI/NEU oder dem NEU-Symbol erstellt wurde.
Dokument öffnen	...direkt nachdem ein Dokument mit DATEI/ÖFFNEN oder dem ÖFFNEN-Symbol geladen wurde.
Dokument sichern als	...direkt nachdem ein Dokument unter einem bestimmten Namen gesichert wurde (entweder mit DATEI/SPEICHERN UNTER oder mit DATEI/SPEICHERN oder dem SPEICHERN-Symbol, wenn zuvor noch kein Dokumentenname bestimmt wurde).
Dokument sichern	...direkt nachdem ein Dokument mit DATEI/SPEICHERN oder mit dem SPEICHERN-Symbol gesichert wurde, sofern zuvor schon ein Dokumentenname für das Dokument bestimmt wurde.
Dokument schließen	...direkt nachdem ein Dokument geschlossen wurde. Achtung: Wurde das Dokument seit der letzten Änderung nicht gespeichert, und der Anweder bestätigt die Speicher-Abfrage mit [JA], wird automatisch das „Dokument sichern“-Ereignis zusätzlich ausgelöst.
Dokument aktivieren	...direkt nachdem ein Dokument entweder mit dem entsprechenden Eintrag im Fenster-Menü oder mit der Tastenkombination (Strg)() in den Vordergrund geholt wurde.
Dokument deaktivieren	...direkt nachdem ein anderes Dokument entweder mit dem entsprechenden Eintrag im Fenster-Menü oder mit der Tastenkombination (Strg)() in den Vordergrund geholt wurde.
Dokument drucken	...direkt nachdem der Drucken-Dialog beendet wurde aber noch vor dem eigentlichen Druckprozeß.
Serienbriefe drucken	...direkt vor dem Ausdruck von Serienbriefen.
Hinweis: Ein Makro wird, sofern es mit einem Ereignis verknüpft wurde, ebenfalls automatisch ausgeführt, wenn das entsprechende Ereignis durch ein gestartetes Makro ausgelöst wurde!

So verknüpfen Sie ein Ereignis mit einem Makro

"	Wählen Sie im Menü EXTRAS den Menüpunkt ANPASSEN und dort das Register Ereignisse.

Verknüpfung von Autostart-Ereignissen mit Makros

"	Wählen Sie im Listenfeld EREIGNIS den Ereignistypen aus.

"	Bestimmen Sie im Listenfeld BASIC, in welchem Objekt (geladene Dokumente oder Dokumentvorlagen oder die Applikation selbst) das zuzuweisende Makro zu finden ist.

"	Wählen Sie aus dem Listenfeld MAKRO den Namen des Makros (bzw. der SUB) aus.

"	Bestätigen Sie Ihre Auswahl mit [OK].

So heben Sie eine Ereignisverknüpfung wieder auf

"	Im oben gezeigten Dialog wählen Sie das Ereignis aus, dessen Verknüpfung Sie aufheben möchten, und klicken Sie anschließend auf [LÖSCHEN].

Verknüpfung von Makros bzw. StarBasic-Projekten mit Symbolleisten, Tastatur oder Pull-Down-Menüs

Jede StarOffice-Applikation erlaubt Ihnen, ein Makro und damit jedes StarBasic-Projekt auf bestimmte Symbolleisten zu legen, Tastaturkürzel zum Aufruf zu definieren, oder auch ein Makro (Projekt) mit einem Pull-Down-Menüeintrag zu starten. Wählen Sie zur Zuordnung das Menü EXTRAS/ANPASSEN und dort die entsprechende Registerkarte, mit der Sie alle gewünschten Zuordnungen vornehmen können.


StarWriter Eigenschaften und Methoden
StarWriter Eigenschaften & Methoden

ActiveWindow

ActionEnd-Methode

ActionStart-Methode

BackgroundDialog-Methode

BorderDialog-Methode

BottomMargin-Eigenschaft

Copy-Methode

Cut-Methode

DataAppendRecord-Methode

DataColumn-Methode

DataColumnName-Methode

DataColumnNumber-Methode

DataColumnType-Methode

DataDeleteRecord-Methode

DataFirstRecord-Methode

DataNextRecord-Methode

DataRecordID-Methode

DataRecord-Methode

DataSelect-Methode

DataUpdateRecord-Methode

Delete-Methode

Escape-Methode

FootnoteDialog-Methode

GotoPage-Methode

Hyphenate-Methode

InsertMode-Eigenschaft

LeftMargin-Eigenschaft

LinkDialog-Methode

OpenDatabaseConnection-Methode

PageDown-Methode

PageStyleApply-Methode

PageStyleName-Eigenschaft

PageUp-Methode

PasteSpecial-Methode

PrintDefault-Methode

Print-Methode

RedoAction-Eigenschaft

Refresh-Methode

Repaginate-Methode

RepeatSearch-Methode

ReplaceAll-Methode

Replace-Methode

RightMargin-Eigenschaft

SearchAll-Methode

Search-Methode

SelectionMode-Eigenschaft

SendFax-Methode

ShowFourPages-Methode

ShowTwoPages-Methode

Spelling-Methode

StandardFontDialog-Methode

StartOfDocument-Methode

ThesaurusDialog-Methode

TopMargin-Eigenschaft

UndoAction-Eigenschaft

UndoMode-Eigenschaft

UpdateFields-Methode

UpdateInputFields-Methode

 Application

AdressbookDialog-Methode

AutoPilotAgenda-Methode

AutoPilotFax-Methode

AutoPilotLetter-Methode

AutoPilotMemo-Methode

BasicIDEAppear-Methode

DeleteDatabaseConnection-Methode

InsertEnvelop-Methode

InsertLabels-Methode

MacroDialog-Methode

Mail-Methode

NavigatorDialog-Methode

OptionDialog-Methode

Document

LoadStyles-Methode

Font

 Shrink-Methode

Bold-Eigenschaft

CharSet-Eigenschaft

Color-Eigenschaft

Escapement-Eigenschaft

Family-Eigenschaft

FontDialog-Methode

Grow-Methode

Italic-Eigenschaft

Language-Eigenschaft

OutlineFont-Eigenschaft

Pitch-Eigenschaft

Prop-Eigenschaft

RelativeSize-Eigenschaft

Shadow-Eigenschaft

Size-Eigenschaft

Spacing-Eigenschaft

Strikethrough-Eigenschaft

StyleName-Eigenschaft

SubScript-Eigenschaft

SuperScript-Eigenschaft

WordMode-Eigenschaft

Frame

ActionEnd-Methode

ActionStart-Methode

BottomMargin-Eigenschaft

BringToFront-Methode

Content-Eigenschaft

FrameDialog-Methode

FrameProtect-Eigenschaft

GraphicDialog-Methode

GraphicMirror-Eigenschaft

HorzOrientation-Eigenschaft

HorzRelation-Eigenschaft

LeftMargin-Eigenschaft

LineColor-Eigenschaft

PageColumnDialog-Methode

PageDialog-Methode

Paste-Methode

Pos-Eigenschaft

RightMargin-Eigenschaft

SendToBack-Methode

Shadow.BackColor-Eigenschaft

Shadow.FillColor-Eigenschaft

Shadow.Location-Eigenschaft

Shadow.Style-Eigenschaft

Shadow.Transparent-Eigenschaft

Shadow.Width-Eigenschaft

Size-Eigenschaft

ToBack-Methode

ToFront-Methode

TopMargin-Eigenschaft

VertOrientation-Eigenschaft

VertRelation-Eigenschaft

XPos-Eigenschaft

YPos-Eigenschaft

Graphic

BringToFront-Methode

GraphicDialog-Methode

GraphicMirror-Eigenschaft

SendToBack-Methode

Shadow.BackColor-Eigenschaft

Shadow.FillColor-Eigenschaft

Shadow.Location-Eigenschaft

Shadow.Style-Eigenschaft

Shadow.Transparent-Eigenschaft

Shadow.Width-Eigenschaft

ToBack-Methode

ToFront-Methode

Hyphenzone

Hyphen-Eigenschaft

MaxHyphens-Eigenschaft

MinLead-Eigenschaft

MinTrails-Eigenschaft

PageEnd-Eigenschaft

Interior

BackColor-Eigenschaft

FillColor-Eigenschaft

LaunchStarImage-Methode

Style-Eigenschaft

Transparent-Eigenschaft

List

DecrementLevel-Methode

DecrementSubLevels-Methode

JumpDownThisLevel-Methode

JumpUpThisLevel-Methode

MoveDown-Methode

MoveDownSubItems-Methode

Paragraph

Alignment-Eigenschaft (Paragraph)

BottomMargin-Eigenschaft

Break-Eigenschaft

DropCap-Eigenschaft

IdentFirstLine-Eigenschaft

InterLineSpace-Eigenschaft

InterSpace-Eigenschaft

LeftMargin-Eigenschaft

LineHeight-Eigenschaft

LineSpace-Eigenschaft

Orphan-Eigenschaft

PageStyle-Eigenschaft

ParagraphDialog-Methode

ParagraphEnd-Eigenschaft

ParaKeepTogether-Eigenschaft

ParaSplit-Eigenschaft

ParaStyleApply-Methode

PropLineHeight-Eigenschaft

RightMargin-Eigenschaft

TopMargin-Eigenschaft

Widow-Eigenschaft

PrintPreview

EndOfDocument-Methode

PrintPreView-Methode

PrintSetting

FaxName-Eigenschaft

NotFoundWarning-Eigenschaft

PaperBinWarning-Eigenschaft

PaperFromSetup-Eigenschaft

PaperSizeWarning-Eigenschaft

PrintAnnotations-Eigenschaft

PrintControl-Eigenschaft

PrintDrawing-Eigenschaft

PrintGraphic-Eigenschaft

PrintLeftPage-Eigenschaft

PrintReverse-Eigenschaft

PrintRightPage-Eigenschaft

PrintTable-Eigenschaft

Table

ActionEnd-Methode

ActionStart-Methode

Alignment-Eigenschaft (Table)

AutoFormat-Methode (Table)

BottomMargin-Eigenschaft

Calc-Methode

Columns-Eigenschaft

ConvertTableText-Methode

DeleteBookmark-Methode

DeleteColumns-Methode

DeleteRegion-Methode

DeleteRows-Methode

EditRegion-Methode

GoToEnd-Methode

GoToStart-Methode

HeadlineRepeat-Eigenschaft

InsertColumns-Methode

InsertRows-Methode

JumpToBookmark-Methode

JumpToNextBookmark-Methode

JumpToNextCell-Methode

JumpToPrevBookmark-Methode

JumpToPrevCell-Methode

LeftMargin-Eigenschaft

LineColor-Eigenschaft

MergeCells-Methode

MergeCells-Methode

PageColumnDialog-Methode

PageDialog-Methode

Paste-Methode

ResetTableProtection-Methode

RightMargin-Eigenschaft

Select-Methode (Tabelle)

SetOptimalColumnWidth-Methode

SetOptimalColumnWidth-Methode

SetOptimalRowHeight-Methode

SetRowHeight-Methode

Shadow.BackColor-Eigenschaft

Shadow.FillColor-Eigenschaft

Shadow.Location-Eigenschaft

Shadow.Style-Eigenschaft

Shadow.Transparent-Eigenschaft

Shadow.Width-Eigenschaft

ShowTables-Eigenschaft

SplitCell-Methode

TableBounds-Eigenschaft

TableDialog-Methode

TableName-Eigenschaft

TopMargin-Eigenschaft

Text

ActionEnd-Methode

ActionStart-Methode

AutoCorrectDialog-Methode

AutoFormat-Methode (Text)

Backspace-Methode

BookmarkCount-Eigenschaft

BulletsAndNumberingDialog-Methode

CalculateSel-Methode

ChapterNumberingDialog-Methode

CharStyleApply-Methode

ConvertTableText-Methode

CursorXPos-Eigenschaft

DataUpdateFields-Methode

DataUpdatePrint-Methode

DefaultBullet-Methode

DeleteBookmark-Methode

DeleteRegion-Methode

DelLine-Methode

DelToEndOfLine-Methode

DelToEndOfPara-Methode

DelToEndOfSentence-Methode

DelToEndOfWord-Methode

DelToStartOfLine-Methode

DelToStartOfPara-Methode

DelToStartOfSentence-Methode

DelToStartOfWord-Methode

EditRegion-Methode

ExpandGlossary-Methode

FieldDialog-Methode

GetDatabaseFieldValue-Methode

GetFieldFmt-Methode

GetFieldName-Methode

GetFieldPar1-Methode

GetFieldPar2-Methode

GetUserFieldValue-Methode

GoDown-Methode

GoLeft-Methode

GoRight-Methode

GoToEnd-Methode

GoToEndOfColumn-Methode

GoToEndOfDoc-Methode

GoToEndOfLine-Methode

GoToEndOfNextColumn-Methode

GoToEndOfNextPage-Methode

GoToEndOfPage-Methode

GoToEndOfPara-Methode

GoToEndOfPrevColumn-Methode

GoToEndOfPrevPage-Methode

GotoFrame-Methode

GoToNextSentence-Methode

GoToNextWord-Methode

GoToPrevSentence-Methode

GoToPrevWord-Methode

GoToStartOfColumn-Methode

GoToStartOfDoc-Methode

GoToStartOfLine-Methode

GoToStartOfNextColumn-Methode

GoToStartOfNextPage-Methode

GoToStartOfPage-Methode

GoToStartOfPara-Methode

GoToStartOfPrevColumn-Methode

GoToStartOfPrevPage-Methode

GotoTable-Methode

GoUp-Methode

IndexEntryDialog-Methode

IndexMarkToIndex-Methode

InsertAnnotation-Methode

InsertBookmark-Methode

InsertBreak-Methode

InsertColumnBreak-Methode

InsertField-Methode

InsertFile-Methode

InsertFootnote-Methode

InsertFrame-Methode

InsertGlossary-Methode

InsertGraphic-Methode

InsertIndexEntry-Methode

InsertIndexesEntry-Methode

InsertIndexesIndex-Methode

InsertIndexesTOC-Methode

InsertIndexesUserIndex-Methode

InsertLinebreak-Methode

Insert-Methode

InsertNamedTable-Methode

InsertNonBreakingSpace-Methode

InsertNumbering-Methode

InsertObject-Methode

InsertObjectStarChart-Methode

InsertObjectStarImage-Methode

InsertObjectStarMath-Methode

InsertPagebreak-Methode

InsertPara-Methode

InsertRegion-Methode

InsertSoftHyphen-Methode

InsertSymbol-Methode

InsertTable-Methode

InsertTOCEntry-Methode

InsertUserEntry-Methode

IsEndOfDoc-Eigenschaft

IsEndOfPara-Eigenschaft

IsEndOfWord-Eigenschaft

IsStartOfDoc-Eigenschaft

IsStartOfPara-Eigenschaft

IsStartOfWord-Eigenschaft

JumpToBookmark-Methode

JumpToFooter-Methode

JumpToFootnoteOrAnchor-Methode

JumpToHeader-Methode

JumpToNextBookmark-Methode

JumpToNextFootnote-Methode

JumpToNextFrame-Methode

JumpToNextSelection-Methode

JumpToNextTable-Methode

JumpToPrevBookmark-Methode

JumpToPrevFootnote-Methode

JumpToPrevSelection-Methode

JumpToPrevTable-Methode

JumpToReference-Methode

JumpToRegion-Methode

LogicalPageNumber-Eigenschaft

NewField-Methode

NewGlossary-Methode

NumberOfPages-Eigenschaft

PageColumnDialog-Methode

PageDialog-Methode

PageNumber-Eigenschaft

Paste-Methode

RelativeSize-Eigenschaft

RenameRegion-Methode

ResetAttributes-Methode

SelectAll-Methode

SelectionCount-Eigenschaft

SelectWord-Methode

SetActGlossaryGroup-Methode

SetCurField-Methode

SetUserFieldValue-Methode

Shadow.BackColor-Eigenschaft

Shadow.FillColor-Eigenschaft

Shadow.Location-Eigenschaft

Shadow.Style-Eigenschaft

Shadow.Transparent-Eigenschaft

Shadow.Width-Eigenschaft

SortDialog-Methode

Sort-Methode

StartAutoCorrect-Methode

Value-Eigenschaft

ViewSettings

Bounds-Eigenschaft

CrossHair-Eigenschaft

Drawing-Eigenschaft

Field-Eigenschaft

FieldName-Eigenschaft

FootnoteBackground-Eigenschaft

Graphics-Eigenschaft

HiddenText-Eigenschaft

HorzRuler-Eigenschaft

HorzScrollbar-Eigenschaft

IndexEntry-Eigenschaft

ManualBreak-Eigenschaft

NoneBreakingSpace-Eigenschaft

ParagraphEnd-Eigenschaft

ShowTables-Eigenschaft

SoftHyphen-Eigenschaft

Space-Eigenschaft

StatusLine-Eigenschaft

TableBounds-Eigenschaft

Tabs-Eigenschaft

VertRuler-Eigenschaft

VertScrollbar-Eigenschaft


StarWriter Eigenschaften und Methoden
AdressbookDialog-Methode

Funktion:	Ruft den Adreßbuch-Dialog auf.
Syntax:	Application.AdressbookDialog Switch
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob das Adreßbuch eingeblendet werden soll.
	Wert	Beschreibung
	True	Das Adreßbuch wird eingeblendet.
	False	Das Adreßbuch wird nicht eingeblendet.
Für Objekt:	Application

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Alignment-Eigenschaft

Funktion:	Richtet einen Absatz linksbündig, rechtsbündig, zentriert oder im Blocksatz aus.
Syntax:	Selection.Paragraph.Alignment [= Ausrichtung%]
	Parameter	Beschreibung
	Ausrichtung%	Integer-Ausdruck, der angibt, wie der Absatz ausgerichtet wird:
	Wert	Beschreibung
	1	Absatz wird linksbündig ausgerichtet.
	2	Absatz wird rechtsbündig ausgerichtet.
	3	Absatz wird zentriert ausgerichtet.
	4	Absatz wird im Blocksatz ausgerichtet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Alignment-Eigenschaft

Funktion:	Richtet die Zellen der gesamten Tabelle linksbündig, rechtsbündig, zentriert oder im Blocksatz aus.
Syntax:	Selection.Table.Alignment [= Ausrichtung%]
	Parameter	Beschreibung
	Ausrichtung%	Integer-Ausdruck, der angibt, wie die Tabelle ausgerichtet werden soll:
	Wert	Beschreibung
	1	Tabelle wird linksbündig ausgerichtet.
	2	Tabelle wird rechtsbündig ausgerichtet.
	3	Tabelle wird zentriert ausgerichtet.
	4	Tabelle wird im Blocksatz ausgerichtet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Table

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoCorrectDialog-Methode

Funktion:	Ruft den Dialog auf, mit dessen Hilfe die Optionen für die Autokorrektur gesetzt werden können.
Syntax:	Selection.Text.AutoCorrectDialog
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoFormat-Methode

Funktion:	Führt eine automatische Formatierung der aktuellen Tabelle durch.
Syntax:	Selection.Table.AutoFormat
Für Objekt:	Table

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoFormat-Methode

Funktion:	Führt eine automatische Formatierung des Textes durch.
Syntax:	Selection.Text.AutoFormat
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoPilotAgenda-Methode

Funktion:	Ruft den Autopiloten zur Erstellung einer neuen Agenda auf.
Syntax:	Application.AutoPilotAgenda
Für Objekt:	Application

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoPilotFax-Methode

Funktion:	Ruft den Autopiloten zur Erstellung eines neuen Faxes auf.
Syntax:	Application.AutoPilotFax
Für Objekt:	Application

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoPilotLetter-Methode

Funktion:	Ruft den Autopiloten zur Erstellung eines neuen Briefes auf.
Syntax:	Application.AutoPilotLetter.
Für Objekt:	Application

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
AutoPilotMemo-Methode

Funktion:	Ruft den Autopiloten zur Erstellung eines neuen Memos auf.
Syntax:	Application.AutoPilotMemo
Für Objekt:	Application

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BasicIDEAppear-Methode

Funktion:	Ruft die Entwicklungsumgebung für Makros auf.
Syntax:	Application.BasicIDEAppear
Für Objekt:	Application

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Bold-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Intensität der Fett-Darstellung des selektierten Textes, respektive der an der Schreibmarke einzufügenden Zeichen.
Syntax:	Selection.Font.Bold [= Intens%]
	Parameter	Beschreibung
	Intens%	Integer-Ausdruck, der die Intensität der Fett-Darstellung des Textes angibt. Intens% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Der Text wird normal dargestellt.
	1 - 10	Der Text wird fett dargestellt. Die Intensität der Fett-Darstellung erhöht sich mit zunehmendem Wert.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BulletsAndNumberingDialog-Methode

Funktion:	Ruft den Dialog auf, mit dessen Hilfe die Einstellungen für Aufzählungen und Numerierungen vorgenommen werden können.
Syntax:	Selection.Text.BulletsAndNumberingDialog
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
CalculateSel-Methode

Funktion:	Berechnet die im Dokument selektierte Formel. Das Ergebnis wird in der Zwischenablage abgelegt.
Syntax:	Selection.Text.CalculateSel
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ChapterNumberingDialog-Methode

Funktion:	Ruft den Dialog auf, mit dem die Einstellungen für die Kapitelnumerierungen vorgenommen werden können.
Syntax:	Selection.Text.ChapterNumberingDialog
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
StyleName-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Schriftstil des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen.
Syntax:	Selection.Font.StyleName [= FontStyle$]
	Parameter	Beschreibung
	FontStyle$	Zeichenfolgen-Ausdruck, der den Schriftstil bestimmt. FontStyle$ können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	Leerstring	Voreinstellung. Der Text wird normal dargestellt.
	Bold	Die Schrift wird fett dargestellt.
	Italic	Die Schrift wird kursiv dargestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
CharSet-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Zeichensatz des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen.
Syntax:	Selection.Font..CharSet [= Set%]
	Parameter	Beschreibung
	Set%	Integer-Ausdruck, der den Zeichensatz beschreibt, der der Schrift zugewiesen werden kann:
	Wert	Beschreibung
	0	Voreinstellung. Unbekannter Zeichensatz.
	1	ANSI-Zeichensatz.
	2	Macintosh-Zeichensatz
	3	IBM-PC-Zeichensatz 437.
	4	IBM-PC-Zeichensatz 850.
	5	IBM-PC-Zeichensatz 860.
	6	IBM-PC-Zeichensatz 861.
	7	IBM-PC-Zeichensatz 863.
	8	IBM-PC-Zeichensatz 865.
	9	System-Zeichensatz
	10	Symbol-Zeichensatz
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Family-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Schriftfamilie des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen.
Syntax:	Selection.Font.Family [= Group%]
	Parameter	Beschreibung
	Group%	Integer-Ausdruck, der die Schriftfamilie kennzeichnet, die der Schriftart zugewiesen werden kann:
	Wert	Beschreibung
	0	Voreinstellung. Unbekannte Schriftartgruppe.
	1	Schriftartgruppe Decorative.
	2	Schriftartgruppe Modern
	3	Schriftartgruppe Roman
	4	Schriftartgruppe Script
	5	Schriftartgruppe Swiss
	6	Schriftartgruppe System
Erläuterung:	Wird eine Schriftart gewählt, die nicht vorhanden ist, wird eine adäquate Schriftart aus der angegebenen Schriftfamilie verwendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
CharStyleApply-Methode

Funktion:	Weist dem selektierten Text eine Zeichenvorlage zu.
Syntax:	Selection.Text.CharStyleApply Style$
	Parameter	Beschreibung
	Style$	Ein Zeichenfolgen-Ausdruck, der die Bezeichnung der Zeichenvorlage angibt, die dem selektierten Text zugewiesen werden soll.
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Color-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Farbe des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen.
Syntax:	Selection.Font.Color [= ColVal]
	Parameter	Beschreibung
	ColVal	Beliebiger numerischer Ausdruck, der die Farbe des Textes angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
CursorXPos-Eigenschaft

Funktion:	Ermittelt die aktuelle horizontale Position der Schreibmarke.
Syntax:	Selection.Text.CursorXPos
Zugriff:	Nur Lesen
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataColumn-Methode

Funktion:	Gibt den Inhalt des angegebenen Datenbankfeldes zurück.
Syntax:	ActiveWindow.DataColumn ColumnNumber%
	Parameter	Beschreibung
	ColumnNumber%	Nummer des Datenbankfeldes, dessen Inhalt ermittelt werden soll.
Für Objekt:	ActiveWindow

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataColumnName-Methode

Funktion:	Gibt die Bezeichnung des angegebenen Datenbankfeldes zurück.
Syntax:	ActiveWindow.DataColumnName ColumnNumber%
	Parameter	Beschreibung
	ColumnNumber%	Nummer des Datenbankfeldes, dessen Bezeichnung ermittelt werden soll.
Für Objekt:	ActiveWindow

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataColumnNumber-Methode

Funktion:	Ermittelt die Anzahl aller Spalten einer Datenbanktabelle.
Syntax:	ActiveWindow.DataColumnNumber
Für Objekt:	ActiveWindow

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataColumnType-Methode

Funktion:	Gibt den Feldtyp des angegebenen Datenbankfeldes zurück.
Syntax:	ActiveWindow.DataColumnType ColumnNumber%
	Parameter	Beschreibung
	ColumnNumber%	Nummer des Datenbankfeldes, dessen Feldtyp ermittelt werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataFirstRecord-Methode

Funktion:	Selektiert den ersten Datensatz in der aktuellen Datenbank.
Syntax:	ActiveWindow.DataFirstRecord
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataNextRecord-Methode

Funktion:	Selektiert den nächsten Datensatz in der aktuellen Datenbank.
Syntax:	ActiveWindow.DataNextRecord
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataRecord-Methode

Funktion:	Selektiert den angegebenen Datensatz in der aktuellen Datenbank.
Syntax:	ActiveWindow.DataRecord RecordNumberund
	Parameter	Beschreibung
	RecordNumberund	Ein beliebiger Long-Integer-Ausdruck, der den Datensatz angibt, zu dem gesprungen werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataRecordID-Methode

Funktion:	Gibt die Nummer des aktuellen Datensatzes innerhalb einer SQL-Abfrage zurück.
Syntax:	ActiveWindow.DataRecordID
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataSelect-Methode

Funktion:	Führt eine SQL-Abfrage für die aktuelle Datenbank aus.
Syntax:	ActiveWindow.DataSelect Statement$
	Parameter	Beschreibung
	Statement$	Ein Zeichenfolgen-Ausdruck, der die SQL-Anweisung aufnimmt.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataUpdateFields-Methode

Funktion:	Überträgt die Datenbankinhalte in die Datenbankfelder des Dokumentes.
Syntax:	Selection.Text.DataUpdate DBName$, Statement$, RecordNumberund
	Parameter	Beschreibung
	DBName$	Zeichenfolgen-Ausdruck, der die Bezeichnung der Datenbank aufnimmt, deren Inhalte in die Datenbankfelder des Dokumentes eingefügt werden sollen.
	Statement$	Zeichenfolgen-Ausdruck, der die SQL-Anweisung aufnimmt, die die Datensätze filtert, deren Inhalt den Datenbankfeldern des Dokumentes zugewiesen werden sollen.
	RecordNumberund	Optionaler Long-Integer-Ausdruck, der die Nummer des Datensatzes bestimmt, dessen Inhalt in das Dokument eingefügt werden soll. Wird dieser Parameter nicht angegeben, wird der erste Datensatz der SQL-Abfrage verwendet.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataUpdatePrint-Methode

Funktion:	Druckt das Datenformular, das aus den Datenbankfeldern des Dokumentes besteht, denen wiederum die Inhalte der Datenfelder der aktuell geöffneten Datenbank zugewiesen sind.
Syntax:	Selection.Text.DataUpdatePrint DBName$, Statement$, Printer$
	Parameter	Beschreibung
	DBName$	Zeichenfolgen-Ausdruck, der die Bezeichnung der Datenbank aufnimmt, deren Inhalte ausgedruckt werden sollen.
	Statement$	Zeichenfolgen-Ausdruck, der die SQL-Anweisung aufnimmt, die die Datensätze filtert, deren Inhalt den Datenbankfeldern des Dokumentes zugewiesen werden sollen.
	Printer$	Optionaler Long-Integer-Ausdruck, der die Nummer des Datensatzes bestimmt, dessen Inhalt ausgedruckt werden soll. Wird dieser Parameter nicht angegeben, wird der erste Datensatz der SQL-Abfrage verwendet.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DefaultBullet-Methode

Funktion:	Setzt die Standardeinstellungen für Aufzählungen.
Syntax:	Selection.Text.DefaultBullet
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DeleteColumns-Methode

Funktion:	Löscht die aktuelle Tabellenspalte.
Syntax:	Selection.Table.DeleteColumns
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DeleteDatabaseConnection-Methode

Funktion:	Löst die Verbindung zu einer Datenbank.
Syntax:	Application.DeleteDatabaseConnection DBName$
	Parameter	Beschreibung
	DBName$	Ein Zeichenfolgen-Ausdruck, der die Bezeichnung der Datenbank aufnimmt, die geschlossen werden soll.
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DeleteRows-Methode

Funktion:	Löscht die aktuelle Zeile der Tabelle.
Syntax:	Selection.Table.DeleteRows
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelLine-Methode

Funktion:	Löscht die aktuelle Textzeile.
Syntax:	Selection.Text.DelLine
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToEndOfLine-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Ende der Zeile.
Syntax:	Selection.Text.DelToEndOfLine
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToEndOfPara-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Ende des Absatzes.
Syntax:	Selection.Text.DelToEndOfPara
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToEndOfSentence-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Ende des Satzes.
Syntax:	Selection.Text.DelToEndOfSentence
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToEndOfWord-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Ende des Wortes.
Syntax:	Selection.Text.DelToEndOfWord
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToStartOfLine-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Anfang der Zeile.
Syntax:	Selection.Text.DelToStartOfLine
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToStartOfPara-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Anfang des Absatzes.
Syntax:	Selection.Text.DelToStartOfPara
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToStartOfSentence-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Anfang des Satzes.
Syntax:	Selection.Text.DelToStartOfSentence
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DelToStartOfWord-Methode

Funktion:	Löscht den Text von der aktuellen Position der Schreibmarke bis zum Anfang des Wortes.
Syntax:	Selection.Text.DelToStartOfWord
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
HorzScrollbar-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige der horizontale Bildlaufleiste.
Syntax:	ViewSettings.HorzScrollbar [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die horizontale Bildlaufleiste ein- oder ausgeblendet werden soll.
	Wert	Beschreibung
	True	Die horizontale Bildlaufleiste wird eingeblendet.
	False	Die horizontale Bildlaufleiste wird nicht eingeblendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
VertScrollbar-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige der vertikalen Bildlaufleiste.
Syntax:	ViewSettings.VertScrollbar [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die vertikale Bildlaufleiste ein- oder ausgeblendet werden soll.
	Wert	Beschreibung
	True	Die vertikale Bildlaufleiste wird eingeblendet.
	False	Die vertikale Bildlaufleiste wird nicht eingeblendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
StatusLine-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige der Statusleiste.
Syntax:	ViewSettings.StatusLine [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die Statusleiste ein- oder ausgeblendet werden soll.
	Wert	Beschreibung
	True	Die Statusleiste wird eingeblendet.
	False	Die Statusleiste wird nicht eingeblendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
HorzRuler-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige des horizontalen Lineals.
Syntax:	ViewSettings.HorzRuler [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob das horizontale Lineal ein- oder ausgeblendet werden soll.
	Wert	Beschreibung
	True	Das horizontale Lineal wird eingeblendet.
	False	Das horizontale Lineal wird nicht eingeblendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
VertRuler-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige des vertikalen Lineals.
Syntax:	ViewSettings.VertRuler [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob das vertikale Lineal ein- oder ausgeblendet werden soll.
	Wert	Beschreibung
	True	Das vertikale Lineal wird eingeblendet.
	False	Das vertikale Lineal wird nicht eingeblendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ShowTables-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige von Tabellen im Dokument.
Syntax:	ViewSettings.ShowTables [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Tabellen angezeigt werden sollen.
	Wert	Beschreibung
	True	Tabellen werden angezeigt.
	False	Tabellen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
TableBounds-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige von Tabellenbegrenzungen im Dokument.
Syntax::	ViewSettings.TableBounds [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Tabellenbegrenzungen angezeigt werden sollen:
	Wert	Beschreibung
	True	Tabellenbegrenzungen werden angezeigt.
	False	Tabellenbegrenzungen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Graphics-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige von Grafiken im Dokument.
Syntax:	ViewSettings.Graphics [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Grafiken im Dokument angezeigt werden sollen:
	Wert	Beschreibung
	True	Grafiken werden angezeigt.
	False	Grafiken werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ParagraphEnd-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige von Absatzendezeichen.
Syntax:	ViewSettings.ParagraphEnd [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die Absatzendezeichen angezeigt werden sollen:
	Wert	Beschreibung
	True	Die Absatzendezeichen werden angezeigt.
	False	Die Absatzendezeichen weren nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Tabs-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige von Tabulatorzeichen.
Syntax:	ViewSettings.Tabs [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Tabulatorzeichen angezeigt werden sollen:
	Wert	Beschreibung
	True	Tabulatorzeichen werden angezeigt.
	False	Tabulatorzeichen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Space-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Anzeige von Leerzeichen.
Syntax:	ViewSettings.Space [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Leerzeichen durch einen kleinen Punkt dargestellt angezeigt werden sollen:
	Wert	Beschreibung
	True	Leerzeichen werden durch einen kleinen Punkt dargestellt angezeigt.
	False	Leerzeichen werden nicht durch einen kleinen Punkt dargestellt angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
NoneBreakingSpace-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Option für die Anzeige von geschützten Leerzeichen.
Syntax:	ViewSettings.NoneBreakingSpace [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob geschützte Leerzeichen angezeigt werden sollen:
	Wert	Beschreibung
	True	Geschützte Leerzeichen werden angezeigt.
	False	Geschützte Leerzeichen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SoftHyphen-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für manuell eingefügte weiche Trennstellen.
Syntax:	ViewSettings.SoftHyphen [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob manuell eingefügte weiche Trennstellen angezeigt werden sollen:
	Wert	Beschreibung
	True	Manuell eingefügte weiche Trennstellen werden angezeigt.
	False	Manuell eingefügte weiche Trennstellen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
HiddenText-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für versteckten Text.
Syntax:	ViewSettings.HiddenText [= Switch]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob versteckter Text angezeigt werden soll:
	Wert	Beschreibung
	True	Versteckter Text wird angezeigt.
	False	Versteckter Text wird nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Bounds-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoption für Textbegrenzungen.
Syntax:	ViewSettings.Bounds [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Textbegrenzungen angezeigt werden sollen:
	Wert	Beschreibung
	True	Textbegrenzungen werden angezeigt.
	False	Textbegrenzungen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ManualBreak-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für manuelle Umbrüche.
Syntax:	ViewSettings.ManualBreak [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob manuelle Umbrüche angezeigt werden sollen:
	Wert	Beschreibung
	True	Manuelle Umbrüche werden angezeigt.
	False	Manuelle Umbrüche werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IndexEntry-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoption für Verzeichnisseinträge.
Syntax:	ViewSettings.IndexEntry [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Verzeichniseinträge angezeigt werden sollen:
	Wert	Beschreibung
	True	Verzeichniseinträge werden angezeigt.
	False	Verzeichniseinträge werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FootnoteBackground-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für farbig hinterlegte Fußnoten.
Syntax:	ViewSettings.FootNoteBackground [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die Fußnoten im Dokument farbig hinterlegt angezeigt werden sollen:
	Wert	Beschreibung
	True	Fußnoten werden farbig hinterlegt angezeigt.
	False	Fußnoten werden nicht farbig hinterlegt angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Field-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoption für Feldfunktionen.
Syntax:	ViewSettings.Field [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Feldfunktionen angezeigt werden sollen:
	Wert	Beschreibung
	True	Feldfunktionen werden angezeigt.
	False	Feldfunktionen werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FieldName-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für farbig hinterlegte Feldfunktionen.
Syntax:	ViewSettings.FieldName [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die Feldfunktionen im Dokument farbig hinterlegt angezeigt werden sollen:
	Wert	Beschreibung
	True	Die Feldfunktionen im Dokument wird farbig hinterlegt angezeigt.
	False	Die Feldfunktionen im Dokument wird nicht farbig hinterlegt angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
CrossHair-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für Hilfslinien.
Syntax:	ViewSettings.CrossHair [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob Hilfslinien angezeigt werden sollen:
	Wert	Beschreibung
	True	Hilfslinien werden angezeigt.
	False	Hilfslinien werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Drawing-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Ansichtsoptionen für Zeichnungselemente.
Syntax	ViewSettings.Drawing [=Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die Zeichnungselemente angezeigt werden.
	Wert	Beschreibung
	True	Zeichnungselemente werden angezeigt.
	False	Zeichnungselemente werden nicht angezeigt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ViewSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DropCap-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Formatierung von Absätzen mit Initialen.
Syntax:	Selection.Paragraph.DropCap [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob ein Absatz mit einer Initiale ausgezeichnet werden soll:
	Wert	Beschreibung
	True	Absatz wird mit einer Initiale ausgezeichnet.
	False	Absatz wird nicht mit einer Initiale ausgezeichnet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph-Objekt
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
EntireColumn-Methode

Funktion:	Selektiert die Tabellenspalte, in der sich die Schreibmarke befindet.
Syntax:	Selection.Table.EntireColumn
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
EntireRow-Methode

Funktion:	Selektiert die Tabellenzeile, in der sich die Schreibmarke befindet.
Syntax:	Selection.Table.EntireRow
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Escape-Methode

Funktion:	Löst ein Escape-Ereignis aus, wodurch der aktuelle Vorgang abgebrochen wird.
Syntax:	ActiveWindow.Escape
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Escapement-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Hoch- oder Tiefstellung eines entsprechend selektierten Textes in Prozent.
Syntax:	Selection.Font.Escapement [= SubSuper%]
	Parameter	Beschreibung
	SubSuper%	Integer-Ausdruck, der die Prozentzahl aufnimmt, um die der selektierte Text hoch- oder tiefgestellt werden soll.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
RelativeSize-Eigenschaft

Funktion:	Bestimmt oder ermittelt die prozentuale Zeichengröße.
Syntax:	Selection.Font.Escapement [= RelSize%]
	Parameter	Beschreibung
	RelSize%	Integer-Ausdruck, der die Prozentzahl aufnimmt, die die Schriftgröße des selektierten Textes in Relation zur Schriftgröße in Punkt angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ExpandGlossary-Methode

Funktion:	Fügt einen Autotext-Eintrag aus dem aktuellen Autotext-Bereich in den Text ein.
Syntax:	Selection.Text.ExpandGlossary ShortName$
	Parameter	Beschreibung
	ShortName$	Zeichenfolgen-Ausdruck, der die Kurzbezeichnung des AutoText-Eintrages angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FieldCount-Methode

Funktion:	Ermittelt die im Dokument vorhandene Anzahl des angegebenen Feldbefehles.
Syntax:	ActiveWindow.FieldCount FieldType%
	Parameter	Beschreibung
	FieldType%	Ein beliebiger Integer-Ausdruck, der den Feldbefehltyp angibt, dessen Anzahl ermittelt werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FieldDialog-Methode

Funktion:	Ruft den Dialog zum Bearbeiten und Erstellen von Feldbefehlen auf.
Syntax:	Selection.Text.FieldDialog
Für Objekt:	Text

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Size-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Schriftgröße des selektierten Textes oder der Zeichen, die an der Position der Schreibmarke eingefügt werden.
Syntax:	Selection.{Font|Frame}.Size [= FoSize$]
	Eigenschaft	Beschreibung
	FoSize$	Zeichenfolgen-Ausdruck, der die Größe der Schrift und die Einheit der Schriftgröße angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Prop-Eigenschaft

Funktion:	Bestimmt oder ermittelt die relative Höhe der Schrift einer Absatzvorlage.
Syntax:	Selection.Font.Prop [= PropHeight%]
	Eigenschaft	Beschreibung
	PropHeight%	Integer-Ausdruck, der die relative Höhe der in einer Absatzvorlage verwendeten Schrift angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FootnoteDialog-Methode

Funktion:	Ruft den Fußzeilen-Dialog auf.
Syntax:	ActiveWindow.FootnoteDialog
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Lines-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Anzahl der Textzeilen, über die eine Initiale dargestellt wird.
Syntax:	Selection.DropCap.Lines [= IniLines]
	Parameter	Beschreibung
	IniLines	Numerischer Ausdruck, der die Anzahl der Textzeilen angibt, über die eine Initiale dargestellt werden soll.
Zugriff:	Lesen und Schreiben.
Für Objekt:	DropCap
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Count-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Anzahl der Zeichen eines Absatzes oder eines beliebigen Textes, die als Initiale dargestellt werden sollen.
Syntax:	Selection.DropCap.Count [= CharCount]
	Parameter	Beschreibung
	CharCount	Numerischer Ausdruck, der die Anzahl der ersten Zeichen eines Absatzes oder eines beliebigen Textes angibt, die als Initiale dargestellt werden sollen.
Zugriff:	Lesen und Schreiben.
Für Objekt:	DropCap
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Distance-Eigenschaft

Funktion:	Bestimmt oder ermittelt die den Abstand zwischen einer Initiale und dem nachfolgenden Text.
Syntax:	Selection.DropCap.Distance [= TextDistance$]
	Parameter	Beschreibung
	TextDistance$	Zeichenfolgenausdruck, der den Abstand der Initiale zum nachfolgenden Text und die Einheit aufnimmt, in der der Abstand angegeben wird.
Zugriff:	Lesen und Schreiben.
Für Objekt:	DropCap
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GetUserFieldValue-Methode

Funktion:	Gibt den Inhalt eines benutzerdefinierten Feldes zurück.
Syntax:	Selection.Text.GetUserFieldValue Name$
	Parameter	Beschreibung
	Name$	Zeichenfolgen-Ausdruck, der die Bezeichnung des benutzerdefinierten Feldes aufnimmt, dessen Inhalt übergeben werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoDown-Methode

Funktion:	Bewegt die Schreibmarke um die angegebene Anzahl an Zeilen nach unten.
Syntax:	Selection.Text.GoDown Count%, Select
	Parameter	Beschreibung
	Count%	Ein beliebiger Integer-Ausdruck, der angibt, um wieviele Zeilen die Schreibmarke nach unten bewegt werden soll.
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoLeft-Methode

Funktion:	Bewegt die Schreibmarke um die angegebene Anzahl an Zeichen nach links.
Syntax:	Selection.Text.GoLeft Count%, Select
	Parameter	Beschreibung
	Count%	Ein beliebiger Integer-Ausdruck, der angibt, wieviele Zeichen die Schreibmarke nach links bewegt werden soll.
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoRight-Methode

Funktion:	Bewegt die Schreibmarke um die angegebene Anzahl an Zeichen nach rechts.
Syntax:	Selection.Text.GoRight Count%, Select
	Parameter	Beschreibung
	Count%	Ein beliebiger Integer-Ausdruck, der angibt, wieviele Zeichen die Schreibmarke nach rechts bewegt werden soll.
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEnd-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der aktuellen Tabelle.
Syntax:	Selection.Table.GoToEnd
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfColumn-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der aktuellen Spalte.
Syntax:	Selection.Text.GoToEndOfColumn Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfDoc-Methode

Funktion:	Bewegt die Schreibmarke an das Ende des aktuellen Dokuments, respektive der aktuellen Tabelle.
Syntax:	Selection.Text.GoToEndOfDoc Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfLine-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der Zeile.
Syntax:	Selection.Text.GoToEndOfLine Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfNextColumn-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der nächsten Spalte.
Syntax:	Selection.Text.GoToEndOfNextColumn Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfNextPage-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der nächsten Seite.
Syntax:	Selection.Text.GoToEndOfNextPage Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfPage-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der Seite.
Syntax:	Selection.Text.GoToEndOfPage Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text-Objekt
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfPara-Methode

Funktion:	Bewegt die Schreibmarke an das Ende des Absatzes.
Syntax:	Selection.Text.GoToEndOfPara Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfPrevColumn-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der vorhergehenden Spalte.
Syntax:	Selection.Text.GoToEndOfPrevColumn Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToEndOfPrevPage-Methode

Funktion:	Bewegt die Schreibmarke an das Ende der vorhergehenden Seite.
Syntax:	Selection.Text.GoToEndOfPrevPage Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToNextSentence-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang des nächsten Satzes.
Syntax:	Selection.Text.GoToNextSentence Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToNextWord-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang des nächsten Wortes.
Syntax:	Selection.Text.GoToNextWord Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GotoPage-Methode

Funktion:	Bewegt die Schreibmarke zur angegebenen Seite.
Syntax:	ActiveWindow.GotoPage Page%
	Parameter	Beschreibung
	Page%	Ein beliebiger Integer-Ausdruck, der die Seitennummer der Seite angibt, zu der die Schreibmarke bewegt werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToPrevSentence-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang des vorherigen Satzes.
Syntax:	Selection.Text.GoToPrevSentence Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToPrevWord-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang des vorhergehenden Wortes.
Syntax:	Selection.Text.GoToPrevWord
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStart-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der aktuellen Tabelle.
Syntax:	Selection.Table.GoToStart
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfColumn-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der Spalte.
Syntax:	Selection.Text.GoToStartOfColumn Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfDoc-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang des aktuellen Dokuments, respektive der aktuellen Tabelle.
Syntax:	Selection.Text.GoToStartOfDoc Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfLine-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der Zeile.
Syntax:	Selection.Text.GoToStartOfLine Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfNextColumn-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der nächsten Spalte.
Syntax:	Selection.Text.GoToStartOfNextColumn Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfNextPage-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der nächsten Seite.
Syntax:	Selection.Text.GoToStartOfNextPage Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfPage-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der Seite.
Syntax:	Selection.Text.GoToStartOfPage Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfPara-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang des Absatzes.
Syntax:	Selection.Text.GoToStartOfPara Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfPrevColumn-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der vorhergehenden Spalte.
Syntax:	Selection.Text.GoToStartOfPrevColumn Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoToStartOfPrevPage-Methode

Funktion:	Bewegt die Schreibmarke an den Anfang der vorhergehenden Seite.
Syntax:	Selection.Text.GoToStartOfPrevPage Select
	Parameter	Beschreibung
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GoUp-Methode

Funktion:	Bewegt die Schreibmarke um eine bestimmte Anzahl Zeilen nach oben.
Syntax:	Selection.Text.GoUp Count%, Select
	Parameter	Beschreibung
	Count%	Ein beliebiger Integer-Ausdruck, der die Anzahl der Zeilen angibt, um die die Schreibmarke nach unten bewegt werden soll.
	Select	Ein Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll. Select können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Grow-Methode

Funktion:	Vergrößert die Schrift auf die jeweils nächstmögliche Größe.
Syntax:	Selection.Font.Grow
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Hyphenate-Methode

Funktion:	Führt die Silbentrennung für das gesamte aktuelle Dokument durch.
Syntax:	ActiveWindow.Hyphenate
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IndexEntryDialog-Methode

Funktion:	Ruft den Dialog zum Bearbeiten der Verzeichniseinträge auf.
Syntax:	Selection.Text.IndexEntryDialog
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertFile-Methode

Funktion:	Fügt an der Position der Schreibmarke ein Dokument mit dem angegebenen Textformat ein.
Syntax:	Selection.Text.InsertFile Name$, Filter$
	Parameter	Beschreibung
	Name$	Ein Zeichenfolgenausdruck, der den Pfad und den Dateinamen des einzufügenden Dokumentes angibt.
	Filter$	Ein Zeichenfolgenausdruck, über den der Textfilter angegeben werden kann, mit dem das einzufügende Dokument eingelesen werden soll. Filter$ können die folgenden Textfilter zugewiesen werden:
	Filter	Beschreibung
	Star Writer 3.0	StarWriter 3.0-Dokumente.
	MS Excel	Microsoft Excel-Tabellen.
	MS Winword 6.0	Microsoft Word-für-Windows-6.0-Dokumente.
	Lotus 1-2-3 1.0 (WIN)	Lotus 1-2-3 für Windows-Dokumente.
	Lotus 1-2-3 1.0 (DOS)	Lotus 1-2-3 für DOS-Dokumente.
	Rich Text Format	Rich-Text-Format-Dokumente.
	StarWriter DOS	StarWriter für DOS-Dokumente.
	StarWriter 2.0	StarWriter 2.0-Dokumente.
	StarWriter 1.0	StarWriter 1.0-Dokumente.
	HTML 2.0	WWW-Hypertext-Dokumente.
	Text	ASCII-Text-Dokumente.
	Text DOS	DOS-Text-Dokumente.
	Text Mac	Texte im Macintosh-Format.
	Text Unix	Texte im UNIX-Format.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Insert-Methode

Funktion:	Fügt den angegebenen Text an der Position der Schreibmarke ein.
Syntax:	Selection.Text.Insert StringName$
	Parameter	Beschreibung
	StringName$	Ein beliebiger Zeichenfolgenausdruck, der den einzufügenden Text angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertAnnotation-Methode

Funktion:	Fügt an der Position der Schreibmarke eine Notiz ein.
Syntax:	Selection.Text.InsertAnnotation Note$
	Parameter	Beschreibung
	Note$	Ein beliebiger Zeichenfolgenausdruck, der die einzufügende Notiz angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertBookmark-Methode

Funktion:	Fügt eine Textmarke an der Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertBookmark Name$
	Parameter	Beschreibung
	Name$	Ein beliebiger Zeichenfolgenausdruck, der die Bezeichnung der Textmarke aufnimmt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertColumnBreak-Methode

Funktion:	Fügt an der Position der Schreibmarke einen Spaltenumbruch ein.
Syntax:	Selection.Text.InsertColumnBreak
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertColumns-Methode

Funktion:	Fügt an der Position der Schreibmarke die angegebene Anzahl an Spalten in die Tabelle ein.
Syntax:	Selection.Table.InsertColumns Count%, After
	Parameter	Beschreibung
	Count%	Ein beliebiger Integer-Audruck, der die Anzahl der Spalten angibt, die in die Tabelle eingefügt werden sollen.
	After	Booleanscher Ausdruck, der die Position angibt, an der die Spalten eingefügt werden sollen. After können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Spalten werden hinter der Schreibmarke eingefügt.
	False	Die Spalten werden vor der Schreibmarke eingefügt.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertEnvelop-Methode

Funktion:	Fügt an der Position der Schreibmarke einen Briefumschlag ein.
Syntax:	Application.InsertEnvelop
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertFootnote-Methode

Funktion:	Fügt auf der aktuellen Seite eine Fußnote ein.
Syntax:	Selection.Text.InsertFootnote Text$
	Parameter	Beschreibung
	Text$	Ein Zeichenfolgenausdruck, der den Text der einzufügenden Fußnote aufnimmt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertFrame-Methode

Funktion:	Fügt einen Rahmen ein.
Syntax:	Selection.Text.InsertFrame AnchorType%, X, Y, Breite, Höhe
	Parameter	Beschreibung
	AnchorType%	Integer-Ausdruck, der den Ankerpunkt angibt. Die nachstehende Tabelle gibt Aufschluß über die Werte, die AnchorType% zugewiesen werden können:
	Wert	Beschreibung
	0	Setzt den Ankerpunkt an dem Absatz, auf dem sich die Schreibmarke gegenwärtig befindet.
	1	Setzt den Ankerpunkt an dem Zeichen, auf dem sich die Schreibmarke befindet.
	2	Setzt den Ankerpunkt an die aktuelle Seite.
	X	Numerischer Ausdruck, der die X-Position des Rahmens, gemessen vom Ankerpunkt, aufnimmt. X wird in der Einheit TWIPS angegeben.
	Y	Numerischer Ausdruck, der die Y-Position des Rahmens, gemessen vom Ankerpunkt, aufnimmt. Y wird in der Einheit TWIPS angegeben.
	Breite	Numerischer Ausdruck, der die Breite des Rahmens in TWIPS angibt.
	Höhe	Numerischer Ausdruck, der die Höhe des Rahmens in TWIPS angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertGlossary-Methode

Funktion:	Fügt einen Autotext-Eintrag ein.
Syntax:	Selection.Text.InsertGlossary Group$, Name$
	Parameter	Beschreibung
	Group$	Ein Zeichenfolgenausdruck, der die Gruppe angibt, der der neue Eintrag zugewiesen werden soll.
	Name$	Ein Zeichenfolgenausdruck, der den Text des Eintrages angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertGraphic-Methode

Funktion:	Importiert eine Grafik und fügt diese in das Dokument, an die Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertGraphic FileName$, FilterName$, Link
	Parameter	Beschreibung
	Filename$	Ein Zeichenfolgenausdruck, der den Dateinamen der zu importierenden Grafik angibt.
	FilterName$	Ein Zeichenfolgenausdruck, der den zum Importieren der Grafik notwendigen Grafikfilter angibt:
	Wert	Beschreibung
	BMP	Microsoft Windows-Bitmap.
	JPG	JPEG-Datei.
	DXF	AutoCad-Datei.
	Link	Ein Booleanscher Wert, der Aufschluß darüber gibt, ob die einzufügende Grafik mit dem Dokument verknüpft werden soll:
	Wert	Beschreibung
	True	Die Grafik wird mit dem Dokument verknüpft.
	False	Die Grafik wird im Dokument gespeichert.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertIndexesEntry-Methode

Funktion:	Fügt einem Verzeichnis einen neuen Eintrag hinzu.
Syntax:	Selection.Text.InsertIndexesEntry IndexType%, Entry$, Key1$, Key2$, Level%
	Parameter	Beschreibung
	IndexType%	Integer-Ausdruck, der angibt, welchem Verzeichnis ein Eintrag hinzugefügt werden soll:
	Wert	Beschreibung
	0	Fügt dem Stichwortverzeichnis einen Eintrag hinzu.
	1	Fügt dem Inhaltsverzeichnis einen Eintrag hinzu.
	2	Fügt dem Benutzerverzeichnis einen Eintrag hinzu.
	Entry$	Zeichenfolgenausdruck, der den Text des neuen Eintrages aufnimmt.
	Key1$	Zeichenfolgenausdruck, der den Oberbegriff der ersten Ebene aufnimmt, sofern ein mehrstufiges Verzeichnis verwendet wird.
	Key2$	Zeichenfolgenausdruck, der den Oberbegriff der zweiten Ebene aufnimmt, sofern ein mehrstufiges Verzeichnis verwendet wird.
	Level%	Integer-Ausdruck, der bei Verwendung eines mehrstufigen Verzeichnisses die Kapitelebene angibt, die nach rechts eingerückt dargestellt werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertIndexEntry-Methode

Funktion:	Fügt einen neuen Eintrag in ein Stichwortverzeichnis ein.
Syntax:	Selection.Text.InsertIndexEntry Key$, AltKey$, Entry$
	Parameter	Beschreibung
	Key$	Zeichenfolgenausdruck, der den Oberbegriff der ersten Ebene aufnimmt, sofern ein mehrstufiges Stichwortverzeichnis verwendet wird.
	AltKey$	Zeichenfolgenausdruck, der den Oberbegriff der zweiten Ebene aufnimmt, sofern ein mehrstufiges Stichwortverzeichnis verwendet wird.
	Entry$	Zeichenfolgenausdruck, der den Text des neuen Eintrages aufnimmt, der in das Stichwortverzeichnis eingefügt werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertIndexesIndex-Methode

Funktion:	Fügt ein Stichwortverzeichnis an der Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertIndexesIndex Createform%, Title$
	Parameter	Beschreibung
	Createform%	Dieser Integer-Ausdruck bestimmt die Zusätze, die bei der Erzeugung des Stichwortverzeichnisses zu berücksichtigen sind. Die nachstehenden möglichen Einstellungen können durch Addition der entsprechenden Werte kombiniert werden:
	Wert	Beschreibung
	1	Gleiche Einträge werden zusammengefaßt.
	2	Gleiche Einträge werden mit dem Vermerk „ff“ zusammengefaßt.
	4	Groß-/Kleinschreibung wird bei der Zusammenfassung von Einträgen berücksichtigt.
	8	Schlüsseleinträge bilden eigene Einträge.
	16	Die alphabetisch zusammengefaßten Einträge des Stichwortverzeichnisses werden durch alphabetische Zeichen getrennt.
	Title$	Zeichenfolgendausdruck, der die Bezeichnung des Stichwortverzeichnisses angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertIndexesTOC-Methode

Funktion:	Fügt ein Inhaltsverzeichnis an der Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertIndexesTOC Createform%, MaxLevel%, Title$
	Parameter	Beschreibung
	Createform%	Dieser Integer-Ausdruck gibt an, woraus das Inhaltsverzeichnis erstellt werden soll. Die folgenden Einstellungen sind möglich:
	Wert	Beschreibung
	1	Das Inhaltsverzeichnis wird aus der Gliederung des Dokumentes erzeugt.
	2	Das Inhaltsverzeichnis wird aus der aktuellen Markierung erzeugt.
	3	Das Inhaltsverzeichnis wird aus der aktuellen Markierung und aus der Gliederung des Dokumentes erzeugt.
	MaxLevel%	Ein beliebiger Integer-Ausdruck, der die maximale Anzahl der Ebenen des Inhaltsverzeichnisses angibt.
	Title$	Ein Zeichenfolgenausdruck, der die Bezeichnung des Inhaltsverzeichnisses angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertIndexesUserIndex-Methode

Funktion:	Fügt ein Benutzerverzeichnis an der Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertIndexesUserIndex Creatform%, IndexName$, MaxLevel%, Title$, Template$
	Parameter	Beschreibung
	Createform%	Dieser Integer-Ausdruck gibt an, woraus das Benutzerverzeichnis erstellt werden soll. Die folgenden Einstellungen sind möglich:
	Wert	Beschreibung
	1	Das Benutzerverzeichnis wird aus der aktuellen Markierung erzeugt.
	2	Das Benutzerverzeichnis wird aus einer Absatzvorlage erzeugt.
	4	Das Benutzerverzeichnis wird aus einem OLE-Objekt erzeugt.
	8	Das Benutzerverzeichnis wird aus einer Tabelle erzeugt.
	16	Das Benutzerverzeichnis wird aus einer Grafik erzeugt.
	IndexName$	Zeichenfolgenausdruck, der die Bezeichnung des Benutzerverzeichnisses aufnimmt, über die das Verzeichnis angesprochen werden kann.
	MaxLevel%	Ein beliebiger Integer-Ausdruck, der die maximale Anzahl der Ebenen des Benutzerverzeichnisses angibt.
	Title$	Ein Zeichenfolgenausdruck, der den Titel des Benutzerverzeichnisses angibt.
	Template$	Zeichenfolgenausdruck, der die Absatzvorlage angibt, nach deren Vorgaben das Benutzerverzeichnis erstellt werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertLabels-Methode

Funktion:	Fügt an der Position der Schreibmarke ein Etikett ein.
Syntax:	Appication.InsertLabels
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertLinebreak-Methode

Funktion:	Fügt an der Position der Schreibmarke einen Zeilenumbruch ein. Ein neuer Absatz wird dabei nicht erzeugt.
Syntax:	Selection.Text.InsertLinebreak
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertNamedTable-Methode

Funktion:	Fügt eine Tabelle an der Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertNamedTable aName$, Row%, Col%
	Parameter	Beschreibung
	aName$	Ein Zeichenfolgenausdruck, der den Namen der Tabelle aufnimmt.
	Row%	Ein beliebiger Integer-Ausdruck, der die Anzahl der Zeilen der Tabelle festlegt.
	Col%	Ein beliebiger Integer-Ausdruck, der die Anzahl der Spalten der Tabelle festlegt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertNonBreakingSpace-Methode

Funktion:	Fügt an der Position der Schreibmarke ein geschütztes Leerzeichen ein.
Syntax:	Selection.Text.InsertNonBreakingSpace
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertNumbering-Methode

Funktion:	Schaltet die Numerierung ein.
Syntax:	Selection.Text.InsertNumbering Name$
	Parameter	Beschreibung
	Name$	Zeichenfolgenausdruck, der die Bezeichnung der Numerierung aufnimmt, die verwendet werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertObject-Methode

Funktion:	Ruft den Dialog zum Einfügen von Objekten auf.
Syntax:	Selection.Text.InsertObject
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertObjectStarChart-Methode

Funktion:	Erzeugt ein StarChart-Objekt, wenn sich die Schreibmarke in einer Tabelle befindet.
Syntax:	Selection.Text.InsertObjectStarChart
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertObjectStarImage-Methode

Funktion:	Erzeugt ein StarImage Objekt.
Syntax:	Selection.Text.InsertObjectStarImage
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertObjectStarMath-Methode

Funktion:	Erzeugt ein StarMath Objekt.
Syntax:	Selection.Text.InsertObjectStarMath
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertPagebreak-Methode

Funktion:	Erzeugt an der Position der Schreibmarke einen harten Seitenumbruch.
Syntax:	Selection.Text.InsertPagebreak
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertPara-Methode

Funktion:	Fügt an der Position der Schreibmarke ein Absatzende ein und erzeugt somit einen neuen Absatz.
Syntax:	Selection.Text.InsertPara
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertRows-Methode

Funktion:	Fügt eine bestimmte Zeilenanzahl an die Position der Schreibmarke in die aktuelle Tabelle ein.
Syntax:	Selection.Table.InsertRows Count%, After
	Parameter	Beschreibung
	Count%	Ein beliebiger Integer-Audruck, der die Anzahl der einzufügenden Zeilen angibt.
	After	Ein beliebiger Booleanscher Ausdruck, der die Position angibt, an der die Spalten eingefügt werden sollen. After können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Spalten werden hinter der Schreibmarke eingefügt.
	False	Die Spalten werden vor der Schreibmarke eingefügt.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertSoftHyphen-Methode

Funktion:	Erzeugt an der Position der Schreibmarke eine weiche Silbentrennung.
Syntax:	Selection.Text.InsertSoftHyphen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertSymbol-Methode

Funktion:	Fügt entweder ein Sonderzeichen oder ein Symbol an der Position der Schreibmarke ein.
Syntax:	Selection.Text.InsertSymbol Chars$, Font$
	Parameter	Beschreibung
	Chars$	Ein Zeichenfolgenausdruck, der die Zeichen enthält, die als Sonderzeichen dargestellt werden sollen.
	Font$	Ein Zeichenfolgenausdruck, der die Bezeichnung des Zeichensatzes angibt, aus dem die Sonderzeichen entnommen werden sollen.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertTable-Methode

Funktion:	Fügt an der Position der Schreibmarke eine Tabelle ein.
Syntax:	Selection.Text.InsertTable Row%, Col%
	Parameter	Beschreibung
	Row%	Ein beliebiger Integer-Ausdruck, der die Anzahl der Zeilen der neuen Tabelle angibt.
	Col%	Ein beliebiger Integer-Ausdruck, der die Anzahl der Spalten der neuen Tabelle angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertTOCEntry-Methode

Funktion:	Weist einem Inhaltsverzeichnis einen neuen Eintrag zu.
Syntax:	Selection.Text.InsertTOCEntry Level%, Entry$
	Parameter	Beschreibung
	Level%	Beliebiger Integer-Ausdruck, der die Ebene des Inhaltsverzeichnisses angibt, sofern ein mehrstufiges Inhaltsverzeichnis verwendet wird.
	Entry$	Zeichenfolgenausdruck, der den Text des Eintrages aufnimmt, der dem Inhaltsverzeichnis zugewiesen werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertUserEntry-Methode

Funktion:	Weist einem Benutzerverzeichnis einen neuen Eintrag zu.
Syntax:	Selection.Text.InsertUserEntry IndexName$, Level%, Entry$
	Parameter	Beschreibung
	IndexName$	Zeichenfolgenausdruck, der die Bezeichnung des Benutzerverzeichnisses aufnimmt, dem ein neuer Eintrag zugewiesen werden soll.
	Level%	Beliebiger Integer-Ausdruck, der die Ebene des Benutzerverzeichnisses angibt, sofern ein mehrstufiges Inhaltsverzeichnis verwendet wird.
	Entry$	Zeichenfolgenausdruck, der den Text des Eintrages aufnimmt, der dem Benutzerverzeichnis zugewiesen werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IsEndOfDoc-Eigenschaft

Funktion:	Ermittelt, ob sich die Schreibmarke am Ende des Dokuments befindet.
Syntax:	Selection.Text.IsEndOfDoc [= DocEnd]
	Parameter	Beschreibung
	DocEnd	Booleanscher Ausdruck, der angibt, ob die Schreibmarke am Ende des Dokumentes angeordnet ist:
	Wert	Beschreibung
	True	Die Schreibmarke befindet sich am Ende des Dokumentes.
	False	Die Schreibmarke befindet sich nicht am Ende des Dokumentes.
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IsEndOfPara-Eigenschaft

Funktion:	Ermittelt, ob sich die Schreibmarke am Ende des aktuellen Absatzes befindet.
Syntax:	Selection.Text.IsEndOfPara [= ParaEnd]
	Parameter	Beschreibung
	ParaEnd	Booleanscher Ausdruck, der angibt, ob die Schreibmarke am Ende des aktuellen Absatzes angeordnet ist:
	Wert	Beschreibung
	True	Die Schreibmarke befindet sich am Ende des Absatzes.
	False	Die Schreibmarke befindet sich nicht am Ende des Absatzes.
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IsEndOfWord-Eigenschaft

Funktion:	Ermittelt, ob sich die Schreibmarke am Ende des aktuellen Wortes befindet.
Syntax:	Selection.Text.IsEndOfWord [= WordEnd]
	Parameter	Beschreibung
	DocEnd	Booleanscher Ausdruck, der angibt, ob sich die Schreibmarke am Ende des aktuellen Wortes befindet:
	Wert	Beschreibung
	True	Die Schreibmarke befindet sich am Ende des aktuellen Wortes.
	False	Die Schreibmarke befindet sich nicht am Ende des aktuellen Wortes.
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IsStartOfDoc-Eigenschaft

Funktion:	Ermittelt, ob sich die Schreibmarke am Anfang des Dokumentes befindet.
Syntax:	Selection.Text.IsStartOfDoc [= DocStart]
	Parameter	Beschreibung
	DocStart	Booleanscher Ausdruck, der angibt, ob sich die Schreibmarke am Anfang des Dokumentes befindet:
	Wert	Beschreibung
	True	Die Schreibmarke befindet sich am Anfang des Dokumentes.
	False	Die Schreibmarke befindet sich nicht am Anfang des Dokumentes.
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IsStartOfPara-Eigenschaft

Funktion:	Ermittelt, ob sich die Schreibmarke am Anfang des aktuellen Absatzes befindet.
Syntax:	Selection.Text.IsStartOfPara [= ParaStart]
	Parameter	Beschreibung
	ParaStart	Booleanscher Ausdruck, der angibt, ob sich die Schreibmarke am Anfang des aktuellen Absatzes befindet:
	Wert	Beschreibung
	True	Die Schreibmarke befindet sich am Anfang des aktuellen Absatzes.
	False	Die Schreibmarke befindet sich nicht am Anfang des aktuellen Absatzes.
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IsStartOfWord-Eigenschaft

Funktion:	Ermittelt, ob sich die Schreibmarke am Anfang des aktuellen Wortes befindet.
Syntax:	Selection.Text.IsStartOfWord [= WordStart]
	Parameter	Beschreibung
	WordStart	Booleanscher Ausdruck, der angibt, ob sich die Schreibmarke am Anfang des aktuellen Wortes befindet:
	Wert	Beschreibung
	True	Die Schreibmarke befindet sich am Anfang des aktuellen Wortes.
	False	Die Schreibmarke befindet sich nicht am Anfang des aktuellen Wortes.
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Italic-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die kursive Darstellung des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen.
Syntax:	Selection.Font.Italic [= FontSwitch]
	Parameter	Beschreibung
	FontSwitch	Booleanscher Ausdruck, der angibt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen kursiv dargestellt werden sollen:
	Wert	Beschreibung
	True	Der Text wird kursiv dargestellt.
	False	Der Text wird nicht kursiv dargestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToFooter-Methode

Funktion:	Bewegt die Schreibmarke in die Fußzeile der aktuellen Seite.
Syntax:	Selection.Text.JumpToFooter
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToFootnoteOrAnchor-Methode

Funktion:	Bewegt die Schreibmarke von einer Fußzeile zum entsprechenden Anker und umgekehrt.
Syntax:	Selection.Text.JumpToFootnoteOrAnchor
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToHeader-Methode

Funktion:	Bewegt die Schreibmarke in die Kopfzeile der aktuellen Seite.
Syntax:	Selection.Text.JumpToHeader
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToNextFootnote-Methode

Funktion:	Bewegt die Schreibmarke zur nächsten Fußzeile.
Syntax:	Selection.Text.JumpToNextFootnote
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToNextFrame-Methode

Funktion:	Bewegt die Schreibmarke zum nächsten Rahmen.
Syntax:	Selection.Text.JumpToNextFrame
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToNextSelection-Methode

Funktion:	Bewegt die Schreibmarke zur nächsten Selektion.
Syntax:	Selection.Text.JumpToNextSelektion
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToNextTable-Methode

Funktion:	Bewegt die Schreibmarke zum Anfang der nächsten Tabelle.
Syntax:	Selection.Text.JumpToNextTable
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToPrevFootnote-Methode

Funktion:	Bewegt die Schreibmarke zur vorhergehenden Fußnote.
Syntax:	Selection.Text.JumpToPrevFootnote
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToPrevSelection-Methode

Funktion:	Bewegt die Schreibmarke zur vorhergehenden Selektion.
Syntax:	Selection.Text.JumpToPrevSelection
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToPrevTable-Methode

Funktion:	Bewegt die Schreibmarke zum Anfang der vorhergehenden Tabelle.
Syntax:	Selection.Text.JumpToPrevTable
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToReference-Methode

Funktion:	Springt zur Referenz des Feldes, in dem sich die Schreibmarke befindet.
Syntax:	Selection.Text.JumpToReference
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Language-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Sprache, die für die Schriftart des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen verwendet werden soll.
Syntax:	Selection.Font.Language [= Sprache]
	Parameter	Beschreibung
	Sprache	Numerischer Ausdruck, der die Sprache angibt, die über die Language-Eigenschaft bestimmt oder ermittelt werden soll. Nachstehend finden Sie die wesentlichen Einstellungen aufgeführt:
	Einstellung	Beschreibung
	0x041C	LANGUAGE_ALBANIAN
	0x0401	LANGUAGE_ARABIC
	0x0402	LANGUAGE_BULGARIEN
	0x0004	LANGUAGE_CHINESE
	0x041A	LANGUAGE_CROATIAN
	0x0405	LANGUAGE_CZECH
	0x0406	LANGUAGE_DANISH
	0x0413	LANGUAGE_DUTCH
	0x0009	LANGUAGE_ENGLISH
	0x040B	LANGUAGE_FINNISH
	0x040C	LANGUAGE_FRENCH
	0x0407	LANGUAGE_GERMAN
	0x0408	LANGUAGE_GREEK
	0x040D	LANGUAGE_HEBREW
	0x040E	LANGUAGE_HUNGARIAN
	0x0421	LANGUAGE_INDONESIAN
	0x0410	LANGUAGE_ITALIAN
	0x0411	LANGUAGE_JAPAN
	0x0412	LANGUAGE_KOREAN
	0x0014	LANGUAGE_NORWEGIAN
	0x0415	LANGUAGE_POLISH
	0x0816	LANGUAGE_PORTUGUESE
	0x0419	LANGUAGE_RUSSIAN
	0x041B	LANGUAGE_SLOVAK
	0x0424	LANGUAGE_SLOVENIAN
	0x042E	LANGUAGE_SORBIAN
	0x040A	LANGUAGE_SPANISH
	0x041D	LANGUAGE_SWEDISH
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LineColor-Eigenschaft

Funktion:	Ändert die Farbe der Linien des selektierten Rahmens.
Syntax:	Selection.Frame.LineColor
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LineColor-Eigenschaft

Funktion:	Ändert die Farbe der Linien der selektierten Tabelle.
Syntax:	Selection.Table.LineColor
Zugriff:	Lesen und Schreiben.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LineHeight-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Wert des Mindestzeilenabstandes im aktuellen Absatz, angegeben in TWIPS.
Syntax:	Selection.Paragraph.LineHeight [= LineDist]
	Parameter	Beschreibung
	LineDist	Numerischer Ausdruck, der den Mindestzeilenabstand des aktuellen Absatzes in TWIPS angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PropLineHeight-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Wert des Zeilenabstandes im aktuellen Absatz, angegeben in Prozent.
Syntax:	Selection.Paragraph.PropLineHeight [= Percent]
	Parameter	Beschreibung
	Percent	Numerischer Ausdruck, der den zur Zeilenhöhe prozentualen Zeilenabstand des aktuellen Absatzes in Prozent angibt.
Erläuterung:	Der zur Zeilenhöhe prozentuale Zeilenabstand muß gesetzt werden, wenn dem aktuellen Absatz ein 1,5-zeiliger, ein 2-zeiliger oder ein proportionaler Zeilenabstand zugewiesen wird.
Beispiel:	Die folgenden Beispiele erläutern, welche Werte der PropLineHeight-Eigenschaft für die unterschiedlichen Zeilenabstände zugewiesen werden:
	Zeilenabstand	Wert
	1,5-zeilig	PropLineHeight = 150 (150% der Zeilenhöhe).
	2-zeilig	PropLineHeight = 200 (200% der Zeilenhöhe).
	Proportional	Prozentzahl des zur Zeilenhöhe prozentualen Zeilenabstandes. Soll der Zeilenabstand beispielsweise 80% der Zeilenhöhe betragen, muß der PropLineHeight-Eigenschaft der Wert 80 zugewiesen werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InterLineSpace-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Zeilenabstand, der im aktuellen Absatz verwendet werden soll.
Syntax:	Selection.Paragraph.InterLineSpace [= DistType]
	Parameter	Beschreibung
	DistType	Numerischer Ausdruck, der Aufschluß darüber gibt, welcher Zeilenabstand im aktuellen Absatz verwendet werden soll. Die folgenden Einstellungen könnnen Abstand zugewiesen werden:
	Einstellung	Beschreibung
	0	In dem aktuellen Absatz wird ein einzeiliger Zeilenabstand oder ein Mindestzeilenabstand verwendet. Der Wert für den Mindestzeilenabstand wird mit der LineHeight-Eigenschaft bestimmt.
	1	In dem aktuellen Absatz wird ein proportionaler, 1,5-zeiliger oder 2-zeiliger Zeilenabstand verwendet. Die Prozentzahl des zur Zeilenhöhe prozentualen Zeilenabstandes wird mit der PropLineHeight-Eigenschaft festgesetzt.
	2	In dem aktuellen Absatz wird ein Durchschuß verwendet, also ein zusätzlicher Abstand zum Zeilenabstand. Der zusätzliche Abstand wird über die Eigenschaft InterSpace festgesetzt und in TWIPS angegeben.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InterSpace-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Wert eines Durchschusses, also eines zusätzlichen Abstands zum bereits bestehenden Zeilenabstand.
Syntax:	Selection.Paragraph.InterSpace [= AddDist]
	Parameter	Beschreibung
	AddDist	Numerischer Ausdruck, der den Durchschuß in TWIPS angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LineSpace-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Zeilenhöhe im aktuellen Absatz.
Syntax:	Selection.Paragraph.InterSpace [= AddDist]
	Parameter	Beschreibung
	AddDist	Numerischer Ausdruck, der die Zeilenhöhe des aktuellen Absatzes angibt:
	Wert	Beschreibung
	0	Automatische Zuweisung der Zeilenhöhe. Die Zeilenhöhe entspricht der Zeichenhöhe der größten Schriftart im Absatz.
	1	Mindestzeilenhöhe.
	2	Größtmögliche Zeilenhöhe.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LinkDialog-Methode

Funktion:	Ruft den Dialog auf, mit dem die Einstellungen für Verknüpfungen bestimmt werden.
Syntax:	ActiveWindow.LinkDialog
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LoadStyles-Methode

Funktion:	Lädt eine Vorlage und übernimmt diese in das aktuelle Dokument.
Syntax:	LoadStyles File$, Select%
	Parameter	Beschreibung
	File$	Ein Zeichenfolgenausdruck, der das Dokument angibt, aus der die Vorlage geladen werden soll.
	Select%	Integer-Ausdruck, der angibt, welche Vorlage übernommen werden soll:
	Wert	Beschreibung
	1	Textvorlage
	2	Rahmenvorlage
	4	Seitenvorlage
Für Objekt:	Document

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LogicalPageNumber-Eigenschaft

Funktion:	Liefert die logische Seitennumer des aktuellen Dokuments.
Syntax:	Selection.Text.LogicalPageNumber
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MacroDialog-Methode

Funktion:	Ruft den Dialog zum Bearbeiten von Makros auf.
Syntax:	Application.MacroDialog
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Mail-Methode

Funktion:	Verschickt das aktuelle Dokument über das Mailsystem als Nachricht.
Syntax:	Application.Mail
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MergeCells-Methode

Funktion:	Verbindet die selektierten Tabellenzellen zu einer Zelle.
Syntax:	Selection.Table.MergeCells
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
NavigatorDialog-Methode

Funktion:	Ruft den Navigator auf.
Syntax:	Application.Navigator Switch
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der bestimmt, ob der Navigator eingeblendet wird. Switch können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Navigator wird eingeblendet.
	False	Der Navigator wird nicht eingeblendet.
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
NewField-Methode

Funktion:	Fügt an der Position der Schreibmarke ein neues Feld ein.
Syntax:	Selection.Text.NewField Name$
	Parameter	Beschreibung
	Name$	Ein Zeichenfolgenausdruck, der den Namen des neuen Feldes angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
NewGlossary-Methode

Funktion:	Fügt einer Autotext-Gruppe einen neuen Autotext-Eintrag hinzu.
Syntax:	Selection.Text.NewGlossary Group$, Name$, ShortName$
	Parameter	Beschreibung
	Group$	Ein Zeichenfolgenausdruck, der angibt, welcher Gruppe der neue Eintrag hinzugefügt werden soll.
	Name$	Ein Zeichenfolgenausdruck, der den Text des Eintrages angibt.
	ShortName$	Ein Zeichenfolgenausdruck, der die Kurzbezeichnung des Eintrages angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
NumberOfPages-Eigenschaft

Funktion:	Ermittelt die Anzahl aller Seiten des aktuellen Dokuments.
Syntax:	Selection.Text.NumberOfPages
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
OpenDatabaseConnection-Methode

Funktion:	Öffnet eine mit der AddDatabaseConnection-Methode initialisierte Datenbank.
Syntax:	ActiveWindow.OpenDatabaseConnection DBName$
	Parameter	Beschreibung
	DBName$	Ein Zeichenfolgenausdruck, der die Bezeichnung der Datenbank angibt, die geöffnet werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
OptionDialog-Methode

Funktion:	Öffnet den Dialog für die allgemeinen Optionen.
Syntax:	Application.OptionDialog
Für Objekt:	Application
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Orphan-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Verwendung der Hurenkindregelung.
Syntax:	Selection.Paragraph.Orphan [= Switch]
	Wert	Beschreibung
	True	Die Hurenkindregelung wird verwendet.
	False	Die Hurenkindregelung wird nicht verwendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
OutlineFont-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Darstellung des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen als Konturschrift.
Syntax:	Selection.Font.OutlineFont [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen als Konturschrift dargestellt werden sollen:
	Wert	Beschreibung
	True	Die Konturschrift wird eingeschaltet.
	False	Die Konturschrift wird ausgeschaltet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Break-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellungen für den Seitenumbruch.
Syntax:	Selection.Paragraph.Break [= Setting]
	Parameter	Beschreibung
	Setting	Numerischer Ausdruck, der angibt, wie der Seitenumbruch erfolgen soll:
	Einstellung	Beschreibung
	0	Kein Seitenumbruch.
	1	Seitenumbruch vor einer neuen Spalte.
	2	Seitenumbruch nach einer neuen Spalte.
	3	Seitenumbruch vor und nach einer neuen Spalte.
	4	Seitenumbruch vor einer neuen Seite.
	5	Seitenumbruch nach einer neuen Seite.
	6	Seitenumbruch vor und nach einer neuen Seite.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageDown-Methode

Funktion:	Bewegt die Schreibmarke um eine Seite nach unten.
Syntax:	ActiveWindow.PageDown Select
	Parameter	Beschreibung
	Select	Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageNumber-Eigenschaft

Funktion:	Ermittelt die Anzahl der Seiten des aktuellen Dokuments.
Syntax:	Selection.Text.PageNumber
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageStyle-Eigenschaft

Funktion:	Führt einen Seitenumbruch durch und weist der dem Umbruch nachfolgenden Seite eine bestimmte Seitenvorlage zu.
Syntax:	Selection.Paragraph.PageStyle [= Templ$]
	Parameter	Beschreibung
	Templ$	Zeichenfolgenausdruck, der die Bezeichnung der Seitenvorlage angibt, die der dem Umbruch nachfolgenden Seite zugewiesen werden soll.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageUp-Methode

Funktion:	Bewegt die Schreibmarke um eine Seite nach oben. Select bestimmt, ob der Text, über den sich der Cursor bewegt, markiert wird.
Syntax:	ActiveWindow.PageUp Select
	Parameter	Beschreibung
	Select	Booleanscher Ausdruck, der angibt, ob die Textstelle, über die sich die Schreibmarke bewegt, markiert werden soll:
	Wert	Beschreibung
	True	Der Text wird markiert.
	False	Der Text wird nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ParagraphDialog-Methode

Funktion:	Ruft den FORMATABSATZ-Dialog auf. Der zuvor selektierte Text wird nach Auswahl der neuen Einstellungen formatiert.
Syntax:	Selection.Paragraph.ParagraphDialog
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ParaKeepTogether-Eigenschaft

Funktion:	Verhindert einen Seitenumbruch zwischen zwei Absätzen.
Syntax:	Selection.Paragraph.ParaKeepTogether
	Einstellung	Beschreibung
	True	Verhindert einen Seitenumbruch zwischen zwei Absätzen.
	False	Ein Seitenumbruch zwischen zwei Absätzen ist zulässig.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ParaSplit-Eigenschaft

Funktion:	Verhindert einen Seitenumbruch innerhalb eines Absatzes. Sollte ein am Ende einer Seite angeordneter Absatz nicht vollständig auf dieser Seite angeordnet werden können, wird er vollständig auf die nächste Seite umgebrochen. Absätze, die länger als die gesamte Seite sind, werden umgebrochen.
Syntax:	Selection.Paragraph.Parasplit [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob ein Seitenumbruch innerhalb eines Absatzes verhindert werden soll:
	Wert	Beschreibung
	True	Verhindert einen Seitenumbruch innerhalb eines Absatzes.
	False	Ein Seitenumbruch innerhalb eines Absatzes ist zulässig.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ParaStyleApply-Methode

Funktion:	Weist dem aktuellen Absatz eine neue Absatzvorlage zu.
Syntax:	Selection.Paragraph.ParaStyleApply Style$
	Parameter	Beschreibung
	Style$	Zeichenfolge, die die Bezeichnung der Absatzvorlage angibt.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Print-Methode

Funktion:	Ruft den Dialog zum Drucken des aktuellen Dokumentes auf.
Syntax:	ActiveWindow.Print
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintDefault-Methode

Funktion:	Druckt das aktuelle Dokument mit den Standard-Einstellungen. Ein Druck-Dialog erscheint nicht.
Syntax:	ActiveWindow.PrintDefault
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintGraphic-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den Ausdruck von Grafiken.
Syntax:	PrintSettings.PrintGraphic [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob Grafiken im Ausdruck erscheinen sollen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Grafiken werden ausgedruckt.
	False	Grafiken werden nicht ausgedruckt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintTable-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoption für den Ausdruck von Tabellen.
Syntax:	PrintSettings.PrintTable [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob Tabellen im Ausdruck erscheinen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Tabellen werden ausgedruckt.
	False	Tabellen werden nicht ausgedruckt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintDrawing-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den Ausdruck von Zeichnungen.
Syntax:	PrintSettings.PrintDrawing [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob im Ausdruck Zeichnungen erscheinen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Zeichnungen werden ausgedruckt.
	False	Zeichnungen werden nicht ausgedruckt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintLeftPage-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den ausschließlichen Ausdruck von linken Seiten.
Syntax:	PrintSettings.PrintLeftPage [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob lediglich alle linken Seiten des Dokumentes ausgedruckt werden sollen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Es werden nur die linken Seiten des Dokumentes ausgedruckt.
	False	Es werden alle Seiten ausgedruckt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintRightPage-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den ausschließlichen Ausdruck von rechten Seiten.
Syntax:	PrintSettings.PrintRightPage [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob lediglich alle rechten Seiten des Dokumentes gedruckt werden sollen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Es werden nur die rechten Seiten des Dokumentes ausgedruckt.
	False	Es werden alle Seiten ausgedruckt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintReverse-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den umgekehrten Ausdruck.
Syntax:	PrintSettings.PrintReverse [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob die Seiten des Dokumentes in umgekehrter Reihenfolge gedruckt werden sollen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Ausdruck beginnt mit der letzten Seite und endet mit der ersten Seite des Dokumentes.
	False	Der Ausdruck beginnt mit der ersten Seite und endet mit der letzten Seite des Dokumentes.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
NotFoundWarning-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für die Ausgabe der Warnung, die bei der Verwendung eines unzulässigen Druckers angezeigt wird.
Syntax:	PrintSettings.NotFoundWarning [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob die Warnung „Dokumentdrucker nicht gefunden“ ausgegeben werden soll, sofern der benötigte Drucker nicht auf dem aktuellen Rechner installiert ist. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Warnung „Dokumentdrucker nicht gefunden“ wird ausgegeben, wenn der benötigte Drucker nicht auf dem aktuellen Rechner installiert ist.
	False	Die Warnung „Dokumentdrucker nicht gefunden“ wird nie ausgegeben.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PaperSizeWarning-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für die Ausgabe der Warnung, die bei der Verwendung einer unzulässigen Papiergröße angezeigt wird.
Syntax:	PrintSettings.PaperSizeWarning [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob eine Warnung ausgegeben werden soll, sofern der verwendete Drucker die verlangte Papiergröße nicht bearbeiten kann. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Warnung wird ausgegeben, wenn der verwendete Drucker die verlangte Papiergröße nicht bearbeiten kann.
	False	Die Warnung wird nie ausgegeben.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PaperBinWarning-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für die Ausgabe der Warnung, die bei der Verwendung einer unzulässigen Papierorientierung angezeigt wird.
Syntax:	PrintSettings.PaperBinWarning [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob eine Warnung ausgegeben werden soll, sofern der verwendete Drucker die verlangte Papierorientierung nicht bearbeiten kann. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Warnung wird ausgegeben, wenn der verwendete Drucker die verlangte Papierorientierung nicht bearbeiten kann.
	False	Die Warnung wird nie ausgegeben.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintControl-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den Ausdruck von Kontrollfeldern.
Syntax:	PrintSettings.PrintControl [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob Kontrollfelder im Ausdruck erscheinen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Kontrollfelder werden ausgedruckt.
	False	Statt der Kontrollfelder werden leere Rahmen gedruckt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FaxName-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Treiber für das Versenden von Fax-Nachrichten.
Syntax:	PrintSettings.FaxName [= Name$]
	Parameter	Beschreibung
	Name$	Zeichenfolgenausdruck, der die Bezeichnung des Treibers für das Versenden von Fax-Nachrichten angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintAnnotations-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckoptionen für den Ausdruck von Notizen.
Syntax:	PrintSettings.PrintAnnotations [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob Notizen im Ausdruck erscheinen. Bool können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Im Ausdruck erscheinen nur die im Dokument vorhandenen Notizen.
	False	Im Ausdruck erscheinen keine Notizen.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Refresh-Methode

Funktion:	Berrechnet das Seitenlayout neu und zeigt anschließend die aktualisierte Darstellung.
Syntax:	ActiveWindow.Refresh
Für Objekt:	ActiveWindow, ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
RepeatSearch-Methode

Funktion:	Setzt die Suche nach dem zuletzt gesuchten Ausdruck fort.
Syntax:	ActiveWindow.RepeatSearch
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Replace-Methode

Funktion:	Sucht und ersetzt eine Zeichenfolge. Vor jeder Ersetzung erfolgt eine Abfrage.
Syntax:	ActiveWindow.Replace SearchString$, ReplaceString$
	Parameter	Beschreibung
	SearchString$	Ein Zeichenfolgenausdruck, der den zu ersetzenden Text aufnimmt.
	ReplaceString$	Ein Zeichenfolgenausdruck, der angibt, durch welchen Text der zu ersetzende Text ersetzt werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ReplaceAll-Methode

Funktion:	Sucht und ersetzt alle gefundenen Zeichenfolgen mit einer anderen Zeichenfolge. Es findet keine Abfrage statt.
Syntax:	ActiveWindow.ReplaceAll SearchString$, ReplaceString$
	Parameter	Beschreibung
	SearchString$	Ein Zeichenfolgenausdruck, der den zu ersetzenden Text aufnimmt.
	ReplaceString$	Ein Zeichenfolgenausdruck, der angibt, durch welchen Text der zu ersetzende Text ersetzt werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ResetAttributes-Methode

Funktion:	Entfernt alle harten Textattribute des selektierten Textes.
Syntax:	Selection.Text.ResetAttributes
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Search-Methode

Funktion:	Sucht an der Position der Schreibmarke nach einem bestimmten Text.
Syntax:	ActiveWindow.Search SearchString$
	Parameter	Beschreibung
	SearchString$	Ein Zeichenfolgenausdruck, der den Text aufnimmt, der gesucht werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SearchAll-Methode

Funktion:	Sucht  im gesamten Dokument nach einem bestimmten Text.
Syntax:	ActiveWindow.SearchAll SearchString$
	Parameter	Beschreibung
	SearchString$	Ein Zeichenfolgenausdruck, der den Text aufnimmt, der gesucht werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SelectAll-Methode

Funktion:	Markiert das gesamte Dokument.
Syntax:	Selection.Text.SelectAll
Zugriff:	Lesen und Schreiben.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SelectionCount-Eigenschaft

Funktion:	Ermittelt die Anzahl der Markierungen im gesamten Dokument.
Syntax:	Selection.Text.SelctionCount
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SelectWord-Methode

Funktion:	Selektiert das Wort, über dem sich die Schreibmarke derzeit befindet.
Syntax:	Selection.Text.SelectWord
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SendFax-Methode

Funktion:	Druckt das aktuelle Dokument an das Standard-Fax-Gerät.
Syntax:	ActiveWindow.SendFax
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SetActGlossaryGroup-Methode

Funktion:	Fügt eine Autotext-Gruppe ein.
Syntax:	Selection.Text.SetActGlossaryGroup Group$
	Parameter	Beschreibung
	Group$	Ein Zeichenfolgenausdruck, der die einzufügende Gruppe angibt.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Hyphen-Eigenschaft

Funktion:	Ermittelt oder bestimmt, ob die Silbentrennung ein- oder ausgeschaltet werden soll.
Syntax:	Hyphenzone.Hyphen [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob die Silbentrennung ein- oder ausgeschaltet werden soll.
	Wert	Beschreibung
	True	Die Silbentrennung wird eingeschaltet.
	False	Die Silbentrennung wird ausgeschaltet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	HyphenZone
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageEnd-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob die Silbentrennung eines Wortes über zwei Seiten erfolgen darf.
Syntax:	Hyphenzone.PageEnd [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob die Silbentrennung eines Wortes über zwei Seiten erfolgen darf:
	Wert	Beschreibung
	True	Die Silbentrennung darf über zwei Seiten erfolgen.
	False	Die Silbentrennung darf nicht über zwei Seiten erfolgen.
Zugriff:	Lesen und Schreiben.
Für Objekt:	HyphenZone
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MinLead-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Mindestanzahl der Zeichen, die einem Trennstrich voranstehen müssen.
Syntax:	Hyphenzone.MinLead [= Zeichen]
	Parameter	Beschreibung
	Zeichen	Numerischer Ausdruck, der die Mindestanzahl der Zeichen angibt, die vor einem Trennstrich angeordnet sein müssen.
Zugriff:	Lesen und Schreiben.
Für Objekt:	HyphenZone
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MinTrails-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Mindestanzahl der Zeichen, die einem Trennstrich folgen muß.
Syntax:	Hyphenzone.Trails [= Zeichen]
	Parameter	Beschreibung
	Zeichen	Numerischer Ausdruck, der die Mindestanzahl der Zeichen angibt, die einem Trennstrich folgen muß.
Zugriff:	Lesen und Schreiben.
Für Objekt:	HyphenZone
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MaxHyphens-Eigenschaft

Funktion:	Bestimmt oder ermittelt die maximale Anzahl aufeinanderfolgender Silbentrennungen.
Syntax:	Hyphenzone.MaxHyphens [= Zeichen]
	Parameter	Beschreibung
	Zeichen	Numerischer Ausdruck, der die maximale Anzahl aufeinanderfolgender Silbentrennungen angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	HyphenZone
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SetRowHeight-Methode

Funktion:	Setzt die Höhe der aktuellen Tabellenzeile.
Syntax:	Selection.Table.SetRowHeight Height&
	Parameter	Beschreibung
	Height&	Long-Integer-Audruck, der die neue Höhe der aktuellen Zeile in TWIPS angibt.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SetUserFieldValue-Methode

Funktion:	Bestimmt einen neuen Wert für ein benutzerdefiniertes Feld.
Syntax:	Selection.Text.SetUserFieldValue Name$, Value$
	Parameter	Beschreibung
	Name$	Ein Zeichenfolgenausdruck, der den Namen des benutzerdefinierten Feldes angibt.
	Value$	Ein Zeichenfolgenausdruck, der den neuen Feldwert enthält.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow-Eigenschaft

Funktion:	Schaltet schattierte Schrift ein oder aus.
Syntax:	Selection.Font.Shadow
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ShowFourPages-Methode

Funktion:	Zeigt in der Seitenvorschau vier Seiten gleichzeitig an.
Syntax:	ActiveWindow.ShowFourPages
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ShowTwoPages-Methode

Funktion:	Zeigt in der Seitenvorschau zwei Seiten gleichzeitig an.
Syntax:	ActiveWindow.ShowTwoPages
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shrink-Methode

Funktion:	Verringert die aktuelle Schriftgröße auf die jeweils nächstmögliche Größe.
Syntax:	Selection.Font.Shrink
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Sort-Methode

Funktion:	Sortiert den selektierten Bereich.
Syntax:	Selection.Text.Sort Order%, Direction%, Delimiter%, Col1%, Typ1%, Col2%, Typ2%, Col3%, Typ3%
	Parameter	Beschreibung
	Order%	Integer-Ausdruck, der die Sortierreihenfolge festlegt. Order% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Aufsteigende Sortierreihenfolge.
	1	Absteigende Sortierreihenfolge.
	Direction%	Integer-Ausdruck, der die Sortierrichtung innerhalb einer Tabelle angibt:
	Wert	Beschreibung
	0	Sortiert die Spalten einer Tabelle.
	1	Sortiert die Zeilen einer Tabelle.
	Delimiter%	Integer-Ausdruck, der das Trennzeichen zum Sortieren von Absätzen bestimmt:
	Wert	Beschreibung
	0	Der Tabulator wird als Trennzeichen verwendet.
	1	Ein selbstdefiniertes Zeichen wird als Trennzeichen verwendet.
	Col1%	Integer-Ausdruck, der die Spalte des ersten Sortierschlüssels angibt, nach dem die Tabelle sortiert werden soll.
	Typ1%	Integer-Ausdruck, der den Sortiertyp des ersten Sortierschlüssels angibt, nach dem die Tabelle sortiert werden soll.
	Wert	Beschreibung
	0	Alphanumerische Sortierung.
	1	Numerische Sortierung.
	Col2%	Integer-Ausdruck, der die Spalte des zweiten Sortierschlüssels angibt, nach dem die Tabelle sortiert werden soll.
	Typ2%	Integer-Ausdruck, der den Sortiertyp des zweiten Sortierschlüssels angibt, nach dem die Tabelle sortiert werden soll.
	Wert	Beschreibung
	0	Alphanumerische Sortierung.
	1	Numerische Sortierung.
	Col3%	Integer-Ausdruck, der die Spalte des dritten Sortierschlüssels angibt, nach dem die Tabelle sortiert werden soll.
	Typ3%	Integer-Ausdruck, der den Sortiertyp des dritten Sortierschlüssels angibt, nach dem die Tabelle sortiert werden soll.
	Wert	Beschreibung
	0	Alphanumerische Sortierung.
	1	Numerische Sortierung.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SortDialog-Methode

Funktion:	Ruft den Sortieren-Dialog auf. Die Sortierung bezieht sich auf den selektierten Bereich.
Syntax:	Selection.Text.SortDialog
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Spacing-Eigenschaft

Funktion:	Stellt die Laufweite des aktuellen Fonts ein.
Syntax:	Selection.Font.Spacing [= Laufweite]
	Parameter	Beschreibung
	Laufweite	Numerischer Ausdruck, der die Laufweite in TWIPS angibt. Ein positiver Wert vergrößert den Buchstabenabstand, ein negativer Wert verkleinert diesen.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Spelling-Methode

Funktion:	Führt eine Rechtschreibkontrolle für das gesamte aktuelle Dokument durch.
Syntax:	ActiveWindow.Spelling
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SplitCell-Methode

Funktion:	Unterteilt die selektierte Zelle in mehrere Zellen.
Syntax:	Selection.Table.SplitCell eDir, Count%
	Parameter	Beschreibung
	eDir	Ein beliebiger Booleanscher Ausdruck, der angibt, in welche Richtung die Zelle geteilt werden soll:
	Wert	Beschreibung
	True	Die Zelle wird senkrecht geteilt.
	False	Die Zelle wird waagerecht geteilt.
	Count%	Anzahl der neuen Spalten.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
StartAutoCorrect-Methode

Funktion:	Startet die automatische Korrektur des aktuellen Dokuments.
Syntax:	Selection.Text.StartAutoCorrect
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Strikethrough-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen unterstrichen dargestellt werden sollen.
Syntax:	Selection.Font.Strikethrough [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen unterstrichen dargestellt werden sollen:
	Wert	Beschreibung
	True	Der Text wird unterstrichen dargestellt.
	False	Der Text wird nicht unterstrichen dargestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SubScript-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen tiefergestellt werden sollen.
Syntax:	Selection.Font.SubScript [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen tiefergestellt werden sollen:
	Wert	Beschreibung
	True	Der Text wird tiefergestellt.
	False	Der Text wird nicht tiefergestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SuperScript-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen hochgestellt werden sollen.
Syntax:	Selection.Font.SubScript [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob der selektierte Text oder die an der Schreibmarke einzufügenden Zeichen hochgestellt werden sollen:
	Wert	Beschreibung
	True	Der Text wird hochgestellt.
	False	Der Text wird nicht hochgestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ThesaurusDialog-Methode

Funktion:	Ruft den Thesaurus-Dialog auf, der für das selektierte Wort ein Synonom sucht.
Syntax:	ActiveWindow.ThesaurusDialog
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Underline-Eigenschaft

Funktion:	Schaltet das Unterstreichen der selektierten Schrift ein oder aus.
Syntax:	Selection.Font.Underline [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die selektierte Schrift unterstrichen dargestellt werden soll:
	Wert	Beschreibung
	True	Der Text wird unterstrichen dargestellt.
	False	Der Text wird nicht unterstrichen dargestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Value-Eigenschaft

Funktion:	Ermittelt den Inhalt der aktuellen Selektion.
Syntax:	Selection.Text.Value
Zugriff:	Nur Lesen
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Widow-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Optionen für die Verwendung der Schusterjungenregelung.
Syntax:	Selection.Paragraph.Widow [= Switch]
	Wert	Beschreibung
	True	Die Schusterjungenregelung wird verwendet.
	False	Die Schusterjungenregelung wird nicht verwendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
WordMode-Eigenschaft

Funktion:	Schaltet das wortweise Unterstreichen ein.
Syntax:	Selection.Font.WordMode
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PaperFromSetup-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Druckereinstellung für den Papierschacht.
Syntax:	PrintSettings.PaperFromSetup [= PaperSource]
	Parameter	Beschreibung
	PaperSource	Booleanscher Ausdruck, der angibt, ob der im Druckertreiber vermerkte Papierschacht verwendet werden soll. PaperSource können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der im Druckertreiber vermerkte Papierschacht wird verwendet.
	False	Der im Druckertreiber vermerkte Papierschacht wird nicht verwendet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	PrintSettings
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertField-Methode

Funktion:	Fügt an der aktuellen Position der Schreibmarke ein Feld ein.
Syntax:	Selection.Text.InsertField Type%, SubType%, Name$, Content$, Format%
	Parameter	Beschreibung
	Type%	Integer-Ausdruck, der angibt, welches Feld eingefügt werden soll. Sollen Dokumentinfo-Felder eingefügt werden, werden diese mit SubType% angegeben. Type% bestimmt in diesem Fall lediglich den Feldbereich, also Dokumentinfo. Die folgenden Felder stehen zur Auswahl:
	Wert	Beschreibung
	30	Absender.
	7	Autor.
	27	Bedingter Text.
	25	Beliebiger Datensatz.
	20	Benutzerdefiniertes Feld.
	2	Dateiname.
	3	Datenbankname.
	26	Datensatznummer.
	0	Datum.
	14	DDE-Feld.
	18	Dokumentinfo-Bereich. (Die einzufügenden Felder werden mit SubType% übergeben).
	22	Dokumentvorlage.
	16	Eingabefeld.
	10	Formel einfügen.
	37	Internetfeld.
	4	Kapitel.
	17	Leerer Absatz.
	15	Makro ausführen.
	28	Nächste Seite.
	24	Nächster Datensatz.
	23	Nummernkreis.
	13	Referenz einfügen.
	12	Referenz setzen.
	5	Seitennummer.
	36	Seitenvariable anzeigen.
	35	Seitenvariable setzen.
	19	Serienbrieffeld.
	6	Statistik.
	1	Uhrzeit.
	9	Variable anzeigen.
	8	Variable setzen.
	11	Versteckter Text.
	29	Vorherige Seite.
	SubType%	Integer-Ausdruck, der das einzufügende Feld spezifiziert. SubType% bestimmt vorwiegend eine der in dem Listenfeld AUSWAHL des FELDBEFEHL-Dialoges aufgeführten Funktionen oder Darstellungen des aktuellen Feldes in der Reihenfolge ihrer Anordnung, wobei der Wert 0 den ersten Eintrag bezeichnet. Überdies spezifiziert SubType% auch die Felder des mit Type% übergebenen Dokumentinfo-Bereiches, die über die folgenden Werte bestimmt werden können:
	Wert	Beschreibung
	0	Dokumentinfo-Feld Titel. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	1	Dokumentinfo-Feld Thema. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	2	Dokumentinfo-Feld Schlüsselwörter. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	3	Dokumentinfo-Feld Beschreibung. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	4	Dokumentinfo-Feld Info 0. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	5	Dokumentinfo-Feld Info 1. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	6	Dokumentinfo-Feld Info 2. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	7	Dokumentinfo-Feld Info 3. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	8	Dokumentinfo-Feld Erzeugung. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	9	Dokumentinfo-Feld Änderung. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	10	Dokumentinfo-Feld Letzter Druck. (Type% wurde mit dem Wert 18 für den Bereich Dokumentinfo übergeben.)
	Name$	Zeichenfolgenausdruck, der die Bezeichnung eines benutzerdefiniertes Feldes oder die Bedingung eines Funktionsfeldes aufnimmt.
	Content$	Zeichenfolgenausdruck, der die vom Feldtyp abhängigen Feldinhalte oder Feldwerte aufnimmt.
	Format%	Integer-Ausdruck, der die gewünschte Darstellungsform des aktuellen Feldtyps angibt. Format% bestimmt eine der in dem Listenfeld FORMAT des Feldbefehl-Dialoges aufgeführten Darstellungsformen des aktuellen Feldes in der Reihenfolge ihrer Anordnung, wobei der Wert 0 den ersten Eintrag bezeichnet.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IndexMarkToIndex-Methode

Funktion:	Springt von dem Verzeichniseintrag, auf dem sich die Schreibmarke in dem entsprechenden Verzeichnis befindet, zu dem Textabschnitt, der auf diesen Eintrag verweist.
Syntax:	Selection.Text.IndexMarkToIndex
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SelectionMode-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Selektionsmodus.
Syntax:	ActiveWindow.SelectionMode [= SelMode%]
	Parameter	Beschreibung
	SelMode%	Integer-Ausdruck, der den Selektionsmodus angibt:
	Wert	Beschreibung
	0	Normaler Selektionsmodus. Nur eine Markierung ist möglich.
	1	Erweiterter Selektionsmodus. Ermöglicht das Markieren ganzer Blöcke, von der aktuellen Position der Schreibmarke bis zu ihrer neuen Position.
	2	Ergänzender Selektionsmodus. Mehrere voneinander unabhängige Markierungen sind möglich.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IdentFirstLine-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Einzug der ersten Zeile des selektierten Absatzes.
Syntax:	Selection.Paragraph.IdentFirstLine [= DistUnit$]
	Parameter	Beschreibung
	DistUnit$	Zeichenfolgenausdruck, der den Einzug der ersten Zeile des selektierten Absatzes und die Einheit aufnimmt, in der der Einzug angegeben wird.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Calc-Methode

Funktion:	Berechnet die aktuelle Tabelle neu.
Syntax:	Selection.Table.Calc
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ActionEnd-Methode

Funktion:	Schaltet die sichtbare Formatierung des Dokumentes wieder ein.
Syntax:	Selection.{Frame|Text|Table|ActiveWindow}.ActionEnd
Für Objekt:	Frame, Text, Table, ActiveWindow

Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ActionStart-Methode

Funktion:	Schaltet die sichtbare Formatierung des Dokumentes aus.
Syntax:	Selection.{Frame|Text|Table|ActiveWindow}.ActionStart
Erläuterung:	Nach einem Aufruf dieser Methode werden alle nachfolgenden Formatierungen nicht mehr im Dokument angezeigt. Das Ergebnis dieser Formatierungen wird erst dann wieder sichtbar, wenn die ActionEnd-Methode aufgerufen wird. Makros mit sehr zeitintensiven Formatierungen sollten diese Methoden zur Beschleunigung des Programmablaufs verwenden, da eine Formatierung des Dokumentes im Arbeitsspeicher sehr viel schneller als auf dem Bildschirm durchgeführt wird.
Für Objekt:	Frame, Text, Table, ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Pitch-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob die Schriftart des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen proportional ist.
Syntax:	Selection.Text.Font.Pitch [=PropFont%]
	Parameter	Beschreibung
	PropFont%	Integer-Ausdruck, der angibt, ob die Schriftart des selektierten Textes oder der an der Schreibmarke einzufügenden Zeichen proportional ist.
	Wert	Beschreibung
	0	Unbekannte Laufweite.
	1	Nicht proportionale Schriftart.
	2	Proportionale Schriftart.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GetFieldName-Methode

Funktion:	Gibt die Bezeichnung des angegebenen Feldbefehls zurück.
Syntax:	Selection.Text.GetFieldName Pos%, FieldType%
	Parameter	Beschreibung
	Pos%	Integer-Ausdruck, der die Position des angegebenen Feldes innerhalb aller anderen Felder vom selben Feldtyp bestimmt.
	FieldType%	Integer-Ausdruck, der den Feldbefehl angibt, dessen Bezeichnung ermittelt werden soll. Die folgenden Feldtypen können angegeben werden:
	Wert	Beschreibung
	30	Absender.
	7	Autor.
	27	Bedingter Text.
	25	Beliebiger Datensatz.
	20	Benutzerdefiniertes Feld.
	2	Dateiname.
	3	Datenbankname.
	26	Datensatznummer.
	0	Datum.
	14	DDE-Feld.
	18	Dokumentinfo-Bereich. (Die einzufügenden Felder werden mit SubType% übergeben).
	22	Dokumentvorlage.
	16	Eingabefeld.
	10	Formel einfügen.
	37	Internetfeld.
	4	Kapitel.
	17	Leerer Absatz.
	15	Makro ausführen.
	28	Nächste Seite.
	24	Nächster Datensatz.
	23	Nummernkreis.
	13	Referenz einfügen.
	12	Referenz setzen.
	5	Seitennummer.
	36	Seitenvariable anzeigen.
	35	Seitenvariable setzen.
	19	Serienbrieffeld.
	6	Statistik.
	1	Uhrzeit.
	9	Variable anzeigen.
	8	Variable setzen.
	11	Versteckter Text.
	29	Vorherige Seite.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertBreak-Methode

Funktion:	Ruft den Dialog zum Einfügen eines manuellen Umbruches auf.
Syntax:	Selection.Text.InsertBreak
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataAppendRecord-Methode

Funktion:	Fügt der aktuellen Datenbank einen neuen Datensatz hinzu.
Syntax:	ActiveWindow.DataAppendRecord NewRecord$
	Parameter	Beschreibung
	NewRecord$	Zeichenfolgenausdruck, der die Inhalte der Datenfelder des neuen Datensatzes durch Kommata getrennt angibt.
Erläuterung:	In NewRecord$ müssen alle Datenfelder des neuen Datensatzes berücksichtigt werden. Soll einem Feld kein Wert zugewiesen werden, so wird dies mit zwei aufeinander folgenden Kommata angegeben.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataDeleteRecord-Methode

Funktion:	Löscht den aktuellen Datensatz in der Datenbank.
Syntax:	ActiveWindow.DataAppendRecord
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DataUpdateRecord-Methode

Funktion:	Ändert das angegebene Datenfeld im aktuellen Datensatz der Datenbank.
Syntax:	ActiveWindow.DataUpdateRecord Columnname$, Value$
	Parameter	Beschreibung
	Columnname$	Zeichenfolgenausdruck, der die Bezeichnung des Datenfeldes im Datensatz angibt, das geändert werden soll.
	Value$	Zeichenfolgenausdruck, der den geänderten Inhalt des Datenfeldes aufnimmt.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BackgroundDialog-Methode

Funktion:	Ruft den Hintergrund-Dialog auf, mit dessen Hilfe die Einstellungen für die Hintergrundfarbe, das Muster und die Musterfarbe vorgenommen werden können.
Syntax:	ActiveWindow.BackgroundDialog
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Style-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Muster im Hintergrund des selektierten Bereichs.
Syntax:	Selection.Interior.Style [= Pattern%]
	Parameter	Beschreibung
	Pattern%	Integer-Ausdruck, der angibt, welches Muster im Hintergrund des selektierten Bereiches erscheinen soll. Pattern% können die folgenden Muster zugewiesen werden:
	Wert	Beschreibung
	0	Der Hintergrund des selektierten Bereiches wird transparent dargestellt.
	1
	2
	3
	4
	5
	6
	7
	8
	9
	10
Zugriff:	Lesen und Schreiben
Für Objekt:	Interior
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FillColor-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Farbe des Musters im Hintergrund des selektierten Bereiches.
Syntax:	Selection.Interior.FillColor [= Color]
	Parameter	Beschreibung
	Color	Numerischer Ausdruck, der die Farbe des Musters im Hintergrund des selektierten Bereiches angibt.
Zugriff:	Lesen und Schreiben
Für Objekt:	Interior
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BackColor-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Farbe für den Hintergrund des selektierten Bereiches.
Syntax:	Selection.Interior.BackColor [= Color]
	Parameter	Beschreibung
	Color	Numerischer Ausdruck, der die Farbe für den Hintergrund des selektierten Bereiches angibt.
Zugriff:	Lesen und Schreiben
Für Objekt:	Interior
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Transparent-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellung für einen transparenten Hintergrund.
Syntax:	Selection.Interior.Transparent [= Bool]
	Parameter	Beschreibung
	Bool	Booleanscher Ausdruck, der angibt, ob der Hintergrund transparent dargestellt werden soll:
	Wert	Beschreibung
	True	Hintergrund wird transparent dargestellt.
	False	Hintergrund wird nicht transparent dargestellt.
Zugriff:	Lesen und Schreiben
Für Objekt:	Interior
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Backspace-Methode

Funktion:	Löscht das zuletzt eingegebene Zeichen.
Syntax:	Selection.Text.Backspace
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BookmarkCount-Eigenschaft

Funktion:	Ermittelt die Anzahl der Textmarken im gesamten Dokument.
Syntax:	Selection.Text.BookmarkCount
Zugriff:	Nur Lesen.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BorderDialog-Methode

Funktion:	Ruft den Dialog zum Umranden von Absätzen auf.
Syntax:	ActiveWindow.BorderDialog
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BringToFront-Methode

Funktion:	Ordnet die selektierte Grafik oder den selektierten Rahmen vor allen anderen Grafiken und Rahmen im Vordergrund an.
Syntax:	Selection.{Graphic|Frame}.BringToFront
Für Objekt:	Graphic, Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Columns-Eigenschaft

Funktion:	Ermittelt die Anzahl der Spalten einer Tabelle.
Syntax:	Selection.Table.Columns
Zugriff:	Nur Lesen.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ConvertTableText-Methode

Funktion:	Konvertiert einen Text in eine Tabelle und umgekehrt.
Syntax:	Selection.{Text|Table}.ConvertTableText Delimiter$
	Parameter	Beschreibung
	Delimiter$	Zeichenfolgenausdruck, der das Trennzeichen angibt, das den Beginn einer neuen Spalte kennzeichnet.
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Copy-Methode

Funktion:	Kopiert die aktuelle Selektion in das Clipboard.
Syntax:	Selection.ActiveWindow.Copy
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Cut-Methode

Funktion:	Kopiert die aktuelle Selektion in das Clipboard und löscht sie anschließend.
Syntax:	Selection.ActiveWindow.Cut
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DecrementLevel-Methode

Funktion:	Stuft eine Aufzählung oder Numerierung um eine Ebene nach unten.
Syntax:	Selection.List.DecrementLevel
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DecrementSubLevels-Methode

Funktion:	Stuft eine Aufzählung oder Numerierung einschließlich ihrer Unterpunkte um eine Ebene nach unten.
Syntax:	Selection.List.DecrementSubLevels
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DeleteBookmark-Methode

Funktion:	Löscht eine bestimmte Textmarke.
Syntax:	Selection.{Text|Table}.DeleteBookmark Marke$
	Parameter	Beschreibung
	Marke$	Zeichenfolgenausdruck, der die Bezeichnung der zu löschenden Textmarke angibt.
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Delete-Methode

Funktion:	Löscht das Zeichen an der Schreibmarke oder die Selektion.
Syntax:	ActiveWindow.Delete
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
DeleteRegion-Methode

Funktion:	Löscht einen Bereich.
Syntax:	Selection.{Text|Table}.DeleteRegion RegionName$
	Parameter	Beschreibung
	RegionName$	Zeichenfolgenausdruck, der die Bezeichnung des zu löschenden Bereiches angibt.
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
EditRegion-Methode

Funktion:	Setzt die Einstellungen für einen bestimmten Bereich.
Syntax:	Selection.{Text|Table}.EditRegion RegionCondition$, RegionHidden, RegionProtect, RegionName$
	Parameter	Beschreibung
	RegionCondition$	Zeichenfolgenausdruck, der die Bedingung für die Anzeige des gewählten Bereiches aufnimmt.
	RegionHidden	Booleanscher Ausdruck, der angibt, ob der gewählte Bereich angezeigt werden soll. RegionHidden können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Bereich wird angezeigt.
	False	Der Bereich wird nicht angezeigt.
	RegionProtect	Booleanscher Ausdruck, der angibt, ob der Text im gewählten Bereich nicht mehr geändert werden darf:
	Wert	Beschreibung
	True	Der Text im Bereich darf nicht mehr geändert werden.
	False	Der Text im Bereich darf geändert werden.
	RegionName$	Zeichenfolgenausdruck, der die Bezeichnung des Bereiches aufnimmt, dessen Einstellungen bearbeitet werden sollen.
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
EndOfDocument-Methode

Funktion:	Springt in der Seitenansicht zum Ende des aktuellen Dokumentes.
Syntax:	PrintPreView.EndOfDocument
Für Objekt:	PrintPreView
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FontDialog-Methode

Funktion:	Ruft den Zeichen-Dialog zum Setzen der Zeichenattribute des selektierten Bereiches auf.
Syntax:	Selection.Font.FontDialog
Für Objekt:	Font
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FrameDialog-Methode

Funktion:	Ruft den Rahmen-Dialog auf, mit dessen Hilfe die Einstellungen für den selektierten Rahmen vorgenommen werden können.
Syntax:	Selection.Frame.FrameDialog
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
RightMargin-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Abstand zwischen dem rechten Rand des selektierten Rahmens und dem Text, der diesen Rahmen umgibt.
Syntax:	Selection.{Frame|Table|Paragraph|ActiveWindow}.RightMargin [= Distance$]
	Parameter	Beschreibung
	Distance$	Zeichenfolgenausdruck, der den Abstand zwischen dem rechten Rand des selektierten Rahmens und dem Text, der diesen Rahmen umgibt und die Einheit aufnimmt, in der der Abstand angegeben wird.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Table, Paragraph, ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LeftMargin-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Abstand von der linken Papierkante bis zum Zeilenanfang am linken Seitenrand.
Syntax:	Selection.{ActiveWindow|Frame|Table|Paragraph}.LeftMargin [= Distance$]
	Parameter	Beschreibung
	Distance$	Zeichenfolgenausdruck, der den Abstand von der linken Papierkante bis zum Zeilenanfang am linken Seitenrand und die Einheit angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow, Frame, Table, Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
TopMargin-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Abstand von der oberen Papierkante bis zum oberen Seitenrand.
Syntax:	Selection.{ActiveWindow|Frame|Table|Paragraph}.TopMargin [= Distance$]
	Parameter	Beschreibung
	Distance$	Zeichenfolgenausdruck, der den Abstand von der oberen Papierkante bis zum oberen Seitenrand und die Einheit angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow, Frame, Table, Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
BottomMargin-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Abstand des selektierten Absatzes zum nachfolgenden Absatz.
Syntax:	Selection.{ActiveWindow|Frame|Table|Paragraph}.BottomMargin [= Distance$]
	Parameter	Beschreibung
	Distance$	Zeichenfolgenausdruck, der den Abstand des selektierten Absatzes zum nachfolgenden Absatz und die Einheit aufnimmt, in der der Abstand angegeben wird.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow, Frame, Table, Paragraph
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GetDatabaseFieldValue-Methode

Funktion:	Gibt den Inhalt des angegebenen Datenbankfeldes zurück.
Syntax:	Selection.Text.GetDatabaseFieldValue Name$
	Parameter	Beschreibung
	Name$	Zeichenfolgenausdruck, der die Bezeichnung des Datenbankfeldes angibt, dessen Inhalt zurückgegeben werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GetFieldFmt-Methode

Funktion:	Gibt einen Zeichenfolgenausdruck zurück, der die Darstellungsform des selektierten Feldes bezeichnet. Der zurückgegebene Ausdruck ist eine Zahl, die die Position der Darstellungsform in dem Listenfeld FORMAT des Feldbefehl-Dialoges bezeichnet, wobei dem ersten Eintrag der Wert 0 zugewiesen ist.
Syntax:	Selection.Text.GetFieldFmt
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GetFieldPar1-Methode

Funktion:	Gibt einen Zeichenfolgenausdruck zurück, der die Bezeichnung eines selektierten benutzerdefinierten Feldes oder die Bedingung eines selektierten Funktionsfeldes aufnimmt.
Syntax:	Selection.Text.GetFieldPar1
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GetFieldPar2-Methode

Funktion:	Gibt einen Zeichenfolgenausdruck zurück, der die vom Feldtyp des selektierten Feldes abhängigen Feldinhalte oder Feldwerte aufnimmt.
Syntax:	Selection.Text.GetFieldPara2
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GotoFrame-Methode

Funktion:	Selektiert den angegebenen Rahmen.
Syntax:	Selection.Text.GotoFrame FrameName$
	Parameter	Beschreibung
	FrameName$	Zeichenfolgenausdruck, der die Bezeichnung des Rahmens aufnimmt, der selektiert werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GotoTable-Methode

Funktion:	Selektiert die angegebene Tabelle.
Syntax:	Selection.Text.GotoTable TableName$
	Parameter	Beschreibung
	TableName$	Zeichenfolgenausdruck, der die Bezeichnung der Tabelle aufnimmt, der selektiert werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GraphicDialog-Methode

Funktion:	Ruft den Grafik-Dialog auf, mit dessen Hilfe die Einstellungen für die selektierte Grafik vorgenommen werden können.
Syntax:	Selection.Graphic.GraphicDialog
Für Objekt:	Graphic
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
GraphicMirror-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellung für das Spiegeln der selektierten Grafik.
Syntax:	Selection.Graphic.GraphicMirror [= MirrorValue%]
	Parameter	Beschreibung
	MirrorValue%	Integer-Ausdruck, der die Einstellung zum Spiegeln der selektierten Grafik angibt. MirrorValue% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Grafik wird nicht gespiegelt.
	1	Grafik wird vertikal gespiegelt.
	2	Grafik wird horizontal gespiegelt.
	3	Grafik wird horizontal und vertikal gespiegelt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Graphic
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
HeadlineRepeat-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob nach einem Seitenumbruch innerhalb einer Tabelle die Tabellenüberschrift dieser Tabelle wiederholt werden soll.
Syntax:	Selection.Table.HeadlineRepeat [= Repetition]
	Parameter	Beschreibung
	Repetition	Booleanscher Ausdruck, der angibt, ob nach einem Seitenumbruch innerhalb der selektierten Tabelle deren Tabellenüberschrift wiederholt werden soll:
	Wert	Beschreibung
	True	Die Tabellenüberschrift wird wiederholt.
	False	Die Tabellenüberschrift wird nicht wiederholt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
HorzOrientation-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellung für die horizontale Ausrichtung des selektierten Rahmens.
Syntax:	Selection.Frame.HorzOrientation [= Orientation%]
	Parameter	Beschreibung
	Orientation%	Integer-Ausdruck, der die Einstellung für die horizontale Ausrichtung des selektierten Rahmens angibt. Orientation% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Positioniert den linken Rand des selektierten Rahmens in einer angegebenen Entfernung vom linken Seitenrand, sofern dieser an der Seite verankert ist. Ist der Rahmen am Absatz verankert, wird er in einer angegebenen Entfernung vom linken Einzug dieses Absatzes angeordnet. Die Entfernung des Rahmens zum Absatz oder zur Seite wird mit der XPos-Eigenschaft bestimmt.
	1	Ordnet den rechten Rand des selektierten Rahmens rechts am Dokument oder Absatz an. Die genaue Position des Rahmens wird über die HorzRelation-Eigenschaft bestimmt.
	2	Positioniert den selektierten Rahmen in der Mitte des rechten und linken Seitenrands, sofern dieser an der Seite verankert ist. Ist der selektierte Rahmen am Absatz verankert, wird er in der Mitte des rechten und linken Einzuges angeordnet.
	3	Ordnet den linken Rand des selektierten Rahmens links am Dokument oder Absatz an. Die genaue Position des Rahmens wird über die HorzRelation-Eigenschaft bestimmt.
Zugriff:	Lesen und Schreiben
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IncrementLevel-Methode

Funktion:	Stuft eine Aufzählung oder Numerierung um eine Ebene nach oben.
Syntax:	Selection.List.IncrementLevel
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
IncrementSubLevels-Methode

Funktion:	Stuft eine Aufzählung oder Numerierung einschließlich ihrer Unterpunkte um eine Ebene nach oben.
Syntax:	Selection.List.IncrementSubLevels
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertMode-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Zustand des Einfügemodus.
Syntax:	ActiveWindow.InsertMode [= InsertFlag]
	Parameter	Beschreibung
	InsertFlag	Booleanscher Ausdruck, der den Zustand des Einfügemodus angibt:
	Wert	Beschreibung
	True	Der Einfügemodus ist aktiviert.
	False	Der Einfügemodus ist nicht aktiviert.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertNeutralParagraph-Methode

Funktion:	Fügt innerhalb einer Numerierung oder Aufzählung einen neuen Absatz ohne voranstehende Nummer oder voranstehendem Aufzählungszeichen an der Position der Schreibmarke ein.
Syntax:	Selection.List.InsertNeutralParagraph
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
InsertRegion-Methode

Funktion:	Erstellt einen neuen Bereich aus der aktuellen Selektion.
Syntax:	Selection.Text.InsertRegion RegionName$, RegionHidden, RegionProtect, RegionCondition$
	Parameter	Beschreibung
	RegionName$	Zeichenfolgenausdruck, der die Bezeichnung des Bereiches aufnimmt, der aus der Selektion erstellt werden sollen.
	RegionCondition$	Zeichenfolgenausdruck, der die Bedingung für die Anzeige des neuen Bereiches aufnimmt.
	RegionHidden	Booleanscher Ausdruck, der angibt, ob der neue Bereich angezeigt werden soll. RegionHidden können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Der Bereich wird angezeigt.
	False	Der Bereich wird nicht angezeigt.
	RegionProtect	Booleanscher Ausdruck, der angibt, ob der Text im neuen Bereich nicht mehr geändert werden darf:
	Wert	Beschreibung
	True	Der Text im Bereich darf nicht mehr geändert werden.
	False	Der Text im Bereich darf geändert werden.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpDownThisLevel-Methode

Funktion:	Springt innerhalb einer Aufzählung oder Numerierung zum nächsten Absatz der gleichen Ebene.
Syntax:	Selection.List.JumpDownThisLevel
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToBookmark-Methode

Funktion:	Springt zu der angegebenen Textmarke.
Syntax:	Selection.{Text|Table}.JumpToBookmark Marke$
	Parameter	Beschreibung
	Marke$	Zeichenfolgenausdruck, der die Bezeichnung der Textmarke aufnimmt, zu der gesprungen werden soll.
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToNextBookmark-Methode

Funktion:	Springt zur nächsten Textmarke, die der aktuellen Selektion oder der Position der Schreibmarke folgt.
Syntax:	Selection.{Text|Table}.JumpToNextBookmark
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToNextCell-Methode

Funktion:	Springt zur nächsten Tabellenzelle, die der aktuellen Selektion oder der Position der Schreibmarke folgt.
Syntax:	Selection.Table.JumpToNextCell
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToPrevBookmark-Methode

Funktion:	Springt zu der Textmarke, die der aktuellen Selektion oder der Position der Schreibmarke vorangeht.
Syntax:	Selection.{Text|Table}.JumpToPrevBookmark
Für Objekt:	Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToPrevCell-Methode

Funktion:	Springt zu der Tabellenzelle, die der aktuellen Selektion oder der Position der Schreibmarke vorangeht.
Syntax:	Selection.Table.JumpToPrevCell
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpToRegion-Methode

Funktion:	Springt zu dem angegebenen Bereich.
Syntax:	Selection.Text.JumpToRegion Name$
	Parameter	Beschreibung
	Name$	Zeichenfolgenausdruck, der die Bezeichnung des Bereiches aufnimmt, zu dem gesprungen werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
JumpUpThisLevel-Methode

Funktion:	Springt innerhalb einer Aufzählung oder Numerierung zum vorangehenden Absatz der gleichen Ebene.
Syntax:	Selection.List.JumpUpThisLevel
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
LaunchStarImage-Methode

Funktion:	Startet StarImage zur Bearbeitung der im Dokument selektierten Grafik.
Syntax:	Selection.Interior.LaunchStarImage
Für Objekt:	Interior
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MoveDown-Methode

Funktion:	Verschiebt die selektierte Aufzählung oder Numerierung um eine Position nach unten.
Syntax:	Selection.List.MoveDown
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MoveDownSubItems-Methode

Funktion:	Verschiebt die selektierte Aufzählung oder Numerierung einschließlich ihrer Unterpunkte um eine Position nach unten.
Syntax:	Selection.List.MoveDownSubItems
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MoveUp-Methode

Funktion:	Verschiebt die selektierte Aufzählung oder Numerierung um eine Position nach oben.
Syntax:	Selection.List.MoveUp
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
MoveUpSubItems-Methode

Funktion:	Verschiebt die selektierte Aufzählung oder Numerierung einschließlich ihrer Unterpunkte um eine Position nach oben.
Syntax:	Selection.List.MoveUpSubItems
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageColumnDialog-Methode

Funktion:	Ruft den Spalten-Dialog auf, mit dessen Hilfe die Einstellungen für die Spalten einer Seite gesetzt werden können.
Syntax:	Selection.{Frame|Text|Table}.PageColumnDialog
Für Objekt:	Frame, Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageDialog-Methode

Funktion:	Ruft den Seiten-Dialog auf, mit dessen Hilfe die Einstellungen für die aktuelle Seite gesetzt werden können.
Syntax:	Selection.{Frame|Text|Table}.PageDialog
Für Objekt:	Frame, Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageStyleApply-Methode

Funktion:	Weist der aktuellen Seite die angegebene Seitenvorlage zu.
Syntax:	ActiveWindow.PageStyleApply Style$
	Parameter	Beschreibung
	Style$	Zeichenfolgenausdruck, der die Bezeichnung der Seitenvorlage aufnimmt, die der aktuellen Seite zugewiesen werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PageStyleName-Eigenschaft

Funktion:	Ermittelt die Bezeichnung der Seitenvorlage der aktuellen Seite.
Syntax:	ActiveWindow.PageStyleName
Zugriff:	Nur Lesen.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Paste-Methode

Funktion:	Fügt den Inhalt der Zwischenablage an der Position der Schreibmarke ein.
Syntax:	Selection.{Frame|Text|Table}.Paste
Für Objekt:	Frame, Text, Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PasteSpecial-Methode

Funktion:	Ruft zum Einfügen des Inhaltes der Zwischenablage den INHALT-EINFÜGEN-Dialog auf, mit dessen Hilfe das Format des einzufügenden Inhaltes bestimmt werden kann.
Syntax:	ActiveWindow.PasteSpecial
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
PrintPreView-Methode

Funktion:	Schaltet die Seitenansicht ein oder aus.
Syntax:	ActiveDocument.PrintPreView
	Parameter	Beschreibung
	State	Booleanscher Ausdruck, der angibt, ob die Seitenansicht ein- oder ausgeschaltet werden soll. State können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Seitenansicht wird eingeschaltet.
	False	Die Seitenansicht wird ausgeschaltet.
Für Objekt:	ActiveDocument
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
FrameProtect-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellung für den geschützten Inhalt und die geschützte Größe und Position des selektierten Rahmens.
Syntax:	Selection.Frame.FrameProtect [= ProtectItem$]
	Parameter	Beschreibung
	ProtectItem$	Zeichenfolgenausdruck, der die Einstellung für den geschützten Inhalt und die geschützte Größe und Position des selektierten Rahmens aufnimmt. Die nachstehenden Einstellungen, die  mit ProtectItem$ übergeben werden können, sind kombinierbar:
	Wert	Beschreibung
	Leerstring (““)	Weder der Inhalt noch die Größe oder die Position des selektierten Rahmens werden geschützt und können somit verändert werden.
	C	Der Inhalt des selektierten Rahmens wird geschützt und darf somit nicht verändert werden.
	S	Die Größe des selektierten Rahmens wird geschützt und darf somit nicht verändert werden.
	P	Die Position des selektierten Rahmens wird geschützt und darf somit nicht verändert werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
RedoAction-Eigenschaft

Funktion:	Ermittelt die im Menü BEARBEITEN unter dem Menüpunkt WIEDERHOLEN aufgeführte Beschreibung der zuvor rückgängig gemachten Aktion.
Syntax:	ActiveWindow.RedoAction
Zugriff:	Nur Lesen.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Remove-Methode

Funktion:	Schaltet die Aufzählung oder Numerierung des selektierten Absatzes aus.
Syntax:	Selection.List.Remove
Für Objekt:	List
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
RenameRegion-Methode

Funktion:	Weist dem angegebenen Bereich eine neue Bezeichnung zu.
Syntax:	Selection.Text.RenameRegion NewName$, RegionName$
	Parameter	Beschreibung
	NewName$	Zeichenfolgenausdruck, der die neue Bezeichnung des angegebenen Bereichs aufnimmt.
	RegionName$	Zeichenfolgenausdruck, der die Bezeichnung des Bereiches angibt, dem eine neue Bezeichnung zugewiesen werden soll.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Repaginate-Methode

Funktion:	Führt eine Neuformatierung des Dokumentes durch.
Syntax:	ActiveWindow.Repaginate
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Select-Methode

Funktion:	Selektiert die gesamte Tabelle, in der sich die Schreibmarke gegenwärtig befindet.
Syntax:	Selection.Table.Select
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SendToBack-Methode

Funktion:	Ordnet die selektierte Grafik oder den selektierten Rahmen hinter allen anderen Grafiken und Rahmen im Dokument an.
Syntax:	Selection.{Frame|Graphic}.SendToBack
Für Objekt:	Frame, Graphic
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SetCurField-Methode

Funktion:	Weist dem selektierten Feld die angegebenen Parameter zu.
Syntax:	Selection.Text.SetCurField Par1$, Par2$, Format%
	Parameter	Beschreibung
	Par1$	Zeichenfolgenausdruck, der dem selektierten Feld Bezeichnung zuweist, sofern dieses benutzerdefiniert ist. Ist das selektierte Feld ein Funktionsfeld, übergibt Par1$ die Funktionsbedingung.
	Par2$	Zeichenfolgenausdruck, der dem selektierten Feld den vom Feldtyp abhängigen Feldinhalt oder Feldwert zuweist.
	Format%	Integer-Ausdruck, der die Darstellungsform des selektierten Feldes angibt. Format% kann eine der in dem Listenfeld FORMAT des FELDBEFEHL-Dialoges aufgeführten Darstellungsformen in der Reihenfolge ihrer Anordnung zugewiesen werden, wobei der Wert 0 den ersten Eintrag kennzeichnet.
Für Objekt:	Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SetOptimalColumnWidth-Methode

Funktion:	Setzt die optimale Spaltenbreite für die selektierte Tabellenspalte.
Syntax:	Selection.Table.SetOptimalColumnWidth
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
SetOptimalRowHeight-Methode

Funktion:	Setzt die optimale Zeilenhöhe für die selektierte Tabellenzeile.
Syntax:	Selection.Table.SetOptimalRowHeight
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
StandardFontDialog-Methode

Funktion:	Ruft den GRUNDSCHRIFTEN-Dialog auf, mit dessen Hilfe die Schriftarten für den Standard-, Überschrifts-, Listen-, Beschriftungs- und Verzeichnistext bestimmt werden können.
Syntax:	ActiveWindow.StandardFontDialog
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
StartOfDocument-Methode

Funktion:	Springt zum Anfang des aktuellen Dokumentes.
Syntax:	ActiveWindow.StartOfDocument
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
TableDialog-Methode

Funktion:	Ruft den TABELLENFORMAT-Dialog auf, mit dessen Hilfe die Einstellungen für die selektierte Tabelle gesetzt werden können.
Syntax:	Selection.Table.TableDialog
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
TableName-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Bezeichnung der selektierten Tabelle.
Syntax:	Selection.Table.TableName [= TabName$]
	Parameter	Beschreibung
	TabName$	Zeichenfolgenausdruck, der die Bezeichnung der selektierten Tabelle angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ToBack-Methode

Funktion:	Setzt das selektierte Objekt um eine Darstellungsstufe zurück in den Hintergrund.
Syntax:	Selection. {Frame|Graphic}.ToBack
Für Objekt:	Frame, Graphic
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ToFront-Methode

Funktion:	Setzt die selektierte Grafik oder den selektierten Rahmen um eine Darstellungsstufe nach vorne in den Vordergrund.
Syntax:	Selection.{Frame|Graphic}.ToFront
Für Objekt:	Frame, Graphic
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
UndoAction-Eigenschaft

Funktion:	Ermittelt die im Menü BEARBEITEN unter dem Menüpunkt RÜCKGÄNGIG aufgeführte Beschreibung der zuvor ausgeführten Aktion.
Syntax:	ActiveWindow.UndoAction
Zugriff:	Nur Lesen.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
UndoMode-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellung für den Rückgängig-Modus.
Syntax:	ActiveWindow.UndoMode [= BackSetting]
	Parameter	Beschreibung
	BackSetting	Booleanscher Ausdruck, der angibt, ob die zuletzt ausgeführte Aktion rückgängig gemacht werden kann.
	Wert	Beschreibung
	True	Die zuletzt ausgeführte Aktion kann rückgängig gemacht werden.
	True	Die zuletzt ausgeführte Aktion kann nicht rückgängig gemacht werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
UpdateFields-Methode

Funktion:	Aktualisiert alle Felder im Dokument.
Syntax:	ActiveWindow.UpdateFields
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
UpdateInputFields-Methode

Funktion:	Aktualisiert alle Eingabefelder im Dokument.
Syntax:	ActiveWindow.UpdateInputFields
Für Objekt:	ActiveWindow
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
VertOrientation-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellung für die vertikale Ausrichtung des selektierten Rahmens.
Syntax:	Selection.Frame.VertOrientation [= Orientation%]
	Parameter	Beschreibung
	Orientation%	Integer-Ausdruck, der die Einstellung für die vertikale Ausrichtung des selektierten Rahmens angibt. Orientation% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Positioniert den oberen Rand des selektierten Rahmens in einer angegebenen Entfernung vom oberen Seitenrand, sofern dieser an der Seite verankert ist. Ist der Rahmen am Absatz verankert, wird er in einer angegebenen Entfernung vom oberen Absatzrand angeordnet. Ein an einem Zeichen verankerter selektierter Rahmen wird in einer angegebenen Entfernung von der Grundlinie der vorangehenden Zeile positioniert. Die Entfernung des Rahmens zum Absatz oder zur Seite wird mit der XPos-Eigenschaft bestimmt.
	1	Ordnet den oberen Rand des selektierten Rahmens am oberen Rand des Dokumentes, Absatzes oder Zeichens an. Die genaue Position des Rahmens wird über die VertRelation-Eigenschaft bestimmt.
	2	Positioniert den selektierten Rahmen in der Mitte der oberen und unteren Seitenränder, sofern dieser an der Seite verankert ist. Ist der selektierte Rahmen am Absatz verankert, wird er in der Mitte des oberen und unteren Absatzrandes angeordnet. Ein an einem Zeichen verankerter selektierter Rahmen wird in der Mitte der Grundlinien der vorangehenden und aktuellen Zeile positioniert.
	3	Ordnet den unteren Rand des selektierten Rahmens am unteren Rand des Dokumentes, Absatzes oder Zeichens an. Die genaue Position des Rahmens wird über die VertRelation-Eigenschaft bestimmt.
Zugriff:	Lesen und Schreiben
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
XPos-Eigenschaft

Funktion:	Bestimmt oder ermittelt die horizontale Position des selektierten Rahmens.
Syntax:	Selection.Frame.XPos [= HorzPos]
	Parameter	Beschreibung
	HorzPos	Numerischer Ausdruck, der die Entfernung des linken Rahmenrandes zum linken Seitenrand angibt, sofern der selektierte Rahmen an der Seite verankert ist. Ist der Rahmen am Absatz verankert, gibt HorzPos die Entfernung des linken Rahmenrandes zum linken Einzug des Absatzes an. Die Entfernung wird in der Einheit TWIPS bestimmt.
Erläuterung:	Um den selektierten Rahmen in der x-Ebene positionieren zu können, muß der HorzOrientation-Eigenschaft sowie der HorzRelation-Eigenschaft der Wert 0 zugewiesen werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
YPos-Eigenschaft

Funktion:	Bestimmt oder ermittelt die vertikale Position des selektierten Rahmens.
Syntax:	Selection.Frame.YPos [= VertPos]
	Parameter	Beschreibung
	VertPos	Numerischer Ausdruck, der die Entfernung des oberen Rahmenrandes zum oberen Seitenrand angibt, sofern der selektierte Rahmen an der Seite verankert ist. Ist der Rahmen am Absatz verankert, gibt VertPos die Entfernung des oberen Rahmenrandes zum oberen Absatzrand an. Die Entfernung wird in der Einheit TWIPS bestimmt.
Erläuterung:	Um den selektierten Rahmen in der y-Ebene positionieren zu können, muß der VertOrientation-Eigenschaft sowie der VertRelation-Eigenschaft der Wert 0 zugewiesen werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
HorzRelation-Eigenschaft

Funktion:	Bestimmt oder ermittelt detailliert die Ausrichtung des linken oder rechten Randes des selektierten Rahmens.
Syntax:	Selection.Frame.HorzRelation [=FramePos%]
	Parameter	Beschreibung
	FramePos%	Integer-Ausdruck, der die mit der HorzOrientation-Eigenschaft gesetzte Ausrichtung des selektierten Rahmens spezifiziert. Der HorzOrientation-Eigenschaft muß entweder der Wert 1 für die Ausrichtung des rechten Rahmenrandes oder der Wert 3 für die Ausrichtung des linken Rahmenrandes zugewiesen sein. FramePos% können die folgenden Einstellungen zugewiesen werden:
	Wert	Beschreibung
	0	Positioniert den linken oder rechten Rand des Rahmens an der linken oder rechten Papierkante (Verankerung an der Seite), respektive am linken oder rechten Seitenrand (Verankerung am Absatz).
	1	Positioniert den linken oder rechten Rand des Rahmens am linken oder rechten Seitenrand (Verankerung an der Seite), respektive am linken oder rechten Einzug des Absatzes (Verankerung am Absatz).
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	HorzOrientation
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
VertRelation-Eigenschaft

Funktion:	Bestimmt oder ermittelt detailliert die Ausrichtung des oberen oder unteren Randes des selektierten Rahmens.
Syntax:	Selection.Frame.VertRelation [=FramePos%]
	Parameter	Beschreibung
	FramePos%	Integer-Ausdruck, der die mit der VertOrientation-Eigenschaft gesetzte Ausrichtung des selektierten Rahmens spezifiziert. Der VertOrientation-Eigenschaft muß entweder der Wert 1 für die Ausrichtung des oberen Rahmenrandes oder der Wert 3 für die Ausrichtung des unteren Rahmenrandes zugewiesen sein. FramePos% können die folgenden Einstellungen zugewiesen werden:
	Wert	Beschreibung
	0	Positioniert den oberen oder unteren Rand des Rahmens an der oberen oder unteren Papierkante (Verankerung an der Seite).
	1	Positioniert den oberen oder unteren Rand des Rahmens an dem oberen oder unteren Seitenrand (Verankerung an der Seite).
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	VertOrientation
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Pos-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellungen für den Schutz der Position des selektierten Rahmens.
Syntax:	Selection.Frame.Pos [= ProtectedPos]
	Parameter	Beschreibung
	ProtectedPos	Booleanscher Ausdruck, der angibt, ob die Position des selektierten Rahmens geschützt werden soll. ProtectedPos können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	True	Die Position des Rahmens wird geschützt und kann somit nicht verändert werden.
	False	Die Position des Rahmens wird nicht geschützt und kann somit verändert werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Content-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Einstellungen für den Schutz des Inhaltes des selektierten Rahmens.
Syntax:	Selection.Frame.Content [= ProtectedCont]
	Parameter	Beschreibung
	ProtectedCont	Booleanscher Ausdruck, der angibt, ob der Inhalt des selektierten Rahmens geschützt werden soll:
	Wert	Beschreibung
	True	Der Inhalt des selektierten Rahmens wird geschützt und kann somit nicht verändert werden.
	False	Der Inhalt des selektierten Rahmens wird nicht geschützt und kann somit verändert werden.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
ResetTableProtection-Methode

Funktion:	Hebt den Zellenschutz für die selektierte Tabelle auf.
Syntax:	Selection.Table.ResetTableProtection
Für Objekt:	Table
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow.Style-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Füllmuster des Schattens, der dem selektierten Bereich zugewiesen ist.
Syntax:	Selection.{Frame|Graphic|Table|Text}.Shadow.Style [= FillStyle]
	Parameter	Beschreibung
	FillStyle	Numerischer Ausdruck, der angibt, welches Füllmuster dem Schatten des selektierten Bereiches zugewiesen werden soll:
	Wert	Füllmuster
	0	Der Schatten wird transparent dargestellt.
	1
	2
	3
	4
	5
	6
	7
	8
	9
	10
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Graphic, Table, Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow.Width-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Größe des Schattens, der dem selektierten Bereich zugewiesen ist.
Syntax:	Selection.{Frame|Graphic|Table|Text}.Shadow.Width [= ShadSize]
	Parameter	Beschreibung
	ShadSize	Numerischer Ausdruck, der die Größe des Schattens in TWIPS angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Graphic, Table, Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow.Location-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Position des Schattens, der dem selektierten Bereich zugewiesen ist.
Syntax:	Selection.{Frame|Graphic|Table|Text}.Shadow.Location [= ShadPos]
	Parameter	Beschreibung
	ShadPos	Numerischer Ausdruck, der die Position des Schattens beschreibt. ShadPos können die folgenden Werte zugewiesen werden:
	Wert	Position
	0	Kein Schatten
	1	Schatten links/oben
	2	Schatten rechts/oben
	3	Schatten links/unten
	4	Schatten rechts/unten
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Graphic, Table, Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow.Transparent-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob der dem selektierten Bereich zugewiesene Schatten transparent dargestellt werden soll.
Syntax:	Selection.{Frame|Graphic|Table|Text}.Shadow.Transparent [= ShadTransp]
	Parameter	Beschreibung
	ShadTransp	Booleanscher Ausdruck, der angibt, ob der dem selektierten Bereich zugewiesene Schatten transparent dargestellt werden soll:
	Wert	Beschreibung
	True	Der Schatten wird transparent dargestellt.
	False	Der Schatten wird nicht transparent dargestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Graphic, Table, Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow.FillColor-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Farbe des Füllmusters des Schattens, der dem selektierten Bereich zugewiesen ist.
Syntax:	Selection.{Frame|Graphic|Table|Text}.Shadow.FillColor [= Color&]
	Parameter	Beschreibung
	Color&	Beliebiger Long-Integer-Ausdruck, der die Farbe angibt, die dem Füllmuster des Schattens zugewiesen werden soll.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Graphic, Table, Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarWriter Eigenschaften und Methoden
Shadow.BackColor-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Farbe des Schattens, der dem selektierten Bereich zugewiesen ist.
Syntax:	Selection.{Frame|Graphic|Table|Text}.Shadow.BackColor [= Color&]
	Parameter	Beschreibung
	Color&	Beliebiger Long-Integer-Ausdruck, der die Farbe des Schattens angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Frame, Graphic, Table, Text
Siehe auch:	StarWriter Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden

ActivCell

AutoFill-Methode

ClearArrowDependents-Methode

ClearArrowPrecedents-Methode

DeleteColumnbreak-Methode

DeleteColumn-Methode

DeleteRowbreak-Methode

DeleteRow-Methode

InsertAnnotation-Methode

InsertCell-Methode

InsertColumnBreak-Methode

InsertColumn-Methode

Insert-Methode

InsertRowBreak-Methode

InsertRow-Methode

Paste-Methode

ShowDependents-Methode

ShowErrors-Methode

ShowPrecedents-Methode

TextValue-Eigenschaft

Value-Eigenschaft

ActiveTable

ClearArrows-Methode

Index-Eigenschaft

Move-Methode

Name-Eigenschaft

PageDialog-Methode

Protect-Methode

ActiveWindow

AutomaticCalculation-Eigenschaft

Calculate-Methode

GoDownBlock-Methode

GoDown-Methode

GoDownToEndOfData-Methode

GoLeftBlock-Methode

GoLeft-Methode

GoLeftToStartOfData-Methode

GoRightBlock-Methode

GoRight-Methode

GoRightToEndOfData-Methode

GoToCurrentCell-Methode

GoToEndOfData-Methode

GoToEndOfRow-Methode

GoToStart-Methode

GoToStartOfRow-Methode

GoUpBlock-Methode

GoUp-Methode

GoUpToStartOfData-Methode

Hide-Methode

JumpToNextTable-Methode

JumpToPrevTable-Methode

SelectAll-Methode

SelectColumn-Methode

SelectRow-Methode

Show-Methode

Document

Calculate-Methode

UpdateChart-Methode

Font

Bold-Eigenschaft

Color-Eigenschaft

Italic-Eigenschaft

Size-Eigenschaft

Underline-Eigenschaft

Range

ApplyAutoFormat-Methode

ColumnWidth-Eigenschaft

HorizontalAlignment-Eigenschaft

InsertObjectStarChart-Methode

NumberFormatCurrency-Methode

NumberFormatPercent-Methode

RowHeight-Eigenschaft

Select-Eigenschaft

SetOptimalColumnWidth-Methode

SetOptimalRowHeight-Methode

ShowColumn-Methode

ShowRow-Methode

UpdateChart-Methode

VerticalAlignment-Eigenschaft

Selection

ClearContents-Methode

Clear-Methode

ColumnWidth-Eigenschaft

Copy-Methode

Cut-Methode

Delete-Methode

Deselect-Methode

FillDown-Methode

FillLeft-Methode

FillRight-Methode

FillTable-Methode

FillUp-Methode

FunctionDialog-Methode

HideColumn-Methode

HideRow-Methode

HorizontalAlignment-Eigenschaft

MergeCells-Methode

NumberFormatCurrency-Methode

NumberFormatPercent-Methode

ResetAttributes-Methode

RowHeight-Eigenschaft

SelectData-Methode

Select-Eigenschaft

SetOptimalColumnWidth-Methode

SetOptimalRowHeight-Methode

ShowColumn-Methode

ShowRow-Methode

SortAscending-Methode

SortDescending-Methode

SplitCell-Methode

StarChartDialog-Methode

VerticalAlignment-Eigenschaft


StarCalc Eigenschaften und Methoden
GoUpToStartOfData-Methode

Funktion:	Bewegt die Einfügemarke nach oben, zum Ende, respektive zum Anfang eines Datenblockes.
Syntax:	ActiveWindow.GoUpToStartOfData Sel
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Erläuterung:	Ist vor der aktuellen Zelle keine weitere Zelle mit Inhalt angeordnet, wird die Einfügemarke in die erste Tabellenzeile gesetzt.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoToCurrentCell-Methode

Funktion:	Bewegt die Bildschirmmaske direkt auf die aktuelle Zelle.
Syntax:	ActiveWindow.GoToCurrentCell
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoToEndOfRow-Methode

Funktion:	Bewegt die Einfügemarke in der aktuellen Tabellenzeile auf die Tabellenspalte des letzten Datenfeldes in der aktuellen Tabelle.
Syntax:	ActiveWindow.GoToEndOfRow Sel
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen.
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoToStart-Methode

Funktion:	Bewegt die Einfügemarke auf die erste Zelle der Tabelle (A1).
Syntax:	ActiveWindow.GoToStart
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoToStartOfRow-Methode

Funktion:	Bewegt die Einfügemarke auf die erste Zelle der aktuellen Tabellenzeile.
Syntax:	ActiveWindow.GoToStartOfRow
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoToEndOfData-Methode

Funktion:	Bewegt die Einfügemarke in die Tabellenspalte und Tabellenzeile des jeweils letzten Datenfeldes der aktuellen Tabelle.
Syntax:	ActiveWindow.GoToEndOfData
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoLeftToStartOfData-Methode

Funktion:	Bewegt die Einfügemarke nach links zum Beginn, respektive zum Ende des jeweils nächsten Datenblockes.
Syntax:	ActiveWindow.GoLeftToStartOfData Sel
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Erläuterung:	Ist links der aktuellen Zelle keine weitere Zelle mit Inhalt vorhanden, wird die Einfügemarke in die erste Tabellenspalte gesetzt.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoRightToEndOfData-Methode

Funktion:	Bewegt die Einfügemarke nach rechts zum Beginn, respektive zum Ende des jeweils nächsten Datenblockes.
Syntax:	ActiveWindow.GoRightToEndOfData Sel
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Erläuterung:	Folgt der aktuellen Zelle keine weitere Zelle mit Inhalt, wird die Einfügemarke in die letzte Tabellenspalte gesetzt.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
AutoFill-Methode

Funktion:	Füllt die Zellen rechts oder unterhalb der aktuellen Zelle bis zur angegebnen Tabellenspalte und Tabellenzeile mit dem Inhalt der aktuellen Zelle aus.
Syntax:	ActiveCell.AutoFill
	Parameter	Beschreibung
	Addr$	Zeichenfolgenausdruck, der die Adresse der Endzelle angibt. Der Bezeichnung der Tabellenspalte und der Nummer der Tabellenzeile muß das $-Zeichen voranstehen (beispielsweise ActiveCell.AutoFill $A$3).
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoDownToEndOfData-Methode

Funktion:	Bewegt die Einfügemarke nach unten, zum Anfang, respektive zum Ende des jeweils nächsten Datenblockes.
Syntax:	ActiveWindow.GoUpToStartOfData Sel
	Parameter	Beschreibung
	Sel	Booleanscherr Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen werden markiert.
	False	Die Zellen werden nicht markiert.
Erläuterung:	Folgt der aktuellen Zelle keine weitere Zelle mit Inhalt, wird die Einfügemarke in die letzte Tabellenzeile gesetzt.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Bold-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Intensität der Fett-Darstellung der Schrift des selektierten Bereiches.
Syntax:	Selection.Font.Bold [= BoldIntens%]
	Parameter	Beschreibung
	BoldIntens%	Integer-Ausdruck, der die Intensität der Fett-Darstellung der Schrift des selektierten Bereiches angibt. BoldIntens% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Bestimmt die normale Darstellung für die Schrift des selektierten Bereiches.
	1 - 10	Bestimmt die Fett-Darstellung für die Schrift des selektierten Bereiches. Die Intensität der Darstellung erhöht sich mit zunehmenden Wert.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Clear-Methode

Funktion:	Löscht den Inhalt, respektive das Format des selektierten Bereiches.
Syntax:	Selection.Clear Flag$
	Parameter	Beschreibung
	Flags$	Zeichenfolgenausdruck, der angibt, ob das Format oder welche Inhalte des selektierten Bereiches gelöscht werden sollen. Wird Flag$ nicht übergeben, wird der Dialog INHALTE LÖSCHEN aufgerufen. Flag$ können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	A	Der gesamte Inhalt und das Format des selektierten Bereiches wird gelöscht.
	S	Im selektierten Bereich werden lediglich alle Zeichenfolgen gelöscht. Zahlen, Daten, Zeiten, Notizen und Formate bleiben erhalten.
	V	Im selektierten Bereich werden lediglich alle Zahlen gelöscht. Zeichenfolgen, Daten, Zeiten, Notizen und Formate bleiben erhalten.
	D	Im selektierten Bereich werden lediglich alle Daten und Zeiten gelöscht. Zeichenfolgen, Zahlen, Notizen und Formate bleiben erhalten.
	N	Im selektierten Bereich werden lediglich alle Notizen gelöscht. Zeichenfolgen, Daten, Zeiten, Zahlen und Formate bleiben erhalten.
	F	Das Format des selektierten Bereiches wird gelöscht. Zeichenfolgen, Daten, Zeiten, Notizen und Zahlen bleiben erhalten.
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ClearArrowDependents-Methode

Funktion:	Entfernt die Spur der aktuellen Zelle zu ihrem Nachfolger.
Syntax:	ActiveCell.ClearArrowDependents
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ClearArrowPrecedents-Methode

Funktion:	Entfernt die Spur der aktuellen Zelle zu ihrem Vorgänger.
Syntax:	ActiveCell.ClearArrowPrecedents
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ClearContents-Methode

Funktion:	Löscht den gesamten Zelleninhalt des selektierten Bereiches. Formatierungen werden nicht gelöscht.
Syntax:	Selection.ClearContents
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Copy-Methode

Funktion:	Kopiert den Inhalt des selektierten Bereiches in die Zwischenablage.
Syntax:	Selection.Copy
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Cut-Methode

Funktion:	Kopiert den Inhalt des selektierten Bereiches in die Zwischenablage und löscht diesen anschließend.
Syntax:	Selection.Cut
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Delete-Methode

Funktion:	Löscht die selektierten Zellen.
Syntax:	Selection.Delete Flags$
	Parameter	Beschreibung
	Flags$	Zeichenfolgenausdruck, der angibt, wie die Zellen gelöscht werden:
	Wert	Beschreibung
	U	Löscht die selektierten Zellen, indem die darunter angeordneten Zellen nach oben, über die selektierten Zellen verschoben werden.
	L	Löscht die selektierten Zellen, indem die rechts davon angeordneten Zellen nach links, über die selektierten Zellen verschoben werden.
	R	Löscht alle Tabellenzeilen, in denen die selektierten Zellen angeordnet sind.
	C	Löscht alle Tabellenspalten, in denen die selektierten Zellen angeordnet sind.
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
DeleteColumn-Methode

Funktion:	Löscht die Tabellenspalte, in der sich die Einfügemarke befindet.
Syntax:	ActiveCell.DeleteColumn
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
DeleteColumnbreak-Methode

Funktion:	Löscht den Spaltenumbruch vor dem selektierten Bereich.
Syntax:	ActiveCell.DeleteColumnbreak
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
DeleteRow-Methode

Funktion:	Löscht die Tabellenzeile, in der sich die Einfügemarke befindet.
Syntax:	ActiveCell.DeleteRow
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
DeleteRowbreak-Methode

Funktion:	Löscht den Zeilenumbruch über dem selektierten Bereich.
Syntax:	ActiveCell.DeleteRow
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Deselect-Methode

Funktion:	Hebt die aktuelle Selektion auf.
Syntax:	Selection.Deselect
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
FillDown-Methode

Funktion:	Füllt die selektierten Zellen mit dem Inhalt und dem Format der Zellen in der obersten Zeile dieser Selektion aus.
Syntax:	Selection.FillDown
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
FillLeft-Methode

Funktion:	Füllt die selektierten Zellen mit dem Inhalt und Format der Zellen in der äußerst rechten Spalte dieser Selektion aus.
Syntax:	Selection.FillLeft
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
FillRight-Methode

Funktion:	Füllt die selektierten Zellen mit dem Inhalt und Format der Zellen in der äußerst linken Spalte dieser Selektion aus.
Syntax:	Selection.FillRight
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
FillTable-Methode

Funktion:	Füllt die markierten Tabellen mit dem Inhalt, respektive mit dem Format oder mit dem Inhalt und dem Format der selektierten Zellen aus.
Syntax:	Selection.FillTable Flags$
	Parameter	Beschreibung
	Flags$	Zeichenfolgenausdruck, der angibt, womit die markierten Tabellen ausgefüllt werden sollen. Flags$ können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	A	Die selektierten Tabellen werden mit dem gesamten Inhalt und dem Format der selektierten Zellen ausgefüllt.
	S	Die selektierten Tabellen werden lediglich mit den in den selektierten Zellen enthaltenen Zeichenfolgen ausgefüllt. Zahlen, Daten, Zeiten, Notizen und Formate werden nicht übernommen.
	V	Die selektierten Tabellen werden lediglich mit den in den selektierten Zellen enthaltenen Zahlen ausgefüllt. Zeichenfolgen, Daten, Zeiten, Notizen und Formate werden nicht übernommen.
	D	Die selektierten Tabellen werden lediglich mit den in den selektierten Zellen enthaltenen Daten und Zeiten ausgefüllt. Zeichenfolgen, Zahlen, Notizen und Formate werden nicht übernommen.
	N	Die selektierten Tabellen werden lediglich mit den in den selektierten Zellen enthaltenen Notizen ausgefüllt. Zeichenfolgen, Zahlen, Daten, Zeiten und Formate werden nicht übernommen.
	F	Die selektierten Tabellen werden lediglich mit dem Format der selektierten Zellen ausgefüllt. Zeichenfolgen, Zahlen, Daten, Zeiten und Notizen werden nicht übernommen.
Erläuterung:	Um Tabellen mit dem Inhalt und Format bestimmter Zellen einer anderen Tabelle ausfüllen zu können, müssen zunächst die gewünschten Zellen selektiert werden. Drücken und halten Sie anschließend die Taste (ª), und markieren Sie nun nacheinander die Tabellen, die mit den gewünschten Daten ausgefüllt werden sollen mit der linken Maustaste.
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
FillUp-Methode

Funktion:	Füllt die selektierten Zellen mit dem Inhalt und Format der Zellen in der untersten Zeile dieser Selektion aus.
Syntax:	Selection.FillUp
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoDown-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Zellen nach unten.
Syntax:	ActiveWindow.GoDown By%, Sel
	Parameter	Beschreibung
	By%	Integer-Ausdruck, der die Anzahl der Zellen angibt, um die die Einfügemarke nach unten bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoDownBlock-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Seiten nach unten.
Syntax:	ActiveWindow.GoDown By%, Sel
	Parameter	Beschreibung
	By%	Beliebiger Integer-Ausdruck, der die Anzahl der Seiten angibt, um die die Einfügemarke nach unten bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoLeft-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Zellen nach links.
Syntax:	ActiveWindow.GoLeft By%, Sel
	Parameter	Beschreibung
	By%	Integer-Ausdruck, der die Anzahl der Zellen angibt, um die die Einfügemarke nach links bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoLeftBlock-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Seiten nach links.
Syntax:	ActiveWindow.GoLeft By%, Sel
	Parameter	Beschreibung
	By%	Beliebiger Integer-Ausdruck, der die Anzahl der Seiten angibt, um die die Einfügemarke nach links bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoRight-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Zellen nach rechts.
Syntax:	ActiveWindow.GoRight By%, Sel
	Parameter	Beschreibung
	By%	Integer-Ausdruck, der die Anzahl der Zellen angibt, um die die Einfügemarke nach rechts bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoRightBlock-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Seiten nach rechts.
Syntax:	ActiveWindow.GoRight By%, Sel
	Parameter	Beschreibung
	By%	Beliebiger Integer-Ausdruck, der die Anzahl der Seiten angibt, um die die Einfügemarke nach rechts bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoUp-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Zellen nach oben.
Syntax:	ActiveWindow.GoUp By%, Sel
	Parameter	Beschreibung
	By%	Integer-Ausdruck, der die Anzahl der Zellen angibt, um die die Einfügemarke nach oben bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
GoUpBlock-Methode

Funktion:	Bewegt die Einfügemarke um die angegebene Anzahl an Seiten nach oben.
Syntax:	ActiveWindow.GoUp By%, Sel
	Parameter	Beschreibung
	By%	Integer-Ausdruck, der die Anzahl der Seiten angibt, um die die Einfügemarke nach oben bewegt werden soll.
	Sel	Booleanscher Ausdruck, der angibt, ob die Zellen, über die sich die Einfügemarke bewegt, markiert werden sollen:
	Wert	Beschreibung
	True	Die Zellen, über die sich die Einfügemarke bewegt, werden markiert.
	False	Die Zellen, über die sich die Einfügemarke bewegt, werden nicht markiert.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertColumn-Methode

Funktion:	Fügt eine Spalte an der Position der Einfügemarke ein.
Syntax:	ActiveCell.InsertColumns
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertColumnBreak-Methode

Funktion:	Fügt einen Spaltenumbruch links der Position der Einfügemarke ein.
Syntax:	ActiveCell.InsertColumnBreak
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertRow-Methode

Funktion:	Fügt eine Zeile an der Position der Einfügemarke ein.
Syntax:	ActiveCell.InsertRow
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertRowBreak-Methode

Funktion:	Fügt einen Zeilenumbruch über der Position der Einfügemarke ein.
Syntax:	ActiveCell.InsertRowBreak
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Italic-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Grad der kursiven Darstellung der Schrift des selektierten Bereiches.
Syntax:	Selection.Font.Italic [= ItalicExtent%]
	Parameter	Beschreibung
	ItalicExtent%	Integer-Ausdruck, der den Grad der kursiven Darstellung der Schrift des selektierten Bereiches angibt. ItalicExtent% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Bestimmt die normale Darstellung für die Schrift des selektierten Bereiches.
	1 - 10	Bestimmt die kursive Darstellung für die Schrift des selektierten Bereiches. Der Grad der kursiven Darstellung erhöht sich mit zunehmenden Wert.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
MergeCells-Methode

Funktion:	Verbindet die selektierten Zellen zu einer einzigen Zelle.
Syntax:	Selection.MergeCells
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Paste-Methode

Funktion:	Fügt den Inhalt der Zwischenablage an die Position der Einfügemarke ein.
Syntax:	ActiveCell.Paste
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ResetAttributes-Methode

Funktion:	Setzt alle Schriftattribute zurück, die dem selektierten Bereich zuvor zugewiesen wurden.
Syntax:	Selection.ResetAttributes
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SelectAll-Methode

Funktion:	Markiert die gesamte Tabelle.
Syntax:	ActiveWindow.SelectAll
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SelectColumn-Methode

Funktion:	Markiert die gesamte aktuelle Spalte.
Syntax:	ActiveWindow.SelectColumn
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SelectRow-Methode

Funktion:	Markiert die gesamte aktuelle Zeile.
Syntax:	ActiveWindow.SelectRow
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ShowDependents-Methode

Funktion:	Zeigt die Spur zu den Nachfolgern der aktuellen Zelle an.
Syntax:	ActiveCell.ShowDependents
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ShowErrors-Methode

Funktion:	Zeigt die Zellen an, die einen Fehler in der markierten Zelle hervorrufen.
Syntax:	ActiveCell.ShowErrors
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ShowPrecedents-Methode

Funktion:	Zeigt eine Spur vom Vorgänger der aktuellen Zelle zu dieser Zelle an.
Syntax:	ActiveCell.ShowPrecedents
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Size-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Schriftgröße der Schrift des selektierten Bereiches.
Syntax:	Selection.Font.Size [= SizeUnit$]
	Eigenschaft	Beschreibung
	SizeUnit$	Zeichenfolgenausdruck, der die Größe der Schrift und die Einheit der Schriftgröße angibt.
Zugriff:	Lesen und Schreiben
Für Objekt:	Font
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SortAscending-Methode

Funktion:	Sortiert die Feldinhalte des selektierten Bereiches in aufsteigender Reihenfolge.
Syntax:	Selection.SortAscending
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SortDescending-Methode

Funktion:	Sortiert die Feldinhalte des selektierten Bereiches in absteigender Reihenfolge.
Syntax:	Selection.SortDescending
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SplitCell-Methode

Funktion:	Löst den selektierten zusammengefaßten Zellbereich wieder auf.
Syntax:	Selection.SplitCell
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Underline-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Anzahl der Unterstriche der Schrift des selektierten Bereiches.
Syntax:	Selection.Font.Underline [= LineCount%]
	Parameter	Beschreibung
	LineCount%	Integer-Ausdruck, der die Anzahl der Unterstriche der Schrift des selektierten Bereiches angibt. LineCount% können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	0	Die Schrift des selektierten Bereiches wird nicht unterstrichen dargestellt.
	1	Die Schrift des selektierten Bereiches wird einmal unterstrichen dargestellt.
	2	Die Schrift des selektierten Bereiches wird zweimal unterstrichen dargestellt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font-Objekt
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SelectData-Methode

Funktion:	Selektiert den geschlossenen Datenbereich, in dem sich die Einfügemarke befindet.
Syntax:	Selection.SelectData
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ClearArrows-Methode

Funktion:	Löscht alle Detektivlinien innerhalb der aktuellen Tabelle.
Syntax:	ActiveTable.ClearArrows
Für Objekt:	ActiveTable
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ApplyAutoFormat-Methode

Funktion:	Weist dem selektierten oder dem bezeichneten Bereich das angebene Autoformat zu.
Syntax:	Selection.ApplyAutoFormat aFormatName$ oder Range(“Z1S1:Z2S2“).ApplyAutoFormat aFormatName$
	Parameter	Beschreibung
	aFormatName$	Zeichenfolgenausdruck, der die Bezeichnung des Formates angibt, das dem selektierten oder dem bezeichneten Bereich zugewiesen werden soll. aFormatName$  kann die Bezeichnungen eines im Dialog AUTOFORMAT unter FORMAT aufgeführten Formates aufnehmen.
Für Objekt:	Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
AutomaticCalculation-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Option für die automatische Berechnung.
Syntax:	ActiveWindow.AutomaticCalculation [= Switch]
	Parameter	Beschreibung
	Switch	Booleanscher Ausdruck, der angibt, ob die automatische Berechnung ein- oder ausgeschaltet werden soll:
	Wert	Beschreibung
	True	Die automatische Berechnung wird eingeschaltet.
	False	Die automatische Berechnung wird ausgeschaltet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Calculate-Methode

Funktion:	Führt eine Neuberechnung des aktuellen Fensters oder des angegebenen Dokumentes durch.
Syntax:	{ActiveWindow|Documents(n)}.Calculate
Für Objekt:	ActiveWindow, Documents(n)
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ColumnWidth-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Breite der Spalten im selektierten oder angegebenen Bereich.
Syntax:	Selection.ColumnWidth [= ColWidth]  oder Range(“Z1S1:Z2S2“).ColumnWidth [= ColWidth]
	Parameter	Beschreibung
	ColWidth	Numerischer Ausdruck, der die Breite der Spalten im selektierten oder angegebenen Bereich in TWIPS angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Color-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Farbe der Schrift im selektierten Bereich.
Syntax:	Selection.Font.Color [= Col&]
	Parameter	Beschreibung
	Col&	Long-Integer-Ausdruck, der die Farbe der Schrift im selektierten Bereich angibt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Font
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
FunctionDialog-Methode

Funktion:	Ruft den Dialog FUNKTIONSAUTOPILOT zum Einfügen von Funktionen auf.
Syntax:	Selection.FunctionDialog
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Hide-Methode

Funktion:	Blendet die angegebene Tabelle aus.
Syntax:	ActiveDocument.Hide aTableName$
	Parameter	Beschreibung
	aTableName$	Zeichenfolgenausdruck, der die Bezeichnung der Tabelle aufnimmt, die ausgeblendet werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
HideColumn-Methode

Funktion:	Blendet die Tabellenspalte aus, in der sich die Einfügemarke befindet.
Syntax:	Selection.HideColumn
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
HideRow-Methode

Funktion:	Blendet die Tabellenzeile aus, in der sich die Einfügemarke befindet.
Syntax:	Selection.HideRow
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
HorizontalAlignment-Eigenschaft

Funktion:	Bestimmt oder ermittelt die horizontale Ausrichtung des selektierten oder angegebenen Bereiches.
Syntax:	Selection.HorizontalAlignment [= AlignTyp] oder Range(“Z1S1:Z2S2“).HorizontalAlignment [= AlignTyp]
	Parameter	Beschreibung
	AlignTyp	Numerischer Ausdruck, der angibt, wie der selektierte oder angegebene Bereich ausgerichtet werden soll. AlignTyp können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	1	Der selektierte oder angegebene Bereich wird linksbündig ausgerichtet.
	2	Der selektierte oder angegebene Bereich wird zentriert ausgerichtet.
	3	Der selektierte oder angegebene Bereich wird rechtsbündig ausgerichtet.
	4	Der selektierte oder angegebene Bereich wird im Blocksatz ausgerichtet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Selection, Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Index-Eigenschaft

Funktion:	Ermittelt den Index der aktuellen Tabelle.
Syntax:	ActiveTable.Index
Zugriff:	Nur Lesen.
Für Objekt:	ActiveTable
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Insert-Methode

Funktion:	Fügt Daten in die selektierte oder angegebene Zelle ein.
Syntax:	ActiveCell.Insert [=StringName$] oder Cells.Insert [=StringName$]
	Parameter	Beschreibung
	StringName$	Zeichenfolgenausdruck, der die Daten aufnimmt, die in die Zelle eingefügt werden sollen.
Für Objekt:	ActiveCell, Cells
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertAnnotation-Methode

Funktion:	Fügt in der aktuellen Zelle eine Notiz ein.
Syntax:	ActiveCell.InsertAnnotation Date$, Author$, Text$
	Parameter	Beschreibung
	Date$	Zeichenfolgenausdruck, der das Datum der Notiz angibt.
	Author$	Zeichenfolgenausdruck, der den Namen des Autors angibt.
	Text$	Zeichenfolgenausdruck, der den Text der Notiz angibt.
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertCell-Methode

Funktion:	Fügt an der aktuellen Position der Einfügemarke eine Zelle ein.
Syntax:	ActiveCell.InsertCell Flags$
	Parameter	Beschreibung
	Flags$	Zeichenfolgenausdruck, der angibt, wie die umliegenden Zellen verschoben werden sollen. Flags$ können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	V	Die Zellen werden nach unten verschoben.
	>	Die Zellen werden nach rechts verschoben.
	R	Eine vollständige Zeile wird eingefügt.
	C	Eine vollständige Spalte wird eingefügt.
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
InsertObjectStarChart-Methode

Funktion:	Fügt ein StarChart-Diagramm in die aktuelle Tabelle ein, das aus dem selektierten oder angegebenen Bereich erzeugt wird.
Syntax:	Range(“Z1S1:Z2S2“).InsertObjectStarChart RowHeaders, ColHeaders, InNewTable
	Parameter	Beschreibung
	RowHeaders	Booleanscher Ausdruck, der angibt, ob die erste Spalte des angegebenen Bereiches als Beschriftung verwendet werden soll:
	Wert	Beschreibung
	True	Erste Spalte wird als Beschriftung verwendet.
	False	Erste Spalte wird nicht als Beschriftung verwendet.
	ColHeaders	Booleanscher Ausdruck, der angibt, ob die erste Zeile des angegebenen Bereiches als Beschriftung verwendet werden soll:
	Wert	Beschreibung
	True	Erste Zeile wird als Beschriftung verwendet.
	False	Erste Zeile wird nicht als Beschriftung verwendet.
	InNewTable	Booleanscher Ausdruck, der angibt, ob das Diagramm in eine neue Tabelle eingefügt werden soll:
	Wert	Beschreibung
	True	Das Diagramm wird in eine neue Tabelle eingefügt.
	False	Das Diagramm wird nicht in eine neue Tabelle eingefügt.
Für Objekt:	Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
JumpToNextTable-Methode

Funktion:	Springt zur nächsten Tabelle im aktuellen Dokument.
Syntax:	ActiveWindow.JumpToNextTable
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
JumpToPrevTable-Methode

Funktion:	Springt zur vorangehenden Tabelle im aktuellen Dokument.
Syntax:	ActiveWindow.JumpToPrevTable
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Move-Methode

Funktion:	Verschiebt oder kopiert die aktuelle Tabelle in das angegebene Dokument.
Syntax:	ActiveTable.Move DocName$, Copy, Index%
	Parameter	Beschreibung
	DocName$	Zeichenfolgenausdruck, der die Bezeichnung des Dokumentes angibt, in das die Tabelle kopiert oder verschoben werden soll.
	Copy	Booleanscher Ausdruck, der angibt, ob die Tabelle kopiert oder verschoben werden soll:
	Wert	Beschreibung
	True	Die Tabelle wird kopiert.
	False	Die Tabelle wird verschoben.
	Index%	Integer-Ausdruck, der die Nummer der Tabelle bestimmt, vor der die aktuelle Tabelle eingefügt werden soll. Der Wert 0 gibt an, daß die Tabelle an das Ende des Dokumentes kopiert oder verschoben werden soll.
Für Objekt:	ActiveTable
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Name-Eigenschaft

Funktion:	Weist der aktuellen Tabelle eine Bezeichnung zu.
Syntax:	ActiveTable.Name [= TabName$]
	Parameter	Beschreibung
	TabName$	Zeichenfolgenausdruck, der die Bezeichnung aufnimmt, die der aktuellen Tabelle zugewiesen werden soll.
Zugriff:	Lesen und Schreiben.
Für Objekt:	ActiveTable
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
NumberFormatCurrency-Methode

Funktion:	Weist dem Zellinhalt des selektierten oder angegebenen Bereiches das aktuelle Währungsformat zu.
Syntax:	Selection.NumberFormatCurrency oder Range(“Z1S1:Z2S2“).NumberFormatCurrency
Für Objekt:	Range, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
NumberFormatPercent-Methode

Funktion:	Weist dem Zellinhalt des selektierten oder angegebenen Bereiches das aktuelle Prozentformat zu.
Syntax:	Selection.NumberFormatPercent oder Range(“Z1S1:Z2S2“).NumberFormatPercent
Für Objekt:	Range, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
PageDialog-Methode

Funktion:	Ruft den Dialog zum Formatieren einer Seite auf.
Syntax:	ActiveTable.PageDialog
Für Objekt:	ActiveTable
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Protect-Methode

Funktion:	Schützt die aktuelle Tabelle oder hebt den Schutz der aktuellen Tabelle auf.
Syntax:	ActiveTable.Protect Password$, Protect
	Parameter	Beschreibung
	Password$	Zeichenfolgenausdruck, der das Paßwort angibt, das den Zugriff auf die aktuelle Tabelle ermöglicht.
	Protect	Booleanscher Ausdruck, der angibt, ob die Tabelle geschützt oder der Tabellenschutz aufgehoben werden soll:
	Wert	Beschreibung
	True	Die Tabelle wird geschützt.
	False	Der Tabellenschutz wird aufgehoben.
Für Objekt:	ActiveTable
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
RowHeight-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Höhe der selektierten oder angegebenen Tabellenzeile.
Syntax:	Selection.RowHeight [= TabRowHeight] oder Range(“Z1S1:Z2S2“).RowHeight [= TabRowHeight]
	Parameter	Beschreibung
	TabRowHeight	Numerischer Ausdruck, der die Höhe der selektierten oder angegebenen Tabellenzeile in TWIPS bestimmt.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Range, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Select-Eigenschaft

Funktion:	Selektiert den angegebenen Bereich.
Syntax:	Range(“Z1S1:Z2S2“).Select
Zugriff:	Nur Schreiben.
Für Objekt:	Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SetOptimalColumnWidth-Methode

Funktion:	Berechnet für den selektierten oder angegebenen Bereich die optimale Spaltenbreite und weist diese dem Bereich zu.
Syntax:	Selection.SetOptimalColumnWidth aExtraWidth oder Range(“Z1S1:Z2S2“).SetOptimalColumnWidth aExtraWidth
	Parameter	Beschreibung
	aExtraWidth	Integer-Ausdruck, der die Breite angibt, die dem selektierten oder angegebenen Bereich zusätzlich zur optimalen Spaltenbreite zugewiesen werden soll.
Für Objekt:	Range, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
SetOptimalRowHeight-Methode

Funktion:	Berechnet für den selektierten oder angegebenen Bereich die optimale Zeilenhöhe und weist diese dem Bereich zu.
Syntax:	Selection.SetOptimalRowHeight aExtraHeight oder Range(“Z1S1:Z2S2“).SetOptimalRowHeight aExtraHeight
	Parameter	Beschreibung
	aExtraHeight	Integer-Ausdruck, der die Höhe angibt, die dem selektierten oder angegebenen Bereich zusätzlich zur optimalen Zeilenhöhe zugewiesen werden soll.
Für Objekt:	Range, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Show-Methode

Funktion:	Stellt die angegebene Tabelle, die zuvor ausgeblendet wurde, wieder dar.
Syntax:	ActiveWindow.Show aTableName$
	Parameter	Beschreibung
	aTableName$	Zeichenfolgenausdruck, der die Bezeichnung der Tabelle angibt, die wieder angezeigt werden soll.
Für Objekt:	ActiveWindow
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ShowColumn-Methode

Funktion:	Stellt die im selektierten oder angegebenen Bereich enthaltenen Tabellenspalten, die zuvor ausgeblendet wurden, wieder dar.
Syntax:	Selection.ShowColumn oder Range(“Z1S1:Z2S2“).ShowColumn
Für Objekt:	Range, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
ShowRow-Methode

Funktion:	Stellt die im selektierten oder angegebenen Bereich enthaltenen Tabellenzeilen, die zuvor ausgeblendet wurden, wieder dar.
Syntax:	Selection.ShowColumn oder Range(“Z1S1:Z2S2“).ShowRow
Für Objekt:	Selection, Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
StarChartDialog-Methode

Funktion:	Ruft den Dialog zum Einfügen von StarChart-Diagrammen auf.
Syntax:	Selection.StarChartDialog
Für Objekt:	Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
TextValue-Eigenschaft

Funktion:	Ermittelt eine in der selektierten Zelle enthaltene Zeichenfolge.
Syntax:	Selection.TextValue oder ActiveCell.TextValue
Zugriff:	Nur Lesen.
Für Objekt:	ActiveCell, Selection
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
UpdateChart-Methode

Funktion:	Aktualisiert das im selektierten oder angegebenen Bereich enthaltene StarChart-Diagramm.
Syntax:	Selection.UpdateChart AllCharts oder Range(“Z1S1:Z2S2“).UpdateChart AllCharts
	Parameter	Beschreibung
	AllCharts	Booleanscher Ausdruck, der angibt, ob die Diagramme aller Tabellen oder nur der aktiven Tabelle aktualisiert werden sollen:
	Wert	Beschreibung
	True	Die Diagramme aller Tabellen werden aktualisiert.
	False	Die Diagramme der aktiven Tabelle werden aktualisiert.
Für Objekt:	Document
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
Value-Eigenschaft

Funktion:	Ermittelt einen in der selektierten Zelle enthaltenen numerischen Wert.
Syntax:	ActiveCell.Value
Zugriff:	Nur Lesen.
Für Objekt:	ActiveCell
Siehe auch:	StarCalc Eigenschaften und Methoden


StarCalc Eigenschaften und Methoden
VerticalAlignment-Eigenschaft

Funktion:	Bestimmt oder ermittelt die vertikale Ausrichtung des selektierten oder angegebenen Bereiches.
Syntax:	Selection.VerticalAlignment [= AlignTyp] oder Range(“Z1S1:Z2S2“).VerticalAlignment [= AlignTyp]
	Parameter	Beschreibung
	AlignTyp	Numerischer Ausdruck, der angibt, wie der selektierte oder angegebene Bereich ausgerichtet werden soll. AlignTyp können die folgenden Werte zugewiesen werden:
	Wert	Beschreibung
	1	Der selektierte oder angegebene Bereich wird an den oberen Zellbegrenzungen ausgerichtet.
	2	Der selektierte oder angegebene Bereich wird zentriert ausgerichtet.
	3	Der selektierte oder angegebene Bereich wird an den unteren Zellbegrenzungen ausgerichtet.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Selection, Range
Siehe auch:	StarCalc Eigenschaften und Methoden


StarOffice Eigenschaften und Methoden
Ereignisse & Methoden des StarOffice

Application

AboutDialog-Methode

ActiveHelp-Eigenschaft

Application-Objekt

Caption-Eigenschaft

ConfigureToolboxVisible-Eigenschaft

CurrentDate-Eigenschaft

CurrentTime-Eigenschaft

DefaultFilePath-Eigenschaft

DesignerDialog-Eigenschaft

DocumentManager-Methode

ExtendedHelp-Eigenschaft

FullName-Eigenschaft

FullScreen-Eigenschaft

FunctionBarVisible-Eigenschaft

Height-Eigenschaft

HelperDialog-Eigenschaft

HelpTip-Eigenschaft

Interactive-Eigenschaft

Item-Eigenschaft

Left-Eigenschaft

LoadAccel-Methode;

LoadConfiguration-Methode;

LoadEvent-Methode;

MailReadDialog-Eigenschaft

MailReceipt-Eigenschaft

Maximized-Eigenschaft

MetricUnit-Eigenschaft

Minimized-Eigenschaft

Name-Eigenschaft

ObjectBarVisible-Eigenschaft

OnActivate-Eigenschaft

OnClose-Eigenschaft

OnCreate-Eigenschaft

OnDeactivate-Eigenschaft

OnDocActivate-Eigenschaft

OnDocClose-Eigenschaft

OnDocCreate-Eigenschaft

OnDocDeactivate-Eigenschaft

OnDocOpen-Eigenschaft

OnDocPrint-Eigenschaft

OnDocSave-Eigenschaft

OnDocSaveAs-Eigenschaft

OnOpen-Eigenschaft

OnPrint-Eigenschaft

OnQuit-Eigenschaft

Organizer-Methode

Parent-Eigenschaft

Path-Eigenschaft

PathSettings-Eigenschaft

Quit-Methode

Recording-Eigenschaft

Remove-Methode

SaveConfiguration-Methode

SaveSettings-Eigenschaft

SaveSettings-Objekt

SearchDialog-Eigenschaft

Selection-Eigenschaft

StatusBar-Eigenschaft

StatusBarVisible-Eigenschaft

StopRecording-Methode

ToolBarVisible-Eigenschaft

Top-Methode

UndoCount-Eigenschaft

Visible-Eigenschaft

Width-Methode

Dokument

Parent-Eigenschaft

Path-Eigenschaft

Name-Eigenschaft

Activate-Methode

Close-Methode

DocumentInfo-Eigenschaft

DocumentInfo-Objekt

Document-Objekt

Documents-Collection

IsPrinting-Eigenschaft

Open-Methode

PrintDefault-Methode

Print-Methode

PrintOut-Methode

ReadOnly-Eigenschaft

Remove-Methode

SaveAs-Methode

SaveAsTemplate-Methode

Saved-Eigenschaft

Save-Methode

Title-Eigenschaft

Add-Methode

Windows

Add-Methode

Remove-Methode

Close-Methode

Activate-Methode

Minimized-Eigenschaft

FullName-Eigenschaft

Top-Methode

Width-Methode

ArrangeHorizontal-Methode, ArrangeVertical-Methode

ArrangeIcons-Methode

Cascade-Methode

Tile-Methode

Window-Objekt

Windows-Collection

ActivWindow

Height-Eigenschaft

ClearHistory-Methode

ConfigureDialog-Methode

Optimize-Methode

RedoAction-Eigenschaft

Redo-Methode

RepeatAction-Eigenschaft

UndoAction-Eigenschaft


StarOffice Eigenschaften und Methoden
AboutDialog-Methode

Funktion:	Ruft den Info-Dialog eines StarOffice-Programms auf.
Syntax:	Application.AboutDialog
Für Objekt	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Activate-Methode

Funktion:	Erklärt ein geöffnetes Dokument zum aktiven (im Vordergrund stehenden und bearbeitbaren) Dokument.
Syntax:	ActiveDocument.Activate
Für Objekt	Document-Objekt, Windows-Collection, [unbenannt 1:1]

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ActiveHelp-Eigenschaft

Funktion:	Schaltet die aktive Hilfe ein (True) oder aus (False) oder ermittelt, ob die aktive Hilfe eingeschaltet ist oder nicht.
Syntax:	Application.ActiveHelp[=(True|False)]
Zugriff:	Lesbar und schreibbar.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Add-Methode

Funktion:	Fügt ein Objekt einer Collection hinzu.
Syntax:	Documents-Collection: Documents (n).Add [(TemplateRegion$,TemplateName$] Windows-Collection: Windows (n).Add
Wird die Documents-Collection um ein Objekt erweitert, so hat das im jeweiligen StarOffice-Programm das Erstellen eines neuen Dokumentes zur Folge. Angewendet auf die Documents-Collection können daher zwei Parameter übergeben werden, die, wie beim Erstellen eines neuen Dokumentes im Programm, die Angabe von Dokumentvorlagenbereich und -vorlagenname erlauben.

Angewendet auf die Window-Collcetion wird ein weiteres Fenster geöffnet, in dem ebenfalls der Inhalt des zuvor aktiven Dokuments dargestellt wird.

	Parameter	Beschreibung
	TemplateRegion$	Zeichenkettenausdruck, der bestimmt, aus welchem Vorlagenbereich die Dokumentvorlage bestimmt werden soll.
	TemplatName$	Zeichenkettenausdruck, der den Namen der Dokumentvorlage bestimmt.
Für Objekt:	Documents-Collection, Windows-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Application-Objekt

Funktion:	Beinhaltet die eigentliche Applikation als Objekt und erlaubt damit die Steuerung der Applikation durch Eigenschaften und Methoden.
Eigenschaften:	ActiveDocument-Eigenschaft, ActiveHelp-Eigenschaft, ActiveWindow-Eigenschaft, Application-Eigenschaft, Caption-Eigenschaft, ConfigureToolboxVisible-Eigenschaft, CurrentDate-Eigenschaft, CurrentTime-Eigenschaft, DefaultFilePath-Eigenschaft, DesignerDialog-Eigenschaft, Documents-Eigenschaft, ExtendedHelp-Eigenschaft, FullName-Eigenschaft, FullScreen-Eigenschaft, FunctionBarVisible-Eigenschaft, Height-Eigenschaft, HelperDialog-Eigenschaft, HelpTip-Eigenschaft, Interactive-Eigenschaft, Left-Eigenschaft, MailReadDialog-Eigenschaft, MailReceipt-Eigenschaft, Maximized-Eigenschaft, MetricUnit-Eigenschaft, Minimized-Eigenschaft, Name-Eigenschaft, ObjectBarVisible-Eigenschaft, OnDocActivate-Eigenschaft, OnDocClose-Eigenschaft, OnDocCreate-Eigenschaft, OnDocDeactivate-Eigenschaft, OnDocOpen-Eigenschaft, OnDocPrint-Eigenschaft, OnDocSave-Eigenschaft, OnDocSaveAs-Eigenschaft, OnQuit-Eigenschaft, OnStart-Eigenschaft, Parent-Eigenschaft, Path-Eigenschaft, PathSettings-Eigenschaft, Recording-Eigenschaft, SaveSettings-Eigenschaft, SearchDialog-Eigenschaft, Selection-Eigenschaft, StatusBar-Eigenschaft, StatusBarVisible-Eigenschaft, ToolBarVisible-Eigenschaft, Top-Eigenschaft, UndoCount-Eigenschaft, Visible-Eigenschaft, Width-Eigenschaft, Windows-Eigenschaft
Methoden:	AboutDialog-Methode, DocumentManager-Methode, LoadAccel-Methode, LoadConfiguration-Methode, LoadEvent-Methode, LoadMenu-Methode, LoadStatusBar-Methode, LoadToolbox-Methode, Quit-Methode, SaveConfiguration-Methode, StopRecording-Methode,
Beispiel:	Application.AboutDialog ‘Zeigt den About-Dialog an
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ArrangeHorizontal-Methode; ArrangeVertical-Methode

Funktion:	Ordnet die nicht als Symbol dargestellten Fenster horizontal bzw. vertikal an.
Syntax:	Windows(n).ArrangeHorizontal Windows(n).ArrangeVertical
Für Objekt	Windows-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ArrangeIcons-Methode

Funktion:	Ordnet die als Sinnbilder dargestellten Dokumente neu an.
Syntax:	Windows(n).ArrangeIcons
Für Objekt	Windows-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Caption-Eigenschaft

Funktion:	Ermittelt die Titelzeile des Programmfensters.
Syntax:	Application.Caption
Zugriff:	Nur Lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Cascade-Methode

Funktion:	Ordnet die nicht als Symbol dargestellten Fenster hintereinander an.
Syntax:	Windows(n).Cascade
Für Objekt	Windows-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ClearHistory-Methode

Funktion:	Löscht die Historie der Aktionen, die über das Menü BEARBEITEN/RÜCKGÄNGIG rückgängig gemacht werden können und gibt somit Speicherplatz frei.
Syntax:	ActiveWindow.ClearHistory
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Close-Methode

Funktion:	Schließt ein Dokument, eine View eines Dokumentes oder schließt alle geöffneten Dokumente.
Syntax:	ActiveDocument.Close [SaveChanges[, FileName$]] {Activewindow}.Close , Windows.Close
Für Objekt	Document-Objekt, Window-Objekt
	Parameter	Beschreibung
	SaveChanges	Boolscher Ausdruck, der bestimmt, ob die Datei gespeichert werden soll (True) oder nicht (False).
	FileName$	Zeichenkettenausdruck, der den Dateinamen bestimmt, unter dem die Datei gespeichert werden soll.
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ConfigureDialog-Methode

Funktion:	Ruft den Dialog ANPASSEN auf, mit dessen Hilfe die Eingabe- und Auswahlelemente, sowie die Ereignisse eingerichtet werden.
Syntax:	ActiveWindow.ConfigureDialog
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ConfigureToolboxVisible-Eigenschaft

Funktion:	Schaltet den Dialog zum Anpassen der Symbolleisten ein (True) oder aus (False) oder ermittelt, ob der Dialog z.Z. angezeigt wird oder nicht.
Syntax:	Application.ConfigureToolboxVisible[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
CurrentDate-Eigenschaft

Funktion:	Ermittelt das aktuelle Tagesdatum im Format, das durch die Systemeinstellung vorgegeben ist.
Syntax:	Application.CurrentDate
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
CurrentTime-Eigenschaft

Funktion:	Ermittelt die aktuelle Uhrzeit im Format, das durch die Systemeinstellung vorgegeben ist
Syntax:	Application.CurrentTime
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
DefaultFilePath-Eigenschaft

Funktion:	Bestimmt oder ermittelt den Vorgabepfad für alle Dokument-Dateidialoge.
Syntax:	Application.DefaultFilePath[=Path$]
	Parameter	Beschreibung
	Path$	Beliebiger Zeichenkettenausdruck, der den Pfadnamen als Vorgabepfad für alle Dateidialoge beinhaltet.
Zugriff:	Lesbar und Schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
DesignerDialog-Eigenschaft

Funktion:	Schaltet den Gestalter-Dialog ein (True) oder aus (False) oder ermittelt, ob der Gestalter-Dialog dargestellt ist oder nicht.
Syntax:	Application.DesignerDialog[=(True|False)]
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
DocumentInfo-Eigenschaft

Funktion:	Liefert die aktuelle Dokumenteninfo eines Dokumentes als DOCUMENTINFO-Objekt zurück.
Syntax:	ActiveDocument.DocumentInfo
Zugriff:	Nur lesbar
Für Objekt:	Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
DocumentInfo-Objekt

Funktion:	Beinhaltet alle Informationen über die Herkunft eines Dokumentes (Dokumenteninfo).
Eigenschaften:	Das DocumentsInfo-Objekt verfügt über die folgenden Eigenschaften, die alle Zeichenketten erwarten bzw. zurückliefern und die die verschiedenen Parameter der Dokumenteninfo definieren, so, wie man es bei der Bedienung der Applikation von dem Befehl DATEI/DOKUMENTENINFO kennt. Die folgende Tabelle zeigt, welche Eigenschaften es gibt, ob sie nur lesbar sind und welche Parameter sie definieren:
	Eigenschaft	Zugriff *=nur lesen	Beschreibung
	Author	*	Der Name des Autors des Dokumentes
	CreationDate	*	Datum der Dokumenterstellung im Format, das durch die Systemeinstellung vorgegeben ist
	CreationTime	*	Uhrzeit der Dokumenterstellung im Format, das durch die Systemeinstellung vorgegeben ist
	Description		Text, der das Dokument beschreibt
	EditTime	*	Die Bearbeitungszeit des Dokumentes in Stunden, Minuten und Sekunden, dargestellt in dem Format, das durch die Systemeinstellung vorgegeben ist
	FileName	*	Der Dateinamen des Dokumentes inclusive Pfad
	KeyWords		Schlüsselworte zum Text durch Komma oder Semikolon getrennt
	ModificationAuthor	*	Der Name des Autors des Dokumentes, der das Dokument zuletzt bearbeitet hat.
	ModificationDate	*	Datum der letzten Dokumentenaktualisierung im Format, das durch die Systemeinstellung vorgegeben ist
	ModificationTime	*	Uhrzeit der letzten Dokumentenaktualisierung im Format, das durch die Systemeinstellung vorgegeben ist
	Revision	*	Versionsnummer des Dokumentes
	Subject		Das Thema des Dokumentes
	Template	*	Die Dokumentvorlage des Dokumentes
	Title		Der Titel des Dokumentes
Ferner kennt das DocumentsInfo-Objekt die Eigenschaften Application-Eigenschaft, Name-Eigenschaft und Parent-Eigenschaft, die an den entsprechenden Stellen beschrieben sind.

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
DocumentManager-Methode

Funktion:	Öffnet den Dokumentmanager.
Syntax:	Application.DocumentManager
Für Objekt	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Document-Objekt

Funktion:	Dieses Objekt erlaubt den Zugriff auf ein geöffnetes Dokument eines StarOffice-Programms.
Eigenschaften:	Title-Eigenschaft, Application-Eigenschaft, DocumentInfo-Eigenschaft, FullName-Eigenschaft, IsPrinting-Eigenschaft, Parent-Eigenschaft
Methoden:	Activate-Methode, Close-Methode, Print-Methode, PrintOut-Methode, Save-Methode, SaveAs-Methode, SaveAsTemplate-Methode
Beispiel:	[unbenannt1].SaveAs „Dateiname“ ‘Ansprechen direkt Application.ActiveDocument.SaveAs „Dateiname“ ‘Ansprechen über Eigenschaft
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Documents-Collection

Funktion:	Die Documents-Collection beinhaltet alle in einem StarOffice-Programm geöffneten Dokumente als Document-Objekt.
Eigenschaften:	Application-Eigenschaft, Parent-Eigenschaft
Methoden:	Add-Methode, Item-Methode, Open-Methode, Remove-Methode
Beispiel:	Documents(3) ‘Dokumentobjekt ansprechen durch Index Documents(„unbenannt1“) ‘Dokumentobjekt ansprechen durch Namen
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ExtendedHelp-Eigenschaft

Funktion:	Schaltet die kontextsensitive Hilfe ein (True) oder aus (False) oder ermittelt, ob sie eingeschaltet ist oder nicht.
Syntax:	Application.ExtendedHelp[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
FullName-Eigenschaft

Funktion:	Ermittelt den Dateinamen des dem Objekt entsprechenden StarOffice-Programms bzw. Dokuments inclusive Pfadnamens.
Syntax:	{Application | Activewindow}.FullName
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt, Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
FullScreen-Eigenschaft

Funktion:	Maximiert (True) oder normalisiert (False) die Arbeitsfläche des dem Objekt entsprechenden StarOffice-Programmfensters oder ermittelt, ob die Arbeitsfläche maximiert ist, oder nicht. Maximieren in diesem Zusammenhang bedeutet die Darstellung der Arbeitsfläche als Vollbild – also ohne Menüs, Funktion- und Objektleisten, etc.
Syntax:	Application.FullScreen[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
FunctionBarVisible-Eigenschaft

Funktion:	Schaltet die Funktionsleiste ein (True) oder aus (False) oder ermittelt, ob die Funktionsleiste eingeschaltet ist oder nicht.
Syntax:	Application.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Height-Eigenschaft

Funktion:	Definiert oder ermittelt die Höhe des Fensters, das durch das entsprechende Objekt bestimmt wird.
Syntax:	{Application | Activewindow}.Height[=Height&]
	Parameter	Beschreibung
	Height&	Beliebiger Long-Integer-Ausdruck, der die neue Höhe des Fensters in Pixeln festlegt.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt, Window-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
HelperDialog-Eigenschaft

Funktion:	Schaltet das Helferlein ein (True) oder aus (False) oder ermittelt, ob das Helferlein eingeschaltet ist oder nicht.
Syntax:	Application.HelperDialog[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
HelpTip-Eigenschaft

Funktion:	Schaltet die Tiphilfe ein (True) oder aus (False) oder ermittelt, ob die Tiphilfe eingeschaltet ist oder nicht.
Syntax:	Application.HelpTip[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Interactive-Eigenschaft

Funktion:	Schaltet die die Möglichkeit zur Bedienung der Applikation ein (True) oder aus (False) oder ermittelt, ob die die Möglichkeit zur Bedienung der Applikation eingeschaltet ist oder nicht.
Syntax:	Application.Interactive[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Wichtiger Hinweis! Sorgen Sie dafür, daß Ihr Programm unbedingt die „Bedienbarkeit“ des Programms wiederherstellt, da Sie anderenfalls nicht in die IDE zurückkehren können – denn diese ist ebenfalls nicht bedienbar, solange Interaktive auf False gesetzt ist.

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
IsPrinting-Eigenschaft

Funktion:	Ermittelt, ob das dem Objekt entsprechende Dokument z.Z. ausgedruckt wird (Eigenschaft ist True) oder nicht (False).
Syntax:	ActiveDocument.IsPrinting
Zugriff:	Nur lesbar
Für Objekt:	Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Item-Eigenschaft

Funktion:	Liefert ein bestimmtes Objekt einer Collection zurück, das wahlweise durch einen Index oder durch eine Zeichenkette genau identifiziert werden kann. Das Eigenschaftswort .ITEM ist optional, muß also nicht mit angegeben werden.
Syntax:	{Application | Activewindow}[.Item](Index%) oder {Application | Activewindow}[.Item](Zeichen$) oder
Zugriff:	Nur lesbar
	Parameter	Beschreibung
	Index%	Nummer des Objektes innerhalb der Collection, daß ermittelt werden soll (beginnend mit 1).
	Zeichen$	Zeichenkette, die ein bestimmtes Objekt innerhalb einer Collection eindeutig identifizieren kann.
Für Objekt:	Documents-Collection, Windows-Collection
Beispiel:	Die folgende Schleife ermittelt die Dokumentennamen aller geöffneten Dokumente und gibt sie aus. If Documents.Count>0 then ‘Wieviele Fenster sind geöffnet? For z%=1 to Documents.Count ‘Dokumentnamen und -pfad ermitteln text$=Documents.Item(z%).FullName ‘alternative geht natürlich auch text$=Documents(z%).FullName Next z% End If
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Left-Eigenschaft

Funktion:	Definiert oder ermittelt die horizontale Position des Fensters, das durch das entsprechende Objekt bestimmt wird.
Syntax:	{Application | Activewindow}.Left[=Left&]
	Parameter	Beschreibung
	Left&	Beliebiger Long-Integer-Ausdruck, der die neue horizontale Position des Fensters festlegt.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt, Window-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
LoadAccel-Methode; LoadConfiguration-Methode, LoadEvent-Methode; LoadMenu-Methode; LoadStatusBar-Methode; LoadToolBox-Methode

Funktion:	Lädt aus einer Konfigurationsdatei (*.CFG) die für einen Teil der Applikation oder für die gesamte Applikation relevanten Konfigurationsdaten.
Syntax:	Application.Loadxxx FileName$
	Parameter	Beschreibung
	FileName$	Dateiname einer StarOffice-Konfigurationsdatei (*.CFG). Es gelten folgende Methoden:
	Methode	Bedeutung
	LoadAccel	Aus einer Konfigurationsdatei wird nur die Tastaturbelegung geladen und verwendet.
	LoadConfiguration	Die gesamte Konfigurationsdatei wird geladen und verwendet.
	LoadEvent	Nur die Ereignisdefinition wird aus der angegebenen Konfigurationsdatei geladen und verwendet.
	LoadMenu	Aus einer Konfigurationsdatei wird nur die Pull-Down-Menü-Belegung geladen und verwendet.
	LoadStatusBar	Aus einer Konfigurationsdatei wird nur die Statusleisten-Konfiguration geladen und verwendet.
	LoadToolBox	Aus einer Konfigurationsdatei wird nur die Funktionsleisten-Definition geladen und verwendet.
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
MailReadDialog-Eigenschaft

Funktion:	Schaltet die Anzeige des Posteingangkorbes ein (True) oder aus (False) oder ermittelt, ob die Anzeige des Posteingangkorbes eingeschaltet ist oder nicht.
Syntax:	Application.MalReadDialog
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
MailReceipt-Eigenschaft

Funktion:	Ermittelt, ob im Posteingang neue Nachrichten vorhanden sind.
Syntax:	Application.MailReceipt [= IsMail]
	Parameter	Beschreibung
	IsMail	Booleanscher Ausdruck, der angibt, ob im Posteingang neue Nachrichten vorhanden sind:
	Wert	Beschreibung
	True	Im Posteingang sind neue Nachrichten enthalten.
	False	Im Posteingang sind keine neuen Nachrichten enthalten.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Maximized-Eigenschaft

Funktion:	Maximiert (True) oder normalisiert (False) das dem Objekt entsprechende Fenster oder ermittelt, ob das Fenster maximiert ist, oder nicht.
Syntax:	Application.Maximized[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt, Window-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
MetricUnit-Eigenschaft

Funktion:	Bestimmt oder ermittelt die Maßeinheit (Konstanten: SOCM, SOPICA, SOPOINT, SOINCH), die in Dialogboxen verwenden werden soll.
Syntax:	Application.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Minimized-Eigenschaft

Funktion:	Minimiert (True) oder normalisiert (False) das dem Objekt entsprechende Fenster oder ermittelt, ob das Fenster minimiert ist, oder nicht.
Syntax:	Application.Minimized[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt, Window-Objekt

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Name-Eigenschaft

Funktion:	Ermittelt den Namen des Applikationsobjektes bzw. ermittelt oder bestimmt den Namen des Dokumentes bei einem DocumentInfo- oder Window-Objekt.
Syntax:	Application.Name bzw. ActiveDocument.Name
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt, DocumentInfo-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ObjectBarVisible-Eigenschaft

Funktion:	Schaltet die Objektleiste ein (True) oder aus (False) oder ermittelt, ob die Objektleiste eingeschaltet ist oder nicht.
Syntax:	Application.ObjectBarVisible[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnActivate-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein Dokument aktiviert wird (d.H. sein Fenster in den Vordergrund geholt wird).
Syntax:	Application.OnActivate Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnClose-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein Dokument geschlossen wird.
Syntax:	Application.OnClose Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnCreate-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein Dokument neu erstellt wird.
Syntax:	Application.OnCreate Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDeactivate-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein anderes Dokument in den Vordergrund geholt wird (und das aktuelle Dokument also den Fokus verliert).
Syntax:	Application.OnDeactivate Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocActivate-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, wenn ein Dokument aktiviert wird.
Syntax:	Application.OnDocActivate [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocClose-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, wenn ein Dokument geschlossen wird.
Syntax:	Application.OnDocClose [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocCreate-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, sobald ein neues Dokument erzeugt wird.
Syntax:	Application.OnDocCreate [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocDeactivate-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, wenn ein Dokument deaktiviert wird.
Syntax:	Application.OnDocDeactivate [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocOpen-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, sobald ein Dokument geöffnet wird.
Syntax:	Application.OnDocOpen [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocPrint-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, wenn ein Dokument gedruckt wird.
Syntax:	Application.OnDocPrint [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocSave-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, sobald ein Dokument gespeichert wird.
Syntax:	Application.OnDocSave [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnDocSaveAs-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, sobald ein Dokument gespeichert wird.
Syntax:	Application.OnDocSave [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnOpen-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein Dokument geöffnet wird.
Syntax:	Application.OnOpen Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnPrint-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein Dokument ausgedruckt wird.
Syntax:	Application.OnPrint Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnQuit-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, sobald die Applikation beendet wird.
Syntax:	Application.OnQuit [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnSave-Eigenschaft; OnSaveAs-Eigenschaft

Funktion:	Ermittelt oder definiert, welches Makro in welchem Modul und in welcher Bibliothek automatisch aufgerufen wird, wenn ein Dokument gespeichert bzw. unter einem bestimmten Namen gespeichert wird.
Syntax:	Application.OnSave Makro$ Application.OnSaveAs Makro$
	Parameter	Beschreibung
	Makro$	Zeichenkettenausdruck, der den Makronamen in folgendem Format enthält: Makroname(Bibliothekname.Modulname)
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
OnStart-Eigenschaft

Funktion:	Bestimmt oder ermittelt das Modul und die Bezeichnung des Makros, das ausgeführt werden soll, sobald die Applikation gestartet wird.
Syntax:	Application.OnStart [= MacroName$(Library$.Modul$)]
	Parameter	Beschreibung
	MacroName$	Zeichenfolgenausdruck, der die Bezeichnung des Makros aufnimmt, das ausgeführt werden soll, sobald die Applikation gestartet wird.
	Library$	Zeichenfolgenausdruck, der die Bezeichnung der Bibliothek angibt, in der das Makro enthalten ist.
	Modul$	Zeichenfolgenausdruck, der die Bezeichnung des Moduls angibt, in dem das Makro enthalten ist.
Zugriff:	Lesen und Schreiben.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Open-Methode

Funktion:	Öffnet ein auf einem Datenträger bereits vorhandenes Dokument.
Syntax:	{Application | Activewindow}.Open (FileName$, FilterName$, OpenFlags$, FilterFlags$)
	Parameter	Beschreibung
	FileName$	Beliebiger Zeichenkettenausdruck, der den Dateinamen der zu öffnenden Datei bestimmt.
	FilterName$	Zeichenfolgenausdruck, der die Bezeichnung des Textfilters angibt, mit dem das angegebene Dokument geöffnet werden soll.
	OpenFlags$	Zeichenkettenausdruck, der den Zugriffsmodus bestimmt (H=Hidden, C=Convert, R=Readonly).
	FilterFlags$	Applikationsspezifische Filterangabe.
Für Objekt	Documents-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Optimize-Methode

Funktion:	Weist dem aktuellen Fenster die optimale Größe zu.
Syntax:	ActiveWindow.Optimize
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Organizer-Methode

Funktion:	Ruft den Dialog zum Verwalten von Dokumentvorlagen auf.
Syntax:	Application.Organizer
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


Parent-Eigenschaft

Funktion:	Liefert das Objekt zurück, aus dem das abgefragte Objekt abgeleitet ist. (Die PARENT-Eigenschaft des DOCUMENT-Objekt ist beispielsweise das APPLICATION-Object, da das DOCUMENT-Objekt aus dem APPLICATION-Objekt abgeleitet ist. Das APPLICATION-Objekt ist also sozusagen das „Eltern“-Objekt.)
Syntax:	Application.Parent
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt, Document-Objekt, DocumentInfo-Objekt, PathSettings-Objekt, SaveSettings-Objekt, Window-Objekt, Windows-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Path-Eigenschaft

Funktion:	Ermittelt den Datei-Pfad des jeweiligen StarOffice-Programms.
Syntax:	Application.Path oder ActiveDocument.Path
Zugriff:	Nur lesbar
Für Objekt:	Document-Objekt, Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
PathSettings-Eigenschaft

Funktion:	Liefert die aktuellen Pfadeinstellungen für die verschiedenen Module eines StarOffice-Programms als PATHSETTINGS-Objekt zurück.
Syntax:	Application.PathSettings
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Beispiel:	Um z.B. von StarWriter aus „C:\STAROFFICE\DICT“ als Pfad zu bestimmen, in dem die Wörterbücher von StarWriter abgelegt sind, verwenden Sie das folgende Konstrukt: Application.PathSettings.Dictonary=“C:\STAROFFICE\DICT“
Siehe auch:	PathSettings-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
PathSettings-Objekt

Funktion:	Beinhaltet die Pfade aller Module einer Applikation.
Eigenschaften:	Das PathSettings-Objekt verfügt über die folgenden Eigenschaften, die alle samt Zeichenketten erwarten bzw. zurückliefern und die die Pfade der verschiedenen Module festlegen, so, wie man es bei der Bedienung der Applikation von dem Befehl EXTRAS/OPTIONEN/PFADE kennt. Die folgende Tabelle zeigt, welche Eigenschaften es gibt und welche Pfade sie definieren:
	Eigenschaft	Beschreibung
	Backup	Beinhaltet das Verzeichnis, in dem Sicherungskopien gespeichert werden.
	Basic	Beinhaltet das Basic-Verzeichnis, also z.B. das Vorgabeverzeichnis für ASCII-Basic-Texte und *.SBL-Dateien.
	Config	Beinhaltet das Konfigurationsverzeichnis, das Verzeichnis also, in der Konfigurationsdateien standardmäßig abgelegt werden.
	Database	Beinhaltet das Datenbankverzeichnis.
	Dictionary	Beinhaltet das Verzeichnis, in dem sich die Wörterbücher befinden.
	DocManagerIni	Beinhaltet das Verzeichnis der Ini-Datei des Dokumentmanagers.
	Glossary	Beinhaltet das Verzeichnis, in dem alle Textbaustein-Dateien standardmäßig gesichert werden.
	Graphics	Beinhaltet das Grafik-Basisverzeichnis, in dem sich Cliparts, Grafiken (Gallery) befinden.
	Modules	Beinhaltet das Basisverzeichnis einer StarOffice-Applikation bzw. das Basisverzeichnis von StarOffice.
	SubIni	Beinhaltet das Verzeichnis, in dem Pfade zu weiteren .INI-Dateien abgelegt werden.
	Template	Beinhaltet das Verzeichnis, in dem die Dokumentvorlagen abgelegt werden.
	Work	Beinhaltet das vorgegebene Arbeitsverzeichnis, also das Verzeichnis, das der Anwender vorgeschlagen bekommt, wenn er neue Dokumente speichert.
Ferner kennt das PathSettings-Objekt die Eigenschaften Application-Eigenschaft und Parent-Eigenschaft, die an den entsprechenden Stellen beschrieben sind.

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
PrintDefault-Methode

Funktion:	Druckt das angegebene Dokument, ohne zuvor den DRUCKEN-Dialog aufzurufen.
Syntax:	ActiveDocument.PrintDefault
Für Objekt:	Document
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Print-Methode

Funktion:	Durckt das dem Objekt entsprechende Dokument auf dem Drucker aus.
Syntax:	ActiveDocument.Print From%, To%, Copies%
	Parameter	Beschreibung
	From%	Beliebiger Integer-Ausdruck, der die Seitenzahl der ersten zu druckenden Seite definiert.
	To%	Beliebiger Integer-Ausdruck, der die Seitenzahl der letzten zu druckenden Seite definiert.
	Copies%	Beliebiger Integer-Ausdruck, der die Anzahl der zu druckenden Kopien des Dokumentes bestimmt.
Für Objekt	Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
PrintOut-Methode

Funktion:	Druckt das angegebene Dokument.
Syntax:	ActiveDocument.PrintOut from%, to%, copies%
	Parameter	Beschreibung
	from%	Integerausdruck, der die Nummer der ersten zu druckenden Seite angibt.
	to%	Integerausdruck, der die Nummer der letzten zu druckenden Seite angibt.
	copies%	Integerausdruck, der die Anzahl der zu druckenden Exemplare angibt.
Für Objekt:	Document
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Quit-Methode

Funktion:	Beendet das StarOffice-Programm.
Syntax:	Application.Quit
Für Objekt	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ReadOnly-Eigenschaft

Funktion:	Ermittelt, ob das aktuelle Dokument schreibgeschützt ist und somit nicht gespeichert, sondern lediglich geöffnet werden kann.
Syntax:	ActiveDocument.ReadOnly [= IsReadOnly]
	Parameter	Beschreibung
	IsReadOnly	Booleanscher Ausdruck, der angibt, ob das aktuelle Dokument schreibgeschützt ist:
	Wert	Beschreibung
	True	Das Dokument ist schreibgeschützt. Änderungen an dem Dokument können somit nicht gespeichert werden.
	False	Das Dokument ist nicht schreibgeschützt.
Zugriff:	Nur lesen.
Für Objekt:	Document
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Recording-Eigenschaft

Funktion:	Ermittelt, ob die Makroaufzeichnung derzeitig aktiviert ist (True) oder nicht (False).
Syntax:	Application.Recording
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
RedoAction-Eigenschaft

Funktion:	Ermittelt die im Menü BEARBEITEN unter dem Menüpunkt WIEDERHOLEN aufgeführte Beschreibung der zuvor rückgängig gemachten Aktion.
Syntax:	ActiveWindow.RedoAction
Zugriff:	Nur lesen.
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Redo-Methode

Funktion:	Wiederholt die zuletzt rückgängig gemachte Aktion.
Syntax:	ActiveWindow.Redo
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Remove-Methode

Funktion:	Entfernt ein bestimmtes Objekt aus einer Collection, das wahlweise durch einen Index oder durch eine Zeichenkette genau identifiziert werden kann.
Syntax:	{Application | Activewindow}.Remove (Index%) oder {Application | Activewindow}.Remove(Zeichen$) oder
	Parameter	Beschreibung
	Index%	Nummer des Objektes innerhalb der Collection, daß entfernt werden soll.
	Zeichen$	Zeichenkette, die ein bestimmtes Objekt, das entfernt werden soll, innerhalb einer Collection eindeutig identifizieren kann.
Für Objekt	Documents-Collection, Windows-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
RepeatAction-Eigenschaft

Funktion:	Ermittelt die im Menü BEARBEITEN unter dem Menüpunkt LETZTER BEFEHL aufgeführte Beschreibung der zuletzt ausgeführten Aktion, die wiederholt werden kann.
Syntax:	ActiveWindow.RepeatAction
Zugriff:	Nur lesen.
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
SaveAs-Methode

Funktion:	Speichert das dem Objekt entsprechende Dokument unter einem bestimmten Namen ab.
Syntax:	ActiveDocument.SaveAs FileName$[,FilterName$[,PassWord$]]]
	Parameter	Beschreibung
	FileName$	Dateiname des Dokumentes incl. Pfad.
	FilterName$	Filtername des Dokumentes, der das Format bestimmt, in dem das Dokument abgespeichert werden soll. Es gelten die Einstellungen der Dateiauswahl im jeweiligen StarOffice-Programm.
	PassWord$	Passwort für den geschützten Zugriff auf das Dokument.
Für Objekt	Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
SaveAsTemplate-Methode

Funktion:	Speichert das angegebene Dokument als Dokumentvorlage.
Syntax:	ActiveDocument.SaveAsTemplate TemplateName$, TemplateRegion$
	Parameter	Beschreibung
	TemplateName$	Zeichenfolgenausdruck, der den Dateinamen angibt, unter dem die Dokumentvorlage gespeichert werden soll.
	TemplateRegion$	Zeichenfolgenausdruck, der den Bereich angibt, dem die Dokumentvorlage zugewiesen werden soll.
Für Objekt:	Document
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
SaveConfiguration-Methode

Funktion:	Speichert die aktuelle Konfiguration der Applikation unter dem angegebenen Dateinamen.
Syntax:	Application.SaveConfiguration FileName$
	Parameter	Beschreibung
	FileName$	Zeichenfolgenausdruck, der den Dateinamen angibt, unter dem die Konfiguration gespeichert werden soll.
Für Objekt:	Application
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Saved-Eigenschaft

Funktion:	Ermittelt, ob das aktuelle Dokument gespeichert wurde, nachdem die letzten Änderungen daran vorgenommen wurden.
Syntax:	ActiveDocument.Save [= IsSaved]
	Parameter	Beschreibung
	IsSaved	Booleanscher Ausdruck, der angibt, ob das aktuelle Dokument gespeichert wurde, nachdem die letzten Änderungen daran vorgenommen wurden:
	Wert	Beschreibung
	True	Das Dokument wurde gespeichert.
	False	Das Dokument wurde nicht gespeichert.
Zugriff:	Nur Lesen.
Für Objekt:	Document
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Save-Methode

Funktion:	Speichert das dem Objekt entsprechende Dokument ab. Hat das Dokument noch keinen Namen, kommt es zu einem Laufzeitfehler.
Syntax:	ActiveDocument.Save
Für Objekt	Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
SaveSettings-Eigenschaft

Funktion:	Liefert die aktuellen Speichereinstellungen eines StarOffice-Programms als SAVESETTINGS-Objekt.
Syntax:	Application.PathSettings
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Beispiel:	Um z.B. von StarWriter aus zu bestimmen, daß die geöffneten Dokumente alle 3 Minuten gespeichert werden sollen, verwenden Sie das folgende Konstrukt: Application.SaveSettings.AutoSave=True Application.SaveSettings.AutoSaveInterval=3
Siehe auch:	PathSettings-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
SaveSettings-Objekt

Funktion:	Beinhaltet die Speichereinstellung einer Applikation.
Eigenschaften:	Das SaveSettings-Objekt verfügt über die folgenden Eigenschaften, die alle boolsche Werte bzw. Integer-Werte erwarten oder zurückliefern und die verschiedenen Speichereinstellungen bestimmen, so, wie man es bei der Bedienung der Applikation von dem Befehl EXTRAS/OPTIONEN/SPEICHERN kennt. Die folgende Tabelle zeigt, welche Eigenschaften es gibt und welche Aufgabe sie haben:
Eigenschaft	Beschreibung
AutoBackup	Bestimmt, ob Sicherheitskopien beim Speichern einer Datei automatisch erstellt werden sollen (True) oder nicht (False).
AutoSave	Bestimmt, ob geöffnete Dokumente in einem bestimmten Interval automatisch gespeichert werden sollen (True) oder nicht (False). Siehe auch AUTOSAVEINTERVAL-Eigenschaft.
AutoSaveInterval	Definiert oder ermittelt das Zeitinterval (Integer-Ausdruck), in dem alle geöffneten Dokumente automatisch gesichert werden sollen, sofern die AUTOSAVE-Eigenschaft auf True gesetzt ist.
GraphicsIndep	Bestimmt, ob Grafiken beim Speichern einer Datei im plattformunabhängig Format gespeichert werden sollen (True) oder nicht (False).
PopUpDocInfo	Bestimmt, ob  der Dialog zum Erfassen der Autoreninformationen beim Speichern aufgerufen werden soll (True) oder nicht (False).
QueryAutoSave	Bestimmt, ob eine Nachfrage beim automatischen Speichern einer Datei erfolgen soll (True) oder nicht (False).
SaveWorkingset	Bestimmt, ob die Einstellungen an der Bedienungsumgebung bei jedem Speichern ebenfalls mit gespeichert werden sollen (True) oder nicht (False).
Ferner kennt das SaveSettings-Objekt die Eigenschaften Application-Eigenschaft und Parent-Eigenschaft, die an den entsprechenden Stellen beschrieben sind.

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
SearchDialog-Eigenschaft

Funktion:	Schaltet den Suchen-Dialog ein (True) oder aus (False) oder ermittelt, ob der Suchen-Dialog eingeschaltet ist oder nicht.
Syntax:	Application.SearchDialog[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Selection-Eigenschaft

Funktion:	Liefert den selektierten Inhalt eines Dokumentes als SELECTION-Objekt zurück.
Syntax:	Application.Selection
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
StatusBar-Eigenschaft

Funktion:	Ermittelt oder bestimmt den Text der Statusleiste.
Syntax:	Application.StatusBar[=Text$]
	Parameter	Beschreibung
	Text$	Beliebiger Zeichenkettenausdruck, der in die Statuszeile des Applikationsfensters geschrieben werden soll.
Zugriff:	Schreibbar und lesbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
StatusBarVisible-Eigenschaft

Funktion:	Schaltet die Statusleiste ein (True) oder aus (False) oder ermittelt, ob die Statusleiste z.Z. angezeigt wird oder nicht.
Syntax:	Application.StatusBarVisible[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
StopRecording-Methode

Funktion:	Schaltet die Makroaufzeichnung aus, sofern sie aktiviert war.
Syntax:	Application.StopRecording
Für Objekt	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Tile-Methode

Funktion:	Ordnet die nicht als Symbol dargestellten Fenster so an, daß alle Fenster sichtbar sind und den kompletten Arbeitsbereich ausfüllen.
Syntax:	Windows.Tile
Für Objekt	Windows-Collection
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Title-Eigenschaft

Funktion:	Definiert oder bestimmt den dem Objekt entsprechenden Dokumententitel.
Syntax:	ActiveDocument.Title[=Zeichenkette$]
Zugriff:	Lesbar und schreibbar.
	Parameter	Beschreibung
	zeichenkette$	Beliebiger Zeichenkettenausdruck, der den neuen Titel des Dokumentes bestimmt.
Für Objekt:	Document-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
ToolBarVisible-Eigenschaft

Funktion:	Schaltet die Werkzeugleiste ein (True) oder aus (False) oder ermittelt, ob die Werkzeugleiste z.Z. angezeigt wird oder nicht.
Syntax:	Application.ToolBarVisible[=(True|False)]
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Top-Methode

Funktion:	Definiert oder ermittelt die vertikale Position des Fensters, das durch das entsprechende Objekt bestimmt wird.
Syntax:	{Application | Activewindow}.Top[=Top&]
	Parameter	Beschreibung
	Top&	Beliebiger Long-Integer-Ausdruck, der die neue vertikale Position des Fensters in Pixel festlegt.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt, Window-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
UndoAction-Eigenschaft

Funktion:	Ermittelt die im Menü BEARBEITEN unter dem Menüpunkt RÜCKGÄNGIG aufgeführte Beschreibung der zuletzt ausgeführten Aktion.
Syntax:	ActiveWindow.UndoAction
Zugriff:	Nur lesen.
Für Objekt:	ActiveWindow
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
UndoCount-Eigenschaft

Funktion:	Bestimmt, wieviele Schritte des „Rückgängigmachens“ im Rückgängig-Speicher erhalten bleiben sollen.
Syntax:	Application.UndoCount [Count%]
	Parameter	Beschreibung
	Count%	Beliebiger Integer-Ausdruck, der die Nummer der rückgängig zu machenden Schritte definiert.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Visible-Eigenschaft

Funktion:	Bestimmt oder ermittelt, ob die gesamte Applikation sichtbar ist (True) oder nicht (False).
Syntax:	Application.Visible[=(True|False)]
Zugriff:	Nur lesbar
Für Objekt:	Application-Objekt
Wichtiger Hinweis! Sorgen Sie dafür, daß Ihr Programm unbedingt die „Bedienbarkeit“ des Programms wiederherstellt, da Sie anderenfalls nicht in die IDE zurückkehren können – denn diese ist ebenfalls nicht bedienbar, solange Visible auf False gesetzt ist.

Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Width-Methode

Funktion:	Definiert oder ermittelt die Breite des Fensters, das durch das entsprechende Objekt bestimmt wird.
Syntax:	{Application | Activewindow}.Width[=Width&]
	Parameter	Beschreibung
	Width&	Beliebiger Long-Integer-Ausdruck, der die neue Breite des Fensters festlegt.
Zugriff:	Lesbar und schreibbar
Für Objekt:	Application-Objekt, Window-Objekt
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Window-Objekt

Funktion:	Dieses Objekt erlaubt den Zugriff auf ein Fenster eines geöffneten Dokumentes eines StarOffice-Programms.
Eigenschaften:	Application-Eigenschaft, Height-Eigenschaft, Left-Eigenschaft, Maximized-Eigenschaft, Minimized-Eigenschaft, Top-Eigenschaft, Width-Eigenschaft
Methoden:	Activate-Methode, Close-Methode, Optimize-Methode,
Beispiel:	[unbenannt1:1].Maximize=TRUE Application.ActiveWindow.Maximie=True
Siehe auch:	Ereignisse & Methoden des StarOffice


StarOffice Eigenschaften und Methoden
Windows-Collection

Funktion:	Die Windows-Collcetion beinhaltet alle in einem StarOffice-Programm geöffneten Fenster als Window-Objekt.
Eigenschaften:	Application-Eigenschaft, Parent-Eigenschaft
Methoden:	Add-Methode, ArrangeHorizontal-Methode, ArrangeIcons-Methode, ArrangeVertical-Methode, Cascade-Methode, Close-Methode, Item-Methode, Minimize-Methode, Remove-Methode, Tile-Methode
Beispiel:	Windows(3) ‘Window-Objekt ansprechen durch Index Windows(„unbenannt1:1“) ‘Window-Objekt ansprechen durch Namen
Siehe auch:	Ereignisse & Methoden des StarOffice


Es existiert kein StarBasic-Befehl mit diesem Anfangsbuchstaben.