Mostrando postagens com marcador Listview. Mostrar todas as postagens
Mostrando postagens com marcador Listview. Mostrar todas as postagens

segunda-feira, 22 de setembro de 2008

Listview: de 20 a 40 por cento mais rápido !

Uma das dificuldades que os desenvolvedores sentem ao utilizar o Listview é a demora que existe incluindo uma quantidade razoável de dados em sua estrutura. Utilizando dois métodos simples, o desenvolvedor pode ganhar até 40 por cento do tempo gasto com esse procedimento, tornando assim o Listview mais rápido.

Quando estamos alimentando um Listview com dados, o Windows se encarrega de mostrar visualmente esse procedimento. As linhas e colunas do Listview vão sendo atualizadas, a barra de rolagem é redesenhada proporcionalmente à quantidade de ítens, entre outras coisas. O método "stopRedrawing" indica ao componente que nenhuma atualização visual deve ser feita enquanto os dados forem incluídos. O método "startRedrawing" retorna o componente à sua condição normal.

Localize em seu programa o ponto exatamente anterior à inclusão dos seus dados no Listview e então acrescente a linha abaixo:

invoke umListview "stopRedrawing"

Ao terminar a inclusão de dados em seu Listview, precisamos dizer a ele pra voltar a sua condição normal. Para isso, acrescente a linha abaixo:

invoke umListview "startRedrawing"

Você vai notar que a inclusão dos dados em seu componente será de 20 a 40 por cento mais rápida.

Observação: o fato do Listview não ser atualizado visualmente na inclusão dos dados, pode dar a impressão ao usuário de que o micro está travado, pois nada é mostrado no Listview indicando que ele está sendo "alimentado". Portanto, é interessante que alguma mensagem seja colocada ao usuário comentando sobre essa atualização.


quarta-feira, 7 de novembro de 2007

Criando listas de imagens

Muitos dos componentes do Windows como o listview, toolbar, treeview, entre outros, utilizam listas de imagens para mostrar ícones ou bitmaps. Aprenda a criar listas de imagens com ícones em tempo de execução e faça uso desse recurso em suas aplicações.

São instâncias da classe MaskedImageList que são passadas como parâmetro para os principais componentes do Windows que utilizam listas de imagens. Essas listas de imagens utilizam instâncias da classe Icondata, que carregam um arquivo de ícone em memória.

O exemplo a seguir mostra como criar uma lista de imagens e como usá-la em um listview. O exemplo considera que um listview foi criado no programa, representado por uma variável na GS denominada umListview (obj-ref).

Defina na class-control, as classes que serão utilizadas:

class-control.
....Icondata is class "icondata"
....MaskedImageList is class "mskimglt".

Na working-storage section, crie as seguintes variáveis:

working-storage section.
77 umaLista object reference value null.
77 umIcone object reference value null.
77 wsNumeroDoIcone pic 9(09) comp-5 value zeros.
77 wsAltura pic 9(09) comp-5 value zeros.
77 wsLargura pic 9(09) comp-5 value zeros.
77 wsNumeroDoItem pic 9(09) comp-5 value zeros.
77 umItem object reference value null.

Depois de criado o listview, criaremos a lista de imagens que vai armazenar os ícones que serão utilizados. A classe MaskedImageList cria a lista recebendo como parâmetros a largura e a altura dos ícones, em pixéis:

CriarListaDeImagens section.
....move 16 to wsLargura wsAltura
....invoke MaskedImageList "new" using wsLargura wsAltura
....returning umaLista

Para adicionar ícones à lista, precisamos criar instâncias da classe Icondata. Para isso, vamos utilizar o método "fromFileZ". Essas instâncias serão adicionadas à lista de imagens pelo método "AddIcon". Esse método adiciona um ícone à lista e retorna como parâmetro um índice que vai identificar o ícone na lista de imagens. Depois de criada a lista de imagens, ela é passada ao listview como parâmetro do método "setSmallImages". Como a lista de imagens foi criada com ícones de 16x16 pixéis, então devemos utilizar arquivos de ícones que possuam essas mesmas características:

