ShortcutGadget()

Syntax

Ergebnis = ShortcutGadget(#Gadget, x, y, Breite, Höhe, Tastenkürzel)

Erstellt ein Gadget für die Auswahl von Tastenkürzeln (englisch "Keyboard Shortcuts") in der aktuellen Gadgetliste. Der Anwender kann es auswählen und eine Tastenkombination drücken, um ein neues Tastenkürzel auszuwählen.

Parameter

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Tastenkürzel	Das anfänglich anzuzeigende Tastenkürzel. Die möglichen Werte sind die gleichen, wie bei der AddKeyboardShortcut() Funktion. Ein Wert von 0 kann gesetzt werden, um damit anzuzeigen, das aktuell kein Tastenkürzel definiert ist.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Befehle können zum Verwalten des ShortcutGadget benutzt werden:

- GetGadgetState(): Ermittelt das aktuell ausgewählte Tastenkürzel.
- SetGadgetState(): Ändert das aktuell ausgewählte Tastenkürzel.

Beispiel

  If OpenWindow(0, 0, 0, 240, 70, "ShortcutGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ShortcutGadget(0, 20, 20, 200, 25, #PB_Shortcut_Control | #PB_Shortcut_A)
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetState(), SetGadgetState(), AddKeyboardShortcut()

Unterstützte OS

Alle