Share via

Objeto Category (Outlook)

  • Artigo

Representa uma categoria definida pelo usuário pela qual os itens do Outlook podem ser agrupados.

Comentários

Microsoft Outlook fornece um sistema de categorização com os quais itens do Outlook podem ser facilmente identificados e agrupados nas categorias definidas pelo usuário. O objeto de categoria representa uma categoria definida pelo usuário.

Use o método Add da propriedade Categories para o objeto NameSpace para criar um novo objeto Category, adicionando a categoria para a lista mestra de categorias daquele namespace.

Use a propriedade Name para especificar o nome da categoria; a propriedade Color para especificar a cor exibida para aquela categoria; e a propriedade ShortcutKey para especificar a tecla de atalho usada para atribuir aquela categoria a um item do Outlook na interface de usuário do Outlook. Use a propriedade CategoryID para recuperar o identificador exclusivo de uma categoria.

Atribuindo categorias aos itens

As categorias podem ser atribuídas aos itens do Outlook especificando os nomes dos objetos Category apropriados em uma sequência de caracteres delimitada por vírgula na propriedade Categories dos seguintes objetos:

Objeto Objeto
AppointmentItem RemoteItem
Item de contato Reportar Item
Lista de item Dist. SharingItem
Item de documento Item de tarefa
Item de diário Item de solicitação de tarefa aceita
Item de Email Item de solicitação de tarefa negada
Item de reunião Item de solicitação de tarefa
Item de nota Item de solicitação de tarefa atualizada
PostItem

Exemplo

O seguinte exemplo Visual Basic for Applications (VBA) exibe uma caixa de diálogo contendo os nomes e os identificadores para cada objeto Category contido no conjunto Categories associado ao objeto NameSpace padrão.

Private Sub ListCategoryIDs() 
 
 Dim objNameSpace As NameSpace  
 Dim objCategory As Category  
 Dim strOutput As String 
  
  ' Obtain a NameSpace object reference. 
 
 Set objNameSpace = Application.GetNamespace("MAPI") 
  
  ' Check if the Categories collection for the Namespace 
 
 ' contains one or more Category objects. 
 
 If objNameSpace.Categories.Count > 0 Then 
 
 
 ' Enumerate the Categories collection. 
 
 For Each objCategory In objNameSpace.Categories 
 
 
 ' Add the name and ID of the Category object to 
 
 ' the output string. 
 
 strOutput = strOutput & objCategory.Name & _ 
 
 ": " & objCategory.CategoryID & vbCrLf 
 
 Next 
 
 End If 
  
 ' Display the output string. 
 
 MsgBox strOutput 
 
 
 ' Clean up. 
 
 Set objCategory = Nothing  
 Set objNameSpace = Nothing 
 
  
End Sub

Propriedades

Nome
Application
CategoryBorderColor
CategoryGradientBottomColor
CategoryGradientTopColor
CategoryID
Classe
Color
Nome
Responsável
Sessão
ShortcutKey

Confira também

Referência de modelo de objeto do Outlook

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.