Propriedade CheckBox. ColumnOrder (Access)CheckBox.ColumnOrder property (Access)

Você pode usar a propriedade ColumnOrder para especificar a ordem das colunas no modo folha de dados.You can use the ColumnOrder property to specify the order of the columns in Datasheet view. número inteiro de leitura/gravação.Read/write Integer.

SintaxeSyntax

expressão. ColumnOrderexpression.ColumnOrder

expressão Uma variável que representa um objeto CheckBox .expression A variable that represents a CheckBox object.

ComentáriosRemarks

Para definir ou alterar essa propriedade para uma tabela ou consulta usando o Visual Basic, você deve usar o conjunto de Propriedades de uma coluna.To set or change this property for a table or query by using Visual Basic, you must use a column's Properties collection. Para obter mais informações sobre como usar a coleção Properties , consulte Properties.For more information about using the Properties collection, see Properties.

[!OBSERVAçãO] A propriedade ColumnOrder não está disponível no modo Design.The ColumnOrder property isn't available in Design view.

A propriedade ColumnOrder se aplica a todos os campos no modo folha de dados e aos controles de formulário quando o formulário está no modo folha de dados.The ColumnOrder property applies to all fields in Datasheet view and to form controls when the form is in Datasheet view.

No modo de folha de dados, a configuração da propriedade ColumnOrder um campo é determinada pela posição do campo.In Datasheet view, a field's ColumnOrder property setting is determined by the field's position. Por exemplo, o campo na coluna mais à esquerda no modo folha de dados tem uma configuração de propriedade ColumnOrder de 1, o próximo campo tem uma configuração de 2 e assim por diante.For example, the field in the leftmost column in Datasheet view has a ColumnOrder property setting of 1, the next field has a setting of 2, and so on. Alterando a propriedade ColumnOrder de um campo redefine a propriedade para esse campo e para cada campo à esquerda da sua posição original no modo folha de dados.Changing a field's ColumnOrder property resets the property for that field and every field to the left of its original position in Datasheet view.

Nos outros modos, a configuração da propriedade é 0, a menos que você altere explicitamente a ordem de um ou mais campos no modo de folha de dados (seja arrastando os campos para novas posições ou alterar suas configurações de propriedade ColumnOrder ).In other views, the property setting is 0 unless you explicitly change the order of one or more fields in Datasheet view (either by dragging the fields to new positions or by changing their ColumnOrder property settings). Campos à direita da nova de posição do campo movido terão uma definição de propriedade de 0 nos modos de exibição que não seja o modo folha de dados.Fields to the right of the moved field's new position will have a property setting of 0 in views other than Datasheet view.

A ordem dos campos no modo de folha de dados não afeta a ordem dos campos no modo de design da tabela ou modo de formulário.The order of the fields in Datasheet view doesn't affect the order of the fields in table Design view or Form view.

ExemploExample

O exemplo a seguir exibe os campos NomeDoProduto e QuantityPerUnit nas duas primeiras colunas no modo folha de de de formulário de produtos .The following example displays the ProductName and QuantityPerUnit fields in the first two columns in Datasheet view of the Products form.

Forms!Products!ProductName.ColumnOrder = 1 
Forms!Products!QuantityPerUnit.ColumnOrder = 2

O exemplo a seguir exibe os campos NomeDoProduto e QuantityPerUnit nas duas primeiras colunas da tabela produtos no modo folha de de de.The following example displays the ProductName and QuantityPerUnit fields in the first two columns of the Products table in Datasheet view. Para definir a propriedade ColumnOrder , o exemplo usa o **** procedimento setfieldproperty.To set the ColumnOrder property, the example uses the SetFieldProperty procedure. Se esse procedimento for executado enquanto a tabela estiver aberta, as alterações não serão exibidas até a tabela ser fechada e reaberta.If this procedure is run while the table is open, changes will not be displayed until it is closed and reopened.

Public Sub SetColumnOrder() 
 
 Dim dbs As DAO.Database 
 Dim tdf As DAO.TableDef 
 
 Set dbs = CurrentDb 
 Set tdf = dbs!Products 
 
 ' Call the procedure to set the ColumnOrder property. 
 SetFieldProperty tdf!ProductName, "ColumnOrder", dbLong, 2 
 SetFieldProperty tdf!QuantityPerUnit, "ColumnOrder", dbLong, 3 
 
 Set tdf = Nothing 
 Set dbs = Nothing 
 
End Sub 
 
Private Sub SetFieldProperty(ByRef fld As DAO.Field, _ 
 ByVal strPropertyName As String, _ 
 ByVal intPropertyType As Integer, _ 
 ByVal varPropertyValue As Variant) 
 ' Set field property without producing nonrecoverable run-time error. 
 
 Const conErrPropertyNotFound = 3270 
 Dim prp As Property 
 
 ' Turn off error handling. 
 On Error Resume Next 
 
 fld.Properties(strPropertyName) = varPropertyValue 
 
 ' Check for errors in setting the property. 
 If Err <> 0 Then 
 If Err <> conErrPropertyNotFound Then 
 On Error GoTo 0 
 MsgBox "Couldn't set property '" & strPropertyName & _ 
 "' on field '" & fld.Name & "'", vbCritical 
 Else 
 On Error GoTo 0 
 Set prp = fld.CreateProperty(strPropertyName, intPropertyType, _ 
 varPropertyValue) 
 fld.Properties.Append prp 
 End If 
 End If 
 
 Set prp = Nothing 
 
End Sub

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.