IVsObjectList::GetDisplayData Method (UInt32, array<VSTREEDISPLAYDATA>^)

Visual Studio 2015

Retrieves data to draw the requested tree list item.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

C++

int GetDisplayData(
	unsigned int index,
	array<VSTREEDISPLAYDATA>^ pData
)

Parameters

index: Type: System::UInt32
[in] Specifies the index of the node of interest.

pData: Type: array<Microsoft.VisualStudio.Shell.Interop::VSTREEDISPLAYDATA>^
[out] Pointer to a VSTREEDISPLAYDATA structure containing the display data.

Return Value

Type: System::Int32

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

Implements

IVsLiteTreeList::GetDisplayData(UInt32, array<VSTREEDISPLAYDATA>^)

Remarks

COM Signature

From vsshell.idl:

C++

HRESULT IVsObjectList::GetDisplayData(
   [in] ULONG Index,
   [out] VSTREEDISPLAYDATA *pData
);

The pData parameter is a VSTREEDISPLAYDATA structure which is used to request specific display parameters for the requested tree list item. For more detailed information see VSTREEDISPLAYDATA, _VSTREEDISPLAYMASK, and _VSTREEDISPLAYSTATE.

The tree view will set Mask and StateMask in pData to indicate which display or state data items are of interest, so only those items need to be returned. If State is set, it indicates that StateMask specifies the state data that is being requested. If TDS_STATEIMAGEMASK is not set, the tree view will use its default image list. Typically GetDisplayData is called separately for display data and state data.