> ## Documentation Index
> Fetch the complete documentation index at: https://docs-fw.madbuilder.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# BDBTreeView
> O `BDBTreeView` é um componente (derivado da classe `BTreeView`) especializado em construir uma árvore de visualização baseada em dados provenientes de um banco de dados.
*Obs.: todos os métodos presentes nesta documentação utilizarão como base uma tabela chamada "estado". Esta tabela foi criada em um modelo de dados chamado "docs" e possui quatro colunas: id, nome, sigla e regiao\_id, sendo a última uma chave estrangeira para uma tabela chamada "regiao", esta possuindo as colunas id e nome.*
## \_\_construct
Construtor da classe `BDBTreeView`.
**Parâmetros:**
Nome do campo que será utilizado no formulário.
Nome do banco de dados.
Modelo dos dados.
Chave principal dos dados.
Valor associado à chave principal.
(Opcional) Grupos de dados.
(Opcional) Coluna para ordenação dos dados.
(Opcional) Critérios para a busca de dados.
**Exemplo de código:**
```php theme={null}
$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', '{nome} ({sigla})');
$estadosTreeView->setGroups(['{regiao->id}' => '{regiao->nome}']);
$estadosTreeView->enableCheck();
```
## addGroup
Adiciona um grupo à visualização da árvore.
**Parâmetros:**
Chave do grupo.
Valor do grupo.
**Exemplo de código:**
```php theme={null}
$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', '{nome} ({sigla})');
$estadosTreeView->addGroup('norte', 'Região Norte');
```
## setGroups
Define os grupos para a árvore.
**Parâmetros:**
Array de grupos.
**Exemplo de código:**
```php theme={null}
$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', 'name');
$estadosTreeView->setGroups(['brasil' => 'Brasil', 'estados' => 'Estados']);
```
*Obs.: exemplo com grupos baseados em uma coluna de banco de dados presente na seção "\_\_construct()".*
## getGroups
Obtém os grupos atuais.
**Exemplo de código:**
```php theme={null}
$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', 'name');
$grupos = $estadosTreeView->getGroups();
```
## getItemsFromModel
Obtém os itens a partir do modelo definido.
**Exemplo de código:**
```php theme={null}
$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', 'name');
$itens = $estadosTreeView->getItemsFromModel();
```
## reloadFromModel
(Método estático) Recarrega os itens do modelo para o componente.
**Parâmetros:**
Nome do formulário.
Nome do componente.
Banco de dados.
Modelo dos dados.
Chave dos dados.
Valor da chave.
(Opcional) Grupos.
(Opcional) Coluna de ordenação.
(Opcional) Critérios para seleção.
(Opcional) Opções adicionais.
**Exemplo de código:**
```php theme={null}
$estadosTreeView = new BDBTreeView('estadosTreeView', 'docs', 'Estado', 'id', '{nome}');
$estadosTreeView->setGroups(['{regiao->id}' => '{regiao->nome}']);
$estadosTreeView->enableCheck();
$btnRecarregar = new TButton('btnReloadFromModel');
$btnRecarregar->addStyleClass('btn-default');
$btnRecarregar->setImage('far:circle #000000');
$btnRecarregar->setAction(new TAction([$this, 'recarregarDados']), 'Recarregar Itens do Modelo');
```
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function):
```php theme={null}
public static function recarregarDados($param = null)
{
$criterio = new TCriteria();
$criterio->add(new TFilter('regiao', '=', 'Sudeste'));
BDBTreeView::reloadFromModel('nomeForm', 'estadosTreeView', 'docs', 'Estado', 'id', '{nome} ({sigla})', null, $criterio);
}
```