Customizing Folders in C#

• Download demo project - 66.78 KB
• Download source - 82.49 KB

Contents

• Introduction
• Desktop.ini
  • INI Entries
  • Using a DLL for the Icon
  • Using an Icon File for the Icon
• The Code
  • CreateIconFolder
  • UndoIconFolder
• Next Steps / Future Features
• History
• References

Introduction

By now, many of us have seen customized folders in Windows XP and earlier, i.e. folders like My Documents, My Pictures and so on. Well this is accomplished by setting the folder as a System folder and placing a file named desktop.ini into the same folder.

I intend to show you how to create these customized folder views using C#.

• Step 1: Make a folder a system folder. This is as easy as setting the system attribute on the folder. This can be done in DOS with a attrib +s folderName, or through the properties of the folder in Explorer, or through the System.File namespace.
• Step 2: Create the desktop.ini file. This is relatively easy too, all you need is Notepad or the System.IO namespace.

Desktop.ini

The desktop.ini file is an old school INI file. It is essentially a text file with a special syntax.

[section1]
parameter1=value1
parameter2=value2
parameter3=value3
[section2]
parameter1=value1
parameter2=value2
parameter3=value3    

The desktop.ini file requires a section of [.ShellClassInfo] and a minimum of two attributes/parameters, IconFile and IconIndex. There are two ways that an icon can be specified for a folder. The first is through a Win32 resource file (note: this is not the same as a .NET resource file) or through a file.

INI Entries

These are the valid entries and values for the [.ShellClassInfo] section.

Using a DLL for the Icon

Use this method when the icon exists in a Win32 DLL like SHELL32.DLL. In the example below, you will see that the InfoTip value is "pulled" from the Shell32.dll resource section as well as the IconFile.

[.ShellClassInfo]
InfoTip=@Shell32.dll,-12690
IconFile=%SystemRoot%\system32\SHELL32.dll
IconIndex=-238    

Using an Icon File for the Icons

Use this method when you will provide a physical file like Folder_Blue_Software_1.ico.

[.ShellClassInfo]
IconFile=Folder_Blue_Software_1.ico
IconIndex=0
InfoTip=Sample tooltip for this folder.
ConfirmFileOp=0
NoSharing=0

The Code

Now the fun part, the code.

Here I provide two methods CreateIconFolder and UndoIconFolder.

CreateIconFolder

The CreateIconFolder method provides a helper function to create the "iconed" folder. This method is overloaded.

The first overload ...

CreateIconFolder(string folderName, string iconFile)

... uses the following defaults for the desktop.ini creation: IconIndex = 0, InfoTip="", ConfirmFileOp=0, and NoSharing = 0.

The second overload provides more control over the creation of the desktop.ini file.

CreateIconFolder(string folderName, string iconFile, int iconIndex, 
            string toolTip, bool preventSharing, bool confirmDelete)

The code...

/// <summary>
/// Turns a folder into a "Special" folder, at least one that contains 
/// an icon and custom tooltip
/// </summary>
/// <remarks>
/// The default for iconIndex is 0.
/// The default for toolTip is "".
/// The default for preventSharing is false.
/// The default for confirmDelete is true.
/// </remarks>
/// <param name="folderName">The fully qualified path to the file.</param>
/// <param name="iconFile">The Icon File to use.</param>
/// <returns>True upon success, otherwise false.</returns>
private bool CreateIconedFolder (string folderName, string iconFile)
{
   return CreateIconedFolder(folderName, iconFile, 0, "", false, true);
}

/// <summary>
/// Turns a folder into a "Special" folder, at least one that contains an icon 
/// and custom tooltip
/// </summary>
/// <param name="folderName">The fully qualified path to the file.</param>
/// <param name="iconFile">The Icon File to use.</param>
/// <param name="iconIndex">The index of the icon to use.</param>
/// <param name="toolTip">The tooltip or "InfoTip" to use.</param>
/// <param name="preventSharing">True indicates the folder cannot be shared. 
/// False indicates sharing is allowed.</param>
/// <param name="confirmDelete">True indicates the use will receive a message 
/// "You are deleting a system" when attempting
/// to delete the folder.  False indicates that the operating system 
/// will not raise this warning.</param>
/// <returns>True upon success, otherwise false.</returns>
private bool CreateIconedFolder 
    (string folderName, string iconFile, int iconIndex, string toolTip,
      bool preventSharing, bool confirmDelete)
{
   #region Private Variables
   DirectoryInfo folder;
   string fileName = "desktop.ini";
   #endregion Private Variables

   #region Data Validation

   if (Directory.Exists(folderName) == false)
   {
      return false;
   }

   #endregion Data Validation

   try
   {
      folder = new DirectoryInfo(folderName);
      fileName = Path.Combine(folderName, fileName);

      // Create the file
      using (StreamWriter sw = new StreamWriter(fileName))
      {
         sw.WriteLine("[.ShellClassInfo]");
         sw.WriteLine("ConfirmFileOp={0}", confirmDelete);
         sw.WriteLine("NoSharing={0}", preventSharing);
         sw.WriteLine("IconFile={0}", iconFile);
         sw.WriteLine("IconIndex={0}", iconIndex);
         sw.WriteLine("InfoTip={0}", toolTip);
         sw.Close();
      }

      // Update the folder attributes
      folder.Attributes = folder.Attributes | FileAttributes.System;

      // "Hide" the desktop.ini
      File.SetAttributes(fileName, File.GetAttributes(fileName) | FileAttributes.Hidden);
   }
   catch
   {
      return false;
   }

   return true;
}

UndoIconFolder

The UndoIconFolder utility function will revert a file back to a "normal" folder. This function deletes the desktop.ini and removes the system attribute from the folder.

/// <summary>
/// Turns a "Special" folder back into a normal folder.
/// </summary>
/// <param name="folderName">The folder to revert back.</param>
/// <returns>True upon success otherwise false.</returns>
private bool UndoIconedFolder (string folderName)
{
   #region Private Variables
   DirectoryInfo folder;
   #endregion Private Variables

   #region Data Validation
   if (Directory.Exists(folderName) == false)
   {
      return false;
   }
   #endregion Data Validation

   try
   {
      folder = new DirectoryInfo(folderName);

      // Remove the file [Desktop.ini]
      FileInfo file = new FileInfo(Path.Combine(folderName, "desktop.ini"));
      if (file.Exists)
      {
         file.Delete();
      }

      folder.Attributes = (folder.Attributes | FileAttributes.System);
   }
   catch
   {
      return false;
   }

   return true;
}

Next Steps / Future Features

• I don't plan on adding anything to this, but let me know if I need to add anything.

History

References

• Shell Basics: Extending the Shell

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)