Objeto ListBox (Script do Outlook Forms)

Exibe uma lista de valores e permite selecionar um ou mais valores.

Comentários

Se o ListBox estiver ligado a uma fonte de dados, o ListBox armazenará o valor selecionado nessa fonte de dados.

O ListBox pode ser exibido como uma lista ou como um grupo de controles OptionButton ou CheckBox.

A propriedade padrão de um ListBox é a propriedade Value.

O evento padrão de um ListBox é o evento Click.

Não é possível soltar texto em um ListBox suspenso.

Estilos de caixa de listagem

É possível escolher um dos dois estilos de apresentação de um ListBox. Isso é expresso pela propriedade ListStyle . Cada estilo fornece diferentes maneiras para a seleção de itens na lista pelos usuários.

Se o estilo for 0, cada item será exibido em uma linha separada; o usuário selecionará um item realçando uma ou mais linhas.

Se o estilo for 1, um OptionButton ou CheckBox aparecerá no início de cada linha. Com esse estilo, o usuário selecionará um item clicando no botão de opção ou na caixa de seleção. As caixas de seleção aparecem somente quando a propriedade MultiSelect é True.

Eventos

Nome	Descrição
Click	Occurs when the user definitively selects a value for the control that has more than one possible value.

Métodos

Nome	Descrição
AddItem	For a single-column ListBox, the AddItem method adds an item to the list. For a multicolumn ListBox, this method adds a row to the list.
Clear	Removes all entries in the list in a ListBox.
RemoveItem	Remove uma linha da lista em uma ListBox.

Propriedades

Nome	Descrição
BackColor	Returns or sets a Long that specifies the background color of the object. Leitura/gravação.
BorderColor	Returns or sets a Long that specifies the border color of an object. Leitura/gravação.
BorderStyle	Returns or sets an Integer that specifies the type of border of the control. Leitura/gravação.
BoundColumn	Returns or sets a Variant that identifies the source of data in a multicolumn ListBox. Leitura/gravação.
Coluna	Returns or sets a Variant that represents a single value, a column of values, or a two-dimensional array to load into a ListBox. Leitura/gravação.
ColumnCount	Returns or sets a Long that represents the number of columns to display in a list box. Leitura/gravação.
ColumnHeads	Returns or sets a Boolean that specifies whether a single row of column headings are displayed. Leitura/gravação.
ColumnWidths	Returns or sets a String that specifies the width of each column in a multicolumn ListBox. Leitura/gravação.
Enabled	Returns or sets a Boolean that specifies whether a control can receive the focus and respond to user-generated events. Leitura/gravação.
ForeColor	Returns or sets a Long that specifies the foreground color of an object. Leitura/gravação.
IMEMode	Returns or sets an Integer that specifies the default run-time mode of the Input Method Editor (IME) for a control. Leitura/gravação.
IntegralHeight	Returns or sets a Boolean that specifies whether a ListBox displays full lines of text in a list or partial lines. Leitura/gravação.
List	Returns or sets a Variant that represents the specified entry in a ListBox. Leitura/gravação.
ListCount	Returns a Long that represents the number of list entries in a control. Somente leitura.
ListIndex	Retorna ou define um valor Variant que representa o item selecionado em um ListBox. Leitura/gravação.
ListStyle	Retorna ou define um Inteiro que especifica a aparência visual da lista em uma ListBox. Leitura/gravação.
Locked	Returns or sets a Boolean that specifies whether a control can be edited. Leitura/gravação.
MatchEntry	Returns or sets an Integer that indicates how a ListBox searches its list as the user types. Leitura/gravação.
MouseIcon	Returns a String that represents the full path name of a custom icon that is to be assigned to the control. Somente leitura.
MousePointer	Returns or sets an Integer that specifies the type of pointer displayed when the user positions the mouse over a particular object. Leitura/gravação.
MultiSelect	Returns or sets an Integer that indicates whether the object permits multiple selections. Leitura/gravação.
Selected	Returns or sets a Boolean that indicates the selection state of items in a ListBox. Leitura/gravação.
SpecialEffect	Returns or sets an Integer that specifies the visual appearance of an object. Leitura/gravação.
Text	Returns or sets a String that specifies text in a ListBox, changing the selected row in the control. Leitura/gravação.
TextAlign	Returns or sets an Integer that specifies how text is aligned in a control. Leitura/gravação.
TextColumn	Returns or sets a Variant that identifies the column in a ListBox to display to the user. Leitura/gravação.
TopIndex	Returns or sets a Long that represents the index of the list item displayed in the topmost position in the list. Leitura/gravação.
Valor	Returns or sets a Variant that specifies the value in the BoundColumn of the currently selected rows. Leitura/gravação.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.