AdicionarIcones section.
....invoke IconData "fromFileZ" using z"printer.ico"
....returning umIcone
....invoke umaLista "addIcon" using umIcone returning wsNumeroDoIcone

....invoke IconData "fromFileZ" using z"disk.ico"
....returning umIcone
....invoke umaLista "addIcon" using umIcone returning wsNumeroDoIcone

....invoke umListview "setSmallImages" using umaLista
.....

Para indicar ao listview qual ícone utilizar em um determinado ítem, primeiro devemos pegar o ítem como uma instância da classe ListviewItem e utilizar o método "SetImageIndex", passando o índice que representa o ícone escolhido:

SetarIcones section.
....move 1 to wsNumeroDoItem
....invoke umListview "itemAtIndex" using wsNumeroDoItem
....returning umItem
....move 1 to wsNumeroDoIcone
....invoke umItem "setImageIndex" using wsNumeroDoIcone

Outros ícones podem ser adicionados a lista e outros ítens do listview podem ser mudados, utilizando os métodos demonstrados acima. Você pôde notar que os comandos mostrados necessitaram uma quantidade razável de linhas de código. A Programação Orientada ao Objeto possibilita que você crie a sua própria classe Listview e com isso, possa otimizar todos os procedimentos demonstrados nesse artigo.

Estou procurando representantes em outras cidades para que eu possa apresentar o Workshop - Programação Orientada ao Objeto com o Microfocus NetExpress. Saiba mais sobre o Workshop clicando aqui.

sexta-feira, 19 de outubro de 2007

Listview: mudando a cor de fundo

Muitas pessoas me perguntam como alterar a cor de fundo de um Listview. O método "setBackgroundRGB" altera a cor de fundo da maioria dos componentes visuais do Windows. Veja como utilizá-lo:

Defina as seguintes variáveis na working-storage section:

77 wsRed pic 99 comp-5 value zeros.
77 wsGreen pic 99 comp-5 value zeros.
77 wsBlue pic 99 comp-5 value zeros.

Depois de criado o Listview, utilize o método "setBackgroundRGB":

move 255 to wsRed
move 255 to wsGreen
move 215 to wsBlue
invoke umListview "setBackgroundRGB" using wsRed wsGreen wsBlue

Os valores para wsRed, wsGreen e wsBlue podem ser encontrados em qualquer editor de desenhos, como o Paintbrush, por exemplo.

quarta-feira, 3 de outubro de 2007

Perfumes para o Listview

Acrescente algumas funcionalidades ao seu Listview, enviando mensagens para alterar o comportamento do mouse, rastrear a seleção de ítens, mudar as barras de rolagem e mostrar o conteúdo automático das colunas.

Defina o tipo de chamada das API´s:

special-names.
call-convention 66 is wapi.

Na working-storage section, defina as variáveis utilizadas:

77 ListviewHandle pic 9(09) comp-5 value zeros.
78 LVM-SETEXTENDEDLISTVIEWSTYLE value 4150.
78 LVS-EX-TRACKSELECT value h"00000008".
78 LVS-EX-ONECLICKACTIVATE value h"00000040".
78 LVS-EX-TWOCLICKACTIVATE value h"00000080".
78 LVS-EX-FLATSB value h"00000100".
78 LVS-EX-INFOTIP value h"00000400".

Vamos considerar que o Listview será representado pela variável umListview, definida como masterfield dentro da GS.

Para rastrear o ponteiro do mouse e selecionar o ítem automaticamente:

invoke umListview "GetSystemHandle" returning ListviewHandle
call WAPI "SendMessageA" using by value ListviewHandle
by value LVM-SETEXTENDEDLISTVIEWSTYLE
by value LVS-EX-TRACKSELECT
by value LVS-EX-TRACKSELECT

Para mudar o ponteiro do mouse e deixar os ítens semelhantes a links:

invoke umListview "GetSystemHandle" returning ListviewHandle
call WAPI "SendMessageA" using by value ListviewHandle
by value LVM-SETEXTENDEDLISTVIEWSTYLE
by value LVS-EX-ONECLICKACTIVATE
by value LVS-EX-ONECLICKACTIVATE

