Lade...
 

Gruppe

Group

Group(name, flags, x, y, w, h, text)

Parameter
Parameter   Beschreibung
name   Identifikator
flags   Flags
x * Position X (in Minicells)
y * Position Y (in Minicells)
w * Breite der Group (in Minicells)
h * Höhe der Group (in Minicells)
text   Text als String oder (mehrsprachig) als Mupltiple-String-Konstante
  • - Pflichtparameter

Die Childobjekte einer Group sind meist Radio-Buttons und Check-Boxes.

Flags
Flag Beschreibung
SELECT_MULTIPLE Eine Group hat die Eigenschaft, für ein inliegendes Widget die Message SELECT zu triggern, sobald dieses den Fokus erhält. Radio-Buttons reagieren auf dieses SELECT in besonderer Weise: Alle anderen Radio-Buttons und Check-Boxes innerhalb der Group werden deselektiert, sobald ein Widget gewählt wurde.
Für alle anderen Widgets ist dieses Verhalten ungewöhnlich, weil hier ein SELECT bereits beim Fokussieren getriggert wird. Das Flag SELECT_MULTIPLE verhindert bei einer Group, dass ein SELECT getriggert wird. Daher gilt: Groups mit Radio-Buttons dürfen das Flag SELECT_MULTIPLE nicht gesetzt haben, alle anderen Groups müssen das Flag haben!
Fenster mit einer Radio-Button-Group dürfen zudem keinen Default-Button haben. Dieser würde "gedrückt" werden sobald ein Radio-Button ausgewählt wurde.
Check-Boxes verhalten sich in diesem Fall wie die Radio-Buttons, nur dass es häufig vorkommt, dass mehrere Check-Boxen aktiviert werden sollen und somit das Flag SELECT_MULTIPLE situationsbedingt gesetzt werden muss.
HIDDEN Die Group bleibt solange unsichtbar, bis Anweisung Show ihn auf dem Bildschirm erschienen lässt.
FONT(k) k = 0, 1, ..., 9 wählt einen Eintrag in der Font-Tabelle. Der dort eingetragene Font wird benutzt. Fonts werden mit PMFonts in die Tabelle eingetragen. Für 0, 1 und 2 existieren vordefinierte Fonts. Der Font-Index kann später mit SetFont verändert werden.
MIN_HEIGHT(h) Höhe der Gruppe 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 der Gruppe 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.

Der Tooltip erscheint auf den Flächen der Group, auf denen kein anderes (Child-) Windowobjekt dargestellt ist. Allgemein übernimmt immer das Windowobjekt die Kontrolle über gegebenenfalls erscheinende Tooltips, das zu oberst unter dem Maus-Cursor liegt.

TOGGLE
195158

Das setzen dieses Flags hat nativ aktuell keine Auswirkung auf das Widget, bewirkt jedoch in MorphIT, dass sich die Gruppe zuklappen lässt.

Um den Toggle-Zustand von InstantView aus zu kontrollieren, kann man den MorphIT-Slot isHidden verwenden.
CONTEXTMENU(identifikator) Der Identifikator ist ein Bezeichner eines Items innerhalb einer Menu- oder ContextMenuList-Deklaration. Das unter diesem Item hängende Untermenu wird automatisch beim betätigen der rechten Maustaste eingeblendet. Wird daraufhin ein Menupunkt ausgewählt wird wie zu Item beschrieben die jeweilige Aktion gestartet, in gleicher Weise, als wäre der Menueintrag aus dem Hauptmenu heraus aufgerufen worden.
Zusätzlich kann man jedoch bei Ausführung von SELECT zu dem entsprechenden Item mittels GetCurrentWidget ermitteln aus welchem Windowobjekt heraus der Menupunkt via ContextMenu aufgerufen wurde. Bei einem Ausruf aus dem Hauptmenu liefert GetCurrentWidget NULL zurück.

Soll ein ContextMenu nicht automatisch erscheinen, so kann es (nach Gestaltungsrichtlinie sollte dies als Reaktion auf die rechte Maustaste, also innerhalb MOUSE_CLICK_R erfolgen) mittels PopupMenu auch aus InstantView® heraus aufgerufen werden. In diesem Fall sollte auf die Angabe des Flags CONTEXTMENU verzichtet werden, da sonst das Menu zweimal (einmal automatisch, einmal gesteuert) erscheint.
VOLATILE, VOLATILE(identifikator)

Das Eingabefeld soll nur dann sichtbar sein, wenn das darzustellende Datum auch existiert, andernfalls wird es von FillWindow automatisch ausgeblendet. Wann fehlen Daten in einem Objekt? Das ist der Fall

  • wenn ein Slot im Objekt nicht existiert
  • wenn im Zugriffspfad ein Pointer den Wert NULL besitzt
  • wenn eine Funktion im Zugriffspfad NULL liefert.
  • beim Zugriff auf das k-te Element einer Collection mit Cardinalität < k

Mit einer Funktion kann man z.B. an beliebiger Stelle im Zugriffsaufdrucks entscheiden, ob dieser weiterverfolgt werden soll oder nicht. Oft sollen noch andere Windowobjekte - z.B. der zum Eingabefeld gehörende Prompt - ebenfalls mit ein- und ausgeblendet werden. Für diese Objekte gibt man das VOLATILE-Flag mit dem gleichen Identifikator an, der hier eine Gruppe logisch zusammengehöriger Windowobjekte kennzeichnet. Falls sich ein Windowobjekt direkt auf ein 'normales' Datenmember eines Modellobjekts bezieht, ist Flag VOLATILE sinn- und funktionslos.
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.