Partager via


Objet Categories (Outlook)

Représente la collection d’objets Category qui définissent la liste de catégories principales pour un espace de noms.

Remarques

Microsoft Outlook fournit un système de catégorisation grâce auquel les éléments Outlook peuvent être aisément identifiés et groupés en catégories définies par l'utilisateur. L’objet Categories représente l’ensemble de catégories définies par l’utilisateur accessibles à l’utilisateur d’une boîte à lettres spécifique.

Utilisez la propriété Categories de l’objet NameSpace pour obtenir une référence d’objet Categories , représentant la liste de catégories principale pour cet espace de noms.

Utilisez la méthode Add pour créer un objet Category et l’ajouter à la collection. Utilisez la méthode Item afin d'obtenir une référence d'objet Category pour une catégorie existante, ainsi que la méthode Remove pour supprimer un objet Category de la collection. Utilisez la propriété Count afin de renvoyer le nombre de catégories que comprend la collection.

Exemple

L’exemple Visual Basic pour Applications (VBA) suivant affiche une boîte de dialogue contenant les noms et les identificateurs de chaque objet Category contenu dans la collection Categories associée à l’objet NameSpace par défaut.

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 

Méthodes

Nom
Add
Élément
Remove

Propriétés

Nom
Application
Classe
Count
Parent
Session

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.