Propriedade ObjectFrame.ColumnCount (Access)

Use a propriedade ColumnCount para especificar o número de colunas exibidas em uma caixa de listagem ou na parte da caixa de listagem de uma caixa de combinação ou enviada para objetos OLE em um controle de gráfico ou quadro de objeto desvinculado. número inteiro de leitura/gravação.

Sintaxe

expressão. Columncount

Expressão Uma variável que representa um objeto ObjectFrame .

Comentários

Propriedade ColumnCount contém um número inteiro entre 1 e o número máximo de campos na tabela, consulta ou instrução SQL ou o número máximo de valores na lista de valores, especificada na propriedade RowSource do controle.

Para campos de tabela , você pode definir essa propriedade na guia pesquisa na seção Propriedades do campo do modo de Design para os campos da tabela com a propriedade DisplayControl definida como caixa de combinação ou caixa de listagem.

Por exemplo, se você definir a propriedade ColumnCount para uma caixa de listagem em um formulário Funcionários como 3, uma coluna poderá listar sobrenomes , outra poderá listar os primeiros nomes e a terceira poderá listar números de ID do funcionário.

Uma caixa de combinação ou caixa de listagem pode ter várias colunas. Se a propriedade do controle RowSource contém o nome de uma tabela, consulta ou instrução SQL, uma caixa de combinação ou caixa de listagem exibirá os campos dessa fonte, da esquerda para a direita, até o número especificado pela propriedade ColumnCount.

Para exibir uma combinação diferente de campos, crie uma nova consulta ou uma nova instrução SQL para a propriedade RowSource, especificando os campos e a ordem desejada.

Se a propriedade RowSource contiver uma lista de valores (a propriedade RowSourceType estiver definida como Lista de valores), os valores serão colocados nas linhas e nas colunas da caixa de combinação ou da caixa de listagem na ordem que eles são listados na propriedade RowSource. Por exemplo, se a propriedade RowSource contiver a lista "Vermelho, Verde, Azul, Amarelo" e a propriedade ColumnCount estiver definida como 2, a primeira linha da lista da caixa de combinação ou da caixa de listagem conterá "Vermelho" na primeira coluna e "Verde" na segunda coluna. A segunda linha conterá "Azul" na primeira coluna e "Amarelo" na segunda coluna.

Use a propriedade ColumnWidths para definir a largura das colunas exibidas no controle ou para ocultar colunas.

Exemplo

O exemplo a seguir usa a propriedade Column e a propriedade ColumnCount para imprimir os valores de uma seleção de caixa de listagem.

Public Sub Read_ListBox() 
 
 Dim intNumColumns As Integer 
 Dim intI As Integer 
 Dim frmCust As Form 
 
 Set frmCust = Forms!frmCustomers 
 If frmCust!lstCustomerNames.ItemsSelected.Count > 0 Then 
 
 ' Any selection? 
 intNumColumns = frmCust!lstCustomerNames.ColumnCount 
 Debug.Print "The list box contains "; intNumColumns; _ 
 IIf(intNumColumns = 1, " column", " columns"); _ 
 " of data." 
 
 Debug.Print "The current selection contains:" 
 For intI = 0 To intNumColumns - 1 
 ' Print column data. 
 Debug.Print frmCust!lstCustomerNames.Column(intI) 
 Next intI 
 Else 
 Debug.Print "You haven't selected an entry in the " _ 
 & "list box." 
 End If 
 
 Set frmCust = Nothing 
 
End Sub

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.