IShellFolderViewType-Schnittstelle

Artikel
06/13/2023

Macht Methoden verfügbar, die es einem Shellordner ermöglichen, unterschiedliche Ansichten für seinen Inhalt (unterschiedliche hierarchische Layouts seiner Daten) zu unterstützen.

Member

Die IShellFolderViewType-Schnittstelle erbt von der IUnknown-Schnittstelle . IShellFolderViewType verfügt auch über folgende Membertypen:

Methoden

Methoden

Die IShellFolderViewType-Schnittstelle verfügt über diese Methoden.

Methode	BESCHREIBUNG
EnumViews	Ruft einen Enumerator ab, der eine PIDL für jede erweiterte Ansicht zurückgibt.
GetDefaultViewName	Ruft den Namen der Standardansicht ab. Rufen Sie IShellFolder::GetDisplayNameOf auf, um die Namen der anderen Ansichten abzurufen.
GetViewTypeProperties	Ruft die Eigenschaften der Ansicht ab.
TranslateViewPidl	Rekonstruiert eine PIDL aus einer hierarchischen Darstellung des Shellordners in eine andere Darstellung.

Bemerkungen

Dieser Enumerator gibt PIDLs zurück, bei denen es sich um spezielle ausgeblendete Ordner auf der obersten Ebene des Shellordners handelt, die andernfalls nicht aufgelistet werden. Die Standardansicht ist die Ansicht, die der Shell-Ordner normal anzeigt.

Diese Schnittstelle ist in keiner öffentlichen Headerdatei definiert. Wenn Sie diese Schnittstelle implementieren möchten, können Sie den folgenden C/C++-Code verwenden, um die Methoden zu deklarieren.

#undef  INTERFACE
#define INTERFACE   IShellFolderViewType
DECLARE_INTERFACE_IID_(IShellFolderViewType, IUnknown, "49422C1E-1C03-11d2-8DAB-0000F87A556C")
{
    // *** IUnknown methods ***
    STDMETHOD(QueryInterface) (THIS_ REFIID riid, __out void **ppv) PURE;
    STDMETHOD_(ULONG,AddRef)  (THIS) PURE;
    STDMETHOD_(ULONG,Release) (THIS) PURE;

    // *** IShellFolderViewType Methods ***

    // EnumViews:
    //   Returns an enumerator which will give out one pidl for every extended view.
    STDMETHOD(EnumViews)(THIS_ ULONG grfFlags, __out IEnumIDList **ppenum) PURE;

    // GetDefaultViewName:
    //   Returns the name of the default view.  The names of the other views
    //   can be retrieved by calling GetDisplayNameOf.
    STDMETHOD(GetDefaultViewName)(THIS_ DWORD  uFlags, __out LPWSTR *ppwszName) PURE;
    STDMETHOD(GetViewTypeProperties)(THIS_ PCUITEMID_CHILD pidl, __out DWORD *pdwFlags)  PURE;

    // TranslateViewPidl:
    //   Attempts to take a pidl represented in one hierarchical representation of
    //   the Shell folder, and find it in a different representation.
    //   pidl should be relative to the root folder.
    //   Remember to ILFree ppidlOut
    STDMETHOD(TranslateViewPidl)(THIS_ PCUIDLIST_RELATIVE pidl, PCUIDLIST_RELATIVE pidlView,
              __out PIDLIST_RELATIVE *ppidlOut) PURE;
};

#define SFVTFLAG_NOTIFY_CREATE  0x00000001
#define SFVTFLAG_NOTIFY_RESORT  0x00000002

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
DLL	Shell32.dll