ActionDialog

Datei: ActionDialog.cs

Verantwortung

Modaler Dialog zum Bearbeiten einer einzelnen Aktion (MX-Button oder Encoder-Slot) inkl. optionaler LED-Einstellungen.

Ergebnis-Properties

public DeviceAction ResultAction { get; }   // Typ + Keycode/Usage/etc.
public Color        ResultColor  { get; }   // LED-Basisfarbe
public LedAnimType  ResultAnim   { get; }   // Animation
public ushort       ResultPeriod { get; }   // Periode in ms

Panels (je nach Typ ein Panel sichtbar)

Typ	Panel	Inhalt
HID Tastatur	`_hidKeyPanel`	Capture-Button + Strg/Shift/Alt/Win-Checkboxen
HID Consumer	`_consumerPanel`	Dropdown mit 12 Medien-Aktionen
Host Command	`_cmdPanel`	TextBox für numerische Command-ID
Makro	`_macroPanel`	8 Step-Buttons + je Strg/Shift/Alt-Checkboxen
Profil wechseln	`_profilePanel`	Dropdown: "Nächstes Profil (Zyklus)" / "Profil 1" / "Profil 2" / "Profil 3"
Keine	—	Alle Panels ausgeblendet

LED-Panels (_colorPanel, _animPanel) erscheinen zusätzlich wenn showColor=true (nur MX-Buttons, nicht Encoder).

UpdateLayout() repositioniert LED-Panels und passt ClientSize dynamisch an wenn der Typ gewechselt wird.

Profil-Panel

// Items in _profileCombo:
//   Index 0: "Nächstes Profil (Zyklus)"  → Data = 0xFFFF
//   Index 1: "Profil 1"                   → Data = 0
//   Index 2: "Profil 2"                   → Data = 1
//   Index 3: "Profil 3"                   → Data = 2

// Initialbelegung:
_profileCombo.SelectedIndex = action.Data == 0xFFFF ? 0 : action.Data + 1;

// In OnOk():
data = _profileCombo.SelectedIndex == 0
    ? (ushort)0xFFFF
    : (ushort)(_profileCombo.SelectedIndex - 1);

Im Board wird 0xFFFF als (uint8_t)0xFF gespeichert und in der Firmware als "nächstes Profil" interpretiert.

Tasten-Capture (HID-Modus)

Benutzer klickt "Taste drücken..."
_capturing = true
Nächste Taste in ProcessCmdKey() → VkToHid() → _hidKeycode setzen
Capture-Button zeigt Tastenname (HidKeyName())

Warum ProcessCmdKey statt OnKeyDown? WinForms behandelt Pfeil- und Enter-Tasten als "Dialog Keys" in ProcessDialogKey() — sie erreichen OnKeyDown nie. ProcessCmdKey wird vor ProcessDialogKey aufgerufen und kann diese Tasten abfangen.

Makro-Capture

Jeder der 8 Steps hat einen eigenen Capture-Button. _captureStep (0–7, -1 = inaktiv) zeigt welcher Step gerade aufnimmt. Capture-Logik identisch mit HID-Modus, schreibt in _stepKeycodes[captureStep].

Schlüssellookup (layout-unabhängig)

Problem: Windows VK-Codes sind tastaturlayout-abhängig. Keys.OemQuotes auf QWERTZ → Ö, auf US → '. Würde falsche HID-Codes liefern.

Lösung: PS/2 Scan-Codes sind layout-unabhängig (physische Tastenposition).

VK → Scan-Code via MapVirtualKey(vk, MAPVK_VK_TO_VSC)
Scan-Code → HID Usage via s_scanToHid[sc]

s_scanToHid: vollständige PS/2-Set-1 → HID-Tabelle (~60 Einträge).

Ausnahme: Erweiterte Navigationstasten (Pfeiltasten, Pos1, Ende, …) geben via MapVirtualKey den Numpad-Scan-Code zurück. Für diese gibt es eine direkte Keys → HID-Tabelle (s_extVkToHid).

Anzeige: HidKeyName(hid) gibt den lokalisierten Tastennamen zurück:

Sondertasten: fest eingetragene deutsche Namen ("Esc", "→", "F5", …)
Zeichentasten: GetKeyNameText(scanCode << 16, ...) → Windows gibt den Namen laut aktivem Layout zurück ("Ö" auf QWERTZ, ";" auf US)

Consumer-Aktionen

12 HID Consumer Usage IDs als feste Liste:

Usage	Name
0x00CD	Play / Pause
0x00B5	Nächster Titel
0x00B6	Vorheriger Titel
0x00B7	Stop
0x00E9	Lauter
0x00EA	Leiser
0x00E2	Stummschalten
0x0192	Taschenrechner
0x0223	Browser – Startseite
0x0224	Browser – Zurück
0x0225	Browser – Vor
0x00B0	Aufnahme

LED-Einstellungen

Nur wenn showColor=true (MX-Buttons). Enthält:

Farbpicker: ColorDialog → _colorBtn.BackColor
Animations-Dropdown: Statisch / Blinken / Pulsieren / Regenbogen
Periode-Dropdown: Presets von "Sehr langsam (8 s)" bis "Sehr schnell (250 ms)"

Bei "Regenbogen" wird der Farbpicker ausgeblendet (Farbe irrelevant).

4.2 KiB Raw Blame History Unescape Escape