Funzioni membro controllo Slider
Un'applicazione può chiamare le funzioni membro del controllo dispositivo di scorrimento per recuperare informazioni sul controllo dispositivo di scorrimento (CSliderCtrl) e per modificarne le caratteristiche.
Per recuperare la posizione del dispositivo di scorrimento, ovvero il valore scelto dall'utente, usare la funzione membro GetPos . Per impostare la posizione del dispositivo di scorrimento, usare la funzione membro SetPos . In qualsiasi momento è possibile usare la VerifyPos funzione membro per assicurarsi che il dispositivo di scorrimento sia compreso tra i valori minimo e massimo.
L'intervallo di un controllo dispositivo di scorrimento è il set di valori contigui che il controllo dispositivo di scorrimento può rappresentare. La maggior parte delle applicazioni usa la funzione membro SetRange per impostare l'intervallo di un controllo dispositivo di scorrimento quando viene creato per la prima volta. Le applicazioni possono modificare dinamicamente l'intervallo dopo la creazione del controllo dispositivo di scorrimento usando le funzioni membro SetRangeMax e SetRangeMin . Un'applicazione che consente di modificare l'intervallo in modo dinamico recupera in genere le impostazioni dell'intervallo finale al termine dell'utilizzo del dispositivo di scorrimento. Per recuperare queste impostazioni, usare le funzioni membro GetRange, GetRangeMax e GetRangeMin.
Un'applicazione può usare lo stile TBS_AUTOTICKS per visualizzare automaticamente i segni di graduazione di un controllo dispositivo di scorrimento. Se un'applicazione deve controllare la posizione o la frequenza dei segni di graduazione, tuttavia, è possibile usare una serie di funzioni membro.
Per impostare la posizione di un segno di graduazione, un'applicazione può usare la funzione membro SetTic . La funzione membro SetTicFreq consente a un'applicazione di impostare segni di graduazione visualizzati a intervalli regolari nell'intervallo del controllo dispositivo di scorrimento. Ad esempio, l'applicazione può usare questa funzione membro per visualizzare solo 10 segni di graduazione in un intervallo compreso tra 1 e 100.
Per recuperare l'indice nell'intervallo corrispondente a un segno di graduazione, utilizzare la funzione membro GetTic . La funzione membro GetTicArray recupera una matrice di questi indici. Per recuperare la posizione di un segno di graduazione, nelle coordinate client, usare la funzione membro GetTicPos . Un'applicazione può recuperare il numero di segni di graduazione usando la funzione membro GetNumTics .
La funzione membro ClearTics rimuove tutti i segni di graduazione di un controllo dispositivo di scorrimento.
Le dimensioni della riga di un controllo dispositivo di scorrimento determinano la distanza di spostamento del dispositivo di scorrimento quando un'applicazione riceve un messaggio di notifica TB_LINEDOWN o TB_LINEUP. Analogamente, le dimensioni della pagina determinano la risposta ai messaggi di notifica TB_PAGEDOWN e TB_PAGEUP. Le applicazioni possono recuperare e impostare i valori delle dimensioni di riga e pagina usando le funzioni membro GetLineSize, SetLineSize, GetPageSize e SetPageSize .
Un'applicazione può usare funzioni membro per recuperare le dimensioni di un controllo dispositivo di scorrimento. La funzione membro GetThumbRect recupera il rettangolo di delimitazione per il dispositivo di scorrimento. La funzione membro GetChannelRect recupera il rettangolo di delimitazione per il canale del controllo dispositivo di scorrimento. Il canale è l'area su cui si sposta il dispositivo di scorrimento e che contiene l'evidenziazione quando viene selezionato un intervallo.
Se un controllo dispositivo di scorrimento ha lo stile TBS_ENABLEedizione Standard LRANGE, l'utente può selezionare un intervallo di valori contigui. Una serie di funzioni membro consente di regolare dinamicamente l'intervallo di selezione. La funzione membro SetSelection imposta le posizioni iniziali e finali di una selezione. Al termine dell'impostazione di un intervallo di selezione, un'applicazione può recuperare le impostazioni usando la funzione membro GetSelection . Per cancellare la selezione di un utente, usare la funzione membro ClearSel .