Compartilhar via

Atributos e comentários de localização

Os comentários de localização do WPF (Windows Presentation Foundation) são propriedades, dentro do código-fonte XAML, fornecidas pelos 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 deseja incluir.

Adicionar comentários de localização

Se os autores do aplicativo de marcação tiverem requisitos para elementos específicos no XAML, como restrições no comprimento do texto, na família de fontes ou no tamanho da 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 build, 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 despojados são colocados em um arquivo separado. Especifique sua opção usando uma LocalizationDirectivesToLocFile marca, por exemplo:

    <LocalizationDirectivesToLocFile> valor</LocalizationDirectivesToLocFile>

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

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

    • CommentsOnly - Remove apenas os comentários do assembly e os coloca no LocFile separado.

    • Tudo – remove os comentários e os atributos do assembly e os coloca em um 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ário de localização, que contêm 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 (legível não modificável) A propriedade da família de fontes do elemento TextBlock não pode ser alterada, mas é visível para o localizador.
Comentários livres sobre localização Significado
$Content (Marca registrada) O autor do aplicativo informa ao localizador que o conteúdo no elemento TextBlock é uma marca registrada.
FontSize (tamanho da fonte da marca) O autor do aplicativo indica que a propriedade de tamanho da fonte deve seguir o tamanho da marca padrão.

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 um nome de $Content especial. Se for um nome de propriedade, o valor de destino será o valor da propriedade. Se for $Content, o valor de destino será o conteúdo do elemento.

Há três tipos de atributos:

  • Categoria. Isso especifica se um valor deve ser modificável de uma ferramenta de localizador. Consulte Category.

  • Legibilidade. Isso especifica se uma ferramenta de localizador deve ler (e exibir) um valor. Consulte Readability.

  • Modificabilidade. Isso especifica se uma ferramenta de localizador permite que um valor seja modificado. Consulte 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, ao definir Localization.Attributes = "Não Modificável Modificável", a modificabilidade é configurada para modificável 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: None, Inherit, Ignore e NeverLocalize.

A tabela a seguir mostra o significado das categorias especiais.

Categoria Significado
Nenhum O valor de destino não tem nenhuma categoria definida.
Herdar O valor solicitado herda sua categoria do elemento pai.
Ignorar O valor alvo é ignorado no processo de localização. Ignorar afeta apenas o valor atual. Isso não afetará os nós filhos.
NeverLocalize O valor atual não pode ser localizado. Essa 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 cadeia de caracteres cercada por "()". Use '\' para escapar de caracteres.

Consulte também

  • Last updated on