Partilhar via


Atributos de localização e comentários

Os comentários de localização do Windows Presentation Foundation (WPF) são propriedades, dentro do código-fonte XAML, fornecidas por desenvolvedores para fornecer regras e dicas para localização. Os comentários de localização do WPF contêm dois conjuntos de informações: atributos de localizabilidade e comentários de localização de forma livre. Os atributos de localizabilidade são usados pela API de Localização do WPF para indicar quais recursos devem ser localizados. Comentários de forma livre são qualquer informação que o autor do aplicativo queira incluir.

Adicionar comentários de localização

Se os autores de aplicativos de marcação tiverem requisitos para elementos específicos em XAML, como restrições de comprimento de texto, família de fontes ou tamanho de fonte, eles poderão transmitir essas informações aos localizadores com comentários no código XAML. O processo para adicionar comentários ao código-fonte é o seguinte:

  1. O desenvolvedor de aplicativos adiciona comentários de localização ao código-fonte XAML.

  2. Durante o processo de compilação, você pode especificar no arquivo .proj se deseja deixar os comentários de localização de forma livre no assembly, remover parte dos comentários ou remover todos os comentários. Os comentários removidos são colocados em um arquivo separado. Você especifica sua opção usando uma tag LocalizationDirectivesToLocFile, por exemplo:

    <LocalizationDirectivesToLocFile> valor</LocalizationDirectivesToLocFile>

  3. Os valores que podem ser atribuídos são:

    • Nenhum - Ambos os comentários e atributos permanecem dentro do assembly e nenhum arquivo separado é gerado.

    • CommentsOnly - Retira apenas os comentários da montagem e coloca-os no ficheiro LocFile separado.

    • Todos os - Retira os comentários e os atributos da assemblagem e coloca ambos num LocFile separado.

  4. Quando recursos localizáveis são extraídos do BAML, os atributos de localizabilidade são respeitados pela API de Localização do BAML.

  5. Os arquivos de comentários de localização, contendo apenas comentários de forma livre, são incorporados ao processo de localização posteriormente.

O exemplo a seguir mostra como adicionar comentários de localização a um arquivo XAML.

<TextBlock x:Id = "text01"

FontFamily = "Microsoft Sans Serif"

FontSize = "12"

Localization.Attributes = "$Content (Unmodifiable Readable Text)

FontFamily (Unmodifiable Readable)"

Localization.Comments = "$Content (Trademark)

FontSize (Trademark font size)" >

Microsoft

</TextBlock>

No exemplo anterior, a seção Localization.Attributes contém os atributos de localização e a seção Localization.Comments os comentários de forma livre. As tabelas a seguir mostram os atributos e comentários e seu significado para o localizador.

Atributos de localização Significado
$Content (texto legível não modificável) O conteúdo do elemento TextBlock não pode ser modificado. Os localizadores não podem alterar a palavra "Microsoft". O conteúdo é visível (legível) para o localizador. A categoria do conteúdo é texto.
FontFamily (Não modificável legível) A propriedade da família de fontes do elemento TextBlock não pode ser alterada, mas é visível para o localizador.
Comentários de localização em texto livre Significado
$Content (Marca registada) O autor do aplicativo informa ao localizador que o conteúdo no elemento TextBlock é uma marca registrada.
FontSize (Tamanho da fonte da marca comercial) O autor do aplicativo indica que a propriedade font size deve seguir o tamanho padrão da marca registrada.

Atributos de localizabilidade

As informações em Localization.Attributes contêm uma lista de pares: o nome do valor de destino e os valores de localizabilidade associados. O nome de destino pode ser um nome de propriedade ou o especial nome $Content. Se for um nome de propriedade, o valor de destino é o valor da propriedade. Se for $Content, o valor de destino é o conteúdo do elemento.

Existem três tipos de atributos:

  • Categoria. Isso especifica se um valor deve ser modificável a partir de uma ferramenta de localização. Ver Category.

  • Legibilidade. Isso especifica se uma ferramenta de localização deve ler (e exibir) um valor. Ver Readability.

  • Alterabilidade. Isso especifica se uma ferramenta de localização permite que um valor seja modificado. Veja o Modifiability.

Esses atributos podem ser especificados em qualquer ordem delimitada por um espaço. Caso atributos duplicados sejam especificados, o último atributo substituirá os anteriores. Por exemplo, Localization.Attributes = "Unmodifiable Modifiable" define Modifiability como Modifiable porque é o último valor.

A modificabilidade e a legibilidade são autoexplicativas. O atributo Category fornece categorias predefinidas que ajudam o localizador ao traduzir texto. Categorias, como Texto, Rótulo e Título, fornecem ao localizador informações sobre como traduzir o texto. Há também categorias especiais: Nenhum, Herdar, Ignorar e Nunca Localizar.

A tabela a seguir mostra o significado das categorias especiais.

Categoria Significado
Nenhum O valor-alvo não tem categoria definida.
Herdar O valor de destino herda a sua categoria do seu parente.
Ignorar O valor de destino é ignorado no processo de localização. Ignorar afeta apenas o valor atual. Isso não afetará nós filhos.
NeverLocalize O valor atual não pode ser localizado. Esta categoria é herdada pelos filhos de um elemento.

Comentários de localização

Localization.Comments contém cadeias de caracteres de forma livre relativas ao valor de destino. Os desenvolvedores de aplicativos podem adicionar informações para dar dicas aos localizadores sobre como o texto dos aplicativos deve ser traduzido. O formato dos comentários pode ser qualquer string rodeada por "()". Utilize '\' para escapar de caracteres.

Ver também