CSliderCtrl-Klasse

  • Artikel

Stellt die Funktionalität des allgemeinen Windows-Schieberegler-Steuerelements bereit.

Syntax

class CSliderCtrl : public CWnd

Member

Öffentliche Konstruktoren

Name Beschreibung
CSliderCtrl::CSliderCtrl Erstellt ein CSliderCtrl-Objekt.

Öffentliche Methoden

Name Beschreibung
CSliderCtrl::ClearSel Löscht die aktuelle Auswahl in einem Schieberegler-Steuerelement.
CSliderCtrl::ClearTics Entfernt die aktuellen Teilstriche aus einem Schieberegler-Steuerelement.
CSliderCtrl::Create Erstellt ein Schieberegler-Steuerelement und fügt es an ein CSliderCtrl Objekt an.
CSliderCtrl::CreateEx Erstellt ein Schieberegler-Steuerelement mit den angegebenen erweiterten Windows-Formatvorlagen und fügt es an ein CSliderCtrl Objekt an.
CSliderCtrl::GetBuddy Ruft den Ziehpunkt an einem Schieberegler-Steuerelement-Kumpelfenster an einer bestimmten Position ab.
CSliderCtrl::GetChannelRect Ruft die Größe des Kanals des Schiebereglersteuerelements ab.
CSliderCtrl::GetLineSize Ruft die Liniengröße eines Schieberegler-Steuerelements ab.
CSliderCtrl::GetNumTics Ruft die Anzahl der Teilstriche in einem Schieberegler-Steuerelement ab.
CSliderCtrl::GetPageSize Ruft die Seitengröße eines Schieberegler-Steuerelements ab.
CSliderCtrl::GetPos Ruft die aktuelle Position des Schiebereglers ab.
CSliderCtrl::GetRange Ruft die minimalen und maximalen Positionen für einen Schieberegler ab.
CSliderCtrl::GetRangeMax Ruft die maximale Position für einen Schieberegler ab.
CSliderCtrl::GetRangeMin Ruft die Mindestposition für einen Schieberegler ab.
CSliderCtrl::GetSelection Ruft den Bereich der aktuellen Auswahl ab.
CSliderCtrl::GetThumbLength Ruft die Länge des Schiebereglers im aktuellen Trackbar-Steuerelement ab.
CSliderCtrl::GetThumbRect Ruft die Größe des Schieberegler-Steuerelements ab.
CSliderCtrl::GetTic Ruft die Position des angegebenen Teilstrichs ab.
CSliderCtrl::GetTicArray Ruft das Array von Teilstrichpositionen für ein Schieberegler-Steuerelement ab.
CSliderCtrl::GetTicPos Ruft die Position des angegebenen Teilstrichs in Clientkoordinaten ab.
CSliderCtrl::GetToolTips Ruft den Ziehpunkt für das QuickInfo-Steuerelement ab, das dem Schieberegler-Steuerelement zugewiesen ist, falls vorhanden.
CSliderCtrl::SetBuddy Weist ein Fenster als Kumpelfenster für ein Schieberegler-Steuerelement zu.
CSliderCtrl::SetLineSize Legt die Liniengröße eines Schieberegler-Steuerelements fest.
CSliderCtrl::SetPageSize Legt die Seitengröße eines Schieberegler-Steuerelements fest.
CSliderCtrl::SetPos Legt die aktuelle Position des Schiebereglers fest.
CSliderCtrl::SetRange Legt die minimalen und maximalen Positionen für einen Schieberegler fest.
CSliderCtrl::SetRangeMax Legt die maximale Position für einen Schieberegler fest.
CSliderCtrl::SetRangeMin Legt die Mindestposition für einen Schieberegler fest.
CSliderCtrl::SetSelection Legt den Bereich der aktuellen Auswahl fest.
CSliderCtrl::SetThumbLength Legt die Länge des Schiebereglers im aktuellen Trackbar-Steuerelement fest.
CSliderCtrl::SetTic Legt die Position des angegebenen Teilstrichs fest.
CSliderCtrl::SetTicFreq Legt die Häufigkeit der Teilstriche pro Schieberegler-Steuerelement inkrementierung fest.
CSliderCtrl::SetTipSide Positioniert ein QuickInfo-Steuerelement, das von einem Trackbar-Steuerelement verwendet wird.
CSliderCtrl::SetToolTips Weist einem Schieberegler-Steuerelement ein QuickInfo-Steuerelement zu.

