Tipo de botão

  • 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.]

Os botões vêm em dois tipos gerais: localização e região. Cada tipo geral tem três tipos específicos, fazendo seis tipos de botão ao todo.

Observação

Os tipos de botões são preteridos em skins para Reprodutor Multimídia do Windows 10 Mobile ou posterior.

 

Tipos de botão de localização

Os botões de localização usam coordenadas para definir seus locais em relação à tela de fundo. A tabela a seguir mostra os valores válidos para tipos de botão de localização. Você não precisa definir valores para tipos que não usará em sua pele.

Valor Descrição
Push Define um botão que dispara um evento uma vez. O botão deve ser pressionado cada vez para disparar outros eventos. Um exemplo seria um botão que se move para o próximo item na playlist. O local do botão é definido por suas coordenadas.
Alternar Define um botão que dispara um evento que altera um estado. O estado permanece até que o botão seja pressionado novamente. Um exemplo é um botão que embaralha a playlist. Depois que a playlist estiver em um estado embaralhado, ela permanecerá embaralhada até que o botão seja pressionado novamente. O local do botão é definido por suas coordenadas.
2Push Define um botão que dispara um evento e, em seguida, muda para um estado que está pronto para disparar um evento diferente. Os dois estados são alternados sempre que o botão é pressionado. Um exemplo é um botão que usa a função PlayPause para alternar entre reproduzir e pausar o item de mídia atual. Quando o botão é pressionado pela primeira vez, o estado de Reprodução primária é disparado e uma imagem secundária é exibida para indicar que um evento Pause pode ser disparado. Quando o botão é pressionado novamente, o estado Pausar é disparado e a imagem original é exibida para indicar que um evento Play pode ser disparado. O local do botão é definido por suas coordenadas.

 

Tipos de botão de região

Os botões de região usam áreas de cores na imagem Região para definir onde os toques serão processados para um botão específico. A tabela a seguir mostra os valores válidos para tipos de botão de região. Você não precisa definir valores para tipos que não usará em sua pele.

Valor Descrição
PushHit Semelhante ao valor do botão Pressionar, exceto que a área de clique do botão é definida pelo valor de cor na imagem Região.
ToggleHit Semelhante ao valor do botão Alternar, exceto que a área de clique do botão é definida pelo valor de cor na imagem Região.
2PushHit Semelhante ao valor do botão 2Push, exceto que a área de clique do botão é definida pelo valor de cor na imagem Região.

 

Botões