This documentation is archived and is not being maintained.

Category Property [Visio 2003 SDK Documentation]

Office 2003

Gets or sets the value of a document's category, one of the document properties.

strRet = object.Category

object.Category = stringExpression

strRet     String. The current string that names the category of the doucment.

object     Required. An expression that returns a Document object.

stringExpression     Required String. The new string that names the category of the document.

Version added



Setting the Category property is equivalent to entering information in the Category box in the Properties dialog box (File menu).

Security  Use this feature with caution. Sensitive or confidential information could be revealed to other users.


This Microsoft Visual Basic macro shows how to use the Category property to categorize a drawing. It adds a Document object to the Documents collection and sets the Document object's Category property as well as other properties.

Before running this macro, substitute your own values for the items in italics in the following code. To verify that these properties have been set, open the Properties dialog box.

Public Sub Category_Example()
    Dim vsoDocument As Visio.Document 

    Set vsoDocument = Documents.Add("") 

    'Set the properties of the document. 
    vsoDocument.Title = "document title" 
    vsoDocument.Creator = "author name" 
    vsoDocument.Description = "document description" 
    vsoDocument.Keywords = "keyword1, keyword2, keyword3" 
    vsoDocument.Subject = "document subject" 
    vsoDocument.Manager = "manager name" 
    vsoDocument.Category = "document category" 

End Sub

Applies to | Document object