Hinweise

Ein Schieberegler-Steuerelement (auch als Trackbar bezeichnet) ist ein Fenster mit einem Schieberegler und optionalen Teilstrichen. Wenn der Benutzer den Schieberegler mithilfe der Maus oder der Richtungstasten bewegt, sendet das Steuerelement Benachrichtigungen, um die Änderung anzuzeigen.

Schiebereglersteuerelemente sind nützlich, wenn der Benutzer einen einzelnen Wert oder eine Reihe aufeinander folgender Werte in einem Bereich auswählen soll. Sie können z. B. ein Schieberegler-Steuerelement verwenden, damit der Benutzer die Wiederholungsrate der Tastatur festlegen kann, indem Sie den Schieberegler auf ein bestimmtes Teilstrich setzen.

Dieses Steuerelement (und daher die Klasse) ist nur für Programme verfügbar, die CSliderCtrl unter Windows 95/98 und Windows NT, Version 3.51 und höher ausgeführt werden.

Der Schieberegler wird in Schritten verschoben, die Sie beim Erstellen angeben. Wenn Sie beispielsweise angeben, dass der Schieberegler einen Bereich von fünf aufweisen soll, kann der Schieberegler nur sechs Positionen belegen: eine Position an der linken Seite des Schieberegler-Steuerelements und eine Position für jede Inkrementierung im Bereich. In der Regel wird jede dieser Positionen durch ein Teilstrich identifiziert.

Sie erstellen einen Schieberegler mithilfe des Konstruktors und der Create Memberfunktion von CSliderCtrl. Nachdem Sie ein Schieberegler-Steuerelement erstellt haben, können Sie Memberfunktionen CSliderCtrl verwenden, um viele seiner Eigenschaften zu ändern. Änderungen, die Sie vornehmen können, umfassen das Festlegen der minimalen und maximalen Positionen für den Schieberegler, das Zeichnen von Teilstrichen, das Festlegen eines Auswahlbereichs und das Ändern der Position des Schiebereglers.

Weitere Informationen zur Verwendung CSliderCtrlfinden Sie unter "Steuerelemente und Verwenden" CSliderCtrl.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CSliderCtrl

Anforderungen

Headerafxcmn.h:

CSliderCtrl::ClearSel

Löscht die aktuelle Auswahl in einem Schieberegler-Steuerelement.

void ClearSel(BOOL bRedraw = FALSE);

Parameter

bRedraw
Kennzeichnung neu zeichnen. Wenn dieser Parameter lautet TRUE, wird der Schieberegler neu gezeichnet, nachdem die Auswahl gelöscht wurde. Andernfalls wird der Schieberegler nicht neu gezeichnet.

CSliderCtrl::ClearTics

Entfernt die aktuellen Teilstriche aus einem Schieberegler-Steuerelement.

void ClearTics(BOOL bRedraw = FALSE);

Parameter

bRedraw
Kennzeichnung neu zeichnen. Wenn dieser Parameter lautet TRUE, wird der Schieberegler neu gezeichnet, nachdem die Teilstriche gelöscht wurden. Andernfalls wird der Schieberegler nicht neu gezeichnet.

CSliderCtrl::Create

Erstellt ein Schieberegler-Steuerelement und fügt es an ein CSliderCtrl Objekt an.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Gibt die Formatvorlage des Schieberegler-Steuerelements an. Wenden Sie eine beliebige Kombination von Schieberegler-Steuerelementformaten an, die im Windows SDK beschrieben werden, auf das Steuerelement.

