IVsWindowFrame Interface

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.11.40262

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides access to behaviors and properties of environment window frames, for both tool and document windows.

public interface class IVsWindowFrame

public interface class IVsWindowFrame

__interface IVsWindowFrame

[System.Runtime.InteropServices.ComConversionLoss]
[System.Runtime.InteropServices.Guid("11138F8A-38C0-4436-B5A6-2F5EF2C3E242")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsWindowFrame

[System.Runtime.InteropServices.ComConversionLoss]
[System.Runtime.InteropServices.Guid("11138F8A-38C0-4436-B5A6-2F5EF2C3E242")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IVsWindowFrame

[<System.Runtime.InteropServices.ComConversionLoss>]
[<System.Runtime.InteropServices.Guid("11138F8A-38C0-4436-B5A6-2F5EF2C3E242")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsWindowFrame = interface

[<System.Runtime.InteropServices.ComConversionLoss>]
[<System.Runtime.InteropServices.Guid("11138F8A-38C0-4436-B5A6-2F5EF2C3E242")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IVsWindowFrame = interface

Public Interface IVsWindowFrame

Attributes: ComConversionLossAttribute GuidAttribute InterfaceTypeAttribute

Remarks

The environment does not provide two modes for controls hosted in an IVsWindowFrame object. A check for ambient properties returns null indicating that ambient properties are not supported.

A VSPackage that implements IOleObject, such as an editor that uses a document window, might call the GetAmbientUserMode method to check for design mode or run mode. While the guidelines for ActiveX control containers state that the containers (or sites) should support ambient properties, this doesn't work in Visual Studio because the site created for the VSPackage does not support ambient properties.

UserMode normally indicates the mode in which the control should be run:

Run Mode

UserMode == false

DesignMode

UserMode == true

Notes to Callers

Call IVsWindowFrame to obtain an IVsWindowFrame pointer to call methods on a document or tool window. IVsWindowFrame is implemented by the environment through the SVsWindowFrame service.

Methods

CloseFrame(UInt32)	Closes a window.
GetFramePos(VSSETFRAMEPOS[], Guid, Int32, Int32, Int32, Int32)	Returns the position of the window.
GetGuidProperty(Int32, Guid)	Returns a window frame property based on a supplied GUID.
GetProperty(Int32, Object)	Returns a window property.
Hide()	Hides a window.
IsOnScreen(Int32)	Returns `true` if the window frame is on the screen.
IsVisible()	Determines whether or not the window is visible.
QueryViewInterface(Guid, IntPtr)	Provides IVsWindowFrame with a view helper (VSFPROPID_ViewHelper) inserted into its list of event notifications.
SetFramePos(VSSETFRAMEPOS, Guid, Int32, Int32, Int32, Int32)	Sets the position of the window.
SetGuidProperty(Int32, Guid)	Sets a window frame property based on a supplied GUID.
SetProperty(Int32, Object)	Sets a window frame property.
Show()	Renders this window visible, brings the window to the top, and activates the window.
ShowNoActivate()	Shows or makes a window visible and brings it to the top, but does not make it the active window.

Applies to

Share via