Funções de membro de controle deslizante
Um aplicativo pode chamar as funções membro do controle deslizante para recuperar informações sobre o controle deslizante (CSliderCtrl) e alterar suas características.
Para recuperar a posição do controle deslizante (ou seja, o valor escolhido pelo usuário), use a função membro GetPos. Para definir a posição do controle deslizante, use a função membro SetPos. A qualquer momento, você pode usar a função membro VerifyPos para garantir que o controle deslizante esteja entre os valores mínimo e máximo.
O intervalo de um controle deslizante é o conjunto de valores contíguos que o controle deslizante pode representar. A maioria dos aplicativos usa a função membro SetRange para definir o intervalo de um controle deslizante quando ele é criado pela primeira vez. Os aplicativos podem alterar dinamicamente o intervalo depois que o controle deslizante tiver sido criado usando as funções membro SetRangeMax e SetRangeMin. Um aplicativo que permite que o intervalo seja alterado dinamicamente normalmente recupera as configurações finais de intervalo quando o usuário terminar de trabalhar com o controle deslizante. Para recuperar essas configurações, use as funções membro GetRange, GetRangeMax e GetRangeMin.
Um aplicativo pode usar o estilo TBS_AUTOTICKS para que as marcas de escala de um controle deslizante sejam exibidas automaticamente. Se um aplicativo precisar controlar a posição ou a frequência das marcas de escala, no entanto, poderão ser usadas várias funções membro.
Para definir a posição de uma marca de escala, um aplicativo pode usar a função membro SetTic. A função membro SetTicFreq permite que um aplicativo defina marcas de escala que aparecem em intervalos regulares no intervalo do controle deslizante. Por exemplo, o aplicativo pode usar essa função membro para exibir apenas 10 marcas de escala em um intervalo de 1 a 100.
Para recuperar o índice no intervalo correspondente a uma marca de escala, use a função membro GetTic. A função membro GetTicArray recupera uma matriz desses índices. Para recuperar a posição de uma marca de escala, nas coordenadas do cliente, use a função membro GetTicPos. Um aplicativo pode recuperar o número de marcas de escala usando a função membro GetNumTics.
A função membro ClearTics remove todas as marcas de escala de um controle deslizante.
O tamanho da linha de um controle deslizante determina até que ponto o controle deslizante se move quando um aplicativo recebe uma mensagem de notificação TB_LINEDOWN ou TB_LINEUP. Da mesma forma, o tamanho da página determina a resposta às mensagens de notificação TB_PAGEDOWN e TB_PAGEUP. Os aplicativos podem recuperar e definir os valores de tamanho de linha e página usando as funções membro GetLineSize, SetLineSize, GetPageSize e SetPageSize.
Um aplicativo pode usar funções membro para recuperar as dimensões de um controle deslizante. A função membro GetThumbRect recupera o retângulo delimitador para o controle deslizante. A função membro GetChannelRect recupera o retângulo delimitador para o canal do controle deslizante. (O canal é a área sobre a qual o controle deslizante se move e que recebe o realce quando um intervalo é selecionado.)
Se um controle deslizante tiver o estilo TBS_ENABLESELRANGE, o usuário poderá selecionar um intervalo de valores contíguos nele. Várias funções membro permitem que o intervalo de seleção seja ajustado dinamicamente. A função membro SetSelection define as posições inicial e final de uma seleção. Quando o usuário terminar de definir um intervalo de seleção, um aplicativo poderá recuperar as configurações usando a função membro GetSelection. Para limpar a seleção de um usuário, use a função membro ClearSel.