Para selecionar um ítem em dois cliques:

invoke umListview "GetSystemHandle" returning ListviewHandle
call WAPI "SendMessageA" using by value ListviewHandle
by value LVM-SETEXTENDEDLISTVIEWSTYLE
by value LVS-EX-TWOCLICKACTIVATE
by value LVS-EX-TWOCLICKACTIVATE

Para mostrar um "tooltip" sempre que a coluna for menor do que o seu conteúdo:

invoke umListview "GetSystemHandle" returning ListviewHandle
call WAPI "SendMessageA" using by value ListviewHandle
by value LVM-SETEXTENDEDLISTVIEWSTYLE
by value LVS-EX-INFOTIP
by value LVS-EX-INFOTIP


Para mostrar barras de rolagem no estilo "flat":

invoke umListview "GetSystemHandle" returning ListviewHandle
call WAPI "SendMessageA" using by value ListviewHandle
by value LVM-SETEXTENDEDLISTVIEWSTYLE
by value LVS-EX-FLATSB
by value LVS-EX-FLATSB

Todas os estilos acima podem ser "desligados" passando o valor "zero" no último parâmetro da API. Veja, por exemplo, como "desligar" as barras de rolagem no estilo "flat", voltando ao normal:

invoke umListview "GetSystemHandle" returning ListviewHandle
call WAPI "SendMessageA" using by value ListviewHandle
by value LVM-SETEXTENDEDLISTVIEWSTYLE
by value LVS-EX-FLATSB
by value 0

Essa regra se aplica a todas os outros estilos descritos acima.

Você está no Orkut ? Clique aqui e participe da comunidade que criei no Orkut para o NetAlexpress !

quarta-feira, 19 de setembro de 2007

Do CSListview para o HTML: um vôo sem escalas

Quando olho para o CSListview eu vejo um mundo de possibilidades. Minha "viagem" mais recente é a possibilidade de exportar os dados do CSListview para um arquivo no formato HTML. Sim, isso é perfeitamente possível. E relativamente fácil.

Uma subclasse do Listview
É claro que o assunto em questão requer conhecimentos da programação orientada ao objeto. O CSListview é uma subclasse da classe Listview, onde implemento os métodos que desejo e manipulo as informações necessárias para os recursos que pretendo criar.

Identificando as colunas
Com o CSListview eu tenho informações de cada uma das colunas criadas. Para isso, criei uma coleção de objetos e cada um deles representa uma dessas colunas. Assim, as informações de cada coluna ficam disponíveis à medida que eu necessitar.

Selecionando as colunas
São as colunas do CSListview que servirão de base para a criação de uma TABLE no arquivo HTML. O usuário deve ter a opção de escolher quais colunas devem ser colocadas no arquivo HTML e na ordem em que ele desejar. Essa seleção de colunas é que vai orientar a criação de cada comando TD dentro do arquivo HTML. Esse procedimento é semelhante ao que já existe no recurso de exportação de dados do CSListview para arquivos texto.

Ordenando as colunas
Penso em permitir ao usuário escolher quais as colunas que devem ser ordenadas para que a geração do arquivo HTML atenda a uma ordem específica de colunas. Por exemplo, em um CSListview de notas fiscais o usuário pode optar por ordenar os dados a partir das colunas de data de vencimento e fornecedor. Além disso, uma quebra de página pode ser implementada a cada mudança de informação de cada uma dessas colunas informadas. Por exemplo, se o usuário especificar uma quebra de página a cada mudança de um fornecedor, a geração do arquivo pode checar essa informação e fazer a quebra automática cada vez que um fornecedor diferente for encontrado nos dados da coluna correspondente. Esse procedimento poderá ser feito em qualquer uma das colunas escolhidas para ordenar a leitura das informações do CSListview.

Totalizando colunas
Outro recurso que imagino ser interessante é possibilitar ao usuário escolher quais colunas ele deseja totalizar. Nesse caso, a totalização poderia ser feita de várias maneiras, como por exemplo, uma soma simples dos valores, uma contagem ou até mesmo uma média dos valores. Outras formas de totalização podem ser implementadas futuramente.

