Share via

Category Property [Visio 2003 SDK Documentation]

  • Article

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

5.0

Remarks

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.

Example

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

See Also | Company property | Description property | HyperlinkBase property | Keywords property | Manager property | Subject property | Title property