TWOLImageList - WOLGUI

Descendente de TWOLBase. É a representação, em objeto WOL, de Lista de Imagens básica da GUI em uso. Tem o objetivo de organizar imagens a serem usadas pela aplicação. Arquivo fonte: WOLGUI16.PP.

Propriedades da TWOLImageList

Propriedade	Descrição
Count	Propriedade que retorna a quantidade imagens na lista.
Dragging	Propriedade que retorna True se a imagem está mostrando o ícone de arraste ou não.
Handle	Propriedade que retorna o handle da lista de imagens. Propriedade do tipo TWOLHandle.
AllocBy	Propriedade que indica o número de imagens alocado pela lista. Lembrar que, em memória, esse número é igual a AllocBy Height * Width * Número de Máscara*
BkColor	Propriedade que indica a cor de fundo adotada quando for desenhada uma imagem. Propriedade do tipo TWOLColor.
BlendColor	Propriedade que indica a cor de blend da imagem. Propriedade do tipo TWOLColor.
DrawingStyle	Propriedade que modifica a forma como as imagens são desenhadas. Propriedade do tipo TDrawingStyle.
Height	Propriedade que indica a altura de cada imagem. Nem sempre essa propriedade é usada para fixar a altura das imagens.
ImageType	Propriedade que indica o tipo de imagem contido na lista. Propriedade do tipo TImageType.
Masked	Propriedade que indica se a lista de imagens contém máscara ou não.
ShareImages	Propriedade que indica que as imagens não serão liberadas da memória porque são compartilhadas
Width	Propriedade que informa a largura de cada imagem
Images	Propriedade representando a lista de imagens propriamente dita. Propriedade do tipo TWOLImages.

Métodos e Eventos Públicos

— constructor CreateSize(AWidth, AHeight:Integer);

procedimento usado para construir uma lista imagens com as dimensões especificadas. Deve-se lembrar que a dimensão é de cada imagem.

— function Add(Image, Mask:TWOLImage):Integer;

Método usado para adicionar uma imagem e, opcionalmente, uma máscara na lista.

— function AddIcon(Image:TWOLIcon):Integer;

Método usado para adicionar um ícone à lista de imagens.

— procedure AddImages(Value:TWOLImageList);

Método usado para adicionar uma lista de imagens à lista de imagens.

— function AddMasked(Image:TWOLImage; MaskColor:TWOLColor):Integer;

Método usado para adionar uma imagem e uma máscara de cor à lista de imagens.

— procedure Assign(Source:TWOLRoot); override;

Método usado para copiar a lista de imagens de uma lista para outra.

— function BeginDrag(Window:TWOLHandle; X, Y:Integer):Boolean;

Método usado para mostrar um ícone de arraste na janela e na posição especificadas

— procedure Clear;

Método usado para limpar a lista de imagens.

— procedure Delete(Index:Integer);

Método usado para apagar a imagem de número index.

— function DragLock(Window:TWOLHandle; XPos, YPos:Integer):Boolean;

Método usado para travar (manter) o ícone de arraste na janela e posição especificadas. Essa operação deve ser a inicial quando se fizer necessário fazer operações drag and drop.

— function DragMove(X, Y:Integer):Boolean;

Método usado para mover o ícone de arraste para a posição especificada.

— procedure DragUnlock;

Método usado para destravar o ícone de arraste.

— procedure Draw(Canvas:TWOLCanvas; X, Y, Index:Integer);

Método usado para desenhar uma lista de imagens num canvas e posição especificados.

— procedure DrawOverlay(Canvas:TWOLCanvas; X, Y:Integer; ImageIndex:Integer; aOverlay:TOverlay);

Método usado para desenhar uma imagem em uma posição de um canvas da forma sobreposta especificados pelos parâmetros.

— function FileLoad(ResType:TResType; aName:string; MaskColor:TWOLColor):Boolean;

Método usado para carregar um arquivo de imagens ou um recurso compilado no próprio programa.

— procedure GetBitmap(Index:Integer; Image:TWOLBitmap);

Método usado para desenhar uma imagem da lista de índice especificado no canvas da imagem indicada

— function GetHotSpot:TWOLPoint;

Método usado para pegar o ponto de arraste da lista de imagem. Em geral o canto inferior esquerdo.

— procedure GetIcon(Index:Integer; Image:TWOLIcon);

Método usado para desenhar o ícone da lista de imagens de índice especificado no canvas na imagem passada como parâmetro.

— function GetImageBitmap:TWOLHBitmap;

Método usado para pegar o handle da lista de imagens como um bitmap só

— function GetResource(ResType:TResType; aName:string; aWidth:Integer; LoadFlags:TLoadResources; MaskColor:TWOLColor):Integer;

Método usado para pegar o recurso especificado pelos parâmetro, retornando-o como um handle.

— function GetMaskBitmap:TWOLHBitmap;

Método usado para pegar a máscara como um handle de bitmap só.

— procedure HideDragImage;

Método usado para esconder o ícone de arraste da lista de imagens

— function Overlay(ImageIndex:Integer; aOverlay:TOverlay):Boolean;

Método usado para modificar a forma de sobreposição da imagem de índice indicado.

— procedure Replace(Index:Integer; Image, Mask:TWOLImage);

Método usado para substituir a imagem e a máscara da posição indicada pelo índice.

— procedure ReplaceIcon(Index:Integer; Image:TWOLIcon);

Método usado para substituir o ícone de índice indicado pelo passado no parâmetro.

— procedure ShowDragImage;

Método usado para mostrar o ícone de arraste da lista de imagens.

— OnChange:TWOLEvent

Evento disparado quando a imagem sofre modificação.

TWOLImages - Apenas TWOLImageList

Essa classe de objetos deve ser usada apenas com TWOLImageList. Trata-se de um objeto que corresponde a uma imagem carregada na memória ou uma série delas. Ela só interage com o objeto TWOLImageList em tempo de desenho. Serve para capturar a lista de imagens que se deseja na lista e recuperá-las depois.

Propriedades da TWOLImages

Propriedade	Descrição
Image[Index:Integer]	Propriedade que retorna a imagem de índice indicado contido na lista. Propriedade do tipo TWOLImage.
ImageName[Index:Integer]	Propriedade que retorna o nome do arquivo da imagem de índice especificado.
ImageType[Index:Integer]	Propriedade que retorna o tipo de imagem de índice especificado. Propriedade do tipo TResType.

Métodos e Eventos Públicos

— constructor Create;

Método usado para criar a lista de imagens. Não se deve chama-lo diretamente.

— destructor Destroy; override;

Método usado para destruir a lista de imagens.

— procedure AddToList(FileName:String; ResType:TResType);

Método usado para adicionar um arquivo de imagem à lista de imagens.

— procedure DelFromList(aIndex:Integer);

Método usado para apagar a imagem de índice indicado da lista.

— procedure Clear;

Método usado para Limpar a lista de imagens.

— procedure Assign(otherImages:TWOLImages);

Método usado para copiar uma lista de imagens para outra.

— function Count:Integer;

Método usado para retornar a quantidade de imagens contidas na lista.

Entrada de Imagens

No WOL Designer, pode-se incluir imagens numa imagelist usando uma janela que aparece quando a propriedade Images é pressionada. Nessa janela, inclui-se ou exclui-se imagens de diferentes formatos e tamanhos. Essa janela permite apenas que o usuário tenha o trabalho poupado, mas não salva as imagens para uso futuro. Lembre-se que o objetivo da WOLGUI é eliminar arquivos de recursos proprietários e deixar apenas código fonte.