As colunas respondem
Com as informações de cada uma das colunas "em minhas mãos", logo depois de selecionadas e ordenadas, basta que eu saiba a descrição de cada coluna, a largura em pixéis e a sua justificação, à esquerda, à direita ou centralizada. Com base nessas informações, enfim, a tabela no arquivo HTML pode ser feita.

As linhas de dados
Gerar as informações das linhas de dados no arquivo HTML talvez seja a parte mais fácil do processamento, afinal de contas, o CSListview fornece esses dados de maneira bem simples. Eu tenho o conteúdo de cada uma das linhas de dados, coluna por coluna. Bastaria encaixar as informações gerando um código HTML para cada uma das linhas de dados do CSListview.Isso seria feito utilizando a tag TR do arquivo HTML.

Cabecalhos e quantidade de linhas
A interface do CSListview para todo esse processo também oferecerá campos para que o usuário possa escolher um título para o arquivo HTML, além de informações como quantidade de linhas por página, a data e a hora da geração do arquivo. Isso permitirá ao usuário imprimir o arquivo HTML, com controle de linhas e quebra de pagina automáticos.

Arquivo gerado. Fim da viagem.
O CSListview possui outros inúmeros recursos. Mas esse último, a geração do arquivo HTML, tornou-se um desafio prazeroso. Os desenvolvedores que já adquiriram o CSListview receberão o recurso gratuitamente em uma próxima atualização. Caso exista interesse de outras pessoas pela aquisição dessa ferramenta, basta entrar em contato comigo pelo email abaixo:

alexandre.cia@iron.com.br

sexta-feira, 10 de agosto de 2007

Power´s e Net´s: prazer, eu sou o Listview !


Olá. Me chamo Listview. Sou um dos componentes padrões do Windows, apesar de muitos desenvolvedores por aí acharem que pertenço a uma linguagem em especial.

Algumas pessoas me acham um componente difícil de lidar. Talvez pelo fato de não saberem como me mandar mensagens ou por não conhecerem as famosas API´s, acabam me achando antipático. Desculpem, meus amigos, mas essas são as únicas formas de comunicação comigo.

Quando uma ferramenta cria um Listview em uma janela ou "form" do Windows, na verdade está executando internamente uma API chamada "CreateWindowEx", passando uma série de parâmetros como posição, tamanho, estilo, entre outras tantas informações.

Na maior parte do tempo, recebo mensagens enviadas pela API "SendMessage", que faz com que a minha aparência seja alterada ao gosto do desenvolvedor. Para facilitar a vida do desenvolvedor, as linguagens visuais não mostram toda essa infinidade de códigos.

Quando o desenvolvedor quer adicionar um ítem, por exemplo, tem que enviar a mensagem LVM-INSERTITEM através da API "SendMessage", junto com alguns outros parâmetros. Para alterar a minha cor de fundo é utilizada a mensagem LVM-SETBKCOLOR. Se quiser conhecer as mensagens que são enviadas a mim, acesse o site da Microsoft. Viu só como as linguagens visuais facilitam esse trabalho ?

Existe um processo (looping) onde eu envio as mensagens contando tudo o que está acontecendo comigo. Algumas linguagens transformam essas mensagens em eventos, facilitando a vida do desenvolvedor. A Programação Orientada ao Objeto permite que qualquer um desses eventos sejam interceptados. Mas nem todas as linguagens oferecem esse recurso.

O Microfocus Net Express nesse ponto sai na frente. Apesar do seu ambiente de desenvolvimento (IDE) dificultar bastante o desenvolvedor que quer me utilizar - diferentemente do PowerCobol - o Net Express permite que a minha classe seja totalmente manipulada. Qualquer evento que acontece comigo pode ser alterado utilizando o Net Express. O mesmo não acontece no PowerCobol. Não é possível, por exemplo, subclassear um Listview no PowerCobol. Eu queria tanto estar errado nesse sentido. Se eu estiver, Power´s, corrijam-me a vontade.

