天天看點

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

(本系列文章由檸檬的(lc_mtt)原創,轉載請注明出處,謝謝~)

Windows Shell 程式設計,即 Windows 外殼程式設計。我們所看到的資料總管以及整個桌面,都是一個 Shell。

好,現在讓我們從基礎學起,早日做出一個強大的資料總管軟體。(偶也是初學者,多多指教)

1 - 基礎,浏覽一個檔案夾

我們知道,在win32中是以外殼名字空間的形式來組織檔案系統的,在外殼名字空間裡的每一個對象(注)都實作了一個IShellFolder的接口,通過這個接口我們可以直接查詢或間接得到其他相關的接口。

(注:這裡的對象指的是外殼名字空間中的一個節點,對象有可能是一個檔案夾,有可能是一個檔案,也有可能是一個虛拟檔案夾,例如:我的電腦,網路上的芳鄰,控制台等)

在C#中,我們這樣定義 IShellFolder 接口:

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

IShellFolder.cs

當然,這個接口還沒有列出細節函數。我們要做的僅僅是從最基礎開始。

“桌面”是最頂級的檔案夾,外殼名字空間中其他各項都可以用從“桌面”開始的 PIDL 加以表示。

如何擷取“桌面”的 PIDL 和其 IShellFolder 接口呢,可以通過 API SHGetDesktopFolder:

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

[DllImport("shell32.dll")]

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        public static extern Int32 SHGetDesktopFolder(out IntPtr ppshf);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

/// <summary>

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        /// 獲得桌面 Shell

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        /// </summary>

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        public static IShellFolder GetDesktopFolder(out IntPtr ppshf)

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        {

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            SHGetDesktopFolder(out ppshf);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            Object obj = Marshal.GetObjectForIUnknown(ppshf);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            return (IShellFolder)obj;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        }

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

//獲得桌面 PIDL

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr desktopPtr;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IShellFolder desktop = API.GetDesktopFolder(out desktopPtr);

好的,我們取得“桌面”的 IShellFolder 接口,就已經成功了一半。現在我需要通過“桌面”,來擷取“C:\”這個路徑的 PIDL 和 IShellFolder 接口,可以通過 IShellFolder 的 ParseDisplayName 和 BindToObject 函數來實作:

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

void ParseDisplayName(

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr hwnd,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr pbc,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            [MarshalAs(UnmanagedType.LPWStr)] string pszDisplayName,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            out uint pchEaten,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            out IntPtr ppidl,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            ref uint pdwAttributes);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

void BindToObject(

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr pidl,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            [In()] ref Guid riid,

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            out IShellFolder ppv);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

//擷取 C 盤的 PIDL

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            string FolderPath = @"C:\";

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr Pidl = IntPtr.Zero;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IShellFolder Root;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            uint i, j = 0;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            desktop.ParseDisplayName(Handle, IntPtr.Zero, FolderPath, out i, out Pidl, ref j);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            desktop.BindToObject(Pidl, IntPtr.Zero, ref Guids.IID_IShellFolder, out Root);

前提是你應該保證路徑存在,因為我沒有做任何出錯控制。這樣我們就獲得了一個 Root,它表示C槽。通過這個Root,我們可以用 EnumObjects 來循環擷取其子項(子檔案和子檔案夾):

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

[PreserveSig]

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

        int EnumObjects(IntPtr hWnd, SHCONTF flags, out IntPtr enumIDList);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

//循環查找 C 盤下面的檔案/檔案夾的 PIDL

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IEnumIDList fileEnum = null;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IEnumIDList folderEnum = null;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr fileEnumPtr = IntPtr.Zero;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr folderEnumPtr = IntPtr.Zero;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            IntPtr pidlSub;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            int celtFetched;

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            //擷取子檔案夾

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            if (Root.EnumObjects(this.Handle, SHCONTF.FOLDERS | SHCONTF.INCLUDEHIDDEN, out fileEnumPtr) == API.S_OK)

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            {

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                fileEnum = (IEnumIDList)Marshal.GetObjectForIUnknown(fileEnumPtr);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                while (fileEnum.Next(1, out pidlSub, out celtFetched) == 0 && celtFetched == API.S_FALSE)

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                {

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                    //擷取顯示名稱

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                    string name = API.GetNameByPIDL(pidlSub);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                    lvFile.Items.Add(name, 1);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                }

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            }

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            //擷取子檔案

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

            if (Root.EnumObjects(this.Handle, SHCONTF.NONFOLDERS | SHCONTF.INCLUDEHIDDEN, out folderEnumPtr) == API.S_OK)

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                folderEnum = (IEnumIDList)Marshal.GetObjectForIUnknown(folderEnumPtr);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                while (folderEnum.Next(1, out pidlSub, out celtFetched) == 0 && celtFetched == API.S_FALSE)

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

                    lvFile.Items.Add(name, 0);

(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾
(C#)Windows Shell 外殼程式設計系列1 - 基礎,浏覽一個檔案夾

事實上,代碼到此結束。然而我發現有太多的結構體和枚舉沒有介紹(以後會有更多),有興趣的朋友可以自己查 MSDN ,否則就等待我下一節再介紹了。

最後把圖和代碼貼上,下一節再詳細介紹。