rect
Gibt die Größe und Position des Schieberegler-Steuerelements an. Dabei kann es sich um ein CRect Objekt oder eine RECT Struktur handeln.

pParentWnd
Gibt das übergeordnete Fenster des Schieberegler-Steuerelements an, in der Regel ein CDialog. Es darf nicht sein NULL.

nID
Gibt die ID des Schieberegler-Steuerelements an.

Rückgabewert

Nonzero, wenn die Initialisierung erfolgreich war; andernfalls 0.

Hinweise

Sie erstellen eine CSliderCtrl in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, und rufen Sie Createdann auf, wodurch das Schieberegler-Steuerelement erstellt und an das CSliderCtrl Objekt angefügt wird.

Abhängig von den für diese Werte festgelegten dwStyleWerten kann das Schieberegler-Steuerelement entweder eine vertikale oder horizontale Ausrichtung aufweisen. Es kann Teilstriche auf beiden Seiten, beide Seiten oder keines haben. Sie kann auch verwendet werden, um einen Bereich aufeinander folgender Werte anzugeben.

Um erweiterte Fensterformatvorlagen auf das Schieberegler-Steuerelement anzuwenden, rufen Sie CreateEx anstelle von Create.

CSliderCtrl::CreateEx

Erstellt ein Steuerelement (ein untergeordnetes Fenster) und ordnet es dem Objekt zu CSliderCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Windows-Stile finden Sie im dwExStyle Parameter für CreateWindowEx das Windows SDK.

dwStyle
Gibt die Formatvorlage des Schieberegler-Steuerelements an. Wenden Sie eine beliebige Kombination von Schieberegler-Steuerelementformaten an, die im Windows SDK beschrieben werden, auf das Steuerelement.

rect
Ein Verweis auf eine RECT Struktur, die die Größe und Position des zu erstellenden Fensters in Clientkoordinaten pParentWndbeschreibt.

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

nID
Die Untergeordnete Fenster-ID des Steuerelements.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Verwenden Sie CreateEx anstelle von Create erweiterten Windows-Formatvorlagen, die durch die Erweiterte Formatvorlage WS_EX_von Windows angegeben werden.

CSliderCtrl::CSliderCtrl

Erstellt ein CSliderCtrl-Objekt.

CSliderCtrl();

CSliderCtrl::GetBuddy

Ruft den Ziehpunkt an einem Schieberegler-Steuerelement-Kumpelfenster an einer bestimmten Position ab.

CWnd* GetBuddy(BOOL fLocation = TRUE) const;

Parameter

fLocation
Ein boolescher Wert, der angibt, welche von zwei Kontaktfensterhandles abgerufen werden soll. Folgenden Werte sind möglich:

  • TRUE Ruft den Ziehpunkt links vom Schieberegler an den Kumpel ab. Wenn das Schieberegler-Steuerelement die TBS_VERT Formatvorlage verwendet, ruft die Nachricht den Kumpel über dem Schieberegler ab.

  • FALSE Ruft den Ziehpunkt rechts vom Schieberegler an den Kumpel ab. Wenn das Schieberegler-Steuerelement die TBS_VERT Formatvorlage verwendet, ruft die Nachricht den Kumpel unter dem Schieberegler ab.

Rückgabewert

Ein Zeiger auf ein CWnd Objekt, das das Kumpelfenster an der angegebenen fLocationPosition ist oder NULL ob an dieser Position kein Kumpelfenster vorhanden ist.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TBM_GETBUDDY, wie im Windows SDK beschrieben. Eine Beschreibung der Schieberegler-Steuerelementstile finden Sie unter Trackbar-Steuerelementstile im Windows SDK.

CSliderCtrl::GetChannelRect

Ruft die Größe und Position des umgebenden Rechtecks für den Kanal eines Schiebereglersteuerelements ab.

void GetChannelRect(LPRECT lprc) const;

Parameter

