BUTTONGROUP.mappingImage

[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 atributo mappingImage especifica ou recupera o nome da imagem que representa o mapa de botões do BUTTONGROUP.

        elementID.mappingImage

Valores possíveis

Esse atributo é uma cadeia de caracteres de leitura/ gravação.

Comentários

Esse é um atributo obrigatório que deve ser especificado.

A imagem de mapeamento deve ser as mesmas dimensões que a imagem main. É um mapa das áreas clicáveis da imagem main. Construa o mapa preenchendo cada área clicável com uma cor diferente.

Ao definir cada BUTTONELEMENT, designe sua cor do mapa usando o atributo mappingColor . Por exemplo, se você tiver um gráfico de botão em forma de sinal de parada na imagem main, poderá criar um mapa com a área do sinal colorido de vermelho. O atributo BUTTONELEMENT deve ser especificado como vermelho para tornar a imagem de sinal de parada clicável.

Os formatos de imagem com suporte são BMP, JPG, PNG e GIF (sem incluir GIFs animados). Como os JPGs são perdidos e, portanto, sujeitos a uma alteração de cor inesperada, eles não são recomendados para mapear imagens.

Exemplos

A ilustração a seguir é um exemplo de mappingImage e a imagem visível à qual corresponde. Essas imagens fazem parte da pele na pasta Tiny incluída no SDK.

de fundo de amostra de mapeamento

Consulte BUTTONELEMENT. atributo mappingColor para um exemplo de código que ilustra o uso desse atributo.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior

Confira também

BUTTONELEMENT.mappingColor

Elemento BUTTONGROUP

BUTTONGROUP.image

BUTTONGROUP.transparencyColor