LinkedWindows.Item Method

Returns a Window object in a LinkedWindows collection.

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

Syntax

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

Window Item(
    Object index
)

Window^ Item(
    [InAttribute] Object^ index
)

abstract Item : 
        index:Object -> Window 

function Item(
    index : Object
) : Window

Parameters

• index
  Type: System.Object
  Required. The index of the Window object to return.

Return Value

Type: EnvDTE.Window
A Window object.

Remarks

The value passed to Index is either an integer that is an index to a Window object in its LinkedWindows collection or the name of a Window 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

Sub LinkedWindowsExample()
   Dim Frame As Window
   Dim w1 As Window = DTE.Windows.Item(Constants.vsWindowKindSolutionExplorer)
   Dim w2 As Window = DTE.Windows.Item(Constants.vsWindowKindOutput)
   Dim w3 As Window = DTE.Windows.Item(Constants.vsWindowKindCommandWindow)

   ' Create a linked window frame and dock Solution Explorer 
   ' and Ouput window together inside it.
   Frame = DTE.Windows.CreateLinkedWindowFrame(w1, w2, vsLinkedWindowType.vsLinkedWindowTypeDocked)
   MsgBox("Total number of windows in the linked window frame: " & Frame.LinkedWindows.Count)

   ' Add another tool window, the Command window, to the frame with 
   ' the other two.
   Frame.LinkedWindows.Add(w3)
   MsgBox("Total number of windows in the linked window frame: " & Frame.LinkedWindows.Count)

   ' Resize the entire linked window frame.
   Frame.Width = 500
   Frame.Height = 600
   MsgBox("Frame height and width changed. Now changing Command window height.")

   ' Resize the height of the Command window.
   Frame.LinkedWindows.Item(3).Height = 800
   MsgBox("Now undocking the Command window from the frame.")

   ' Undock the Command window from the frame.
   Frame.LinkedWindows.Remove(w3)
End Sub

.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

LinkedWindows Interface

EnvDTE Namespace

Other Resources

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