lprc
Ein Zeiger auf ein CRect Objekt, das die Größe und Position des umgebenden Rechtecks des Kanals enthält, wenn die Funktion zurückgegeben wird.

Hinweise

Der Kanal ist der Bereich, über den der Schieberegler bewegt wird und die die Hervorhebung enthält, wenn ein Bereich ausgewählt wird.

CSliderCtrl::GetLineSize

Ruft die Größe der Linie für ein Schieberegler-Steuerelement ab.

int GetLineSize() const;

Rückgabewert

Die Größe einer Linie für das Schieberegler-Steuerelement.

Hinweise

Die Zeilengröße wirkt sich darauf aus, wie viel der Schieberegler für die TB_LINEUP und TB_LINEDOWN Benachrichtigungen verschoben wird. Die Standardeinstellung für die Liniengröße ist 1.

CSliderCtrl::GetNumTics

Ruft die Anzahl der Teilstriche in einem Schieberegler-Steuerelement ab.

UINT GetNumTics() const;

Rückgabewert

Die Anzahl der Teilstriche im Schieberegler-Steuerelement.

CSliderCtrl::GetPageSize

Ruft die Größe der Seite für ein Schieberegler-Steuerelement ab.

int GetPageSize() const;

Rückgabewert

Die Größe einer Seite für das Schieberegler-Steuerelement.

Hinweise

Die Seitengröße wirkt sich darauf aus, wie viel der Schieberegler für die TB_PAGEUP und TB_PAGEDOWN Benachrichtigungen verschoben wird.

CSliderCtrl::GetPos

Ruft die aktuelle Position des Schiebereglers in einem Schieberegler-Steuerelement ab.

int GetPos() const;

Rückgabewert

Die aktuelle Position.

CSliderCtrl::GetRange

Ruft die maximalen und minimalen Positionen für den Schieberegler in einem Schieberegler-Steuerelement ab.

void GetRange(
    int& nMin,
    int& nMax) const;

Parameter

nMin
Bezug auf eine ganze Zahl, die die Mindestposition erhält.

nMax
Bezug auf eine ganze Zahl, die die maximale Position erhält.

Hinweise

Diese Funktion kopiert die Werte in die ganzzahligen Zahlen, auf die verwiesen wird, nMin und nMax.

CSliderCtrl::GetRangeMax

Ruft die maximale Position für den Schieberegler in einem Schieberegler-Steuerelement ab.

int GetRangeMax() const;

Rückgabewert

Die maximale Position des Steuerelements.

CSliderCtrl::GetRangeMin

Ruft die Mindestposition für den Schieberegler in einem Schieberegler-Steuerelement ab.

int GetRangeMin() const;

Rückgabewert

Die Mindestposition des Steuerelements.

CSliderCtrl::GetSelection

Ruft die Anfangs- und Endpositionen der aktuellen Auswahl in einem Schieberegler-Steuerelement ab.

void GetSelection(
    int& nMin,
    int& nMax) const;

Parameter

nMin
Bezug auf eine ganze Zahl, die die Anfangsposition der aktuellen Auswahl empfängt.

nMax
Bezug auf eine ganze Zahl, die die Endposition der aktuellen Auswahl empfängt.

CSliderCtrl::GetThumbLength

Ruft die Länge des Schiebereglers im aktuellen Trackbar-Steuerelement ab.

int GetThumbLength() const;

Rückgabewert

Die Länge des Schiebereglers in Pixel.

Hinweise

Diese Methode sendet die TBM_GETTHUMBLENGTH Nachricht, die im Windows SDK beschrieben wird.

CSliderCtrl::GetThumbRect

Ruft die Größe und Position des umgebenden Rechtecks für den Schieberegler (Daumen) in einem Schieberegler-Steuerelement ab.

void GetThumbRect(LPRECT lprc) const;

Parameter

lprc
Ein Zeiger auf ein CRect Objekt, das das umgebende Rechteck für den Schieberegler enthält, wenn die Funktion zurückgegeben wird.

