Compartilhar via


Objeto ComboBox (Script do Outlook Forms)

Combina os recursos de uma ListBox e uma TextBox.

Comentários

O usuário pode digitar um novo valor, como no caso de um TextBox, ou selecionar um valor existente, como no caso de um ListBox.

Se um ComboBox estiver ligado a uma fonte de dados, o ComboBox inserirá o valor digitado ou selecionado pelo usuário nessa fonte de dados. Se uma caixa de combinação multicolumn estiver vinculada, a propriedade BoundColumn determinará qual valor é armazenado na fonte de dados vinculada.

A lista de um ComboBox consiste em linhas de dados. Cada linha pode ter uma ou mais colunas, que podem aparecer com ou sem títulos. Alguns aplicativos não dão suporte a títulos de coluna, outros fornecem apenas suporte limitado.

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

Se desejar que mais de uma linha da lista sempre apareça, convém usar um ListBox, em vez de um ComboBox. Se desejar usar um ComboBox e limitar-se aos valores da lista, defina a propriedade Style do ComboBox de modo que o controle se assemelhe a uma caixa de listagem suspensa.

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 ComboBox, the AddItem method adds an item to the list. For a multicolumn ComboBox, this method adds a row to the list.
Clear Removes all entries in the list in a ComboBox.
Copy Copies the contents of an object to the Clipboard.
Cut Removes selected information from an object and transfers it to the Clipboard.
DropDown Displays the list portion of a ComboBox.
Paste Transfers the contents of the Clipboard to an object.
RemoveItem Remove uma linha da lista em um ComboBox.

Propriedades

Nome Descrição
AutoSize Returns or sets a Boolean that specifies whether an object automatically resizes to display its entire contents. Leitura/gravação.
AutoTab Returns or sets a Boolean that specifies whether an automatic tab occurs when a user enters the maximum allowable number of characters into the text box portion of a ComboBox. Leitura/gravação.
AutoWordSelect Returns or sets a Boolean that specifies whether the basic unit used to extend a selection is a word or a single character. Leitura/gravação.
BackColor Returns or sets a Long that specifies the background color of the object. Leitura/gravação.
BackStyle Returns or sets an Integer that specifies the background style for an 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 ComboBox. Leitura/gravação.
CanPaste Returns a Boolean that specifies whether the Clipboard contains data that the object supports. Somente leitura.
Coluna Retorna ou define uma Variant que representa um único valor, uma coluna de valores ou uma matriz bidimensional para carregar em um ComboBox. Leitura/gravação.
ColumnCount Returns or sets a Long that represents the number of columns to display in a combo 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 ComboBox. Leitura/gravação.
CurTargetX Returns a Long that represents the preferred horizontal position of the insertion point in a multiline ComboBox. Somente leitura.
CurX Returns or sets a Long that represents the current horizontal position of the insertion point in a multiline ComboBox. Leitura/gravação.
DragBehavior Returns or sets an Integer that specifies whether the system enables the drag-and-drop feature for the control. Leitura/gravação.
DropButtonStyle Returns or sets a fmDropButtonStyle value that represents the symbol displayed on the drop button in a ComboBox. 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.
EnterFieldBehavior Returns or sets an Integer that specifies the selection behavior when entering a ComboBox. Leitura/gravação.
ForeColor Returns or sets a Long that specifies the foreground color of an object. Leitura/gravação.
HideSelection Returns or sets a Boolean that specifies whether selected text remains highlighted when a control does not have the focus. 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.
LineCount Returns a Long that specifies the number of text lines in a ComboBox. Somente leitura.
List Returns or sets a Variant that represents the specified entry in a ComboBox. Leitura/gravação.
ListCount Returns a Long that represents the number of list entries in a control. Somente leitura.
ListIndex Returns or sets a Variant that represents the currently selected item in a ComboBox. Leitura/gravação.
ListRows Returns or sets a Long that specifies the maximum number of rows to display in the list. Leitura/gravação.
ListStyle Retorna ou define um Inteiro que especifica a aparência visual da lista em um ComboBox. Leitura/gravação.
ListWidth Returns or sets a Variant that specifies the width of the list in a ComboBox. 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 ComboBox searches its list as the user types. Leitura/gravação.
MatchFound Returns a Boolean value that indicates whether the text that a user has typed into a ComboBox matches any of the entries in the list. Somente leitura.
MatchRequired Retorna ou define um booliano que especifica se um valor inserido na parte de texto de um ComboBox deve corresponder a uma entrada na parte de lista existente do controle. Leitura/gravação.
MaxLength Retorna ou define um Long que especifica o número máximo de caracteres que um usuário pode inserir em um ComboBox. 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.
SelectionMargin Returns or sets a Boolean that specifies whether the user can select a line of text by clicking in the region to the left of the text. Leitura/gravação.
SelLength Retorna ou define um Long que representa o número de caracteres selecionados na parte de texto de um ComboBox. Leitura/gravação.
SelStart Returns or sets a Long that represents the starting point of selected text, or the insertion point if no text is selected. Leitura/gravação.
SelText Returns or sets a String that represents the selected text of a control. Leitura/gravação.
ShowDropButtonWhen Returns or sets a fmShowDropButtonWhen value that specifies when to show the drop-down button for a ComboBox. Leitura/gravação.
SpecialEffect Returns or sets an Integer that specifies the visual appearance of an object. Leitura/gravação.
Estilo Returns or sets an Integer that specifies how the user can choose or set the control's value. Leitura/gravação.
Text Returns or sets a String that specifies text in a ComboBox, 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 ComboBox to display to the user. Leitura/gravação.
TextLength Retorna um Long que representa o comprimento, em número de caracteres, de texto na região de edição de um ComboBox. Somente leitura.
TopIndex Returns or sets a Long that represents the index of the item displayed in the topmost position in the list portion of the ComboBox. 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.