<< Click to Display Table of Contents >> Window (Objekt) |
Zugriffspfade:
▪Application à Windows à Item
▪Application à ActiveWindow
▪Application à Documents à Item à ActiveWindow
▪Application à ActiveDocument à ActiveWindow
1 Beschreibung
Ein Window-Objekt repräsentiert ein einzelnes in TextMaker geöffnetes Dokumentfenster.
Für jedes Dokumentfenster existiert ein eigenes Window-Objekt. Öffnen oder schließen Sie Dokumentfenster, werden die zugehörigen Window-Objekte dynamisch angelegt bzw. entfernt.
2 Zugriff auf das Objekt
Die einzelnen Window-Objekte können auf folgenden Wegen angesprochen werden:
▪Alle geöffneten Dokumentfenster werden in der Sammlung Application.Windows (Typ: Windows) verwaltet:
' Die Namen aller geöffneten Dokumentfenster anzeigen
For i = 1 To tm.Application.Windows.Count
MsgBox tm.Application.Windows.Item(i).Name
Next i
▪Das aktive Dokumentfenster erhalten Sie über Application.ActiveWindow:
' Den Namen des aktuellen Dokumentfensters anzeigen
MsgBox tm.Application.ActiveWindow.Name
▪Window ist der Parent des View-Objekts:
' Den Namen des aktuellen Dokuments über einen Umweg anzeigen
MsgBox tm.Application.ActiveWindow.View.Parent.Name
▪Das Objekt Document enthält einen Objektzeiger auf das ihm zugehörige Dokumentfenster:
' Über das aktive Dokument an das aktive Dokumentfenster kommen
MsgBox tm.Application.ActiveDocument.ActiveWindow.Name
3 Eigenschaften, Objekte, Sammlungen und Methoden
Eigenschaften:
▪FullName R/O
▪Name R/O
▪Path R/O
▪Left
▪Top
▪Width
▪Height
▪WindowState
▪DisplayHorizontalRuler
▪DisplayVerticalRuler
▪DisplayRulers
▪DisplayHorizontalScrollBar
▪DisplayVerticalScrollBar
Objekte:
▪Document → Document
▪View → View
▪Application → Application
▪Parent → Windows
Methoden:
▪Activate
▪Close
FullName (Eigenschaft, R/O)
Datentyp: String
Liefert den Pfad und Namen des in dem Fenster geöffneten Dokuments (z.B. "c:\Briefe\Müller.tmdx").
Name (Eigenschaft, R/O)
Datentyp: String
Liefert den Namen des in dem Fenster geöffneten Dokuments (z.B. "Müller.tmdx").
Path (Eigenschaft, R/O)
Datentyp: String
Liefert den Pfad des in dem Fenster geöffneten Dokuments (z.B. c:\Briefe).
Left (Eigenschaft)
Datentyp: Long
Liest oder setzt die X-Koordinate der Fensterposition. Die Maßeinheit sind Bildschirmpixel.
Top (Eigenschaft)
Datentyp: Long
Liest oder setzt die Y-Koordinate der Fensterposition. Die Maßeinheit sind Bildschirmpixel.
Width (Eigenschaft)
Datentyp: Long
Liest oder setzt die Breite des Dokumentfensters. Die Maßeinheit sind Bildschirmpixel.
Height (Eigenschaft)
Datentyp: Long
Liest oder setzt die Höhe des Dokumentfensters. Die Maßeinheit sind Bildschirmpixel.
WindowState (Eigenschaft)
Datentyp: Long (SmoWindowState)
Liest oder setzt die Fensterdarstellung des Dokumentfensters. Mögliche Werte:
smoWindowStateNormal = 1 ' normal
smoWindowStateMinimize = 2 ' minimiert
smoWindowStateMaximize = 3 ' maximiert
DisplayHorizontalRuler (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Einstellung, ob im Dokumentfenster ein horizontales Lineal angezeigt werden soll (True oder False).
DisplayVerticalRuler (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Einstellung, ob im Dokumentfenster ein vertikales Lineal angezeigt werden soll (True oder False).
DisplayRulers (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Einstellung, ob im Dokumentfenster sowohl das horizontale als auch das vertikale Lineal angezeigt werden sollen (True oder False).
DisplayHorizontalScrollBar (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Einstellung, ob im Dokumentfenster ein horizontaler Rollbalken angezeigt werden soll (True oder False).
DisplayVerticalScrollBar (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Einstellung, ob im Dokumentfenster ein vertikaler Rollbalken angezeigt werden soll (True oder False).
Document (Zeiger auf Objekt)
Datentyp: Object
Liefert das diesem Dokumentfenster zugeordnete Document-Objekt. Mit diesem können Sie zahlreiche Einstellungen Ihres Dokuments lesen und setzen.
View (Zeiger auf Objekt)
Datentyp: Object
Liefert das View-Objekt des Dokumentfensters. Mit diesem können Sie diverse Einstellungen zur Bildschirmdarstellung lesen und setzen.
Application (Zeiger auf Objekt)
Datentyp: Object
Liefert das Application-Objekt.
Parent (Zeiger auf Objekt)
Datentyp: Object
Liefert das übergeordnete Objekt, also ein Objekt vom Typ Windows.
Activate (Methode)
Bringt das Dokumentfenster in den Vordergrund (sofern Visible für das Dokument True ist) und setzt den Fokus auf das Dokumentfenster.
Syntax:
Activate
Parameter:
keine |
Rückgabetyp:
keiner |
Beispiel:
' Das erste Dokumentfenster aktivieren
tm.Windows(1).Activate
Close (Methode)
Schließt das Dokumentfenster.
Syntax:
Close [SaveChanges]
Parameter:
SaveChanges (optional; Typ: Long bzw. SmoSaveOptions) gibt an, ob das im Fenster geöffnete Dokument gespeichert werden soll, sofern es seit dem letzten Speichern verändert wurde. Lassen Sie den Parameter weg, wird stattdessen gegebenenfalls der Benutzer gefragt. Mögliche Werte für SaveChanges: |
smoDoNotSaveChanges = 0 ' Nicht fragen, nicht speichern
smoPromptToSaveChanges = 1 ' Den Benutzer fragen
smoSaveChanges = 2 ' Ohne Rückfrage speichern
Rückgabetyp:
keiner |
Beispiel:
' Das aktuelle Fenster schließen, ohne es zu speichern
tm.ActiveWindow.Close smoDoNotSaveChanges