RicardoHorta.Net - Office XP: Controle ListBox
Parceria RicardoHorta.Net + SUBMARINO !!
O controle.
- Exibe uma lista para o usuário escolher uma ou mais opções.
Propriedades.
- BackColor, BorderColor, BorderStyle, BoundColumn, ColumnCount,
ColumnHeads, ColumnWidths, ControlSource, ControlTipText, Enabled, Font, ForeColor,
Height, HelpContextID, IntegralHeight, Left, ListStyle, Locked, MatchEntry, MouseIcon,
MousePointer, MultiSelect, RowSource, SpecialEffect, TabIndex, TabStop, Tag, Text,
TextAlign, TextColumn, Top, TopIndex, Value, Visible, Width.
Métodos.
- AddItem, Clear, Move, RemoveItem, ZOrder.
Eventos.
- AfterUpdate, BeforeDragOver, BeforeDropOrPaste, BeforeUpdate,
Change, Click, DblClick, Error, KeyPress, MouseMove, Enter, Exit, KeyDown, KeyUp,
MouseDown, MouseUp.
Como inserir ?
- Para inserir um controle ListBox no formulário, abra
Caixa de ferramentas e clique em Caixa de listagem.
- Em seguida, clique no UserForm.
- Se for necessário, altere a altura e a largura utilizando o mouse. Para informar um
valor exato, utilize as propriedades Height e Width.
- Para movê-lo, clique com o botão esquerdo e, mantendo-o pressionado, arraste-o
para a nova posição. Outra opção é utilizar as propriedades Left e Top.
Name.
- Evite trabalhar com os nomes sugeridos pelo Editor do Visual Basic. Antes de criar
qualquer linha de código, crie um nome significativo para o controles. Selecione-o e...
- ...altere a propriedade Name.
Initialize.
- Para inserir uma lista de opções, utilize o evento
Initialize do UserForm. Ele ocorre antes do formulário surgir na tela.
- Assim, o usuário visualizará o ListBox já preenchido quando
for exibido.
ListStyle.
- A propriedade ListStyle define o estilo da lista. O valor padrão
é fmListStylePlain.
- Alterando o valor de ListStyle para fmListStyleOption,
a lista será exibida com botões de opções
MultiSelect.
- Define o modo de seleção. O valor padrão é fmMultiSelectSingle.
Com ela...
- ...é possível selecionar somente uma opção de cada vez.
- Isto vale também para a lista no formato de botões de opção
( ListStyle = fmListStyleOption ).
- Para permitir a seleção de várias opções, altere o valor da
propriedade MultiSelect para fmMultiSelectMulti. Aí, o usuário poderá clicar em
quantas opções ele quiser.
Como desfazer uma seleção ?
- Suponha que você tenha selecionado o site www.terra.com.br e queira
cancelar esta seleção. Simples. Clique, novamente, na opção e a seleção será desfeita.
- A opção fmMultiSelectMulti da propriedade MultiSelect só deve ser ativada nos
casos em que for permitido escolher mais de um ítem na lista. O exemplo abaixo está errado.
É solicitado ao usuário para escolher um endereço apenas e no entanto o controle ListBox está
permitindo mais de uma seleção.
fmListStyleOption + fmMultiSelectMulti.
- Quando as propriedades ListStyle e MultiSelect estão com as
opções fmListStyleOption e fmMultiSelectSingle ativadas, a lista assume o formato de botões de
opções.
- Mantendo ListStyle com o valor fmListStyleOption, se você alterar a propriedade
MultiSelect para fmMultiSelctMulti, a aparência da caixa de listagem será
alterada. Saem botões de opção e entram caixas de verificação.
- Aqui, também, será possível escolher mais de uma opção.
- E o processo para cancelar é o de sempre. Basta clicar, novamente,
na opção e a seleção será desfeita.
fmListStylePlain + fmMultiSelectExtended.
- Quando a propriedade MultiSelect for igual a fmMultiSelectExtended,
você poderá utilizar as teclas [ Shift ] ou [ Ctrl ] para lhe ajudar na seleção.
- Se você clicar na 1a. opção e, mantendo a tecla [ Shift ] selecionada, clicar, por exemplo,
na 5a., o intervalo entre as opções também será selecionado.
- Quando MultiSelect for igual a fmMultiSelectExtended, o usuário deverá utilizar
a tecla [ Ctrl ] para selecionar opções não-adjacentes.
- fmMultiSelectExtended não deve ser utilizada quando o usuário
não puder escolher mais de um item na listagem.
SpecialEffect.
- Esta propriedade define a aparência da caixa de listagem. O
valor padrão de SpecialEffect é fmSpecialEffectSunken.
- Com SpecialEffect igual a fmSpecialEffectRaised o controle exibe
uma sombra nas bordas inferior e direita, dando a impressão do controle estar um pouco
elevado em relação ao formulário.
- Se você gosta de efeitos especiais apenas no seu contra-cheque,
ative a opção fmSpecialEffectPlain. ListBox será exibido no modo plano, no
mesmo nível que o formulário.
SUBMARINO: Fácil ! Rápido ! Seguro !
SUBMARINO: Fácil ! Rápido ! Seguro !
www.ricardo.horta.nom.br - Direitos adquiridos - Autor: Ricardo Horta