Share via


Criando um arquivo de definição de capa

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

Um arquivo de definição de pele é um arquivo de texto que define uma capa e todas as suas partes compostas. A extensão de nome de arquivo deve ser .skn.

Cada arquivo de definição de capa deve começar com a linha a seguir, que especifica o número de versão do arquivo de capa. A tabela a seguir mostra Reprodutor Multimídia do Windows versões e a linha de código que devem ser usadas para identificar cada uma em um arquivo de definição de capa. Embora alguns dos números nas linhas de código não sejam o que você esperaria, eles estão corretos, conforme mostrado na tabela a seguir.

Reprodutor Multimídia do Windows versão Primeira linha do arquivo de definição de pele
1.01.1
[Pocket WMP Skin File v1.0]
1.2 [Pocket WMP Skin File v1.2]
7,0 [Pocket WMP Skin File v2.0]
7.1 [Pocket WMP Skin File v8.0]
Série 9 [Pocket WMP Skin File v9.0.1]
10 Mobile [Pocket WMP Skin File v9.0.1]
10.1 Celular [Pocket WMP Skin File v9.0.1]

O número de versão 9.0.1 é para skins criadas especificamente para Reprodutor Multimídia do Windows série 9 ou posterior. As capas com um número de versão anterior são abertas por Reprodutor Multimídia do Windows série 9 ou posterior como modo retrato, 96 pontos por polegada (DPI).

O arquivo de definição de capa consiste em várias seções. Cada seção define uma área específica da pele. As seções devem ser colocadas na seguinte ordem:

  1. Descrição
  2. Bitmaps
  3. Vídeo
  4. Botões
  5. Status
  6. Texto
  7. Marquee
  8. Trackbars

Cada seção começa com o nome da seção entre colchetes, por exemplo:

[ Bitmaps ]

Observação

O arquivo de definição de capa não será analisado corretamente, a menos que você inclua espaços entre os colchetes e o nome da seção.

Em seguida, uma ou mais linhas definem imagens individuais, botões e assim por diante. Por exemplo, uma seção bitmaps pode incluir o seguinte:

    Background  Background.bmp  0,0
    Disabled    Disabled.bmp    0,0
    Pushed      Pushed.bmp      0,0
    Region      Region.bmp      0,0
    Super       Super.bmp       0,0

Não é necessário alinhar os valores em colunas, mas ajudará seu código a ser mais legível. Para obter mais detalhes sobre cada seção do arquivo de definição de capa, consulte a Referência de pele.

Observação

Não use guias em nenhum lugar no arquivo; em vez disso, use espaços extras. Isso é muito importante, pois pressionar a tecla TAB durante a gravação ou edição do arquivo de definição de pele fará com que toda a pele falhe. Cada linha deve ser concluída e não pode continuar em uma segunda linha. Além disso, os valores Region e Super são preteridos para skins usadas com Reprodutor Multimídia do Windows 10 Mobile ou posterior.

Arquivo de definição de capa