Método Conversation.SetAlwaysAssignCategories (Outlook)
Aplica uma ou mais categorias a todos os itens existentes e itens futuros da conversa.
Sintaxe
expression. SetAlwaysAssignCategories( _Categories_ , _Store_ )
Expressão Uma variável que representa um objeto 'Conversation'.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Categories | Obrigatório | String | Uma cadeia de caracteres delimitada por vírgula de um ou mais nomes de categorias que sempre são atribuídos a todos os itens da conversa. |
| Store | Obrigatório | Store | O repositório no qual os itens da conversa devem sempre ser atribuídos às categorias especificadas pelo parâmetro Categorias . |
Comentários
Se o repositório especificado pelo parâmetro Store representa um repositório que não é de entrega, como um repositório .pst de arquivo, o método retornará uma cadeia de caracteres de categorias que são aplicadas a itens de conversa no repositório de entrega padrão.
O evento ItemChange do objeto Items ocorre quando você chama o método SetAlwaysAssignCategories em uma conversa.
Para determinar as categorias mestras existentes para o usuário atual, examine a propriedade Categories do objeto Store especificada pelo parâmetro Store . Se uma ou mais categorias especificadas pelo parâmetro Categories não existirem na coleção categorias mestras, as categorias serão atribuídas à conversa, mas não serão adicionadas à coleção de categorias mestras.
Para determinar as categorias existentes que sempre serão atribuídas a itens da conversa no repositório especificado, use o método GetAlwaysAssignCategories.
Se SetAlwaysAssignCategories for chamado mais de uma vez, o resultado será cumulativo. Por exemplo, se você chamar SetAlwaysAssignCategories especificando a categoria "Importante" e chamar SetAlwaysAssignCategories novamente especificando as categorias "Business" e "Social", as categorias sempre atribuídas são "Importante", "Comercial" e "Social".
Para interromper a ação de sempre atribuir categorias, use o método ClearAlwaysAssignCategories. Depois que tiver sido chamado o método ClearAlwaysAssignCategories, GetAlwaysAssignCategories retornará uma sequência vazia.
O método SetAlwaysAssignToCategories ignora quaisquer nomes de categoria que são cadeias de caracteres vazias. Por exemplo, se o parâmetro Categories for definido como a cadeia de caracteres "Trabalhar,,Brincar", "Trabalhar" e "Brincar" serão atribuídos à conversa e a categoria de cadeia de caracteres vazia será ignorada.
Exemplo
O seguinte exemplo Visual Basic for Applications (VBA) mostra como atribuir categorias a todos os itens existentes e novos que chegarem na conversa de um item de email específicos. O exemplo de código, DemoSetAlwaysAssignCategories, escolhe o primeiro item de email exibido no Painel de Leitura como o item de email específico. DemoSetAlwaysAssignCategories verifica se as conversas são habilitados na loja para o item de email selecionado, obtém o objeto conversation para esse item de email, se existe uma conversa e usa SetAlwaysAssignToCategories para definir as duas categorias "Práticas recomendadas" e "Memória Insuficiente" para todos os itens existentes e itens futuros da conversa.
Sub DemoSetAlwaysAssignCategories()
Dim oMail As Outlook.MailItem
Dim oConv As Outlook.Conversation
Dim oStore As Outlook.Store
' Get the item displayed in the Reading Pane.
Set oMail = ActiveExplorer.Selection(1)
Set oStore = oMail.Parent.Store
If oStore.IsConversationEnabled Then
Set oConv = oMail.GetConversation
If Not (oConv Is Nothing) Then
Dim oFolder As Outlook.folder
oConv.SetAlwaysAssignCategories "Best Practices; OOM", oStore
End If
End If
End Sub
Confira também
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.