Ler em inglês

Compartilhar via


Método MailMergeDataField.AddToRecipientFields (Publisher)

Adiciona o objeto MailMergeDataField pai de uma fonte de dados específica à fonte de dados mestra (coleção de campos de dados) para uma publicação de mala direta.

Sintaxe

expressão. AddToRecipientFields

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

Comentários

Este método funciona apenas se o objeto MailMergeDataField pai já não tiver sido mapeado para um campo de destinatário. Use a propriedade IsMapped para determinar se o objeto já foi mapeado.

Exemplo

Os seguintes Microsoft Visual Basic for Applications (VBA) macro mostra como usar o método AddToRecipientFields adicionar um campo de dados (coluna) em uma fonte de dados específica à fonte de dados mestra (combinado de lista de destinatários) para a publicação.

Antes de executar essa macro, substitua datasourceindex pelo número de índice de uma fonte de dados válida na coleção de fonte de dados do documento ativo e substitua fieldname pelo nome do campo na fonte de dados que você deseja adicionar à lista combinada de campos de destinatário.

Observação

Para obter um exemplo de como você pode usar a propriedade Name do objeto DataSource para determinar o número de índice da fonte de dados desejada, consulte o método MailMergeDataSources.Item .

Public Sub AddToRecipientFields_Example() 
 
 Dim pubMailMergeDataSources As Publisher.MailMergeDataSources 
 Dim pubMailMergeDataField As Publisher.MailMergeDataField 
 
 Set pubMailMergeDataSources = ThisDocument.MailMerge.DataSource.DataSources 
 Set pubMailMergeDataField = pubMailMergeDataSources.Item(datasourceindex).DataFields.Item("fieldname") 
 
 If pubMailMergeDataField.IsMapped Then 
 
 Debug.Print "This field is already mapped!" 
 
 Else 
 
 pubMailMergeDataField.AddToRecipientFields 
 Debug.Print "Field added successfully. (You can verify this by looking at the recipient or product list in the UI.)" 
 
 End If 
 
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.