IDirList Interface

Manages the appearance and actions of a displayed directory list.

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

Syntax

'Declaration
<GuidAttribute("07F86395-273C-11D7-8BF6-00B0D03DAA06")> _
Public Interface IDirList
[GuidAttribute("07F86395-273C-11D7-8BF6-00B0D03DAA06")]
public interface IDirList
[GuidAttribute(L"07F86395-273C-11D7-8BF6-00B0D03DAA06")]
public interface class IDirList
[<GuidAttribute("07F86395-273C-11D7-8BF6-00B0D03DAA06")>]
type IDirList =  interface end
public interface IDirList

The IDirList type exposes the following members.

Methods

  Name Description
Public method Add Adds a string to a directory list.
Public method get_Count Gets the number of items in the directory list.
Public method get_Description Returns the description of the directory list.
Public method get_HWND Returns the HWND of the directory list.
Public method get_Title Get the title of the directory list.
Public method index Retrieves an item, by position, from the directory list.
Public method put_Description Changes the description of the directory list.
Public method put_ShowCheck Show or hide the checkbox next to each item in the list.
Public method put_ShowTitle Show or hide the title of the directory list.
Public method put_Title Change the title of the directory list.
Public method Reset Go back to the default values for the directory list.

Top

Examples

In order to get an instance of this interface, you must create a CAxWindow and then call QueryControl, as with the code below. (You can find the definition of CAxWindow in atlwin.h.)

CComPtr<IUnknown> pUnk;

m_pServiceProvider->QueryService(SID_SDirList, IID_IUnknown, (void **)&pUnk);
CAxWindow wndDirList;
RECT rectChild = { 0, 26, 263, 151 };

wndDirList.Create(
    m_hWnd, 
    rectChild, 
    CComBSTR(__uuidof(DirList)),
    WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN,
    0, 
    IDC_DIRCONTROL);    //this can be any number that is unique among the controls of the parent window

CComPtr<IDirList> srpList;
wndDirList.QueryControl(&srpList);

CComQIPtr<IDirListSite> srpListSite = srpList;

if (srpListSite)
srpListSite->SetSite(m_pServiceProvider);

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace