<< Click to Display Table of Contents >> Navigation: Konfigurierung Webinterface > Individuelles Maskenlayout > Elemente im individuellen Maskenlayout > Element "Individuelle Maske" |
Attribute
links,oben,Breite,Höhe
Position und Größe
AutoMoveAndResize
doNotCheckRights
Wenn auf true gesetzt, wird beim Öffnen nicht geprüft, ob der Webbenutzer entsprechende Rechte hat.
visible
Legt fest, ob das Element nach der Initiierung der Maske angezeigt wird.
Randfarbe
Standardwert ist schwarz.
Randstärke
Standardwert ist 1.
Funktionen
clearContent()
Löscht den Content-Bereich.
close()
Schließt die Maske, soweit möglich.
getDOMObject()
Gibt das Javascript-DOM-Objekt zurück, hier konkret <iframe>.
getHeight(), getLeft(), getPosition(), getSize(), getTop(), getWidth(), setHeight(height), setLeft(left), setPosition(left,top), setSize(width,height), setTop(top), setWidth(width)
getReturnObject()
Gibt den über MainForm.setReturnObject festgelegten Wert zurück. Standardwert ist null.
getRU()
Gibt das rimacon._userform-Namespace der individuellen Maske zurück.
init(userformid_or_key, objid, readonly, custom_url)
Initiiert eine konkrete individuelle Maske. Die Methode "getRU" ist erst nach dem onInited-Ereignis funktionsfähig.
initModal(userformid_or_key, objid, readonly, custom_url)
Initiiert eine konkrete individuelle Maske modal, d.h. die anderen Maskenelemente sind gesperrt.
initModal( prms: { ... } ), initSupermodal( prms: { ... } )
Ähnlich wie bei initModal/initSupermodal werden die einzelne Parameter über {} eingegeben.
Beispiel:
RU.userform1.initModal({ userformIdOrKey:"<textId>" ,objId: <ID> ,readonly: false ,maximized: false ,openUFContextKey: "" /* RU._server.?() */ ,customUrl: "" ,onInited: function() { console.log("onInited: prms") } ,onMessage: function(msg) { console.log("onMessage", msg) } ,onSaved: function(ctx) { console.log("onSaved: " + ctx.objId) } ,onClosed: function(ctx) { console.log("onClosed", ctx) } }) |
Parameter:
userformIdOrKey, objId, readonly, customUrl: wie bei anderen initModal
maximized: wenn true, wird die Maske maximiert geöffnet
openUFContextKey: siehe auch PrivateMainForm, Methode RegisterOpenUFContext
onInited, onMessage, onSaved, onClosed: Siehe unten Ereignisse. Hier definierte Ereignisse werden zusätzlich zu dem im UI definierten JS-ScriptScripten ausgeführt. Das ermöglicht es, bei komplexeren Szenarien die Hauptlogik auf einer Stelle zu halten,
initSupermodal(userformid_or_key, objid, readonly, custom_url)
Ähnlich wie bei initModal wird eine eine konkrete individuelle Maske modal initiiert. Aber im Gegensatz zu initModal werden nicht nur die Maskenelemente gesperrt, sondern auch die Elemente von allen übergeordneten Masken.
Diese Funktion ist sinnvoll, wenn Sie aus einer individuellen Masken eine zweite Maske aufrufen und aus der zweiten eine dritte, und Sie wissen, dass die dritte Maske größer ist als die zweite Maske. In einem solchem Fall sollte die dritte Maske über initSupermodal geöffnet werden, damit die Größe der zweiten Masken nicht limitiert wird.
maximize()
Maximiert die modalgeöffnete Maske.
onClosed(handler), onInited(handler), onMessage(handler), onSaved(handler)
Legt ein entsprechendes Ereignis-handler fest. Diese Funktionen sollten nach initModal&co aufgerufen werden. Die Werte und Bedeutung sind identisch wie bei Funktion „initModal( prms: { ... } )“ .
Hinweis: Nutzen Sie diese Funktionen, wenn die Maske über SSP modal geöffnet wird. Ansonst (über Javascript) nutzen Sie die Variante „initModal( prms: { ... } )“ .
setModalWindowPos(left, top, width, height)
Legt die Position und Größe der Maske (modal geöffnet) fest.
show(bShow)
Zeigt oder versteckt das Objekt.
startSave()
Startet asynchrones Speichern, d.h. die Werte werden erst verzögert und nicht unmittelbar nach Abschluss der Funktion gespeichert.
Ereignisse
onInited
Wenn die individuelle Maske vollständig initiiert wurde (iinkl. afterFormInit), wird dieses Ereignis ausgeführt.
onSaved
Wenn das Speichern in der individuellen Maske erfolgreich beendet ist.
Kontextvariablen: objid, ctx.objid, ctx.was_new
onSaveFailure
Wenn Speichen fehlschlägt.
onClosed
Wenn die individuelle Maske geschlossen wird
Kontextvariable: objid
onMessage
Dieses Ereignis wird aufgerufen, wenn die geöffnete Maske die Funktion <MainForm>.SendMessageToOpener(msg) aufruft.