IVsSmartTagTipWindow::GetSizePreferences Method (array<RECT>^, array<SMARTTAGSIZEDATA>^)

Visual Studio 2015

Gets the size preferences for the tip window.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop.8.0 (in Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntax

C++

int GetSizePreferences(
	array<RECT>^ prcCtxBounds,
	array<SMARTTAGSIZEDATA>^ pSizeData
)

Parameters

prcCtxBounds: Type: array<Microsoft.VisualStudio.OLE.Interop::RECT>^
[in] Coordinates of the bounding rectangle.

pSizeData: Type: array<Microsoft.VisualStudio.TextManager.Interop::SMARTTAGSIZEDATA>^
[out] Size of the tip window. For values see SMARTTAGSIZEDATA.

Return Value

Type: System::Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From textmgr2.idl:

C++

HRESULT IVsSmartTagTipWindow::GetSizePreferences(
   [out] const RECT *prcCtxBounds,
   [out] SMARTTAGSIZEDATA *pSizeData
);

Implementations should be written to handle cases where the size preference returned here is not the same as the actual real estate available to display content. (that is, cases where it may not be possible to provide the tip window in the requested size). The prcCtxBounds parameter represents the bounding rectangle of the tip's context, for use if needed by the implementation. This rectangle is provided in screen coordinates.