Já em relação ao IDE, o PowerCobol permite que muitas coisas sejam alteradas em minha aparência. Ponto para o PowerCobol, porque nesse quesito, o Net Express fica lá atrás. Até quando a Microfocus vai acreditar que os Net´s gostam do Dialog e seus programas controladores ?

Muita gente gostaria de me ver assim, bem colorido. Uma linha de cada cor, uma fonte diferente em cada linha. Tem gente que adoraria digitar dados diretamente em minhas linhas e colunas. Pra essa gente toda, gostaria de dizer que tudo isso é possível. Mas não quer dizer que seja uma tarefa fácil. Para isso, é necessário primeiro detectar todas as mensagens que eu envio para o seu programa. Sei que no Net Express, essas mensagens são detectadas no método "wmGadgetNotify", dentro da classe Listview. Dá pra saber o momento exato em que estou "desenhando" os meus ítens e é justamente nesse momento que as cores das linhas ou as fontes podem ser alteradas, individualmente. Na internet existe um exemplo de como fazer isso com o Net Express. Infelizmente isso não é possível fazer com o PowerCobol. A Fujitsu bem que poderia colaborar um pouquinho mais, né ?

Digitar dados diretamente em minhas linhas e colunas também não é uma tarefa das mais fáceis, mas é igualmente possível de se fazer. Mais uma vez, o desenvolvedor necessita ter conhecimento sobre as API´s que detectam a posição do clique do mouse, os atributos de um ítem do Listview, como altura, largura, sem contar que o próprio ítem do Listview precisaria se tornar um objeto, para que todas essas alterações sejam refletidas diretamente nele. Ufa, até eu já estou me achando um "cara" meio complicado !

Bem, esse sou eu, o Listview. Uma outra hora conto mais pouquinho sobre meus segredos. Espero que os Net´s e os Power´s possam fazer bom proveito de mim, quando me utilizarem em suas aplicações. Foi um prazer conversar com vocês. Até mais...

quinta-feira, 28 de junho de 2007

Imagens de fundo no Listview


Utilizando a API "SendMessage", você pode colocar imagens de fundo no Listview e oferecer uma interface mais amigável aos usuários dos seus aplicativos. Esse procedimento só possui um único inconveniente, que é a necessidade de informar o caminho completo do arquivo como parâmetro. Na imagem acima, um listview foi utilizado como "pano de fundo" do seletor principal de uma aplicação. Veja como fazer, passo-a-passo:

Defina o "call-convention" apropriado, na Special-Names:

special-names.
call-convention 66 is WAPI.

Defina as seguintes variáveis na Working-Storage Section:

Working-Storage Section.

01 handle pic 9(09) comp-5 value zeros.
01 OLEInitialize procedure-pointer.

01 pImage.
...02 flags pic 9(09) comp-5 value zeros.
...02 imageHandle pic 9(09) comp-5 value zeros.
...02 pszImage pointer.
...02 ImageMax pic 9(09) comp-5 value zeros.
...02 xOffset pic s9(09) comp-5 value zeros.
...02 yOffset pic s9(09) comp-5 value zeros.

01 ret pic 9(09) comp-5 value zeros.
01 bool pic 99 comp-5 value zeros.

78 LVM-SETBKIMAGE value 4164.
78 LVBKIF-SOURCE-URL value h"00000002".
78 LVBKIF-STYLE-TILE value h"00000010".

Crie um parâmetro na Linkage Section, que será utilizado apenas para inicializar a "OLE32.DLL", necessária para o carregamento da imagem:

Linkage Section.
77 lnkNulo pic x.
77 lnkImagem pic x(255).

Na Procedure Division, crie uma section para colocar a imagem no Listview:

