= Caixa de Seleção Genérica =
[[WikiInclude(WF/tableofcontents)]]

== Função: wf_set_generic_select ==

'''Descrição:''' esta função define quais serão os itens mostrados na caixa de seleção.

'''Parâmetros:'''

  $itens: array associativa no formato {{$matriz[$id] = $texto}} ($id pode ser número ou texto) que indica os itens que aparecerão na caixa de seleção.

  $container: um número que identifica o "container" onde os itens serão armazenados. No caso de se utilizar mais de uma caixa de seleção genérica em uma mesma atividade, os containeres precisam ser diferentes.

'''Retorno:''' <nenhum>

'''Exemplo de Uso:'''

{{{
$matriz = array();
$matriz[1] = "João";
$matriz[2] = "José";
$matriz[3] = "Maria";
$matriz['abc'] = "Tiago";

wf_set_generic_select($matriz, 0);
}}}

A lista deste código quando exibida pelo plugin wf_generic_select, seria como na imagem abaixo:

[[Image(htdocs:wf/images/generic_select_set.png)]]

----

== Plugin: wf_generic_select_init ==

'''Descrição:''' insere código que referencia arquivos de javascript responsáveis pela funcionalidade.

'''Parâmetros:''' <nenhum>

'''Exemplo de uso:'''

{{{
{wf_generic_select_init}
}}}

Observação: antes de utilizar "wf_generic_select" (seja uma ou mais vezes), deve-se fazer uma '''única''' chamada ao plugin "wf_generic_select_init".

----

== Plugin: wf_generic_select ==

'''Descrição:''' insere o componente que permite a seleção de itens genéricos.

'''Parâmetros:'''

  name: (obrigatório) o nome que irá armazenar o id do item selecionado;

  container_number: (obrigatório) o número do container onde os itens estão armazenados.

  id_value: (opcional) o id de um item previamente selecionado (não é visível para o usuário).

  desc_value: (opcional) o texto de um item inicialmente selecionado (é visível para o usuário).

  title: (opcional) o título da ''tooltip'' quando o usuário passa o mouse sobre o botão de adicionar.


  O valor padrão para todos os parâmetros não obrigatórios, é uma string vazia.

'''Exemplo de uso:'''

{{{
{wf_generic_select name="empregado" container_number=0 desc_value="ninguém"}
}}}

O componente gerado pelo código acima pode ser visto na imagem abaixo:

[[Image(htdocs:wf/images/generic_select.png)]]