Elemento SLIDER

  • Artigo

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O elemento SLIDER fornece uma maneira de criar e manipular um controle deslizante horizontal ou vertical simples. Ele dá suporte aos seguintes atributos e manipuladores de eventos. Elementos SLIDER predefinidos também são fornecidos para conveniência.

O elemento SLIDER dá suporte aos atributos a seguir.

Atributo Descrição
Backgroundcolor Especifica ou recupera a cor da tela de fundo do controle deslizante.
backgroundEndColor Especifica ou recupera a cor final da tela de fundo do controle deslizante.
backgroundHoverImage Especifica ou recupera a imagem de plano de fundo do controle deslizante que aparece ao passar o mouse sobre ele.
backgroundImage Especifica ou recupera a imagem de plano de fundo padrão do controle deslizante.
Bordersize Especifica ou recupera o tamanho da borda em pixels.
cursor Especifica ou recupera um valor que indica qual tipo de cursor aparece quando o mouse está sobre o controle deslizante.
direction Especifica ou recupera a direção em que as imagens deslizantes são dispostas.
disabledColor Especifica ou recupera a cor desabilitada do controle deslizante.
disabledImage Especifica ou recupera a imagem do controle deslizante que aparece quando o controle é desabilitado.
Foregroundcolor Especifica ou recupera a cor de primeiro plano do controle deslizante.
foregroundEndColor Especifica ou recupera a cor final de primeiro plano do controle deslizante.
foregroundHoverImage Especifica ou recupera a imagem de primeiro plano do controle deslizante que aparece ao focalizar sobre ele com o mouse.
foregroundImage Especifica ou recupera a imagem de primeiro plano padrão do controle deslizante.
foregroundProgress Especifica ou recupera a posição atual da barra de progresso em primeiro plano como um percentual da área do controle deslizante.
max Especifica ou recupera o valor máximo do intervalo definido pelo controle deslizante.
min Especifica ou recupera o valor mínimo do intervalo definido pelo controle deslizante.
Slide Especifica ou recupera um valor que indica se a imagem em primeiro plano desliza sobre a imagem de plano de fundo.
thumbDisabledImage Especifica ou recupera a imagem de polegar desabilitada do controle deslizante.
thumbDownImage Especifica ou recupera a imagem que representa o estado inferior do polegar.
thumbHoverImage Especifica ou recupera a imagem do polegar que aparece ao focalizar com o mouse.
thumbImage Especifica ou recupera a imagem que será usada para representar a posição atual do controle deslizante.
Azulejos Especifica ou recupera um valor que indica se as imagens do controle deslizante serão lado a lado.
Tooltip Especifica ou recupera o texto da Dica de Ferramenta para o controle deslizante.
transparencyColor Especifica ou recupera a cor transparente das imagens do controle deslizante.
useForegroundProgress Especifica ou recupera um valor que indica se a barra de progresso em primeiro plano será usada.
value Especifica e recupera a posição atual do controle deslizante.

 

O elemento SLIDER pode implementar os manipuladores de eventos a seguir.

Manipulador de eventos Descrição
onDragBegin Manipula um evento que ocorre quando o usuário clica e segura o botão esquerdo do mouse para baixo e começa a arrastar o mouse.
onDragEnd Manipula um evento que ocorre quando o botão esquerdo do mouse é liberado após uma operação de arrastar.
onPositionChange Manipula um evento que ocorre quando a posição do controle deslizante é alterada como resultado do usuário clicar ou arrastar.

 

O elemento SLIDER dá suporte aos atributos de ambiente e pode implementar os manipuladores de eventos de ambiente. Para obter mais informações, consulte Atributos ambientes e manipuladores de eventos ambientes.

Controles deslizantes predefinidos são elementos SLIDER normais com várias configurações de atributo comuns especificadas por padrão. Os controles deslizantes predefinidos a seguir estão disponíveis.

CONTROLE DESLIZANTE predefinido Descrição
BALANCESLIDER Um CONTROLE DESLIZANTE usado para definir o saldo de áudio.
SEEKSLIDER Um CONTROLE DESLIZANTE usado para buscar qualquer posição dentro de um arquivo de mídia.
VOLUMESLIDER Um CONTROLE DESLIZANTE usado para definir o volume de áudio.

 

Referência de programação de capa