TWOLListView - WOLGUI
Descendente de TWOLVisualControl. É a representação, em objeto WOL,
de uma Lista Visual básica da GUI em uso. Arquivo fonte: WOLGUI17.PP.
Propriedades da TWOLListView
| Propriedade |
Descrição |
| Column[Index:Integer] |
Propriedade que retorna a coluna de índice especificado. É do tipo TWOLListViewColumn. |
| Count |
Propriedade que retorna a quantidade de Colunas existentes na lista. |
| ImageListNormal |
Propriedade que aponta para a lista de imagens associada à lista visual quando no modo normal. É do tipo
TWOLImageList. |
| ImageListSmall |
Propriedade que aponta para a lista de imagens associada à lista visual quando no modo visual SmallIcons. É do tipo
TWOLImageList. |
| ImageListState |
Propriedade que aponta para a lista de imagens associada à lista visual quando no modo visual List.
É do tipo TWOLImageList. |
| IconAlign |
Propriedade que indica a forma de alinhamento dos ícones em relação aos títulos dos itens. É do tipo TWOLJustifySet. |
| Options |
Propriedade que altera o comportamento a lista visual de diversas formas. É do tipo TWOLBehaviours. |
| ModeView |
Propriedade que modifica a forma de visualizar a lista visual. É do tipo TWOLViewModeSet. |
| Selected |
Propriedade que retorna o índice do item correntemente selecionado pelo usuário. |
| ScrollBars |
Propriedade que indica a presença ou não das barras de rolagem da lista visual. É do tipo TWOLScrollBarSet. |
| Columns |
Propriedade que carrega a representação das colunas da lista visual. É do tipo TWOLListViewColumns. |
Métodos e Eventos Públicos
| — procedure AddColumn(aColumn:TWOLListViewColumn); |
| Método usado para adicionar uma coluna à lista visual. |
| — procedure DelColumn(aColumn:TWOLListViewColumn); |
| Método usado para apagar uma coluna da lista visual. |
| — procedure AddItem(img:Integer; const Captions:array of TListViewString); |
| Método usado para adicionar uma linha de itens com uma imagem associada à lista visual. |
| — function GetItemText(item, subitem:Integer):String; |
| Método usado para recuperar o texto de um item e subitem da lista visual. |
| — procedure DelItem(item:Integer); |
| Método usado para apagar um item da lista visual. |
| — procedure Clear; |
| Método usado para limpar todos os itens da lista. |
| — procedure Freeze; |
| Método usado para indicar a lista que se desejar inserir uma considerável quantidade de itens à lista.
Isso faz a lista congelar e somente ser atualizada visualmente quando o método unFreeze for chamado. |
| — procedure UnFreeze; |
| Método usado para atualizar a lista visual depois de uma considerável inserção.
Não chame esse método se inicialmente não tiver chamado Freeze. |
TWOLListViewColumns
Classe de objetos à parte de uso exclusivo da TWOLListView. Essa classe carrega em o conjunto de colunas de uma ListView.
A criação e manipulação da classe, exceto em determinados casos, fica por conta da ListView da qual é filha. Suas propriedades, métodos
e eventos são:
Propriedades da TWOLListViewColumns
| Propriedade |
Descrição |
| Column[Index:Integer] |
Propriedade que retorna a coluna de índice especificado. É do tipo TWOLListViewColumn. |
| Count |
Propriedade que retorna a quantidade de colunas da lista. |
Métodos e Eventos Públicos
| — constructor Create(AOwner:TWOLListView); |
| Método construtor do objeto (que cria). |
| — destructor Destroy; override; |
| Método destrutor do objeto. Elimina da memória. |
| — procedure Add(Value:TWOLListViewColumn); |
| Método que adiciona uma coluna à lista. |
| — procedure Delete(Index:Integer); |
| Apaga uma coluna da lista indicada pelo índice. |
| — procedure Clear; |
| Apaga todas as colunas da lista visual. |
TWOLListViewColumnn
Classe de objetos de uso exclusivo da TWOLListView que é a representação de uma coluna individual. Suas principais propriedades, métodos e
eventos são:
Propriedades da TWOLListViewColumnn
| Propriedade |
Descrição |
| Caption |
Propriedade que indica o título da coluna. |
| Index |
Propriedade que indica o índice do coluna corrente. |
| Item[aIndex:Integer] |
Propriedade que retorna o item indicado pelo argumento. É do tipo TWOLListViewItem. |
| Count |
Propriedade que retorna a quantidade de itens da coluna. |
| Width |
Propriedade que informa a largura da coluna. |
| Owner |
Propriedade que informa a Lista Visual à qual pertence a coluna. É do tipo TWOLListView. |
| LVHnd |
propriedade que retorna o handle da Lista Visual proprietária. É do tipo TWOLHandle. |
| Align |
Propriedade que indica o alinhamento do texto dentro da coluna. É do tipo TWOLTextAlign. |
Métodos e Eventos Públicos
| — constructor Create(AOwner:TWOLListView); |
| Método Usado para criar o objeto. |
| — destructor Destroy; override; |
| Método Usado para destruir o objeto. |
| — procedure AddItem(Items:TWOLListViewItem); |
| Método usado para adicionar um item à coluna |
| — procedure DelItem(Items:TWOLListViewItem); |
| Método usado para apagar um item da coluna. |
TWOLListViewItem
Classe de objetos que representa o item de cada coluna da ListView. Tal objeto deve ser pensado como o
primeiro título que aparece em cada linha da lista. Os outros títulos da mesma linha devem ser pensados como subitem desse item.
A classe apresenta as seguintes propriedades, métodos e eventos:
Propriedades do TWOLListViewItem
| Propriedade |
Descrição |
| Count |
Propriedade que retorna a quantidade de subitens contidos no item. |
| Item[Index:Integer] |
Propriedade que retorna o subitem indicado pelo índice. É do tipo TWOLListViewSubItem. |
| LVHnd |
Propriedade que retorna o handle da Lista Visual à qual o subitem pertence. É do tipo TWOLHandle. |
Métodos e Eventos Públicos
| — constructor Create(AOwner:TWOLListViewColumn); |
| Método usado para criar o objeto. |
| — destructor Destroy; override; |
| Método usado para destruir o objeto. |
| — procedure AddSubItem(aItem:TWOLListViewSubItem); |
| Método usado para adicionar um subitem ao item corrente. |
| — procedure DelSubItem(aItem:TWOLListViewSubItem); |
| Método usado para apagar o subitem indicado do item corrente. |
TWOLListViewSubItem
Classe de objetos de uso exclusivo da ListView que representa um subitem. Cada subitem deve ser pensado
como os títulos que não são o item zero de cada coluna. Esses são os itens. Suas propriedades, métodos e eventos são:
Propriedades do TWOLListViewSubItem
| Propriedade |
Descrição |
| Caption |
Propriedade que carrega o título do subitem. |
| ImageIndex |
Propriedade que carrega o índice da imagem associada ao subitem. |
| Index |
Propriedade que carrega o índice do subitem. |
| StateIndex |
Propriedade que carrega o índice da imagem associada ao subitem para representar o estado. |
| LVHnd |
Propriedade que carrega o handle da Lista Visual à qual pertence o subitem. É do tipo TWOLHandle. |
| SubItems |
propriedade que carrega os títulos do subitem. É do tipo TStrings. |
Métodos e Eventos Públicos
| — constructor Create(AOwner:TWOLListViewItem); |
| Método usado para criar o objeto. |
| — destructor Destroy; override; |
| Método usado para destruir o objeto. |
No WOL Designer, há uma janela de entrada da ListView apenas para colunas. Ou seja, apenas para a ListView que
estiver usando o modo de visão de relatório (report).