SetarImagemListview section.
....set OLEInitialize to entry "ole32.dll"
....set address of lnkNulo to null
....call wapi "OleInitialize" using by reference lnkNulo returning ret
....invoke umListview "getSystemHandle" returning handle
....move 0 to ImageHandle
....move LVBKIF-SOURCE-URL to Flags
....add LVBKIF-STYLE-TILE to Flags
....move z"c:\imagem.jpg" to lnkImagem
....set pszImage to address of lnkImagem
....move 0 to xOffset yOffset
....call WAPI "SendMessageA" using by value handle
..............by value LVM-SETBKIMAGE
..............by value 0
..............by reference pImage
..............returning lsBool

sexta-feira, 1 de junho de 2007

Ajustando as colunas do Listview

Um duplo clique nos divisores de cada título das colunas de um listview faz com que a coluna em questão seja automaticamente redimensionada, para comportar o texto de maior tamanho dentre os ítens incluídos no listview. Mas isso pode ser feito de maneira automática por dentro do fonte cobol, enviando a mensagem LVM-SETCOLUMNWIDTH para o listview e especificando o parâmetro LVSCW-AUTOSIZE. Para isso, vamos utilizar a API "SendMessageA". Veja o exemplo a seguir:

Inclua em seu programa, na cláusula SPECIAL-NAMES:

call-convention 66 is wapi.

Defina as seguintes variáveis e constantes, na WORKING-STORAGE SECTION:

77 wsHandle pic 9(09) comp-5 value zeros.
77 wsColuna pic 9(09) comp-5 value zeros.
77 wsBool pic s9(09) comp-5 value zeros.

78 LVM-SETCOLUMNWIDTH value 4126.
78 LVSCW-AUTOSIZE value -1.

Você pode encontrar a definição dessas constantes no arquivo WINDOWS.CPY.

Depois que seu listview estiver criado e com todas as informações incluídas, crie uma section para redimensionar automaticamente uma determinada coluna do seu listview:

Redimensionar section.
...invoke umListview "getSystemHandle" returning wsHandle
...move zero to wsColuna
...call wapi "SendMessageA" using by value wsHandle
..................................by value LVM-SETCOLUMNWIDTH
..................................by value wsColuna
..................................by value LVSCW-AUTOSIZE
........................returning wsBool
...end-call

- A primeira linha de comando pega o handle do componente;

- Depois, especificamos a coluna que desejamos redimensionar. Esse parâmetro considera as colunas a partir do zero, portanto movimentamos "zero" para especificarmos a coluna 1, movimentamos 1 para a especificarmos a coluna 2 e assim por diante.
- Em seguinda, chamamos a API "SendMessageA" para executar o redimensionamento;

Note que se a coluna que for utilizada não contiver nenhum ítem com informação, ela será redimensionada com um tamanho mínimo, podendo em alguns casos ficar quase que escondida no listview. Só utilize esse redimensionamento quando tiver certeza que na coluna especificada existam informações dos ítens.

terça-feira, 15 de maio de 2007

Textos transparentes...


Estou fazendo testes com textos transparentes no CSListview. Com um pouco de pesquisa na internet, fica fácil aprender a enviar mensagens aos componentes e manipular todo o visual deles.

Foi utilizada a API "SendMessageA", enviando a mensagem LVM-SETTEXTBKCOLOR com parâmetro CLR-NONE para fazer todo o trabalho. Mas me parece que mesmo sem essa mensagem, o texto já se comporta como transparente quando o CSListview tem imagens de fundo.

sábado, 12 de maio de 2007

Problemas com o "grid" no Listview

A Microsoft documentou um "bug" no Listview (desde Janeiro de 2005) em determinadas aplicações rodando no Windows XP. As linha de grade (quando se utiliza o método "grid") podem aparecer de forma incorreta em determinados momentos. Isso acontece quando se clica com o mouse nas barras de rolagem do Listview. Eu passei por isso na última semana, quando comecei a utilizar diversos Listview´s nas janelas de nossas aplicações. Para resolver o problema, a Microsoft recomenda retirar a aplicação de alguns efeitos visuais. Clique com o botão direto do mouse no desktop e vá em Propriedades. Na aba Aparência, clique em Efeitos. Desmarque a opção Usar este efeito de transição para menus e dicas de ferramentas. Dessa forma, o problema com o Listview desaparece.