Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File9.1.3.7  Popup                                                     TOS

 Name:          »Popup« - Verwaltung eines Popup-Menüs

 Deklaration:   int16_t cdecl (*Popup) (int8_t *items[], int16_t 
                num_items, int16_t default_item, int16_t font_size, 
                GRECT *button, GRECT *world);

 Beschreibung:  Die Funktion ermöglicht die komplette Verwaltung eines 
                Popup-Menüs. Es gilt:

                 Parameter     Bedeutung
                 items         Array mit Zeichenketten für die 
                               einzelnen Einträge. Jeder Eintrag muss 
                               die gleiche Länge besitzen, sowie vorne 
                               mindestens zwei und am Ende mindestens 
                               ein Leerzeichen aufweisen.
                 num_items     Anzahl der Einträge
                 default_item  Default-Eintrag (Zählung beginnt bei 
                               0), oder der Wert -1
                 font_size     Zeichengröße: 8*16 oder 8*8-Font. Als 
                               Parameter sind die gleichen Werte wie 
                               in der TEDINFO-Struktur zu verwenden. 
                               Laut Atari wird z.Zt. nur der große 
                               Zeichensatz verwendet.
                 button        Rechteck des Buttons, zu dem das Popup 
                               gehört.
                 world         Rechteck des Hintergrund-Objekbaumes 
                               (i.d.R. der Objektbaum der CPX)

                Hinweis: Bei zu vielen Einträgen (ab fünf) wird das 
                Popup automatisch gescrollt; die Bearbeitung blockiert 
                alle anderen Aktionen.

 Ergebnis:      Die Funktion liefert den gewählten Eintrag des Popups 
                zurück, oder den Wert -1, wenn kein Element des Popups 
                ausgewählt worden ist.

 Gruppe:        XCONTROL-Funktionen

 Querverweis:   Xform_do   XCONTROL