Table of contents
TOC
Recolher sumário
Expandir sumário

Propriedade CustomControl.Tag (Access)CustomControl.Tag Property (Access)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Armazena informações extras sobre um formulário, relatório, seção ou controle necessitados por um aplicativo do Microsoft Access. Cadeia de caracteresde leitura/gravação.Stores extra information about a form, report, section, or control needed by a Microsoft Access application. Read/write String.

SintaxeSyntax

expressão. Marcaexpression. Tag

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

ComentáriosRemarks

Você pode inserir uma expressão de cadeia de caracteres com até 2048 caracteres. A configuração padrão é uma cadeia de caracteres de comprimento zero (" ").You can enter a string expression up to 2048 characters long. The default setting is a zero-length string (" ").

Diferentemente de outras propriedades, a configuração da propriedade Tag não afeta qualquer um dos atributos de um objeto.Unlike other properties, the Tag property setting doesn't affect any of an object's attributes.

Você pode usar essa propriedade para atribuir uma sequência de caracteres de identificação a um objeto sem afetar qualquer uma das suas outras configurações de propriedade ou causando outros efeitos colaterais. A propriedade Tag é útil quando você precisa verificar a identidade de um formulário, relatório, seção ou controle que é passado como uma variável a um procedimento.You can use this property to assign an identification string to an object without affecting any of its other property settings or causing other side effects. The Tag property is useful when you need to check the identity of a form, report, section, or control that is passed as a variable to a procedure.

ExemploExample

O exemplo a seguir usa a propriedade Tag para exibir mensagens personalizadas sobre controles em um formulário. Quando um controle tiver o foco, o texto descritivo é exibido em um controle rótulo denominado lblMessage. Você pode especificar o texto da mensagem, definindo a propriedade Tag para cada controle como uma cadeia de caracteres de texto curtas. Quando um controle recebe o foco, sua propriedade Tag é atribuída para a propriedade Caption do controle rótulo. Este exemplo exibe o texto descritivo para uma caixa de texto denominada txtDescription e um botão de comando denominado cmdButton em um formulário.The following example uses the Tag property to display custom messages about controls on a form. When a control has the focus, descriptive text is displayed in a label control called lblMessage. You specify the text for the message by setting the Tag property for each control to a short text string. When a control receives the focus, its Tag property is assigned to the label control's Caption property. This example displays the descriptive text for a text box named txtDescription and a command button named cmdButton on a form.

Sub Form_Load() 
 Dim frmMessageForm As Form 

 Set frmMessageForm = Forms!Form1 

 frmMessageForm!lblMessage.Caption = "" ' Clear text. 
 frmMessageForm!txtDescription.Tag = "Help text for the text box." 
 frmMessageForm!cmdButton.Tag = "Help text for the command button." 
End Sub 

Sub txtDescription_GotFocus() 
 ' Tag property setting as caption. 
 Me!lblMessage.Caption = Me!txtDescription.Tag 
End Sub 

Sub txtDescription_LostFocus() 
 Me!lblMessage.Caption = "" 
End Sub 

Sub cmdButton_GotFocus() 
 ' Tag property setting as caption. 
 Me!lblMessage.Caption = Me!cmdButton.Tag 
End Sub 

Sub cmdButton_LostFocus() 
 Me.lblMessage.Caption = " " 
End Sub

Ver tambémSee also

ConceitosConcepts

Objeto CustomControlCustomControl Object

© 2018 Microsoft