Lade...
 

Combobox, Combo, Cbox

Combobox, Combo, CBox

Combobox(name~aliasName, flags, x, y, w, h, transfTable)

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)
transfTable   Filename | filename~section | function()
  • - Pflichtparameter

Das Tupel (Klasse, Zugriffsausdruck) definiert eine Abbildung auf Modelldaten (siehe FillWindow, DrainWindow).
Die Combobox soll wie String als Text-Eingabefeld benutzt werden, wobei bereits vorgefertigte - in einer Tabelle aufgeführte - Texte ausgewählt werden können.

Flags
Flag Beschreibung
MASK(n) Die ganze Zahl n bestimmt den Wert des Filter-Flag für die Darstellung der Tabelle; n kann dezimal oder hexadezimal angegeben werden.
Zulässiger Wertebereich: 0 < n < 256. 
HIDDEN Die Combobox bleibt solange unsichtbar, bis Anweisung Show sie auf dem Bildschirm erschienen lässt.
VIEW_ONLY Das Eingabefeld kann nur Daten anzeigen, aber man kann interaktiv keine Zeichen eingeben.
NO_DRAIN Die Combobox wird zwar von FillWindow gefüllt, aber von DrainWindow ignoriert.
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.
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.

transfTable

Falls die Tabelle explizit angegeben wird, dann hat diese Vorrang gegeüber der Tabelle, die dem Slot des Zugriffspfads zugeordnet ist.

Die möglichen Werte der ComboBox (oder Enumeration) können auf drei Arten angegeben werden:

  • Filename: Angabe der num-Datei
  • Filename~section: Angabe der num-Datei und eines darin enthaltenen Eintrags
  • Funktion: Die Tabelle kann auch von einer Funktion (z.B. GetFontNames()) generiert werden. Die angegebene Funktion wird aufgerufen, nachdem die Message INITIALIZE an das Modul, aber bevor INITIALIZE an Widgets gesendet wird.
Funktionen, die Transformationstabellen für die Windowobjekte Enumeration und Combobox liefern
Name MA* Parameter Rückgabewert Beschreibung
AllUnits       Diese Funktion liefert alle Einheiten
Areas       Diese Funktion liefert die für Flächeneinheiten definierten Einheiten
CompoundUnits       zusammengesetzte Einheiten
CountryCodes       alle angemeldeten Codes der Länder mit Nummernschild-Landeskürzel z.B.:  049 "D"
CountryCodesFromEnum       alle in classix.num aufgelisteten Codes der Länder, mit dem aktuellem Land auf der ersten Stelle.
CountryCodesLong       alle angemeldeten Codes der Länder mit Landesname in der aktuell eingestellten Sprache. z.B.:  "Deutschland" "D"
Durations       Zeiteinheiten
GetCondBagSlotNames       alle Slots Namen, die den Typ CX_CONDITIONED_BAG haben
GetClassNames       Namen aller bekannten Klassen
GetIndexableClassNames       Namen aller indizierbaren Klassen (Klassen mit back pointer , d.h. von CX_EXPANDABLE abgeleitet)
GetEnumTransTbls       alle implizit zugeordneten Enum-Transformationstabellen
GetFontNames       Namen der verfügbaren Schriftarten
GetSlotNames1       Rückgabe aller Slot-Namen
GetSlotNames2       Rückgabe aller Slot-Namen (Vector 0 ist leer)
GetTypeNames       Namen aller Datentypen (in InstantView®-Terminologie)
IntCurrencies       Währungseinheiten (2. Name)
Lengths       Längeneinheiten
LongMonths       Monatsnamen (Longform)
NatCurrencies       Währungseinheiten (1. Name)
Pieces       Stückeinheiten
ShortMonths       Monatsnamen (Kurzform)
Temperatures       Temperatureinheiten
Volumes       Raumeinheiten
Weights       Gewichtseinheiten