Partilhar via

Barra de faixas

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com controles de trackbar.

Visão geral

Tópico Índice
Sobre os controles da barra de trilha Uma barra de faixas é uma janela que contém um controle deslizante (às vezes chamado de polegar) em um canal e marcas de escala opcionais. Quando o usuário move o controle deslizante, usando o mouse ou as teclas de direção, a barra de controle envia mensagens de notificação para indicar a alteração.
Usando controles da barra de controle Esta seção fornece detalhes de implementação e exemplos de controles de barra de controle.

Mensagens

Tópico Índice
TBM_CLEARSEL Limpa o intervalo de seleção atual em uma barra de faixa.
TBM_CLEARTICS Remove as marcas de escala atuais de uma barra de faixa. Esta mensagem não remove a primeira e a última marcas de verificação, que são criadas automaticamente pela barra de faixas.
TBM_GETBUDDY Recupera a alça para uma janela de amigo de controle da barra de trilha em um determinado local. O local especificado é relativo à orientação do controle (horizontal ou vertical).
TBM_GETCHANNELRECT Recupera o tamanho e a posição do retângulo delimitador do canal de uma barra de faixas. (O canal é a área sobre a qual o controle deslizante se move. Ele contém o realce quando um intervalo é selecionado.)
TBM_GETLINESIZE Recupera o número de posições lógicas que o controle deslizante da barra de faixas move em resposta à entrada do teclado das teclas de seta, como as teclas ou . As posições lógicas são os incrementos inteiros no intervalo da barra de faixas de posições deslizantes mínimas a máximas.
TBM_GETNUMTICS Recupera o número de marcas de escala em uma barra de faixa.
TBM_GETPAGESIZE Recupera o número de posições lógicas que o controle deslizante da barra de faixas move em resposta à entrada do teclado, como as teclas ou, ou à entrada do mouse, como cliques no canal da barra de faixas. As posições lógicas são os incrementos inteiros no intervalo da barra de faixas de posições deslizantes mínimas a máximas.
TBM_GETPOS Recupera a posição lógica atual do controle deslizante em uma barra de faixas. As posições lógicas são os valores inteiros no intervalo de posições deslizantes mínimas a máximas da barra de faixas.
TBM_GETPTICS Recupera o endereço de uma matriz que contém as posições das marcas de escala de uma barra de controle.
TBM_GETRANGEMAX Recupera a posição máxima do controle deslizante em uma barra de faixa.
TBM_GETRANGEMIN Recupera a posição mínima do controle deslizante em uma barra de faixa.
TBM_GETSELEND Recupera a posição final do intervalo de seleção atual em uma barra de faixa.
TBM_GETSELSTART Recupera a posição inicial do intervalo de seleção atual em uma barra de faixa.
TBM_GETTHUMBLENGTH Recupera o comprimento do controle deslizante em uma barra de faixa.
TBM_GETTHUMBRECT Recupera o tamanho e a posição do retângulo delimitador do controle deslizante em uma barra de faixa.
TBM_GETTIC Recupera a posição lógica de uma marca de escala em uma barra de faixa. A posição lógica pode ser qualquer um dos valores inteiros no intervalo da barra de faixas de posições deslizantes mínimas a máximas.
TBM_GETTICPOS Recupera a posição física atual de uma marca de escala em uma barra de faixa.
TBM_GETTOOLTIPS Recupera o identificador para o controle de dica de ferramenta atribuído à barra de faixa, se houver.
TBM_GETUNICODEFORMAT Recupera o sinalizador de formato de caractere Unicode para o controle.
TBM_SETBUDDY Atribui uma janela como a janela de amigo para um controle de trackbar. As janelas de amigos da barra de controle são exibidas automaticamente em um local relativo à orientação do controle (horizontal ou vertical).
TBM_SETLINESIZE Define o número de posições lógicas que o controle deslizante da barra de faixas move em resposta à entrada do teclado das teclas de seta, como as teclas ou . As posições lógicas são os incrementos inteiros no intervalo da barra de faixas de posições deslizantes mínimas a máximas.
TBM_SETPAGESIZE Define o número de posições lógicas que o controle deslizante da barra de faixas move em resposta à entrada do teclado, como as teclas ou ou a entrada do mouse, como cliques no canal da barra de faixas. As posições lógicas são os incrementos inteiros no intervalo da barra de faixas de posições deslizantes mínimas a máximas.
TBM_SETPOS Define a posição lógica atual do controle deslizante em uma barra de faixas.
TBM_SETPOSNOTIFY Define a posição lógica atual do controle deslizante em uma barra de faixas.
TBM_SETRANGE Define o intervalo de posições lógicas mínimas e máximas para o controle deslizante em uma barra de faixas.
TBM_SETRANGEMAX Define a posição lógica máxima para o controle deslizante em uma barra de faixas.
TBM_SETRANGEMIN Define a posição lógica mínima para o controle deslizante em uma barra de faixas.
TBM_SETSEL Define as posições inicial e final para o intervalo de seleção disponível em uma barra de faixa.
TBM_SETSELEND Define a posição lógica final do intervalo de seleção atual em uma barra de faixa. Esta mensagem será ignorada se a barra de faixas não tiver o estilo TBS_ENABLESELRANGE.
TBM_SETSELSTART Define a posição lógica inicial do intervalo de seleção atual em uma barra de faixas. Esta mensagem será ignorada se a barra de faixas não tiver o estilo TBS_ENABLESELRANGE.
TBM_SETTHUMBLENGTH Define o comprimento do controle deslizante em uma barra de faixas. Esta mensagem será ignorada se a barra de faixas não tiver o estilo TBS_FIXEDLENGTH.
TBM_SETTIC Define uma marca de escala em uma barra de controle na posição lógica especificada.
TBM_SETTICFREQ Define a frequência de intervalo para marcas de escala em uma barra de faixa. Por exemplo, se a frequência estiver definida como dois, será exibida uma marca de escala para cada outro incremento no intervalo da barra de faixa. A configuração padrão para a frequência é um; ou seja, cada incremento no intervalo está associado a uma marca de escala.
TBM_SETTIPSIDE Posiciona um controle de dica de ferramenta usado por um controle de barra de faixa. Controles da barra de trilha que usam as dicas de ferramentas de exibição de estilo TBS_TOOLTIPS.
TBM_SETTOOLTIPS Atribui um controle de dica de ferramenta a um controle de barra de faixa.
TBM_SETUNICODEFORMAT Define o sinalizador de formato de caractere Unicode para o controle. Esta mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle.

Notificações

Tópico Índice
NM_CUSTOMDRAW (trackbar) Enviado por um controle de barra de trilha para notificar suas janelas pai sobre operações de desenho. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_RELEASEDCAPTURE (trackbar) Notifica a janela pai de um controle de barra de faixa de que o controle está liberando a captura do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
TRBN_THUMBPOSCHANGING Notifica que a posição do polegar numa barra de controlo está a mudar. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.

Constantes

Tópico Índice
Valores de desenho personalizados Esta seção lista os valores usados para identificar as partes de um controle de trackbar.
Estilos de controle da barra de trilha Esta seção contém informações sobre os estilos usados com os controles da barra de faixa.