CSliderCtrl::GetTic

Ruft die Position eines Teilstrichs in einem Schieberegler-Steuerelement ab.

int GetTic(int nTic) const;

Parameter

nTic
Nullbasierter Index, der ein Teilstrich identifiziert.

Rückgabewert

Die Position des angegebenen Teilstrichs oder - 1, wenn nTic kein gültiger Index angegeben wird.

CSliderCtrl::GetTicArray

Ruft die Adresse des Arrays ab, das die Positionen von Teilstrichen für ein Schieberegler-Steuerelement enthält.

DWORD* GetTicArray() const;

Rückgabewert

Die Adresse des Arrays, das Teilstrichpositionen für das Schieberegler-Steuerelement enthält.

CSliderCtrl::GetTicPos

Ruft die aktuelle physische Position eines Teilstrichs in einem Schieberegler-Steuerelement ab.

int GetTicPos(int nTic) const;

Parameter

nTic
Nullbasierter Index, der ein Teilstrich identifiziert.

Rückgabewert

Die physische Position in Clientkoordinaten des angegebenen Teilstrichs oder - 1, wenn nTic kein gültiger Index angegeben wird.

CSliderCtrl::GetToolTips

Ruft den Ziehpunkt für das QuickInfo-Steuerelement ab, das dem Schieberegler-Steuerelement zugewiesen ist, falls vorhanden.

CToolTipCtrl* GetToolTips() const;

Rückgabewert

Ein Zeiger auf ein CToolTipCtrl Objekt oder NULL wenn QuickInfos nicht verwendet werden. Wenn das Schieberegler-Steuerelement die Formatvorlage nicht verwendet TBS_TOOLTIPS , lautet NULLder Rückgabewert .

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TBM_GETTOOLTIPS, wie im Windows SDK beschrieben. Beachten Sie, dass diese Memberfunktion ein CToolTipCtrl Objekt anstelle eines Handles für ein Steuerelement zurückgibt.

Eine Beschreibung der Schieberegler-Steuerelementstile finden Sie unter Trackbar-Steuerelementstile im Windows SDK.

CSliderCtrl::SetBuddy

Weist ein Fenster als Kumpelfenster für ein Schieberegler-Steuerelement zu.

CWnd* SetBuddy(
    CWnd* pWndBuddy,
    BOOL fLocation = TRUE);

Parameter

pWndBuddy
Ein Zeiger auf ein CWnd Objekt, das als Schieberegler-Steuerelement-Kumpel festgelegt wird.

fLocation
Wert, der die Position angibt, an der das Kumpelfenster angezeigt werden soll. Die folgenden Werte sind möglich:

  • TRUE Der Kumpel wird links neben der Trackleiste angezeigt, wenn das Trackbar-Steuerelement den TBS_HORZ Stil verwendet. Wenn die Trackleiste den TBS_VERT Stil verwendet, wird der Kumpel über dem Trackbar-Steuerelement angezeigt.

  • FALSE Der Kumpel wird rechts neben der Trackleiste angezeigt, wenn das Trackbar-Steuerelement den TBS_HORZ Stil verwendet. Wenn die Trackleiste den TBS_VERT Stil verwendet, wird der Kumpel unterhalb des Trackbar-Steuerelements angezeigt.

Rückgabewert

Ein Zeiger auf ein CWnd Objekt, das zuvor dem Schieberegler-Steuerelement an dieser Position zugewiesen wurde.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TBM_SETBUDDY, wie im Windows SDK beschrieben. Beachten Sie, dass diese Memberfunktion Zeiger auf CWnd Objekte anstelle von Fensterhandles sowohl für den Rückgabewert als auch für den Parameter verwendet.

Eine Beschreibung der Schieberegler-Steuerelementstile finden Sie unter Trackbar-Steuerelementstile im Windows SDK.

CSliderCtrl::SetLineSize

Legt die Größe der Linie für ein Schieberegler-Steuerelement fest.

