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. Coluna Vinculada

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 registo 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 a partir de uma caixa de listagem ou da 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 controlo estiver vinculado a um campo, esta definição é armazenada nesse campo no registo atual. A propriedade ColunaVinculada não pode ser definida para um valor maior do que a definição da propriedade ColumnCount.

Para campos de tabela, pode definir esta propriedade no separador Pesquisa na secção Propriedades do Campo da vista Estrutura da tabela para campos com a propriedade DisplayControl definida como Caixa de Combinação ou Caixa de Listagem.

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 numa caixa de combinação (a coluna mais à esquerda cuja definiçã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 na vista Formulário ou num 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 igual à coluna visível mais à esquerda no controlo (ou se definir a propriedade ColunaVinculada como 0), a propriedade LimitToList está definida como Sim.

O Access utiliza números baseados em zero para fazer referência a colunas na propriedade Coluna . Ou seja, a primeira coluna é referenciada com a expressão Column(0), a segunda coluna é referenciada com a expressão Column(1), etc. 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 preenche 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 à medida que escreve.

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.