Lade...
 

OleBox

OleBox

OleBox(name~aliasName, flags, x, y, w, h, Typ)

Parameter
Parameter   Beschreibung
name * Identifikator oder KLASSE::ausdr
aliasName   ein zusätzlicher Identifikator
flags   Flags
x * Position X (in Minicells)
y * Position Y (in Minicells)
w * Breite (in Minicells)
h * Höhe (in Minicells)
Typ   Zulässige OLE-Typen (ProgID)
  • - Pflichtparameter

Das Tupel (Klasse, Zugriffsausdruck) definiert eine Abbildung auf Modelldaten (siehe FillWindow, DrainWindow). Es werden Objekte vom Typ CX_COM_OBJECT und CX_MULTIPLE_COM_OBJECT unterstützt. Wird ein CX_MULTIPLE_COM_OBJECT in eine OleBox gefüllt, so wird lediglich die aktuell eingestellte Sprache angezeigt.

Damit ein OLE-Objekt angezeigt werden kann muss auf dem Computer ein passender OLE-Server installiert sein.

Eine OleBox akzeptiert Droppen von OLE-Objekten. Man kann z.B. eine MS-Word-Datei oder einen Ausschnitt eines MS-Excel-Spreadsheets in eine OleBox ziehen. Durch Angabe eines Typs in der OleBox-Anweisung können die zulässigen Dokumenttypen beschränkt werden. Wird kein Typ angegeben wird jedes OLE-Objekt akzeptiert. OleTypen entsprechen den Prog-IDs in der Registry, z.B. "Word.Document" oder "Excel.Sheet.8". Wenn als Typ eine versionsunabhängige Angabe gemacht wird, dann werden alle Objekte diesen Typs unabhängig von der Versionsnummer akzeptiert. Also werden bei der Typangabe "Word.Document" z.B. Objekte vom Typ "Word.Document.8" oder "Word.Document.9" angenommen.

Durch Doppelklick auf ein angezeigtes OLE-Objekt wird die entsprechende Anwendung gestartet und das OLE-Objekt kann darin bearbeitet werden.

Folgende Messages werden von einer OleBox versendet:

Message Beschreibung
ALERT Daten wurden geändert, siehe allgemeine Anweisung ALERT
DOUBLE_CLICK Doppelklick mit linker Maustaste
OLE_WRONG_TYPE Es wurde versucht, ein OLE-Objekt falschen Typs in die OleBox zu füllen (Drag & Drop)
OLE_SAVE Das OLE-Dokument wurde von der Server-Anwendung gespeichert (z.B. wenn der Speicher-Button betätigt wurde)

 

Flags
Flag Beschreibung
AUTODRAIN Wird mit FillWindow oder mit Put ein OLE-Objekt in die OleBox gefüllt und das Flag AUTODRAIN ist gesetzt, dann werden alle Änderungen an diesem Objekt automatisch in das Original-Objekt geschrieben. Ist das Original-Objekt persistent so wird automatisch für das Öffnen einer Transaktion gesorgt. Wird AUTODRAIN nicht angegeben, so erzeugt die OleBox eine Kopie des übergebenen Objekts und arbeitet darauf.
HIDDEN Die OleBox bleibt solange unsichtbar, bis Anweisung Show sie auf dem Bildschirm erschienen lässt.
MIN_HEIGHT(h) Höhe des Widgets fällt in keinem Falle unter den Wert h (Angabe in Minicells). Dies ist vor allem in Kombination mit Attachments von Nutzen.
MIN_WIDTH(w) Breite des Widgets fällt in keinem Falle unter den Wert w (Angabe in Minicells). Dies ist vor allem in Kombination mit Attachments von Nutzen.
TOOLTIP(mlString) Der angegebene String wird als Hinweistext (Tooltip) eingeblendet, oder, falls ein Event TOOLTIP ebenfalls definiert ist, an diesen übergeben. Das Erscheinen des Tooltips wird vom System automatisch nach eine bestimmten Zeit des Verharrens des Maus-Cursors über dem Windowobjekt ausgelöst. Der String kann mehrsprachig sein. An das Event wird der jeweils zur eingestellten Sprache aktuelle übergeben.
HELP(anchor) Help("file~anchor") verbindet das Windowobjekt mit Online-Hilfe im HTML-Format. Wenn kein Filename angegeben wurde, gilt die im Modul festgelegte HTML-Datei.
HELP(n)

Möchte man lieber das Help-System der Plattform (OS/2 PM, MS Windows) benutzten, so ist eine ganze Zahl n anzugeben, die auf das entsprechende Hilfe-Fenster verweist. Dabei muss n < 40000 sein.

Hinweis:  Als Online-Hilfe für InstantView® Applikation wird aus Gründen der Portabilität HTML empfohlen.