Propriedade ComboBox.BoundColumn (Access)

Quando você faz uma seleção de uma caixa de combinação, a propriedade BoundColumn informa ao Microsoft Access a coluna cujos valores serão usados como valor do controle. Se o controle for acoplado a um campo, o valor na coluna especificada pela propriedade BoundColumn será armazenado no campo indicado pela propriedade ControlSource. Long de leitura/gravação.

Sintaxe

expressão. Boundcolumn

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

Comentários

A propriedade BoundColumn usa as configurações a seguir.

Configuração	Descrição
0	O valor da propriedade ListIndex , em vez do valor da coluna, é armazenado no registro atual. O valor da propriedade ListIndex da primeira linha é 0, da segunda linha é 1 e assim por diante. O Access define a propriedade ListIndex quando um item é selecionado em uma caixa de lista ou na parte da caixa de listagem de uma caixa de combinação. A configuração da propriedade BoundColumn como 0 e a utilização do valor da propriedade ListIndex do controle poderia ser útil se, por exemplo, você estivesse interessado somente em armazenar uma sequência de números.
1 ou maior	(O padrão é 1) O valor na coluna especificada torna-se o valor do controle. Se o controle estiver vinculado a um campo, essa configuração será armazenada nesse campo no registro atual. A propriedade BoundColumn não pode ser definida como um valor maior que a configuração da propriedade ColumnCount .

Para campos de tabela, você pode definir essa propriedade na guia Pesquisa na seção Propriedades de Campo da exibição Design da tabela para campos com a propriedade DisplayControl definida como Caixa de Combinação ou Caixa de Lista.

No Visual Basic, defina a propriedade BoundColumn utilizando um número ou uma expressão numérica igual a um valor de 0 até a configuração da propriedade ColumnCount.

A coluna visível mais à esquerda em uma caixa de combinação (a coluna mais à esquerda cuja configuração na propriedade ColumnWidths da caixa de combinação não é 0) contém os dados que aparecem na parte da caixa de texto da caixa de combinação em Modo de exibição ou em um relatório. A propriedade BoundColumn determina de qual valor da coluna na lista da caixa de combinação ou da caixa de texto virá a ser armazenado quando você fizer uma seleção. Isto permite exibir dados diferentes dos armazenados como valor do controle.

Observação

Se a coluna vinculada não for a mesma que a coluna mais visível à esquerda no controle (ou se você definir a propriedade BoundColumn como 0), a propriedade LimitToList será definida como Sim.

O Access usa números baseados em zero para se referir a colunas na propriedade Column . Ou seja, a primeira coluna é referenciada usando a expressão Column(0), a segunda coluna é referenciada usando a expressão Column(1)e assim por diante. Contudo, a propriedade BoundColumn usa números baseados em 1 para referir-se às colunas. Isso significa que, se a propriedade BoundColumn estivesse definida como 1, você poderia acessar o valor armazenado nessa coluna utilizando a expressão Column(0).

Se a propriedade AutoExpand estiver definida como Sim, o Access preencherá automaticamente um valor na parte da caixa de texto da caixa de combinação que corresponde a um valor na lista de caixas de combinação conforme você digitar.

Exemplo

O exemplo a seguir mostra como criar uma caixa de combinação que está associada a uma coluna enquanto exibe a outra. Configurar a propriedade NúmeroDeColunas para 2 especifica que a caixa de combinação cboDept exibirá as duas primeiras colunas da fonte de dados especificado pela propriedade OrigemDaLinha. Configurar a propriedade BoundColumn para 1 especifica que o valor armazenado na primeira coluna será retornado quando inspecionar o valor da caixa de combinação.

A propriedade LargurasDasColunas especifica a largura das duas colunas. Ao definir a largura da´primeira coluna para 0in., a primeira coluna não é exibida na caixa de combinação.

Private Sub cboDept_Enter()
    With cboDept
        .RowSource = "SELECT * FROM tblDepartments ORDER BY Department"
        .ColumnCount = 2
        .BoundColumn = 1
        .ColumnWidths = "0in.;1in."
    End With
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.