Share via


Item Method

Home Page (Objects)OverviewFAQReference

Applies to: Breakpoints object, Configurations object, Documents object, Projects object, Windows object

Gets a specified breakpoint, configuration, document, project, or window from a collection.

Syntax

object**.Item** [index]

-or-

objectindex

Parameters

object

An expression that evaluates to one of the objects in the Applies To list above.

index

A Variant that is a Long or String representing the appropriate breakpoint, configuration, document, project, or window.

  • If you specify a Long, the Item method fetches the object by its one-based index in the collection.

  • If you specify a String, it must be one of the strings described in the following table:

Object String
Configuration The configuration's name (as defined by the Name property).
Document The document's file name (as defined by the Type property).

For the file name, specify the full path to the file. If you specify only the file name, Developer Studio tries to find an open document with that name. However, if more than one open document has that name, the Item method gets the document from the current directory. If none of the open documents are in the current directory, the Item method chooses one arbitrarily.

If you specify a relative path, Developer Studio bases the path on the current directory.

Project The project's name (as defined by the Name property).
Window The window's caption (as defined by the Caption property).

Remarks

If you specify numbers for index, do not store these for later use because the indices might change as documents or windows are added or removed.

The Item method is the default. Accordingly, you don't have to reference Item explicitly, as shown in the syntax.

Example

The following example prints all open documents:

Sub PrintAllOpenDocuments( )
   for num = 1 to Documents.Count
      Documents(num).PrintOut
   next
End Sub