http://docs.kde.org/
AnteriorReferênciaPróxima

Funções disponíveis para scripts de lógica de GUI

Classe "Component"

Classe que representa um único componente ou propriedade de componente. A instância mais importante desta classe é a variável "gui", que é predefinida como a propriedade raiz do componente atual. Os seguintes métodos estão disponíveis para instâncias da classe "Component":

absoluteId(base_id)

Retorna o ID absoluto de base_id, ou - se base_id for omitido - o identificador do componente.

getValue(id)

Desaconselhado. Use getString(), getBoolean() ou getList() em vez disso. Retorna o valor da propriedade filha fornecida. Retorna o valor desta propriedade, se o ID for omitido.

getString(id)

Retorna o valor da propriedade filha fornecida como uma string. Retorna o valor desta propriedade, se o ID for omitido.

getBoolean(id)

Retorna o valor da propriedade filha fornecida como um booleano (se possível). Retorna o valor desta propriedade, caso o ID seja omitido.

getList(id)

Retorna o valor da propriedade filha fornecida como uma matriz de strings (se possível). Retorna o valor desta propriedade, se o ID for omitido.

setValue(id, valor)

Defina o valor da propriedade filha fornecida como valor.

getChild(id)

Retorna uma instância da propriedade filha com o id fornecido.

addChangeCommand(id, comando)

Execute o comando comando sempre que a propriedade filha fornecida por id for alterada. id pode ser fornecido como uma única string ou como um array de IDs (se a função for chamada para alterações em várias propriedades). comando é um valor chamável (geralmente uma função), porém, para compatibilidade com plugins escritos para versões anteriores do RKWard, também pode ser fornecido como uma string para ser avaliada.

A função retorna o parâmetro comando, para conveniência (para que você possa, por exemplo, atribuí-lo a uma variável e/ou chamá-lo durante a inicialização).

Classe "RObject"

Classe que representa um único objeto R. Uma instância desta classe pode ser obtida usando o comando makeRObject(nome_do_objeto). Os seguintes métodos estão disponíveis para instâncias da classe "RObject":

Atenção

Se ainda houver comandos pendentes no servidor, as informações fornecidas por esses métodos podem estar desatualizadas no momento da execução do código do plugin. Não confie nelas para operações críticas (correndo o risco de perda de dados).

getName()

Retorna o nome absoluto do objeto.

exists()

Retorna se o objeto existe. Geralmente, você deve verificar isso antes de usar qualquer um dos métodos listados abaixo.

dimensions()

Retorna uma matriz de dimensões (semelhante a dim() em R).

classes()

Retorna uma matriz de classes (semelhante a class() em R).

isClass(classe)

Retorna verdadeiro se o objeto for da classe classe.

isDataFrame()

Retorna verdadeiro se o objeto for um data.frame.

isMatrix()

Retorna verdadeiro se o objeto for uma matriz.

isList()

Retorna verdadeiro se o objeto for uma lista.

isFunction()

Retorna verdadeiro se o objeto for uma função.

isEnvironment()

Retorna verdadeiro se o objeto for um ambiente.

isDataNumeric()

Retorna verdadeiro se o objeto for um vetor de dados numéricos.

isDataFactor()

Retorna verdadeiro se o objeto for um vetor de dados fatoriais.

isDataCharacter()

Retorna verdadeiro se o objeto for um vetor de dados de caracteres.

isDataLogical()

Retorna verdadeiro se o objeto for um vetor de dados lógicos.

parent()

Retorna uma instância de "RObject" representando o objeto pai deste objeto.

child(nomefilho)

Retorna uma instância de "RObject" representando o filho nomefilho deste objeto.

Classe "RObjectArray"

Uma matriz de instâncias de RObject. Uma instância desta classe pode ser obtida usando o comando makeRObjectArray(nomesobjetos). É particularmente útil ao lidar com `varslots`, que permitem selecionar vários objetos.

Função include()

O comando include(filename) pode ser usado para incluir um arquivo JS separado.

Função doRCommand()

Obsoleto. Não use em novos plugins: doRCommand(comando, callback). Use new RCommand() em vez disso.

Função new RCommand()

new RCommand(comando, id_opcional) pode ser usado para consultar o R para obter informações. Leia a seção sobre consultando o R de dentro de um plugin para obter detalhes e ressalvas.