Creating a Trackbar
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
A TrackBar, que é conhecido também como um controle controle deslizante, é comum um controle que consiste em de uma barra com marcas marcação sobre ele e um controle deslizante, que é conhecido também como um polegar. Quando um usuário arrasta a controle deslizante ou clica em ambos os lados da-lo, o controle deslizante move no apropriado direção, em uma-incrementos marcação. A seguinte ilustração mostra um TrackBar Windows Embedded CE.
.gif)
Para criar um TrackBar
Especifica a classe TRACKBAR_CLASS in a Boolean parâmetro da CreateWindowEx função.
Essa classe é registrado quando o DLL para a comum controle DLL é carregado. Você pode usar o InitCommonControls função para garantir que este DLL é carregado. Para registrar a classe TrackBar usando o InitCommonControlsEx função, especificar o sinalizador ICC_BAR_CLASSES como o dwICC membro das INITCOMMONCONTROLSEX estrutura que você transmitir in a lpInitCtrls parâmetro.
Especificar um estilo TrackBar usando o dwStyle parâmetro da CreateWindowEx função.
Para um completo listagem de com suporte estilos, consulte Janela e estilos de controle.
Você pode enviar mensagens para o TrackBar para recuperar dados sobre a janela e a alteração suas características.
Para recuperar a posição controle deslizante, que é o valor que um usuário tenha escolhido, use a mensagem TBM_GETPOS. Para definir a posição do controle deslizante, use a mensagem TBM_SETPOS.
O intervalo de um TrackBar é o conjunto de contíguo valores que pode representar o TrackBar. Use a mensagem TBM_SETRANGE para definir o intervalo de um TrackBar quando ela é criada pela primeira vez. Você pode alterar o intervalo dinamicamente usando as mensagens TBM_SETRANGEMAX e TBM_SETRANGEMIN. Um aplicativo que aceita dinâmico alterações intervalo recupera as configurações intervalo final quando um usuário tiver terminado o trabalho com o TrackBar. Para recuperar essas configurações, usam as mensagens TBM_GETRANGEMAX e TBM_GETRANGEMIN.
Um TrackBar automaticamente exibe marcas marcação cada final, a menos que você especificar o estilo TBS_NOTICKS. Usar o estilo TBS_AUTOTICKS para exibir adicional marcação marca automaticamente no regular intervalos ao longo de TrackBar. Por padrão, um TrackBar com o estilo TBS_AUTOTICKS exibe uma marca por cada incremento no intervalo de TrackBar. Para especificar um intervalo diferente para a marcação automática de marcas, enviar a mensagem TBM_SETTICFREQ para a TrackBar.
Para definir a posição de uma única marca, envie a mensagem TBM_SETTIC. Um TrackBar mantém uma matriz de DWORD Valores que armazena a posição de cada marca. A matriz não incluir as marcas primeiro e último marcação que cria o TrackBar automaticamente. Você pode especificar um índice nessa matriz quando você envia a mensagem TBM_GETTIC para recuperar a posição do correspondente marca. Como alternativa, você pode enviar a mensagem TBM_GETPTICS para recuperar um ponteiro para a matriz. Para recuperar o físico posição de uma marca marcação, enviar a mensagem TBM_GETTICPOS. A mensagem TBM_CLEARTICS remove todas as marcas de marcação de um TrackBar, exceto para as marcas de marcação e o sobrenome.
O tamanho de linha TrackBar determina quanto o controle deslizante se move em resposta ao entrada do teclado chaves SETA, such as a chave SETA PARA A DIREITA ou a chave seta para baixo do. Para recuperar ou definir o tamanho de linha, enviar a TBM_GETLINESIZE e TBM_SETLINESIZE mensagens, respectivamente.
Tamanho de página TrackBar determina quanto o controle deslizante move em resposta a entrada do teclado, como da chave PAGE UP ou a chave PAGE DOWN ou entrada mouse, such as cliques no canalizar TrackBar. Para recuperar ou Definir tamanho de página, enviar as mensagens TBM_GETPAGESIZE e TBM_SETPAGESIZE.
Um aplicativo pode enviar mensagens para recuperar as dimensões de uma TrackBar. A mensagem TBM_GETTHUMBRECT recupera o retângulo delimitador para o controle deslizante. A mensagem TBM_GETTHUMBLENGTH recupera o comprimento da controle deslizante. A mensagem TBM_GETCHANNELRECT recupera o retângulo delimitador para a canalizar TrackBar, qual é a área através da qual o controle deslizante Move. Se um TrackBar tem o estilo TBS_FIXEDLENGTH, você pode enviar a mensagem TBM_SETTHUMBLENGTH para alteração o comprimento da controle deslizante.
Um TrackBar com o estilo TBS_ENABLESELRANGE pode indicar um intervalo seleção realçar um intervalo da canalizar TrackBar e Exibindo marcação triangular marcas no iniciar e no final da seleção. Quando um TrackBar tiver esse estilo, você pode enviar mensagens para definir e recuperar o intervalo seleção. Normalmente, um aplicativo manipula as mensagens TrackBar e define o intervalo seleção de TrackBar entrada do usuário de acordo com. A mensagem TBM_SETSEL define as posições inicial e final de uma seleção. Para definir somente a posição inicial ou apenas a posição final de uma seleção, use a mensagem TBM_SETSELSTART ou a mensagem TBM_SETSELEND. Para recuperar o Inicial e Final posições de um intervalo seleção, enviar as mensagens TBM_GETSELSTART e TBM_GETSELEND. Para Clear um intervalo seleção, enviar a mensagem TBM_CLEARSEL.