Compartilhar via


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 de membro GetPos . Para definir a posição do controle deslizante, use a função membro SetPos. A qualquer momento, você pode usar a VerifyPos função de membro para garantir que a barra 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 após a criação do controle deslizante usando as funções de membro SetRangeMax e SetRangeMin . Um aplicativo que permite que o intervalo seja alterado dinamicamente normalmente recupera as configurações de intervalo final quando o usuário termina de trabalhar com o controle deslizante. Para recuperar essas configurações, use as funções de 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 de 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 de 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 a barra deslizante se move e que contém o destaque quando um intervalo é selecionado.)

Se um controle deslizante tiver o estilo TBS_ENABLESELRANGE, o usuário poderá selecionar um intervalo de valores contíguos dele. Várias funções de 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 de membro GetSelection . Para limpar a seleção de um usuário, use a função membro ClearSel.

Consulte também

Usando CSliderCtrl
Controles