Memberfunktionen des Schieberegler-Steuerelements
Eine Anwendung kann die Memberfunktionen des Schiebereglersteuerelements aufrufen, um Informationen zum Schieberegler-Steuerelement (CSliderCtrl) abzurufen und seine Merkmale zu ändern.
Verwenden Sie die GetPos-Memberfunktion , um die Position des Schiebereglers abzurufen (d. h. den Wert, den der Benutzer ausgewählt hat). Verwenden Sie die SetPos-Memberfunktion , um die Position des Schiebereglers festzulegen. Sie können jederzeit die VerifyPos Memberfunktion verwenden, um sicherzustellen, dass der Schieberegler zwischen dem Minimal- und dem Höchstwert liegt.
Der Bereich eines Schieberegler-Steuerelements ist der Satz zusammenhängender Werte, die das Schieberegler-Steuerelement darstellen kann. Die meisten Anwendungen verwenden die SetRange-Memberfunktion , um den Bereich eines Schieberegler-Steuerelements festzulegen, wenn es zum ersten Mal erstellt wird. Anwendungen können den Bereich dynamisch ändern, nachdem das Schiebereglersteuerelement mithilfe der Memberfunktionen SetRangeMax und SetRangeMin erstellt wurde. Eine Anwendung, mit der der Bereich dynamisch geändert werden kann, ruft in der Regel die endgültigen Bereichseinstellungen ab, wenn der Benutzer die Arbeit mit dem Schieberegler-Steuerelement abgeschlossen hat. Verwenden Sie zum Abrufen dieser Einstellungen die Memberfunktionen "GetRange", "GetRangeMax" und "GetRangeMin ".
Eine Anwendung kann die TBS_AUTOTICKS Formatvorlage verwenden, um die Teilstriche eines Schieberegler-Steuerelements automatisch anzuzeigen. Wenn eine Anwendung die Position oder Häufigkeit der Teilstriche steuern muss, kann jedoch eine Reihe von Memberfunktionen verwendet werden.
Um die Position eines Teilstrichs festzulegen, kann eine Anwendung die SetTic-Memberfunktion verwenden. Mit der SetTicFreq-Memberfunktion kann eine Anwendung Teilstriche festlegen, die in regelmäßigen Abständen im Bereich des Schiebereglersteuerelements angezeigt werden. Beispielsweise kann die Anwendung diese Memberfunktion verwenden, um nur 10 Teilstriche in einem Bereich von 1 bis 100 anzuzeigen.
Verwenden Sie die GetTic-Memberfunktion, um den Index im Bereich abzurufen, der einem Teilstrich entspricht. Die GetTicArray-Memberfunktion ruft ein Array dieser Indizes ab. Verwenden Sie die GetTicPos-Memberfunktion, um die Position eines Teilstrichs in Clientkoordinaten abzurufen. Eine Anwendung kann die Anzahl der Teilstriche mithilfe der GetNumTics-Memberfunktion abrufen.
Die ClearTics-Memberfunktion entfernt alle Teilstriche eines Schieberegler-Steuerelements.
Die Zeilengröße eines Schiebereglersteuerelements bestimmt, wie weit der Schieberegler verschoben wird, wenn eine Anwendung eine TB_LINEDOWN oder TB_LINEUP Benachrichtigung empfängt. Entsprechend bestimmt die Seitengröße die Antwort auf die TB_PAGEDOWN und TB_PAGEUP Benachrichtigungen. Anwendungen können die Werte für Linien- und Seitengröße mithilfe der Memberfunktionen GetLineSize, SetLineSize, GetPageSize und SetPageSize abrufen und festlegen.
Eine Anwendung kann Memberfunktionen verwenden, um die Dimensionen eines Schieberegler-Steuerelements abzurufen. Die GetThumbRect-Memberfunktion ruft das umgebende Rechteck für den Schieberegler ab. Die GetChannelRect-Memberfunktion ruft das umgebende Rechteck für den Kanal des Schieberegler-Steuerelements ab. (Der Kanal ist der Bereich, über den der Schieberegler bewegt wird und die die Hervorhebung enthält, wenn ein Bereich ausgewählt wird.)
Wenn ein Schieberegler-Steuerelement die TBS_ENABLESELRANGE Formatvorlage aufweist, kann der Benutzer einen Bereich zusammenhängender Werte daraus auswählen. Mit einer Reihe von Memberfunktionen kann der Auswahlbereich dynamisch angepasst werden. Die SetSelection-Memberfunktion legt die Anfangs- und Endpositionen einer Auswahl fest. Wenn der Benutzer das Festlegen eines Auswahlbereichs abgeschlossen hat, kann eine Anwendung die Einstellungen mithilfe der GetSelection-Memberfunktion abrufen. Verwenden Sie die ClearSel-Memberfunktion, um die Auswahl eines Benutzers zu löschen.