Informationen Up-Down Steuerelementen
Ein Nach-unten-Steuerelement ist ein Pfeilschaltflächenpaar, auf das der Benutzer klicken kann, um einen Wert zu erhöhen oder zu dekrementiert, z. B. eine Bildlaufposition oder eine Zahl, die in einem Begleitsteuerfeld angezeigt wird (sogenanntes Fenster "Brille").
Für den Benutzer sehen ein Auf-Ab-Steuerelement und sein Fenster häufig wie ein einzelnes Steuerelement aus. Sie können angeben, dass sich ein Auf-Ab-Steuerelement automatisch neben seinem Zierfenster positioniert und die Beschriftung des Fensters automatisch auf die aktuelle Position des Fensters festgelegt wird. Sie können z. B. ein Auf-Ab-Steuerelement mit einem Bearbeitungssteuerfeld verwenden, um den Benutzer zur Eingabe numerischer Eingaben aufforderungen. Die folgende Abbildung zeigt ein Auf-Ab-Steuerelement mit einem Bearbeitungssteuer steuerelement als Fenster , eine Kombination, die manchmal als Spinner-Steuerelement bezeichnet wird.

Die folgenden Themen werden in diesem Abschnitt erläutert.
- Auf-Ab-Steuerelementstile
- Position und Beschleunigung
- StandardUp-Down steuert die Nachrichtenverarbeitung
Up-Down-Steuerelementstile
Mithilfe von Fensterstilen können Sie Merkmale eines Nach-oben-Steuerelements bearbeiten, z. B. wie es sich relativ zu seinem Fenster positioniert, ob der Text des Fensters festgelegt wird und ob die NACH-OBEN- und NACH-UNTEN-TASTE verarbeitet werden.
Ein Nach-unten-Steuerelement mit dem _ UDS-Stil ALIGNLEFT oder UDS _ ALIGNRIGHT wird am linken oder rechten Rand des Fensters ausgerichtet. Die Breite des Fensters wird verringert, um die Breite des Auf-Ab-Steuerelements zu bieten.
Ein Auf-Ab-Steuerelement mit dem _ UDS-Stil SETBUDDYINT legt die Beschriftung seines Fensters fest, wenn sich die aktuelle Position ändert. Das -Steuerelement fügt ein Tausendertrennzeichen zwischen allen drei Ziffern einer Dezimalzeichenfolge ein, es sei denn, das UDS _ NOTHOUSANDS-Format ist angegeben. Wenn es sich bei dem Fenster um ein Listenfeld handelt, legt ein Auf-Ab-Steuerelement seine aktuelle Auswahl statt seiner Beschriftung fest.
Sie können den UDS _ ARROWKEYS-Stil angeben, um eine Tastaturschnittstelle für ein Auf-Ab-Steuerelement anzugeben. Wenn dieses Format angegeben wird, verarbeitet das Steuerelement die Pfeiltasten nach oben und unten. Das -Steuerelement untergliedert auch das Fenster ,damit es diese Schlüssel verarbeiten kann, wenn das Fenster den Fokus besitzt.
Wenn Sie ein Nach-unten-Steuerelement für horizontales Scrollen verwenden, können Sie den UDS _ HORZ-Stil angeben. Dieser Stil bewirkt, dass die Pfeile des Nach-unten-Steuerelements nach links und rechts anstatt nach oben und unten zeigen.
Standardmäßig ändert sich die aktuelle Position nicht, wenn der Benutzer versucht, sie zu erhöhen oder über den maximalen oder minimalen Wert hinaus zu dekrementiert. Sie können dieses Verhalten ändern, indem Sie den UDS _ WRAP-Stil verwenden, sodass die Position in das gegenteilige Extreme "umbrucht". Wenn Sie beispielsweise über die Obergrenze hinaus inkrementieren, wird die Position wieder an die untere Grenze umschließen.
Position und Beschleunigung
Nachdem ein Auf-Ab-Steuerelement erstellt wurde, können Sie die aktuelle Position, die Mindestposition und die maximale Position des Steuerelements ändern, indem Sie Nachrichten senden. Sie können auch die Radixbasis ändern, die verwendet wird, um die aktuelle Position im Fenster "Fenster" und die Rate anzuzeigen, mit der sich die aktuelle Position ändert, wenn auf den Pfeil nach oben oder nach unten geklickt wird.
Um die aktuelle Position eines Auf-Ab-Steuerelements abzurufen, verwenden Sie die UDM _ GETPOS-Nachricht. Bei einem Auf-Ab-Steuerelement mit einem Fenster ist die aktuelle Position die Nummer in der Beschriftung des Fensters . Da sich die Beschriftung möglicherweise geändert hat (z. B. hat der Benutzer den Text eines Bearbeitungssteuerfelds bearbeitet), ruft das Auf-Ab-Steuerelement die aktuelle Beschriftung ab und aktualisiert die aktuelle Position entsprechend.
Die Beschriftung des Fensters kann entweder eine dezimale oder hexadezimale Zeichenfolge sein, abhängig von der Radixbasis (d. h. Basis 10 oder 16) des Auf-Ab-Steuerelements. Sie können die Basis radix mithilfe der UDM _ SETBASE-Nachricht festlegen und die Radixbasis mithilfe der UDM _ GETBASE-Nachricht abrufen.
Die UDM _ SETPOS-Meldung legt die aktuelle Position eines Fensters fest. Beachten Sie, dass ein Nach-unten-Steuerelement im Gegensatz zu einer Bildlaufleiste automatisch seine aktuelle Position ändert, wenn auf die Pfeile nach oben und unten geklickt wird. Eine Anwendung muss daher bei der Verarbeitung der WM _ VSCROLL- oder WM _ HSCROLL-Nachricht nicht die aktuelle Position festlegen.
Sie können die minimale und maximale Position eines Auf-Ab-Steuerelements ändern, indem Sie die UDM _ SETRANGE-Meldung verwenden. Die maximale Position kann kleiner als das Minimum sein, und in diesem Fall wird die aktuelle Position durch Klicken auf die Nach-oben-Schaltfläche verringert. Anders ausgedrückt: Nach oben bedeutet, sich auf die maximale Position zu bewegen. Verwenden Sie die UDM _ GETRANGE-Nachricht, um die minimalen und maximalen Positionen für ein Auf-Ab-Steuerelement abzurufen.
Sie können die Geschwindigkeit steuern, mit der sich die Position ändert, wenn der Benutzer eine Pfeilschaltfläche gedrückt hält, indem Sie die Beschleunigung des Auf-Ab-Steuerelements festlegen. Die Beschleunigung wird durch ein Array von UDACCEL-Strukturen definiert. Jede -Struktur gibt ein Zeitintervall und die Anzahl der Einheiten an, um die am Ende dieses Intervalls erhöht oder dekrementiert werden soll. Verwenden Sie zum Festlegen der Beschleunigung die UDM _ SETACCEL-Meldung. Verwenden Sie zum Abrufen von Beschleunigungsinformationen die UDM _ GETACCEL-Nachricht.
StandardUp-Down steuert die Nachrichtenverarbeitung
In diesem Abschnitt werden die standardbasierten Windows, die von einem Auf-Ab-Steuerelement verarbeitet werden.
Message |
Verarbeitung ausgeführt |
|---|---|
| WM _ CREATE | Ordnet eine private Datenstruktur zu und initialisiert sie und speichert ihre Adresse als Fensterdaten. |
| WM _ DESTROY | Gibt während der WM _ CREATE-Verarbeitung zugeordnete Daten frei. |
| WM _ ENABLE | Erklärt das Fenster für ungültig. |
| WM _ KEYDOWN | Ändert die aktuelle Position im Fall einer NACH-OBEN- oder NACH-UNTEN-TASTE. |
| WM _ KEYUP | Schließt die Positionsänderung ab. |
| WM _ LBUTTONDOWN | Erfasst die Maus. Wenn es sich bei dem Fenster um ein Bearbeitungs- oder Listenfeld handelt, wird der Fokus auf das Fenster "Schachtel" legt. Wenn sich der Mauszeiger über der Schaltfläche nach oben oder unten befindet, beginnt er mit dem Ändern der Position und legt einen Timer fest. |
| WM _ LBUTTONUP | Schließt die Positionsänderung ab und gibt die Mausaufnahme frei, wenn das Auf-Ab-Steuerelement die Maus erfasst hat. Wenn es sich bei dem Fenster um ein Bearbeitungssteuerfeld handelt, wird der text im Bearbeitungssteuerfeld ausgewählt. |
| WM _ PAINT | Zeichnet das Auf-Ab-Steuerelement. Wenn der wParam-Parameter nicht NULL ist, geht das Steuerelement davon aus, dass der Wert ein HDC ist, und zeichnet unter Verwendung dieses Gerätekontexts. |
| WM _ TIMER | Ändert die aktuelle Position, wenn die Maus über einer Schaltfläche gedrückt gehalten wird und ein ausreichendes Intervall verstrichen ist. |