Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um aplicativo pode chamar as funções de 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 que o usuário escolheu), 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 certificar-se de 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 de membro SetRange para definir o intervalo de um controle deslizante quando ele é criado pela primeira vez. Os aplicativos podem alterar o intervalo dinamicamente após o controle deslizante ter 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 do intervalo 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. No entanto, se uma aplicação precisar de controlar a posição ou a frequência das marcas de escala, podem ser utilizadas várias funções associadas.
Para definir a posição de uma marca de tick, um aplicativo pode usar a função membro SetTic. A função de membro SetTicFreq permite que uma aplicação defina marcas de escala que aparecem em intervalos regulares no alcance do controlo deslizante. Por exemplo, a aplicação pode usar esta função associada para exibir apenas 10 marcas de escala num intervalo de 1 a 100.
Para recuperar o índice no intervalo correspondente a uma marca de escala, use a função de membro GetTic . A função membro GetTicArray recupera um array desses índices. Para recuperar a posição de uma marca de verificação, nas coordenadas do cliente, use a função de membro GetTicPos . Uma aplicação pode recuperar o número de marcas de escala usando a função membro GetNumTics.
A função de membro ClearTics remove todas as marcas de escala de um controle deslizante.
O tamanho da linha de um controle deslizante determina até onde 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. As aplicações 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 de membro para recuperar as dimensões de um controle deslizante. A função membro GetThumbRect obtém o retângulo delimitador para o controle deslizante. A função membro GetChannelRect recupera o retângulo delimitador do canal do cursor deslizante. O canal é a área sobre a qual o slider se desloca e que contém o destaque quando uma faixa é selecionada.
Se um controle deslizante tiver o estilo TBS_ENABLESELRANGE, o usuário poderá selecionar um intervalo de valores contíguos a partir dele. Uma série de 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 de membro ClearSel .