Skip to main content
Derivado da classe TCheckGroup, métodos herdados não sobrescritos podem também ser utililzados por objetos TDBCheckGroup. Acesse a documentação do componente/classe-pai para conhecê-los. Obs.: todos os métodos presentes nesta documentação utilizarão como base uma tabela chamada “produto”. Esta tabela foi criada em um modelo de dados chamado “docs” e possui três colunas: id, nome, preco.

__construct

Construtor da classe TDBCheckGroup. Parâmetros:
$name
mixed
required
Nome do widget.
$database
mixed
required
Nome do banco de dados.
$model
mixed
required
Nome da classe do modelo.
$key
mixed
required
Campo da tabela usado como chave.
$value
mixed
required
Campo da tabela a ser listado.
$ordercolumn
mixed
default:"NULL"
(Opcional) Coluna para ordenação dos campos.
$criteria
TCriteria
default:"NULL"
(Opcional) Critérios (objeto TCriteria) para filtrar o modelo.
Exemplo de código:
$selecaoProduto = new TDBCheckGroup('selecaoProduto', 'docs', 'Produto', 'id', '{nome}, R$ {preco}');
$selecaoProduto->setSize(180);
$selecaoProduto->setLayout('vertical');
Exemplo de código (com parâmetros opcionais):
$criterio = new TCriteria();
$criterio->add(new TFilter('preco', '<', 5)); // Filtrar por itens da tabela cujo preço seja menor que 5

$selecaoProduto = new TDBCheckGroup('selecaoProduto', 'docs', 'Produto', 'id', '{nome}, R$ {preco}', 'id asc', $criterio);
$selecaoProduto->setSize(180);
$selecaoProduto->setLayout('vertical');

reloadFromModel

(Método estático) Recarrega o checkbox a partir dos dados do modelo. Parâmetros:
$formname
mixed
required
Nome do formulário.
$field
mixed
required
Nome do campo.
$database
mixed
required
Nome do banco de dados.
$model
mixed
required
Nome da classe do modelo.
$key
mixed
required
Campo da tabela usado como chave no checkbox.
$value
mixed
required
Campo da tabela a ser listado no checkbox.
$ordercolumn
mixed
default:"NULL"
(Opcional) Coluna para ordenação dos campos.
$criteria
TCriteria
default:"NULL"
(Opcional) Critérios (objeto TCriteria) para filtrar o modelo.
$options
array
default:"[]"
(Opcional) Array de opções [layout, breakItems, useButton, value, valueSeparator, changeAction, changeFunction].
Exemplo de código:
$selecaoProduto = new TDBCheckGroup('selecaoProduto', 'docs', 'Produto', 'id', '{nome}, R$ {preco}', 'id asc');
$selecaoProduto->setSize(180);
$selecaoProduto->setLayout('vertical');

$btnRecarregar = new TButton('btnRecarregar');
$btnRecarregar->addStyleClass('btn-default');
$btnRecarregar->setImage('far:circle #000000');
$btnRecarregar->setAction(new TAction([$this, 'recarregarDados']), 'Recarregar Dados');
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).
public static function recarregarDados($param)
{
    TDBCheckGroup::reloadFromModel('nomeForm', 'selecaoProduto', 'docs', 'Produto', 'id', '{nome}, R$ {preco}', 'preco asc', null, ['changeFunction' => 'alert("Seleção alterada com sucesso!");']);
}