MLOleBox

MLOleBox

MLOleBox(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_MULTIPLE_COM_OBJECT unterstützt. In einer MLOleBox wird ähnlich einem MLString-Widget die aktuelle Sprache angezeigt. Zusätzlich wird in der oberen Rechten Ecke des Widgets die aktuelle Sprache durch eine Anzahl von Dreiecken angezeigt. Die aktuelle Sprache kann durch die Tasten PgUp/PgDown (Bild auf, Bild ab) umgestellt werden.

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

Eine MLOleBox akzeptiert Droppen von OLE-Objekten. Man kann z.B. eine MS-Word-Datei oder einen Ausschnitt eines MS-Excel-Spreadsheets in eine MLOleBox ziehen. Dadurch wird die lediglich die aktuelle Sprache beeinflusst. Durch Angabe eines Typs in der MLOleBox-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. Wird ein Typ angegeben wird immer ein OLE-Dokument in der MLOleBox hinterlegt, auch wenn die aktuelle Sprache leer ist oder gar kein OLE-Dokument eingefüllt ist.

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

Folgende Messages werden von einer OleBox versendet:

Message	Beschreibung
ALTERED	Daten wurden geändert, siehe allgemeine Anweisung ALERT
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 CX_MULTIPLE_COM-Objekt in die MLOleBox 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 MLOleBox 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.