...montar uma barra de navegação de grid

...montar uma barra de navegação de grid

Início Anterior Próximo

...montar uma barra de navegação de grid

Neste passo-a-passo será explicado como o desenvolvedor poderá montar uma barra de navegação com botões que levem aos primeiros, próximo, anterior e últimos registro, semelhante às que são encontradas em componentes Delphi ou Visual Basic. Para montar essa barra de navegação serão feitas algumas personalizações em algumas propriedades que os grids possuem, para saber mais detalhes sobre as variáveis disponíveis para um grid acesse o tópico da Ajuda Variáveis do grid.

Para a montagem da barra de navegação de um grid precisaremos de:

um grid (obviamente!) que esteja com o campo Quantidade definido com algum valor válido o suficiente para gerar uma navegação pelos registros retornados.

imagens que serão usadas para a montagem da barra de navegação.

	Imagem para os últimos registros.
	Imagem para os primeiros registros.
	Imagem para os próximos registros.
	Imagem para os registros anteriores.

Como o exemplo dos códigos aqui exibidos fazem referência á grid.<identificador> lembre-se de substituir <identificador> pelo identificador correspondente ao grid para o qual você quer montar a barra de navegação, ou seja, caso você queira montar a barra de navegação para um grid cujo identificador seja meuGrid então substitua <identificador> por meuGrid.

Um grid do WebIntegrator oferece uma série de propriedades sendo que algumas dessas podem ter seus valores alterados, as que serão alteradas aqui para a montagem da barra de navegação serão:

grid.<identificador>txtBack	Esta propriedade tanto pode ser usada para exibir o texto do link que aponta para os registros anteriores quanto pode ser usada para que o desenvolvedor personalize este texto atribuindo algum valor a ela. Por default, o valor dessa propriedade é Anterior.
grid.<identificador>txtGo	Esta propriedade tanto pode ser usada para exibir o texto do link que aponta para os próximos registros quanto pode ser usada para que o desenvolvedor personalize este texto atribuindo algum valor a ela. Por default, o valor dessa propriedade é Próximo.
grid.<identificador>txtFirst	Esta propriedade tanto pode ser usada para exibir o texto do link que aponta para os primeiros registros quanto pode ser usada para que o desenvolvedor personalize este texto atribuindo algum valor a ela. Por default, o valor dessa propriedade é Primeiro.
grid.<identificador>txtLast	Esta propriedade tanto pode ser usada para exibir o texto do link que aponta para os últimos registros quanto pode ser usada para que o desenvolvedor personalize este texto atribuindo algum valor a ela. Por default, o valor dessa propriedade é Último.
grid.<identificador>txtMid	Esta propriedade tanto pode ser usada para exibir o que será exibido como separador dos links para os anteriores e os próximos registros quanto pode ser usada para que o desenvolvedor personalize o que será exibido atribuindo algum valor a ela. Por default, o valor dessa propriedade é -.

As propriedades txtBack, txtGo, txtLast e txtFirst são usadas internamente pelo WI Engine para a montagem das propriedades linkBack, linkGo, linkLast e linkFirst, respectivamente. As duas primeiras propriedades são usadas internamente para a montagem do link de navegação de um grid, que é retornado pela propriedade link. Já a propriedade linkFull retorna um link de navegação contendo todas as propriedades de navegação incluindo os links para os primeiros e últimos resultados.

Para começar a montagem da barra de navegação primeiramente copie as imagens que serão usadas para um diretório images do projeto. Na página que exibirá o grid adicione um elemento Gravar com a seguinte configuração:

Campo	Valor
Objetos	grid.<identificador>.txtGo, grid.<identificador>.txtBack, grid.<identificador>.txtMid, grid.<identificador>.txtFirst, grid.<identificador>.txtLast
Se condição verdadeira	<img src="/\|wi.proj.id\|/images/next.jpg" border="0" title="Próximo">,<img src="/\|wi.proj.id\|/images/previous.jpg" border="0" title="Anterior">, ,<img src="/\|wi.proj.id\|/images/first.jpg" border="0" title="Primeiros">,<img src="/\|wi.proj.id\|/images/last.jpg" border="0" title="Últimos"

IMPORTANTE:

Lembre-se de substituir as ocorrências de <identificador> pelo identificador correspondente ao grid que se esteja montando a barra de navegação.

Pronto, a nossa barra de navegação já está configurada! Agora basta fazer a referência na página ao grid (|grid.<identificador>|) e ao link de navegação (|grid.<identificador>.linkFull|). Para que a montagem do link de navegação sejá correto é necessário que a propriedade rowCount do grid retorne um valor válido e esse resultado é dependente do driver JDBC que estiver sendo utilizado.