int SetLineSize(int nSize);

Parameter

nSize
Die neue Liniengröße des Schieberegler-Steuerelements.

Rückgabewert

Die vorherige Zeilengröße.

Hinweise

Die Zeilengröße wirkt sich darauf aus, wie viel der Schieberegler für die TB_LINEUP und TB_LINEDOWN Benachrichtigungen verschoben wird.

CSliderCtrl::SetPageSize

Legt die Größe der Seite für ein Schieberegler-Steuerelement fest.

int SetPageSize(int nSize);

Parameter

nSize
Das neue Seitenformat des Schieberegler-Steuerelements.

Rückgabewert

Die vorherige Seitengröße.

Hinweise

Die Seitengröße wirkt sich darauf aus, wie viel der Schieberegler für die TB_PAGEUP und TB_PAGEDOWN Benachrichtigungen verschoben wird.

CSliderCtrl::SetPos

Legt die aktuelle Position des Schiebereglers in einem Schieberegler-Steuerelement fest.

void SetPos(int nPos);

Parameter

nPos
Gibt die neue Schiebereglerposition an.

CSliderCtrl::SetRange

Legt den Bereich (minimale und maximale Positionen) für den Schieberegler in einem Schieberegler-Steuerelement fest.

void SetRange(
    int nMin,
    int nMax,
    BOOL bRedraw = FALSE);

Parameter

nMin
Mindestposition für den Schieberegler.

nMax
Maximale Position für den Schieberegler.

bRedraw
Die Kennzeichnung neu zeichnen. Wenn dieser Parameter lautet TRUE, wird der Schieberegler neu gezeichnet, nachdem der Bereich festgelegt wurde. Andernfalls wird der Schieberegler nicht neu gezeichnet.

CSliderCtrl::SetRangeMax

Legt den maximalen Bereich für den Schieberegler in einem Schieberegler-Steuerelement fest.

void SetRangeMax(
    int nMax,
    BOOL bRedraw = FALSE);

Parameter

nMax
Maximale Position für den Schieberegler.

bRedraw
Die Kennzeichnung neu zeichnen. Wenn dieser Parameter lautet TRUE, wird der Schieberegler neu gezeichnet, nachdem der Bereich festgelegt wurde. Andernfalls wird der Schieberegler nicht neu gezeichnet.

CSliderCtrl::SetRangeMin

Legt den Minimalbereich für den Schieberegler in einem Schieberegler-Steuerelement fest.

void SetRangeMin(
    int nMin,
    BOOL bRedraw = FALSE);

Parameter

nMin
Mindestposition für den Schieberegler.

bRedraw
Die Kennzeichnung neu zeichnen. Wenn dieser Parameter lautet TRUE, wird der Schieberegler neu gezeichnet, nachdem der Bereich festgelegt wurde. Andernfalls wird der Schieberegler nicht neu gezeichnet.

CSliderCtrl::SetSelection

Legt die Anfangs- und Endpositionen für die aktuelle Auswahl in einem Schieberegler-Steuerelement fest.

void SetSelection(
    int nMin,
    int nMax);

Parameter

nMin
Startposition für den Schieberegler.

nMax
Endposition für den Schieberegler.

CSliderCtrl::SetThumbLength

Legt die Länge des Schiebereglers im aktuellen Trackbar-Steuerelement fest.

void SetThumbLength(int nLength);

Parameter

nLength
[in] Länge des Schiebereglers in Pixel.

Hinweise

Für diese Methode muss das Trackbar-Steuerelement auf formatieren TBS_FIXEDLENGTH festgelegt werden.

Diese Methode sendet die TBM_SETTHUMBLENGTH Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im ersten Codebeispiel wird die Variable definiert, m_sliderCtrldie für den Zugriff auf das aktuelle Trackbar-Steuerelement verwendet wird. Im Beispiel wird auch eine Variable definiert, thumbLengthdie zum Speichern der Standardlänge der Minikomponente des Trackbar-Steuerelements verwendet wird. Diese Variablen werden im nächsten Beispiel verwendet.

