Share via


Window2.Top Property

Gets or sets the vertical distance between the internal top edge of an object and the top edge of its container.

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

Syntax

'Declaration
Property Top As Integer
int Top { get; set; }
property int Top {
    int get ();
    void set (int value);
}
abstract Top : int with get, set
function get Top () : int 
function set Top (value : int)

Property Value

Type: Int32
The vertical distance.

Examples

This example creates a linked window frame, adds the Output Window and Solution Explorer to the linked frame as docked windows, displays some properties, uses the Top property to resize the linked window frame, and then undocks the windows from the frame.

For more information about how to run this example as an add-in, see How to: Compile and Run the Automation Object Model Code Examples.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    TopExample(_applicationObject)
End Sub
Sub TopExample(ByVal dte As DTE2)
    Dim Frame As Window2
    Dim w1 As Window2 = _
    CType(_applicationObject.Windows.Item _
(Constants.vsWindowKindSolutionExplorer), Window2)
    Dim w2 As Window2 = CType(dte.Windows.Item _
(Constants.vsWindowKindOutput), Window2)
    ' Create a linked window frame and dock Solution Explorer 
    ' and the Ouput window together inside it.
    Frame = CType(_applicationObject.Windows.CreateLinkedWindowFrame _
(w1, w2, vsLinkedWindowType.vsLinkedWindowTypeDocked), Window2)
    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
    Frame.Left = 100
    Frame.Top = 100
    MsgBox("Frame height, width, and position changed.")
    Frame.LinkedWindows.Remove(w1)
    Frame.LinkedWindows.Remove(w2);
    MsgBox("Undocked the windows.");
End Sub
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application,
 ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    TopExample(_applicationObject);
}
public void TopExample(DTE2 dte)
{
    Window2 Frame;
    Window2 w1 = (Window2)_applicationObject.Windows.Item
(Constants.vsWindowKindSolutionExplorer);
    Window2 w2 = (Window2)_applicationObject.Windows.Item(
Constants.vsWindowKindOutput);
    // Create a linked window frame and dock Solution Explorer 
    // and the Ouput window together inside it.
    Frame = (Window2)_applicationObject.Windows.CreateLinkedWindowFrame
(w1, w2, vsLinkedWindowType.vsLinkedWindowTypeDocked);
    MessageBox.Show("Total number of windows in the linked 
window frame: " + Frame.LinkedWindows.Count);
    // Resize the entire linked window frame.
    Frame.Width = 500;
    Frame.Height = 600;
    Frame.Left = 100;
    Frame.Top = 100;
    MessageBox.Show("Frame height, width, and position changed.");
    Frame.LinkedWindows.Remove(w1);
    Frame.LinkedWindows.Remove(w2);
    MessageBox.Show("Undocked the windows.");
}

.NET Framework Security

See Also

Reference

Window2 Interface

EnvDTE80 Namespace