Definição de idiomas para conversão de textos

Esta página apresenta os itens para utilização dos seletores de idiomas. Estes atributos estão disponíveis para o HIscada Pro a partir da versão 1.4.00.

../_images/idiomasthree.png — Fig. Árvore de itens de Idiomas

Nota

Para efetuar a utilização do idioma, deve-se utilizar entre as frases dos idiomas o separador ||. Exemplificando, utilizando o objeto de tela StaticText, no campo de Título do objeto escreva a frase da seguinte forma O idioma atual é Português - Texto do indice 0||The current language is English - Texto do indice 1. Dependendo do idioma corrente da aplicação ou do valor do Tag associado a Idiomas, será mostrado na tela o texto O idioma atual é Português - Texto do indice 0 ou The current language is English - Texto do indice 1.

Idiomas

ico1 Este item permite a criação dos idiomas a serem utilizados no projeto.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item “Idiomas” no painel de projeto.

Identificação
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)

Propriedades Específicas

Propriedade

Descrição

Default

Idioma Corrente

Seleciona o Idioma que será utilizado na aplicação. A lista de idiomas será dependente da quantidade de item do tipo Idioma.

Obs: Caso seja expecificado um tag no campo Nome Tag, este campo será desabilitado.

Português Brasil

Tags
Propriedade	Descrição	Default
Nome Tag	Nome do tag associado ao objeto. O valor informado neste tag representa o indice do Idioma que deverá ser utilizado.	(Nenhum)
Índice	Offset para o valor do Tag associado caso ele seja um vetor.	1

Idioma

ico2 Para adicionar um idioma na aplicação, clique com botão direito sobre o item “Idiomas” e selecione o menu “Adiciona Item/Idioma”. Com isso, o item Idioma_001 será criado.

Nota

Quando houver mais de um Idioma criado, o indice do idioma da-se pela ordem que o mesmo se encontra na lista. Exemplo: O primeiro Idioma terá o indice 0. O segundo Idioma terá o indice 1, e assim sucessivamente.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item “Idioma” no painel de projeto.

Identificação
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)

Propriedades Específicas
Propriedade	Descrição	Default
Nome do Idioma	Identificação do nome do idioma.	Português Brasil

API Lua

A lista das propriedades deste e outros componentes está documentada nas páginas de scripts e de Hierarquia dos Scripts Lua

Acesso a Idiomas

O modelo de acesso aos Idiomas consiste em usar o objeto global Idiomas para gerenciar os Idiomas da aplicação. Os Idiomas permitem acesso, lista e valor do idioma corrente dos idiomas cadastrados.

Nota

As funções do Gerenciador dos Idiomas somente podem ser utilizadas a partir da versão 1.4.00 do HIscada Pro.

Modelo de Dados

../_images/uml.png — Fig. Modelo de Dados

Index= Languages.CurrentLanguage

Descrição:

retorna um index do idioma corrente.

Parâmetros de saída:

index - indice do idioma corrente.

Exemplo de utilização:

MessageBox("idioma_001||idioma_002", Languages.CurrentLanguage)

objLanguages = Languages.ListLanguages()

Descrição:

retorna um objeto lista de Idiomas.

Parâmetros de saída:

objLanguages - Lista de Idiomas, Se não existir retorna nil.

Exemplo de utilização:

function printLanguage(i)
     print("Name = " .. i.Name)
     print("Language Name = " .. i.LanguageName)
end

-- Retorna lista de Languages
local LanguagesList = Languages.ListLanguages()

-- lista todos os Languages
for pos,i in ipairs(LanguagesList) do
     printLanguage(i)
end

objLanguages = Languages.GetLanguage(string textLanguageName)

Descrição:

retorna um objeto language.

Parâmetros de entrada:

textlanguageName - string com o Nome do Idioma.

Parâmetros de saída:

objlanguage - Objeto language. Se não existir retorna nil.

Exemplo de utilização:

function printLanguage(l)
     print("Name = " .. l.Name)
     print("Language Name = " .. l.LanguageName)
end

-- Obtem um objeto Language
local Language = Languages.GetLanguage("Idioma_001")

printLanguage(Language)