// Variable to access the slider control.
CSliderCtrl m_sliderCtrl;
// Length of the slider control's thumb.
int thumbLength;

Im nächsten Codebeispiel wird die Minikomponente des Trackbar-Steuerelements auf die doppelte Standardlänge festgelegt.

// Add extra initialization.

// Modify the size of the slider control's thumb.
// First, set the TBS_FIXEDLENGTH style.
m_sliderCtrl.ModifyStyle(0, TBS_FIXEDLENGTH);
thumbLength = m_sliderCtrl.GetThumbLength();
m_sliderCtrl.SetThumbLength(thumbLength * 2);

// End extra initialization.

CSliderCtrl::SetTic

Legt die Position eines Teilstrichs in einem Schieberegler-Steuerelement fest.

BOOL SetTic(int nTic);

Parameter

nTic
Position des Teilstrichs. Dieser Parameter muss einen positiven Wert angeben.

Rückgabewert

Nonzero, wenn das Teilstrich festgelegt ist; andernfalls 0.

CSliderCtrl::SetTicFreq

Legt die Häufigkeit fest, mit der Teilstriche in einem Schieberegler angezeigt werden.

void SetTicFreq(int nFreq);

Parameter

nFreq
Häufigkeit der Teilstriche.

Hinweise

Wenn die Häufigkeit beispielsweise auf 2 festgelegt ist, wird für alle anderen Inkremente im Bereich des Schiebereglers ein Teilstrich angezeigt. Die Standardeinstellung für die Häufigkeit ist 1 (d. h. jedes Inkrement im Bereich ist einem Teilstrich zugeordnet).

Sie müssen das Steuerelement mit der TBS_AUTOTICKS Formatvorlage erstellen, um diese Funktion zu verwenden. Weitere Informationen finden Sie unter CSliderCtrl::Create.

CSliderCtrl::SetTipSide

Positioniert ein QuickInfo-Steuerelement, das von einem Trackbar-Steuerelement verwendet wird.

int SetTipSide(int nLocation);

Parameter

nLocation
Wert, der die Position darstellt, an der das QuickInfo-Steuerelement angezeigt werden soll. Eine Liste möglicher Werte finden Sie in der Win32-Meldung TBM_SETTIPSIDE, wie im Windows SDK beschrieben.

Rückgabewert

Ein Wert, der die vorherige Position des QuickInfo-Steuerelements darstellt. Der Rückgabewert entspricht einem der möglichen Werte für nLocation.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TBM_SETTIPSIDE, wie im Windows SDK beschrieben. Schieberegler-Steuerelemente, die QuickInfos für die TBS_TOOLTIPS Formatvorlagenanzeige verwenden. Eine Beschreibung der Schieberegler-Steuerelementstile finden Sie unter Trackbar-Steuerelementstile im Windows SDK.

CSliderCtrl::SetToolTips

Weist einem Schieberegler-Steuerelement ein QuickInfo-Steuerelement zu.

void SetToolTips(CToolTipCtrl* pWndTip);

Parameter

pWndTip
Ein Zeiger auf ein CToolTipCtrl Objekt, das die QuickInfos enthält, die mit dem Schieberegler-Steuerelement verwendet werden sollen.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TBM_SETTOOLTIPS, wie im Windows SDK beschrieben. Wenn ein Schieberegler-Steuerelement mit der TBS_TOOLTIPS Formatvorlage erstellt wird, wird ein Standardmäßiges QuickInfo-Steuerelement erstellt, das neben dem Schieberegler angezeigt wird und die aktuelle Position des Schiebereglers anzeigt. Eine Beschreibung der Schieberegler-Steuerelementstile finden Sie unter Trackbar-Steuerelementstile im Windows SDK.

Siehe auch

MFC-Beispiel CMNCTRL2
CWnd Klasse
Hierarchiediagramm
CProgressCtrl Klasse