OutputGroups.Item Method

Returns a OutputGroup object in a OutputGroups collection.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
Function Item ( _
    index As Object _
) As OutputGroup

OutputGroup Item(
    Object index
)

OutputGroup^ Item(
    [InAttribute] Object^ index
)

abstract Item : 
        index:Object -> OutputGroup

function Item(
    index : Object
) : OutputGroup

Parameters

• index
  Type: System.Object

  Required. The index of the OutputGroup object to return.

Return Value

Type: EnvDTE.OutputGroup
An OutputGroup object.

Remarks

The value passed to Index is either an integer that is an index to a OutputGroup object in a OutputGroups collection, or a string value that equates to the name of an OutputGroup object in the collection.

The Item method throws a ArgumentException exception if the collection cannot find the object that corresponds to the index value.

Examples

public void CodeExample(DTE2 dte)
{  
    try
    {
        // Open a project before running this example.
        Project proj = dte.Solution.Projects.Item(1);
        OutputGroups groups = proj.ConfigurationManager.ActiveConfiguration.OutputGroups;
        int c = 1;
        int x = 0;
        string msg;
        // Find the last outputgroup with at least one file.
        foreach (OutputGroup grp in groups)
        {
            x++;
            if (grp.FileCount > 0)
                c = x;
        }
        OutputGroup group = groups.Item(c);
        msg = "The " + c + "/" + groups.Count + " item in the OutputGroups groups collection is " +
            group.DisplayName;
        msg += "\nThe parent of the collection is the Configuration: " + groups.Parent.ConfigurationName;
        msg += "\nThe application containing this collection is: " + groups.DTE.Name;
        MessageBox.Show(msg);
    }
    catch(Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

OutputGroups Interface

EnvDTE Namespace

Other Resources

How to: Compile and Run the Automation Object Model Code Examples