IVsSimpleObjectList2.FillDescription2 Method
Definition
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.
Asks the list item to provide description text to be used in the object browser.
public:
int FillDescription2(System::UInt32 index, System::UInt32 grfOptions, Microsoft::VisualStudio::Shell::Interop::IVsObjectBrowserDescription3 ^ pobDesc);
public:
int FillDescription2(unsigned int index, unsigned int grfOptions, Microsoft::VisualStudio::Shell::Interop::IVsObjectBrowserDescription3 ^ pobDesc);
int FillDescription2(unsigned int index, unsigned int grfOptions, Microsoft::VisualStudio::Shell::Interop::IVsObjectBrowserDescription3 const & pobDesc);
public int FillDescription2 (uint index, uint grfOptions, Microsoft.VisualStudio.Shell.Interop.IVsObjectBrowserDescription3 pobDesc);
abstract member FillDescription2 : uint32 * uint32 * Microsoft.VisualStudio.Shell.Interop.IVsObjectBrowserDescription3 -> int
Public Function FillDescription2 (index As UInteger, grfOptions As UInteger, pobDesc As IVsObjectBrowserDescription3) As Integer
Parameters
- index
- UInt32
[in] Specifies the index of the list item of interest.
- grfOptions
- UInt32
[in] Specifies description options. Values are taken from the _VSOBJDESCOPTIONS enumeration
- pobDesc
- IVsObjectBrowserDescription3
[in] Specifies an IVsObjectBrowserDescription3 interface.
Returns
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From vsshell80.idl:
HRESULT IVsSimpleObjectList2::FillDescription(
[in] ULONG Index,
[in] VSOBJDESCOPTIONS grfOptions,
[in] IVsObjectBrowserDescription2 *pobDesc
);
When an object is selected in the Object Browser, a description of the object appears in the lower pane (Description Pane) of the window. The description text is built through a series of calls to AddDescriptionText3. The environment calls FillDescription
for the index
item of interest. The call passes in an IVsObjectBrowserDescription3 interface. This is similar to an IStream
interface in that you repeatedly call AddDescriptionText3 to write your description as a series of elements. The elements are identified with the VSOBDESCRIPTIONSECTION enumeration.
The environment can specify, through grfOptions
, that you should return the fully qualified name of the Index item.
This method also used as an alternate means of providing tool tip text on the item's icon in the code browsing tools. In this scenario the environment initially calls GetTipText on the Index item. If you return E_NOTIMPLor fail the call, the environment then calls FillDescription
with grfOptions
set to ODO_TOOLTIPDESC | ODO_USEFULLNAME
.