Vanara/PInvoke/Shell32/ShObjIdl.IFileDialog.cs

using System;
using System.Runtime.InteropServices;
using System.Security;
using Vanara.InteropServices;

namespace Vanara.PInvoke
{
	public static partial class Shell32
	{
		/// <summary>
		/// Specifies the values that indicate whether a control is visible and enabled. Used by members of the IFileDialogCustomize interface.
		/// </summary>
		[Flags]
		public enum CDCONTROLSTATEF : uint
		{
			/// <summary>The control is inactive and cannot be accessed by the user.</summary>
			CDCS_INACTIVE = 0x00000000,

			/// <summary>The control is active.</summary>
			CDCS_ENABLED = 0x00000001,

			/// <summary>The control is visible. The absence of this value indicates that the control is hidden.</summary>
			CDCS_VISIBLE = 0x00000002,

			/// <summary>Windows 7 and later. The control is visible and enabled.</summary>
			CDCS_ENABLEDVISIBLE = 0x00000003
		}

		/// <summary>Specifies list placement.</summary>
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb762502")]
		public enum FDAP : uint
		{
			/// <summary>The place is added to the bottom of the default list.</summary>
			FDAP_BOTTOM = 0,

			/// <summary>The place is added to the top of the default list.</summary>
			FDAP_TOP = 1
		}

		/// <summary>
		/// Specifies the values used by the IFileDialogEvents::OnShareViolation method to indicate an application's response to a sharing
		/// violation that occurs when a file is opened or saved.
		/// </summary>
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb762504")]
		public enum FDE_SHAREVIOLATION_RESPONSE
		{
			/// <summary>
			/// The application has not handled the event. The dialog displays a UI that indicates that the file is in use and a different
			/// file must be chosen.
			/// </summary>
			FDESVR_DEFAULT,

			/// <summary>The application has determined that the file should be returned from the dialog.</summary>
			FDESVR_ACCEPT,

			/// <summary>The application has determined that the file should not be returned from the dialog.</summary>
			FDESVR_REFUSE
		}

		/// <summary>Defines the set of options available to an Open or Save dialog.</summary>
		[PInvokeData("Shobjidl.h", MSDNShortId = "dn457282")]
		[Flags]
		public enum FILEOPENDIALOGOPTIONS : uint
		{
			/// <summary>
			/// When saving a file, prompt before overwriting an existing file of the same name. This is a default value for the Save dialog.
			/// </summary>
			FOS_OVERWRITEPROMPT = 0x00000002,

			/// <summary>
			/// In the Save dialog, only allow the user to choose a file that has one of the file name extensions specified through IFileDialog::SetFileTypes.
			/// </summary>
			FOS_STRICTFILETYPES = 0x00000004,

			/// <summary>Don't change the current working directory.</summary>
			FOS_NOCHANGEDIR = 0x00000008,

			/// <summary>Present an Open dialog that offers a choice of folders rather than files.</summary>
			FOS_PICKFOLDERS = 0x00000020,

			/// <summary>
			/// Ensures that returned items are file system items (SFGAO_FILESYSTEM). Note that this does not apply to items returned by IFileDialog::GetCurrentSelection.
			/// </summary>
			FOS_FORCEFILESYSTEM = 0x00000040,

			/// <summary>
			/// Enables the user to choose any item in the Shell namespace, not just those with SFGAO_STREAM or SFAGO_FILESYSTEM attributes.
			/// This flag cannot be combined with FOS_FORCEFILESYSTEM.
			/// </summary>
			FOS_ALLNONSTORAGEITEMS = 0x00000080,

			/// <summary>
			/// Do not check for situations that would prevent an application from opening the selected file, such as sharing violations or
			/// access denied errors.
			/// </summary>
			FOS_NOVALIDATE = 0x00000100,

			/// <summary>
			/// Enables the user to select multiple items in the open dialog. Note that when this flag is set, the IFileOpenDialog interface
			/// must be used to retrieve those items.
			/// </summary>
			FOS_ALLOWMULTISELECT = 0x00000200,

			/// <summary>The item returned must be in an existing folder. This is a default value.</summary>
			FOS_PATHMUSTEXIST = 0x00000800,

			/// <summary>The item returned must exist. This is a default value for the Open dialog.</summary>
			FOS_FILEMUSTEXIST = 0x00001000,

			/// <summary>
			/// Prompt for creation if the item returned in the save dialog does not exist. Note that this does not actually create the item.
			/// </summary>
			FOS_CREATEPROMPT = 0x00002000,

			/// <summary>
			/// In the case of a sharing violation when an application is opening a file, call the application back through OnShareViolation
			/// for guidance. This flag is overridden by FOS_NOVALIDATE.
			/// </summary>
			FOS_SHAREAWARE = 0x00004000,

			/// <summary>Do not return read-only items. This is a default value for the Save dialog.</summary>
			FOS_NOREADONLYRETURN = 0x00008000,

			/// <summary>
			/// Do not test whether creation of the item as specified in the Save dialog will be successful. If this flag is not set, the
			/// calling application must handle errors, such as denial of access, discovered when the item is created.
			/// </summary>
			FOS_NOTESTFILECREATE = 0x00010000,

			/// <summary>
			/// Hide the list of places from which the user has recently opened or saved items. This value is not supported as of Windows 7.
			/// </summary>
			FOS_HIDEMRUPLACES = 0x00020000,

			/// <summary>
			/// Hide items shown by default in the view's navigation pane. This flag is often used in conjunction with the
			/// IFileDialog::AddPlace method, to hide standard locations and replace them with custom locations.
			/// <para>
			/// <c>Windows 7</c> and later. Hide all of the standard namespace locations (such as Favorites, Libraries, Computer, and
			/// Network) shown in the navigation pane.
			/// </para>
			/// <para>
			/// <c>Windows Vista.</c> Hide the contents of the Favorite Links tree in the navigation pane. Note that the category itself is
			/// still displayed, but shown as empty.
			/// </para>
			/// </summary>
			FOS_HIDEPINNEDPLACES = 0x00040000,

			/// <summary>
			/// Shortcuts should not be treated as their target items. This allows an application to open a .lnk file rather than what that
			/// file is a shortcut to.
			/// </summary>
			FOS_NODEREFERENCELINKS = 0x00100000,

			/// <summary>Do not add the item being opened or saved to the recent documents list (SHAddToRecentDocs).</summary>
			FOS_DONTADDTORECENT = 0x02000000,

			/// <summary>Include hidden and system items.</summary>
			FOS_FORCESHOWHIDDEN = 0x10000000,

			/// <summary>
			/// Indicates to the Save As dialog box that it should open in expanded mode. Expanded mode is the mode that is set and unset by
			/// clicking the button in the lower-left corner of the Save As dialog box that switches between Browse Folders and Hide Folders
			/// when clicked. This value is not supported as of Windows 7.
			/// </summary>
			FOS_DEFAULTNOMINIMODE = 0x20000000,

			/// <summary>Indicates to the Open dialog box that the preview pane should always be displayed.</summary>
			FOS_FORCEPREVIEWPANEON = 0x40000000,

			/// <summary>
			/// Indicates that the caller is opening a file as a stream (BHID_Stream), so there is no need to download that file.
			/// </summary>
			FOS_SUPPORTSTREAMABLEITEMS = 0x80000000
		}

		/// <summary>Used by methods of the ITransferSource and ITransferDestination interfaces to control their file operations.</summary>
		[Flags]
		public enum TRANSFER_SOURCE_FLAGS
		{
			/// <summary>Fail if the destination already exists, unless TSF_OVERWRITE_EXIST is specified. This is a default behavior.</summary>
			TSF_NORMAL = 0,

			/// <summary>Fail if the destination already exists, unless TSF_OVERWRITE_EXIST is specified. This is a default behavior</summary>
			TSF_FAIL_EXIST = 0,

			/// <summary>Rename with auto-name generation if the destination already exists.</summary>
			TSF_RENAME_EXIST = 0x1,

			/// <summary>Overwrite or merge with the destination.</summary>
			TSF_OVERWRITE_EXIST = 0x2,

			/// <summary>Allow creation of a decrypted destination.</summary>
			TSF_ALLOW_DECRYPTION = 0x4,

			/// <summary>No discretionary access control list (DACL), system access control list (SACL), or owner.</summary>
			TSF_NO_SECURITY = 0x8,

			/// <summary>
			/// Copy the creation time as part of the copy. This can be useful for a move operation that is being used as a copy and delete
			/// operation (TSF_MOVE_AS_COPY_DELETE).
			/// </summary>
			TSF_COPY_CREATION_TIME = 0x10,

			/// <summary>Copy the last write time as part of the copy.</summary>
			TSF_COPY_WRITE_TIME = 0x20,

			/// <summary>Assign write, read, and delete permissions as share mode.</summary>
			TSF_USE_FULL_ACCESS = 0x40,

			/// <summary>Recycle on file delete, if possible.</summary>
			TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80,

			/// <summary>Hard link to the desired source (not required). This avoids a normal copy operation.</summary>
			TSF_COPY_HARD_LINK = 0x100,

			/// <summary>Copy the localized name.</summary>
			TSF_COPY_LOCALIZED_NAME = 0x200,

			/// <summary>Move as a copy and delete operation.</summary>
			TSF_MOVE_AS_COPY_DELETE = 0x400,

			/// <summary>Suspend Shell events.</summary>
			TSF_SUSPEND_SHELLEVENTS = 0x800
		}

		/// <summary>Exposes methods that initialize, show, and get results from the common file dialog.</summary>
		/// <seealso cref="IModalWindow"/>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("42f85136-db7e-439c-85f1-e4075d135fc8")]
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb775966")]
		public interface IFileDialog : IModalWindow
		{
			/// <summary>Launches the modal window.</summary>
			/// <param name="parent">The handle of the owner window. This value can be NULL.</param>
			/// <returns>
			/// If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:
			/// HRESULT_FROM_WIN32(ERROR_CANCELLED) = The user closed the window by canceling the operation.
			/// </returns>
			[PreserveSig]
			new HRESULT Show(HWND parent);

			/// <summary>Sets the file types that the dialog can open or save.</summary>
			/// <param name="cFileTypes">The number of elements in the array specified by rgFilterSpec.</param>
			/// <param name="rgFilterSpec">A pointer to an array of COMDLG_FILTERSPEC structures, each representing a file type.</param>
			void SetFileTypes(uint cFileTypes,
				[MarshalAs(UnmanagedType.LPArray, SizeParamIndex = 0)] COMDLG_FILTERSPEC[] rgFilterSpec);

			/// <summary>Sets the file type that appears as selected in the dialog.</summary>
			/// <param name="iFileType">
			/// The index of the file type in the file type array passed to IFileDialog::SetFileTypes in its cFileTypes parameter. Note that
			/// this is a one-based index, not zero-based.
			/// </param>
			void SetFileTypeIndex(uint iFileType);

			/// <summary>Gets the currently selected file type.</summary>
			/// <returns>
			/// A UINT value that receives the index of the selected file type in the file type array passed to IFileDialog::SetFileTypes in
			/// its cFileTypes parameter.
			/// </returns>
			uint GetFileTypeIndex();

			/// <summary>Assigns an event handler that listens for events coming from the dialog.</summary>
			/// <param name="pfde">A pointer to an IFileDialogEvents implementation that will receive events from the dialog.</param>
			/// <returns>
			/// A DWORD value identifying this event handler. When the client is finished with the dialog, that client must call the
			/// IFileDialog::Unadvise method with this value.
			/// </returns>
			uint Advise(IFileDialogEvents pfde);

			/// <summary>Removes an event handler that was attached through the IFileDialog::Advise method.</summary>
			/// <param name="dwCookie">
			/// The DWORD value that represents the event handler. This value is obtained through the pdwCookie parameter of the
			/// IFileDialog::Advise method.
			/// </param>
			void Unadvise(uint dwCookie);

			/// <summary>Sets flags to control the behavior of the dialog.</summary>
			/// <param name="fos">One or more of the FILEOPENDIALOGOPTIONS values.</param>
			void SetOptions(FILEOPENDIALOGOPTIONS fos);

			/// <summary>Gets the current flags that are set to control dialog behavior.</summary>
			/// <returns>
			/// When this method returns successfully, points to a value made up of one or more of the FILEOPENDIALOGOPTIONS values.
			/// </returns>
			FILEOPENDIALOGOPTIONS GetOptions();

			/// <summary>Sets the folder used as a default if there is not a recently used folder value available.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			void SetDefaultFolder(IShellItem psi);

			/// <summary>Sets a folder that is always selected when the dialog is opened, regardless of previous user action.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			void SetFolder(IShellItem psi);

			/// <summary>
			/// Gets either the folder currently selected in the dialog, or, if the dialog is not currently displayed, the folder that is to
			/// be selected when the dialog is opened.
			/// </summary>
			/// <returns>The address of a pointer to the interface that represents the folder.</returns>
			IShellItem GetFolder();

			/// <summary>Gets the user's current selection in the dialog.</summary>
			/// <returns>
			/// The address of a pointer to the interface that represents the item currently selected in the dialog. This item can be a file
			/// or folder selected in the view window, or something that the user has entered into the dialog's edit box. The latter case may
			/// require a parsing operation (cancelable by the user) that blocks the current thread.
			/// </returns>
			IShellItem GetCurrentSelection();

			/// <summary>Sets the file name that appears in the File name edit box when that dialog box is opened.</summary>
			/// <param name="pszName">A pointer to the name of the file.</param>
			void SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);

			/// <summary>Retrieves the text currently entered in the dialog's File name edit box.</summary>
			/// <returns>The address of a pointer to a buffer that, when this method returns successfully, receives the text.</returns>
			SafeCoTaskMemString GetFileName();

			/// <summary>Sets the title of the dialog.</summary>
			/// <param name="pszTitle">A pointer to a buffer that contains the title text.</param>
			void SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);

			/// <summary>Sets the text of the Open or Save button.</summary>
			/// <param name="pszText">A pointer to a buffer that contains the button text.</param>
			void SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Sets the text of the label next to the file name edit box.</summary>
			/// <param name="pszLabel">A pointer to a buffer that contains the label text.</param>
			void SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Gets the choice that the user made in the dialog.</summary>
			/// <returns>The address of a pointer to an IShellItem that represents the user's choice.</returns>
			IShellItem GetResult();

			/// <summary>Adds a folder to the list of places available for the user to open or save items.</summary>
			/// <param name="psi">
			/// A pointer to an IShellItem that represents the folder to be made available to the user. This can only be a folder.
			/// </param>
			/// <param name="fdap">Specifies where the folder is placed within the list.</param>
			void AddPlace(IShellItem psi, FDAP fdap);

			/// <summary>Sets the default extension to be added to file names.</summary>
			/// <param name="pszDefaultExtension">
			/// A pointer to a buffer that contains the extension text. This string should not include a leading period. For example, "jpg"
			/// is correct, while ".jpg" is not.
			/// </param>
			void SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);

			/// <summary>Closes the dialog.</summary>
			/// <param name="hr">The code that will be returned by Show to indicate that the dialog was closed before a selection was made.</param>
			void Close([MarshalAs(UnmanagedType.Error)] HRESULT hr);

			/// <summary>Enables a calling application to associate a GUID with a dialog's persisted state.</summary>
			/// <param name="guid">The GUID to associate with this dialog state.</param>
			void SetClientGuid(in Guid guid);

			/// <summary>Instructs the dialog to clear all persisted state information.</summary>
			void ClearClientData();

			/// <summary>Sets the filter. <note>Deprecated. SetFilter is no longer available for use as of Windows 7.</note></summary>
			/// <param name="pFilter">A pointer to the IShellItemFilter that is to be set.</param>
			void SetFilter([MarshalAs(UnmanagedType.Interface)] object pFilter);
		}

		/// <summary>
		/// Extends the IFileDialog interface by providing methods that allow the caller to name a specific, restricted location that can be
		/// browsed in the common file dialog as well as to specify alternate text to display as a label on the Cancel button.
		/// </summary>
		/// <seealso cref="Vanara.PInvoke.Shell32.IFileDialog"/>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("61744fc7-85b5-4791-a9b0-272276309b13")]
		[PInvokeData("Shobjidl.h", MinClient = PInvokeClient.Windows7)]
		public interface IFileDialog2 : IFileDialog
		{
			/// <summary>Launches the modal window.</summary>
			/// <param name="parent">The handle of the owner window. This value can be NULL.</param>
			/// <returns>
			/// If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:
			/// HRESULT_FROM_WIN32(ERROR_CANCELLED) = The user closed the window by canceling the operation.
			/// </returns>
			[PreserveSig]
			new HRESULT Show(HWND parent);

			/// <summary>Sets the file types that the dialog can open or save.</summary>
			/// <param name="cFileTypes">The number of elements in the array specified by rgFilterSpec.</param>
			/// <param name="rgFilterSpec">A pointer to an array of COMDLG_FILTERSPEC structures, each representing a file type.</param>
			new void SetFileTypes(uint cFileTypes,
				[MarshalAs(UnmanagedType.LPArray, SizeParamIndex = 0)] COMDLG_FILTERSPEC[] rgFilterSpec);

			/// <summary>Sets the file type that appears as selected in the dialog.</summary>
			/// <param name="iFileType">
			/// The index of the file type in the file type array passed to IFileDialog::SetFileTypes in its cFileTypes parameter. Note that
			/// this is a one-based index, not zero-based.
			/// </param>
			new void SetFileTypeIndex(uint iFileType);

			/// <summary>Gets the currently selected file type.</summary>
			/// <returns>
			/// A UINT value that receives the index of the selected file type in the file type array passed to IFileDialog::SetFileTypes in
			/// its cFileTypes parameter.
			/// </returns>
			new uint GetFileTypeIndex();

			/// <summary>Assigns an event handler that listens for events coming from the dialog.</summary>
			/// <param name="pfde">A pointer to an IFileDialogEvents implementation that will receive events from the dialog.</param>
			/// <returns>
			/// A DWORD value identifying this event handler. When the client is finished with the dialog, that client must call the
			/// IFileDialog::Unadvise method with this value.
			/// </returns>
			new uint Advise(IFileDialogEvents pfde);

			/// <summary>Removes an event handler that was attached through the IFileDialog::Advise method.</summary>
			/// <param name="dwCookie">
			/// The DWORD value that represents the event handler. This value is obtained through the pdwCookie parameter of the
			/// IFileDialog::Advise method.
			/// </param>
			new void Unadvise(uint dwCookie);

			/// <summary>Sets flags to control the behavior of the dialog.</summary>
			/// <param name="fos">One or more of the FILEOPENDIALOGOPTIONS values.</param>
			new void SetOptions(FILEOPENDIALOGOPTIONS fos);

			/// <summary>Gets the current flags that are set to control dialog behavior.</summary>
			/// <returns>
			/// When this method returns successfully, points to a value made up of one or more of the FILEOPENDIALOGOPTIONS values.
			/// </returns>
			new FILEOPENDIALOGOPTIONS GetOptions();

			/// <summary>Sets the folder used as a default if there is not a recently used folder value available.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			new void SetDefaultFolder(IShellItem psi);

			/// <summary>Sets a folder that is always selected when the dialog is opened, regardless of previous user action.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			new void SetFolder(IShellItem psi);

			/// <summary>
			/// Gets either the folder currently selected in the dialog, or, if the dialog is not currently displayed, the folder that is to
			/// be selected when the dialog is opened.
			/// </summary>
			/// <returns>The address of a pointer to the interface that represents the folder.</returns>
			new IShellItem GetFolder();

			/// <summary>Gets the user's current selection in the dialog.</summary>
			/// <returns>
			/// The address of a pointer to the interface that represents the item currently selected in the dialog. This item can be a file
			/// or folder selected in the view window, or something that the user has entered into the dialog's edit box. The latter case may
			/// require a parsing operation (cancelable by the user) that blocks the current thread.
			/// </returns>
			new IShellItem GetCurrentSelection();

			/// <summary>Sets the file name that appears in the File name edit box when that dialog box is opened.</summary>
			/// <param name="pszName">A pointer to the name of the file.</param>
			new void SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);

			/// <summary>Retrieves the text currently entered in the dialog's File name edit box.</summary>
			/// <returns>The address of a pointer to a buffer that, when this method returns successfully, receives the text.</returns>
			new SafeCoTaskMemString GetFileName();

			/// <summary>Sets the title of the dialog.</summary>
			/// <param name="pszTitle">A pointer to a buffer that contains the title text.</param>
			new void SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);

			/// <summary>Sets the text of the Open or Save button.</summary>
			/// <param name="pszText">A pointer to a buffer that contains the button text.</param>
			new void SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Sets the text of the label next to the file name edit box.</summary>
			/// <param name="pszLabel">A pointer to a buffer that contains the label text.</param>
			new void SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Gets the choice that the user made in the dialog.</summary>
			/// <returns>The address of a pointer to an IShellItem that represents the user's choice.</returns>
			new IShellItem GetResult();

			/// <summary>Adds a folder to the list of places available for the user to open or save items.</summary>
			/// <param name="psi">
			/// A pointer to an IShellItem that represents the folder to be made available to the user. This can only be a folder.
			/// </param>
			/// <param name="fdap">Specifies where the folder is placed within the list.</param>
			new void AddPlace(IShellItem psi, FDAP fdap);

			/// <summary>Sets the default extension to be added to file names.</summary>
			/// <param name="pszDefaultExtension">
			/// A pointer to a buffer that contains the extension text. This string should not include a leading period. For example, "jpg"
			/// is correct, while ".jpg" is not.
			/// </param>
			new void SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);

			/// <summary>Closes the dialog.</summary>
			/// <param name="hr">The code that will be returned by Show to indicate that the dialog was closed before a selection was made.</param>
			new void Close([MarshalAs(UnmanagedType.Error)] HRESULT hr);

			/// <summary>Enables a calling application to associate a GUID with a dialog's persisted state.</summary>
			/// <param name="guid">The GUID to associate with this dialog state.</param>
			new void SetClientGuid(in Guid guid);

			/// <summary>Instructs the dialog to clear all persisted state information.</summary>
			new void ClearClientData();

			/// <summary>Sets the filter. <note>Deprecated. SetFilter is no longer available for use as of Windows 7.</note></summary>
			/// <param name="pFilter">A pointer to the IShellItemFilter that is to be set.</param>
			new void SetFilter([MarshalAs(UnmanagedType.Interface)] object pFilter);

			/// <summary>Replaces the default text "Cancel" on the common file dialog's Cancel button.</summary>
			/// <param name="pszLabel">Pointer to a string that contains the new text to display on the button.</param>
			void SetCancelButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>
			/// Specifies a top-level location from which to begin browsing a namespace, for instance in the Save dialog's Browse folder
			/// option. Users cannot navigate above this location.
			/// </summary>
			/// <param name="psi">Pointer to an IShellItem object that represents the navigation root.</param>
			void SetNavigationRoot([MarshalAs(UnmanagedType.Interface)] IShellItem psi);
		}

		/// <summary>
		/// Exposes methods that allow an application to be notified of events that are related to controls that the application has added to
		/// a common file dialog.
		/// </summary>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("36116642-D713-4b97-9B83-7484A9D00433")]
		[PInvokeData("Shobjidl.h")]
		public interface IFileDialogControlEvents
		{
			/// <summary>Called when [item selected].</summary>
			/// <param name="pfdc">The PFDC.</param>
			/// <param name="dwIDCtl">The dw identifier control.</param>
			/// <param name="dwIDItem">The dw identifier item.</param>
			/// <returns></returns>
			[PreserveSig]
			HRESULT OnItemSelected(IFileDialogCustomize pfdc, uint dwIDCtl, uint dwIDItem);

			/// <summary>Called when [button clicked].</summary>
			/// <param name="pfdc">The PFDC.</param>
			/// <param name="dwIDCtl">The dw identifier control.</param>
			/// <returns></returns>
			[PreserveSig]
			HRESULT OnButtonClicked(IFileDialogCustomize pfdc, uint dwIDCtl);

			/// <summary>Called when [check button toggled].</summary>
			/// <param name="pfdc">The PFDC.</param>
			/// <param name="dwIDCtl">The dw identifier control.</param>
			/// <param name="bChecked">if set to <c>true</c> [b checked].</param>
			/// <returns></returns>
			[PreserveSig]
			HRESULT OnCheckButtonToggled(IFileDialogCustomize pfdc, uint dwIDCtl, [MarshalAs(UnmanagedType.Bool)] bool bChecked);

			/// <summary>Called when [control activating].</summary>
			/// <param name="pfdc">The PFDC.</param>
			/// <param name="dwIDCtl">The dw identifier control.</param>
			/// <returns></returns>
			[PreserveSig]
			HRESULT OnControlActivating(IFileDialogCustomize pfdc, uint dwIDCtl);
		}

		/// <summary>Exposes methods that allow an application to add controls to a common file dialog.</summary>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, Guid("e6fdd21a-163f-4975-9c8c-a69f1ba37034"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
		public interface IFileDialogCustomize
		{
			/// <summary>Enables a drop-down list on the Open or Save button in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the drop-down list.</param>
			void EnableOpenDropDown(uint dwIDCtl);

			/// <summary>Adds a menu to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the menu to add.</param>
			/// <param name="pszLabel">A pointer to a buffer that contains the menu name as a null-terminated Unicode string.</param>
			void AddMenu(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Adds a button to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the button to add.</param>
			/// <param name="pszLabel">A pointer to a buffer that contains the button text as a null-terminated Unicode string.</param>
			void AddPushButton(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Adds a combo box to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the combo box to add.</param>
			void AddComboBox(uint dwIDCtl);

			/// <summary>Adds an option button (also known as radio button) group to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the option button group to add.</param>
			void AddRadioButtonList(uint dwIDCtl);

			/// <summary>Adds a check button (check box) to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the check button to add.</param>
			/// <param name="pszLabel">A pointer to a buffer that contains the button text as a null-terminated Unicode string.</param>
			/// <param name="bChecked">A BOOL indicating the current state of the check button. TRUE if checked; FALSE otherwise.</param>
			void AddCheckButton(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszLabel, [MarshalAs(UnmanagedType.Bool)] bool bChecked);

			/// <summary>Adds an edit box control to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the edit box to add.</param>
			/// <param name="pszText">
			/// A pointer to a null-terminated Unicode string that provides the default text displayed in the edit box.
			/// </param>
			void AddEditBox(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Adds a separator to the dialog, allowing a visual separation of controls.</summary>
			/// <param name="dwIDCtl">The control ID of the separator.</param>
			void AddSeparator(uint dwIDCtl);

			/// <summary>Adds text content to the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the text to add.</param>
			/// <param name="pszText">A pointer to a buffer that contains the text as a null-terminated Unicode string.</param>
			void AddText(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Sets the text associated with a control, such as button text or an edit box label.</summary>
			/// <param name="dwIDCtl">The ID of the control whose text is to be changed.</param>
			/// <param name="pszLabel">A pointer to a buffer that contains the text as a null-terminated Unicode string.</param>
			void SetControlLabel(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Gets the current visibility and enabled states of a given control.</summary>
			/// <param name="dwIDCtl">The ID of the control in question.</param>
			/// <returns>
			/// A variable that receives one or more values from the CDCONTROLSTATE enumeration that indicate the current state of the control.
			/// </returns>
			CDCONTROLSTATEF GetControlState(uint dwIDCtl);

			/// <summary>Sets the current visibility and enabled states of a given control.</summary>
			/// <param name="dwIDCtl">The ID of the control in question.</param>
			/// <param name="dwState">One or more values from the CDCONTROLSTATE enumeration that indicate the current state of the control.</param>
			void SetControlState(uint dwIDCtl, CDCONTROLSTATEF dwState);

			/// <summary>Gets the current text in an edit box control.</summary>
			/// <param name="dwIDCtl">The ID of the edit box.</param>
			/// <param name="ppszText">The address of a pointer to a buffer that receives the text as a null-terminated Unicode string.</param>
			void GetEditBoxText(uint dwIDCtl, [MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(CoTaskMemStringMarshaler))] out string ppszText);

			/// <summary>Sets the text in an edit box control found in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the edit box.</param>
			/// <param name="pszText">A pointer to a buffer that contains the text as a null-terminated Unicode string.</param>
			void SetEditBoxText(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Gets the current state of a check button (check box) in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the check box.</param>
			/// <returns>A BOOL value that indicates whether the box is checked. TRUE means checked; FALSE, unchecked.</returns>
			[return: MarshalAs(UnmanagedType.Bool)]
			bool GetCheckButtonState(uint dwIDCtl);

			/// <summary>Sets the state of a check button (check box) in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the check box.</param>
			/// <param name="bChecked">A BOOL value that indicates whether the box is checked. TRUE means checked; FALSE, unchecked.</param>
			void SetCheckButtonState(uint dwIDCtl, [MarshalAs(UnmanagedType.Bool)] bool bChecked);

			/// <summary>Adds an item to a container control in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the container control to which the item is to be added.</param>
			/// <param name="dwIDItem">The ID of the item.</param>
			/// <param name="pszLabel">
			/// A pointer to a buffer that contains the item's text, which can be either a label or, in the case of a drop-down list, the
			/// item itself. This text is a null-terminated Unicode string.
			/// </param>
			void AddControlItem(uint dwIDCtl, int dwIDItem, [MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Removes an item from a container control in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the container control from which the item is to be removed.</param>
			/// <param name="dwIDItem">The ID of the item.</param>
			void RemoveControlItem(uint dwIDCtl, int dwIDItem);

			/// <summary>Not implemented.</summary>
			/// <param name="dwIDCtl"></param>
			void RemoveAllControlItems(uint dwIDCtl);

			/// <summary>Gets the current state of an item in a container control found in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the container control.</param>
			/// <param name="dwIDItem">The ID of the item.</param>
			/// <returns>
			/// A pointer to a variable that receives one of more values from the CDCONTROLSTATE enumeration that indicate the current state
			/// of the control.
			/// </returns>
			CDCONTROLSTATEF GetControlItemState(uint dwIDCtl, int dwIDItem);

			/// <summary>Sets the current state of an item in a container control found in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the container control.</param>
			/// <param name="dwIDItem">The ID of the item.</param>
			/// <param name="dwState">One or more values from the CDCONTROLSTATE enumeration that indicate the new state of the control.</param>
			void SetControlItemState(uint dwIDCtl, int dwIDItem, CDCONTROLSTATEF dwState);

			/// <summary>Gets a particular item from specified container controls in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the container control.</param>
			/// <returns>The ID of the item that the user selected in the control.</returns>
			uint GetSelectedControlItem(uint dwIDCtl);

			/// <summary>Sets the selected state of a particular item in an option button group or a combo box found in the dialog.</summary>
			/// <param name="dwIDCtl">The ID of the container control.</param>
			/// <param name="dwIDItem">The ID of the item to display as selected in the control.</param>
			void SetSelectedControlItem(uint dwIDCtl, int dwIDItem);

			/// <summary>Declares a visual group in the dialog. Subsequent calls to any "add" method add those elements to this group.</summary>
			/// <param name="dwIDCtl">The ID of the visual group.</param>
			/// <param name="pszLabel">
			/// A pointer to a buffer that contains text, as a null-terminated Unicode string, that appears next to the visual group.
			/// </param>
			void StartVisualGroup(uint dwIDCtl, [MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Stops the addition of elements to a visual group in the dialog.</summary>
			void EndVisualGroup();

			/// <summary>Places a control in the dialog so that it stands out compared to other added controls.</summary>
			/// <param name="dwIDCtl">The ID of the control.</param>
			void MakeProminent(uint dwIDCtl);
		}

		/// <summary>Exposes methods that allow notification of events within a common file dialog.</summary>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("973510DB-7D7F-452B-8975-74A85828D354")]
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb775876")]
		public interface IFileDialogEvents
		{
			/// <summary>Called just before the dialog is about to return with a result.</summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <returns>
			/// Implementations should return S_OK to accept the current result in the dialog or S_FALSE to refuse it. In the case of
			/// S_FALSE, the dialog should remain open.
			/// </returns>
			/// <remarks>
			/// When this method is called, the IFileDialog::GetResult and GetResults methods can be called.
			/// <para>
			/// The application can use this callback method to perform additional validation before the dialog closes, or to prevent the
			/// dialog from closing. If the application prevents the dialog from closing, it should display a UI to indicate a cause. To
			/// obtain a parent HWND for the UI, obtain the IOleWindow interface through IFileDialog::QueryInterface and call IOleWindow::GetWindow.
			/// </para>
			/// <para>An application can also use this method to perform all of its work surrounding the opening or saving of files.</para>
			/// </remarks>
			[PreserveSig]
			HRESULT OnFileOk(IFileDialog pfd);

			/// <summary>
			/// Called before IFileDialogEvents::OnFolderChange. This allows the implementer to stop navigation to a particular location.
			/// </summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <param name="psiFolder">A pointer to an interface that represents the folder to which the dialog is about to navigate.</param>
			/// <returns>
			/// Returns S_OK if successful, or an error value otherwise. A return value of S_OK or E_NOTIMPL indicates that the folder change
			/// can proceed.
			/// </returns>
			/// <remarks>
			/// The calling application can call IFileDialog::SetFolder during this callback to redirect navigation to an alternate folder.
			/// The actual navigation does not occur until IFileDialogEvents::OnFolderChanging has returned.
			/// <para>
			/// If the calling application simply prevents navigation to a particular folder, UI should be displayed with an explanation of
			/// the restriction. To obtain a parent HWND for the UI, obtain the IOleWindow interface through IFileDialog and call IOleWindow::GetWindow.
			/// </para>
			/// </remarks>
			[PreserveSig]
			HRESULT OnFolderChanging(IFileDialog pfd, IShellItem psiFolder);

			/// <summary>Called when the user navigates to a new folder.</summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <returns>If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>
			[PreserveSig]
			HRESULT OnFolderChange(IFileDialog pfd);

			/// <summary>Called when the user changes the selection in the dialog's view.</summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <returns>If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>
			[PreserveSig]
			HRESULT OnSelectionChange(IFileDialog pfd);

			/// <summary>Enables an application to respond to sharing violations that arise from Open or Save operations.</summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <param name="psi">A pointer to the interface that represents the item that has the sharing violation.</param>
			/// <param name="pResponse">
			/// A pointer to a value from the FDE_SHAREVIOLATION_RESPONSE enumeration indicating the response to the sharing violation.
			/// </param>
			/// <returns>
			/// The implementer should return E_NOTIMPL if this method is not implemented; S_OK or an appropriate error code otherwise.
			/// </returns>
			/// <remarks>
			/// The FOS_SHAREAWARE flag must be set through IFileDialog::SetOptions before this method is called.
			/// <para>
			/// A sharing violation could possibly arise when the application attempts to open a file, because the file could have been
			/// locked between the time that the dialog tested it and the application opened it.
			/// </para>
			/// </remarks>
			[PreserveSig]
			HRESULT OnShareViolation(IFileDialog pfd, IShellItem psi, out FDE_SHAREVIOLATION_RESPONSE pResponse);

			/// <summary>Called when the dialog is opened to notify the application of the initial chosen filetype.</summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <returns>If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>
			/// <remarks>
			/// This method is called when the dialog is opened to notify the application of the initially chosen filetype. If the
			/// application has code in IFileDialogEvents that responds to type changes, it can respond to the type. For example, it could
			/// hide certain controls. The application controls the initial file type and could do its own checks, so this method is provided
			/// as a convenience.
			/// </remarks>
			[PreserveSig]
			HRESULT OnTypeChange(IFileDialog pfd);

			/// <summary>Called from the save dialog when the user chooses to overwrite a file.</summary>
			/// <param name="pfd">A pointer to the interface that represents the dialog.</param>
			/// <param name="psi">A pointer to the interface that represents the item that will be overwritten.</param>
			/// <param name="pResponse">
			/// A pointer to a value from the FDE_OVERWRITE_RESPONSE enumeration indicating the response to the potential overwrite action.
			/// </param>
			/// <returns>
			/// The implementer should return E_NOTIMPL if this method is not implemented; S_OK or an appropriate error code otherwise.
			/// </returns>
			/// <remarks>The FOS_OVERWRITEPROMPT flag must be set through IFileDialog::SetOptions before this method is called.</remarks>
			[PreserveSig]
			HRESULT OnOverwrite(IFileDialog pfd, IShellItem psi, out FDE_SHAREVIOLATION_RESPONSE pResponse);
		}

		/// <summary>Extends the IFileDialog interface by adding methods specific to the open dialog.</summary>
		/// <seealso cref="IFileDialog"/>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("d57c7288-d4ad-4768-be02-9d969532d960"), CoClass(typeof(CFileOpenDialog))]
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb775834")]
		public interface IFileOpenDialog : IFileDialog
		{
			/// <summary>Launches the modal window.</summary>
			/// <param name="parent">The handle of the owner window. This value can be NULL.</param>
			/// <returns>
			/// If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:
			/// HRESULT_FROM_WIN32(ERROR_CANCELLED) = The user closed the window by canceling the operation.
			/// </returns>
			[PreserveSig]
			new HRESULT Show(HWND parent);

			/// <summary>Sets the file types that the dialog can open or save.</summary>
			/// <param name="cFileTypes">The number of elements in the array specified by rgFilterSpec.</param>
			/// <param name="rgFilterSpec">A pointer to an array of COMDLG_FILTERSPEC structures, each representing a file type.</param>
			new void SetFileTypes(uint cFileTypes,
				[MarshalAs(UnmanagedType.LPArray, SizeParamIndex = 0)] COMDLG_FILTERSPEC[] rgFilterSpec);

			/// <summary>Sets the file type that appears as selected in the dialog.</summary>
			/// <param name="iFileType">
			/// The index of the file type in the file type array passed to IFileDialog::SetFileTypes in its cFileTypes parameter. Note that
			/// this is a one-based index, not zero-based.
			/// </param>
			new void SetFileTypeIndex(uint iFileType);

			/// <summary>Gets the currently selected file type.</summary>
			/// <returns>
			/// A UINT value that receives the index of the selected file type in the file type array passed to IFileDialog::SetFileTypes in
			/// its cFileTypes parameter.
			/// </returns>
			new uint GetFileTypeIndex();

			/// <summary>Assigns an event handler that listens for events coming from the dialog.</summary>
			/// <param name="pfde">A pointer to an IFileDialogEvents implementation that will receive events from the dialog.</param>
			/// <returns>
			/// A DWORD value identifying this event handler. When the client is finished with the dialog, that client must call the
			/// IFileDialog::Unadvise method with this value.
			/// </returns>
			new uint Advise(IFileDialogEvents pfde);

			/// <summary>Removes an event handler that was attached through the IFileDialog::Advise method.</summary>
			/// <param name="dwCookie">
			/// The DWORD value that represents the event handler. This value is obtained through the pdwCookie parameter of the
			/// IFileDialog::Advise method.
			/// </param>
			new void Unadvise(uint dwCookie);

			/// <summary>Sets flags to control the behavior of the dialog.</summary>
			/// <param name="fos">One or more of the FILEOPENDIALOGOPTIONS values.</param>
			new void SetOptions(FILEOPENDIALOGOPTIONS fos);

			/// <summary>Gets the current flags that are set to control dialog behavior.</summary>
			/// <returns>
			/// When this method returns successfully, points to a value made up of one or more of the FILEOPENDIALOGOPTIONS values.
			/// </returns>
			new FILEOPENDIALOGOPTIONS GetOptions();

			/// <summary>Sets the folder used as a default if there is not a recently used folder value available.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			new void SetDefaultFolder(IShellItem psi);

			/// <summary>Sets a folder that is always selected when the dialog is opened, regardless of previous user action.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			new void SetFolder(IShellItem psi);

			/// <summary>
			/// Gets either the folder currently selected in the dialog, or, if the dialog is not currently displayed, the folder that is to
			/// be selected when the dialog is opened.
			/// </summary>
			/// <returns>The address of a pointer to the interface that represents the folder.</returns>
			new IShellItem GetFolder();

			/// <summary>Gets the user's current selection in the dialog.</summary>
			/// <returns>
			/// The address of a pointer to the interface that represents the item currently selected in the dialog. This item can be a file
			/// or folder selected in the view window, or something that the user has entered into the dialog's edit box. The latter case may
			/// require a parsing operation (cancelable by the user) that blocks the current thread.
			/// </returns>
			new IShellItem GetCurrentSelection();

			/// <summary>Sets the file name that appears in the File name edit box when that dialog box is opened.</summary>
			/// <param name="pszName">A pointer to the name of the file.</param>
			new void SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);

			/// <summary>Retrieves the text currently entered in the dialog's File name edit box.</summary>
			/// <returns>The address of a pointer to a buffer that, when this method returns successfully, receives the text.</returns>
			new SafeCoTaskMemString GetFileName();

			/// <summary>Sets the title of the dialog.</summary>
			/// <param name="pszTitle">A pointer to a buffer that contains the title text.</param>
			new void SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);

			/// <summary>Sets the text of the Open or Save button.</summary>
			/// <param name="pszText">A pointer to a buffer that contains the button text.</param>
			new void SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Sets the text of the label next to the file name edit box.</summary>
			/// <param name="pszLabel">A pointer to a buffer that contains the label text.</param>
			new void SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Gets the choice that the user made in the dialog.</summary>
			/// <returns>The address of a pointer to an IShellItem that represents the user's choice.</returns>
			new IShellItem GetResult();

			/// <summary>Adds a folder to the list of places available for the user to open or save items.</summary>
			/// <param name="psi">
			/// A pointer to an IShellItem that represents the folder to be made available to the user. This can only be a folder.
			/// </param>
			/// <param name="fdap">Specifies where the folder is placed within the list.</param>
			new void AddPlace(IShellItem psi, FDAP fdap);

			/// <summary>Sets the default extension to be added to file names.</summary>
			/// <param name="pszDefaultExtension">
			/// A pointer to a buffer that contains the extension text. This string should not include a leading period. For example, "jpg"
			/// is correct, while ".jpg" is not.
			/// </param>
			new void SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);

			/// <summary>Closes the dialog.</summary>
			/// <param name="hr">The code that will be returned by Show to indicate that the dialog was closed before a selection was made.</param>
			new void Close([MarshalAs(UnmanagedType.Error)] HRESULT hr);

			/// <summary>Enables a calling application to associate a GUID with a dialog's persisted state.</summary>
			/// <param name="guid">The GUID to associate with this dialog state.</param>
			new void SetClientGuid(in Guid guid);

			/// <summary>Instructs the dialog to clear all persisted state information.</summary>
			new void ClearClientData();

			/// <summary>Sets the filter. <note>Deprecated. SetFilter is no longer available for use as of Windows 7.</note></summary>
			/// <param name="pFilter">A pointer to the IShellItemFilter that is to be set.</param>
			new void SetFilter([MarshalAs(UnmanagedType.Interface)] object pFilter);

			/// <summary>Gets the user's choices in a dialog that allows multiple selection.</summary>
			/// <returns>The address of a pointer to an IShellItemArray through which the items selected in the dialog can be accessed.</returns>
			IShellItemArray GetResults();

			/// <summary>
			/// Gets the currently selected items in the dialog. These items may be items selected in the view, or text selected in the file
			/// name edit box.
			/// </summary>
			/// <returns>The address of a pointer to an IShellItemArray through which the selected items can be accessed.</returns>
			IShellItemArray GetSelectedItems();
		}

		/// <summary>
		/// Exposes methods that provide a rich notification system used by callers of IFileOperation to monitor the details of the
		/// operations they are performing through that interface.
		/// </summary>
		[ComImport, Guid("04b0f1a7-9490-44bc-96e1-4296a31252e2"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb775722")]
		public interface IFileOperationProgressSink
		{
			/// <summary>Performs caller-implemented actions before any specific file operations are performed.</summary>
			void StartOperations();

			/// <summary>Performs caller-implemented actions after the last operation performed by the call to IFileOperation is complete.</summary>
			/// <param name="hrResult">
			/// The return value of the final operation. Note that this is not the HRESULT returned by one of the IFileOperation methods,
			/// which simply queue the operations. Instead, this is the result of the actual operation, such as copy, delete, or move.
			/// </param>
			void FinishOperations(HRESULT hrResult);

			/// <summary>Performs caller-implemented actions before the rename process for each item begins.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that control the operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the item to be renamed.</param>
			/// <param name="pszNewName">Pointer to the new display name of the item. This is a null-terminated, Unicode string.</param>
			void PreRenameItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName);

			/// <summary>Performs caller-implemented actions after the rename process for each item is complete.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that were used during the rename operation. Some values can be set or changed during the
			/// rename operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the item before it was renamed.</param>
			/// <param name="pszNewName">
			/// Pointer to the new display name of the item. This is a null-terminated, Unicode string. Note that this might not be the name
			/// that you asked for, given collisions and other naming rules.
			/// </param>
			/// <param name="hrRename">
			/// The return value of the rename operation. Note that this is not the HRESULT returned by RenameItem, which simply queues the
			/// rename operation. Instead, this is the result of the actual rename operation.
			/// </param>
			/// <param name="psiNewlyCreated">Pointer to an IShellItem that represents the item with its new name.</param>
			void PostRenameItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName, HRESULT hrRename, IShellItem psiNewlyCreated);

			/// <summary>Performs caller-implemented actions before the move process for each item begins.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that control the operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the item to be moved.</param>
			/// <param name="psiDestinationFolder">
			/// Pointer to an IShellItem that specifies the destination folder to contain the moved item.
			/// </param>
			/// <param name="pszNewName">
			/// Pointer to a new name for the item in its new location. This is a null-terminated Unicode string and can be NULL. If NULL,
			/// the name of the destination item is the same as the source.
			/// </param>
			void PreMoveItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, IShellItem psiDestinationFolder, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName);

			/// <summary>Performs caller-implemented actions after the move process for each item is complete.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that were used during the move operation. Some values can be set or changed during the move
			/// operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the source item.</param>
			/// <param name="psiDestinationFolder">
			/// Pointer to an IShellItem that specifies the destination folder that contains the moved item.
			/// </param>
			/// <param name="pszNewName">
			/// Pointer to the name that was given to the item after it was moved. This is a null-terminated Unicode string. Note that this
			/// might not be the name that you asked for, given collisions and other naming rules.
			/// </param>
			/// <param name="hrMove">
			/// The return value of the move operation. Note that this is not the HRESULT returned by MoveItem, which simply queues the move
			/// operation. Instead, this is the result of the actual move.
			/// </param>
			/// <param name="psiNewlyCreated">Pointer to an IShellItem that represents the moved item in its new location.</param>
			void PostMoveItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, IShellItem psiDestinationFolder, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName, HRESULT hrMove, IShellItem psiNewlyCreated);

			/// <summary>Performs caller-implemented actions before the copy process for each item begins.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that control the operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the source item.</param>
			/// <param name="psiDestinationFolder">
			/// Pointer to an IShellItem that specifies the destination folder to contain the copy of the item.
			/// </param>
			/// <param name="pszNewName">
			/// Pointer to a new name for the item after it has been copied. This is a null-terminated Unicode string and can be NULL. If
			/// NULL, the name of the destination item is the same as the source.
			/// </param>
			void PreCopyItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, IShellItem psiDestinationFolder, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName);

			/// <summary>Performs caller-implemented actions after the copy process for each item is complete.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that were used during the copy operation. Some values can be set or changed during the copy
			/// operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the source item.</param>
			/// <param name="psiDestinationFolder">
			/// Pointer to an IShellItem that specifies the destination folder to which the item was copied.
			/// </param>
			/// <param name="pszNewName">
			/// Pointer to the new name that was given to the item after it was copied. This is a null-terminated Unicode string. Note that
			/// this might not be the name that you asked for, given collisions and other naming rules.
			/// </param>
			/// <param name="hrCopy">
			/// The return value of the copy operation. Note that this is not the HRESULT returned by CopyItem, which simply queues the copy
			/// operation. Instead, this is the result of the actual copy.
			/// </param>
			/// <param name="psiNewlyCreated">Pointer to an IShellItem that represents the new copy of the item.</param>
			void PostCopyItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, IShellItem psiDestinationFolder, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName,
				HRESULT hrCopy, IShellItem psiNewlyCreated);

			/// <summary>Performs caller-implemented actions before the delete process for each item begins.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that control the operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the item to be deleted.</param>
			void PreDeleteItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem);

			/// <summary>Performs caller-implemented actions after the delete process for each item is complete.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that were used during the delete operation. Some values can be set or changed during the
			/// delete operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiItem">Pointer to an IShellItem that specifies the item that was deleted.</param>
			/// <param name="hrDelete">
			/// The return value of the delete operation. Note that this is not the HRESULT returned by DeleteItem, which simply queues the
			/// delete operation. Instead, this is the result of the actual deletion.
			/// </param>
			/// <param name="psiNewlyCreated">
			/// A pointer to an IShellItem that specifies the deleted item, now in the Recycle Bin. If the item was fully deleted, this value
			/// is NULL.
			/// </param>
			void PostDeleteItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiItem, HRESULT hrDelete, IShellItem psiNewlyCreated);

			/// <summary>Performs caller-implemented actions before the process to create a new item begins.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that control the operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiDestinationFolder">
			/// Pointer to an IShellItem that specifies the destination folder that will contain the new item.
			/// </param>
			/// <param name="pszNewName">
			/// Pointer to the file name of the new item, for instance Newfile.txt. This is a null-terminated, Unicode string.
			/// </param>
			void PreNewItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiDestinationFolder, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName);

			/// <summary>Performs caller-implemented actions after the new item is created.</summary>
			/// <param name="dwFlags">
			/// bitwise value that contains flags that were used during the creation operation. Some values can be set or changed during the
			/// creation operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.
			/// </param>
			/// <param name="psiDestinationFolder">
			/// Pointer to an IShellItem that specifies the destination folder to which the new item was added.
			/// </param>
			/// <param name="pszNewName">
			/// Pointer to the file name of the new item, for instance Newfile.txt. This is a null-terminated, Unicode string.
			/// </param>
			/// <param name="pszTemplateName">
			/// Pointer to the name of the template file (for example Excel9.xls) that the new item is based on, stored in one of the
			/// following locations:
			/// <list type="bullet">
			/// <item>
			/// <description>CSIDL_COMMON_TEMPLATES. The default path for this folder is %ALLUSERSPROFILE%\Templates.</description>
			/// </item>
			/// <item>
			/// <description>CSIDL_TEMPLATES. The default path for this folder is %USERPROFILE%\Templates.</description>
			/// </item>
			/// <item>
			/// <description>%SystemRoot%\shellnew</description>
			/// </item>
			/// </list>
			/// <para>
			/// This is a null-terminated, Unicode string used to specify an existing file of the same type as the new file, containing the
			/// minimal content that an application wants to include in any new file.
			/// </para>
			/// <para>This parameter is normally NULL to specify a new, blank file.</para>
			/// </param>
			/// <param name="dwFileAttributes">The file attributes applied to the new item. One or more of the values found at GetFileAttributes.</param>
			/// <param name="hrNew">
			/// The return value of the creation operation. Note that this is not the HRESULT returned by NewItem, which simply queues the
			/// creation operation. Instead, this is the result of the actual creation.
			/// </param>
			/// <param name="psiNewItem">Pointer to an IShellItem that represents the new item.</param>
			void PostNewItem(TRANSFER_SOURCE_FLAGS dwFlags, IShellItem psiDestinationFolder, [MarshalAs(UnmanagedType.LPWStr)] string pszNewName,
				[MarshalAs(UnmanagedType.LPWStr)] string pszTemplateName, uint dwFileAttributes, HRESULT hrNew, IShellItem psiNewItem);

			/// <summary>Updates the progress.</summary>
			/// <param name="iWorkTotal">The i work total.</param>
			/// <param name="iWorkSoFar">The i work so far.</param>
			void UpdateProgress(uint iWorkTotal, uint iWorkSoFar);

			/// <summary>Resets the timer.</summary>
			[Obsolete("This method is not supported.")]
			void ResetTimer();

			/// <summary>Pauses the timer.</summary>
			[Obsolete("This method is not supported.")]
			void PauseTimer();

			/// <summary>Resumes the timer.</summary>
			[Obsolete("This method is not supported.")]
			void ResumeTimer();
		}

		/// <summary>
		/// Extends the IFileDialog interface by adding methods specific to the save dialog, which include those that provide support for the
		/// collection of metadata to be persisted with the file.
		/// </summary>
		/// <seealso cref="IFileDialog"/>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("84bccd23-5fde-4cdb-aea4-af64b83d78ab"), CoClass(typeof(CFileSaveDialog))]
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb775688")]
		public interface IFileSaveDialog : IFileDialog
		{
			/// <summary>Launches the modal window.</summary>
			/// <param name="parent">The handle of the owner window. This value can be NULL.</param>
			/// <returns>
			/// If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:
			/// HRESULT_FROM_WIN32(ERROR_CANCELLED) = The user closed the window by canceling the operation.
			/// </returns>
			[PreserveSig]
			new HRESULT Show(HWND parent);

			/// <summary>Sets the file types that the dialog can open or save.</summary>
			/// <param name="cFileTypes">The number of elements in the array specified by rgFilterSpec.</param>
			/// <param name="rgFilterSpec">A pointer to an array of COMDLG_FILTERSPEC structures, each representing a file type.</param>
			new void SetFileTypes(uint cFileTypes,
				[MarshalAs(UnmanagedType.LPArray, SizeParamIndex = 0)] COMDLG_FILTERSPEC[] rgFilterSpec);

			/// <summary>Sets the file type that appears as selected in the dialog.</summary>
			/// <param name="iFileType">
			/// The index of the file type in the file type array passed to IFileDialog::SetFileTypes in its cFileTypes parameter. Note that
			/// this is a one-based index, not zero-based.
			/// </param>
			new void SetFileTypeIndex(uint iFileType);

			/// <summary>Gets the currently selected file type.</summary>
			/// <returns>
			/// A UINT value that receives the index of the selected file type in the file type array passed to IFileDialog::SetFileTypes in
			/// its cFileTypes parameter.
			/// </returns>
			new uint GetFileTypeIndex();

			/// <summary>Assigns an event handler that listens for events coming from the dialog.</summary>
			/// <param name="pfde">A pointer to an IFileDialogEvents implementation that will receive events from the dialog.</param>
			/// <returns>
			/// A DWORD value identiying this event handler. When the client is finished with the dialog, that client must call the
			/// IFileDialog::Unadvise method with this value.
			/// </returns>
			new uint Advise(IFileDialogEvents pfde);

			/// <summary>Removes an event handler that was attached through the IFileDialog::Advise method.</summary>
			/// <param name="dwCookie">
			/// The DWORD value that represents the event handler. This value is obtained through the pdwCookie parameter of the
			/// IFileDialog::Advise method.
			/// </param>
			new void Unadvise(uint dwCookie);

			/// <summary>Sets flags to control the behavior of the dialog.</summary>
			/// <param name="fos">One or more of the FILEOPENDIALOGOPTIONS values.</param>
			new void SetOptions(FILEOPENDIALOGOPTIONS fos);

			/// <summary>Gets the current flags that are set to control dialog behavior.</summary>
			/// <returns>
			/// When this method returns successfully, points to a value made up of one or more of the FILEOPENDIALOGOPTIONS values.
			/// </returns>
			new FILEOPENDIALOGOPTIONS GetOptions();

			/// <summary>Sets the folder used as a default if there is not a recently used folder value available.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			new void SetDefaultFolder(IShellItem psi);

			/// <summary>Sets a folder that is always selected when the dialog is opened, regardless of previous user action.</summary>
			/// <param name="psi">A pointer to the interface that represents the folder.</param>
			new void SetFolder(IShellItem psi);

			/// <summary>
			/// Gets either the folder currently selected in the dialog, or, if the dialog is not currently displayed, the folder that is to
			/// be selected when the dialog is opened.
			/// </summary>
			/// <returns>The address of a pointer to the interface that represents the folder.</returns>
			new IShellItem GetFolder();

			/// <summary>Gets the user's current selection in the dialog.</summary>
			/// <returns>
			/// The address of a pointer to the interface that represents the item currently selected in the dialog. This item can be a file
			/// or folder selected in the view window, or something that the user has entered into the dialog's edit box. The latter case may
			/// require a parsing operation (cancelable by the user) that blocks the current thread.
			/// </returns>
			new IShellItem GetCurrentSelection();

			/// <summary>Sets the file name that appears in the File name edit box when that dialog box is opened.</summary>
			/// <param name="pszName">A pointer to the name of the file.</param>
			new void SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);

			/// <summary>Retrieves the text currently entered in the dialog's File name edit box.</summary>
			/// <returns>The address of a pointer to a buffer that, when this method returns successfully, receives the text.</returns>
			new SafeCoTaskMemString GetFileName();

			/// <summary>Sets the title of the dialog.</summary>
			/// <param name="pszTitle">A pointer to a buffer that contains the title text.</param>
			new void SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);

			/// <summary>Sets the text of the Open or Save button.</summary>
			/// <param name="pszText">A pointer to a buffer that contains the button text.</param>
			new void SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);

			/// <summary>Sets the text of the label next to the file name edit box.</summary>
			/// <param name="pszLabel">A pointer to a buffer that contains the label text.</param>
			new void SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);

			/// <summary>Gets the choice that the user made in the dialog.</summary>
			/// <returns>The address of a pointer to an IShellItem that represents the user's choice.</returns>
			new IShellItem GetResult();

			/// <summary>Adds a folder to the list of places available for the user to open or save items.</summary>
			/// <param name="psi">
			/// A pointer to an IShellItem that represents the folder to be made available to the user. This can only be a folder.
			/// </param>
			/// <param name="fdap">Specifies where the folder is placed within the list.</param>
			new void AddPlace(IShellItem psi, FDAP fdap);

			/// <summary>Sets the default extension to be added to file names.</summary>
			/// <param name="pszDefaultExtension">
			/// A pointer to a buffer that contains the extension text. This string should not include a leading period. For example, "jpg"
			/// is correct, while ".jpg" is not.
			/// </param>
			new void SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);

			/// <summary>Closes the dialog.</summary>
			/// <param name="hr">The code that will be returned by Show to indicate that the dialog was closed before a selection was made.</param>
			new void Close([MarshalAs(UnmanagedType.Error)] HRESULT hr);

			/// <summary>Enables a calling application to associate a GUID with a dialog's persisted state.</summary>
			/// <param name="guid">The GUID to associate with this dialog state.</param>
			new void SetClientGuid(in Guid guid);

			/// <summary>Instructs the dialog to clear all persisted state information.</summary>
			new void ClearClientData();

			/// <summary>Sets the filter. <note>Deprecated. SetFilter is no longer available for use as of Windows 7.</note></summary>
			/// <param name="pFilter">A pointer to the IShellItemFilter that is to be set.</param>
			new void SetFilter([MarshalAs(UnmanagedType.Interface)] object pFilter);

			/// <summary>Sets an item to be used as the initial entry in a Save As dialog.</summary>
			/// <param name="psi">Pointer to an IShellItem that represents the item.</param>
			void SetSaveAsItem(IShellItem psi);

			/// <summary>Provides a property store that defines the default values to be used for the item being saved.</summary>
			/// <param name="pStore">Pointer to the interface that represents the property store that contains the associated metadata.</param>
			void SetProperties(PropSys.IPropertyStore pStore);

			/// <summary>Specifies which properties will be collected in the save dialog.</summary>
			/// <param name="pList">Pointer to the interface that represents the list of properties to collect. This parameter can be NULL.</param>
			/// <param name="fAppendDefault">
			/// TRUE to show default properties for the currently selected filetype in addition to the properties specified by pList. FALSE
			/// to show only properties specified by pList.
			/// </param>
			void SetCollectedProperties(PropSys.IPropertyDescriptionList pList, [MarshalAs(UnmanagedType.Bool)] bool fAppendDefault);

			/// <summary>Retrieves the set of property values for a saved item or an item in the process of being saved.</summary>
			/// <returns>Address of a pointer to an IPropertyStore that receives the property values.</returns>
			PropSys.IPropertyStore GetProperties();

			/// <summary>Applies a set of properties to an item using the Shell's copy engine.</summary>
			/// <param name="psi">
			/// Pointer to the IShellItem that represents the file being saved. This is usually the item retrieved by GetResult.
			/// </param>
			/// <param name="pStore">
			/// Pointer to the IPropertyStore that represents the property values to be applied to the file. This can be the property store
			/// returned by IFileSaveDialog::GetProperties.
			/// </param>
			/// <param name="hwnd">The handle of the application window.</param>
			/// <param name="pSink">
			/// Pointer to an optional IFileOperationProgressSink that the calling application can use if they want to be notified of the
			/// progress of the property stamping. This value may be NULL.
			/// </param>
			void ApplyProperties(IShellItem psi, PropSys.IPropertyStore pStore, HWND hwnd, IFileOperationProgressSink pSink);
		}

		/// <summary>Exposes a method that represents a modal window. This interface is used in the Windows XP Passport Wizard.</summary>
		[SuppressUnmanagedCodeSecurity]
		[ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("b4db1657-70d7-485e-8e3e-6fcb5a5c1802")]
		[PInvokeData("Shobjidl.h", MSDNShortId = "bb761686")]
		public interface IModalWindow
		{
			/// <summary>Launches the modal window.</summary>
			/// <param name="parent">The handle of the owner window. This value can be NULL.</param>
			/// <returns>
			/// If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:
			/// HRESULT_FROM_WIN32(ERROR_CANCELLED) = The user closed the window by cancelling the operation.
			/// </returns>
			[PreserveSig]
			HRESULT Show(HWND parent);
		}

		/// <summary>Used generically to filter elements.</summary>
		[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
		[PInvokeData("Shtypes.h", MSDNShortId = "bb773221")]
		public struct COMDLG_FILTERSPEC
		{
			/// <summary>A pointer to a buffer that contains the friendly name of the filter.</summary>
			public string pszName;

			/// <summary>A pointer to a buffer that contains the filter pattern.</summary>
			public string pszSpec;
		}

		/// <summary>Class interface for ITaskbarList and derivatives.</summary>
		[ComImport, Guid("DC1C5A9C-E88A-4dde-A5A1-60F82A20AEF7"), ClassInterface(ClassInterfaceType.None)]
		public class CFileOpenDialog { }

		/// <summary>Class interface for ITaskbarList and derivatives.</summary>
		[ComImport, Guid("C0B4E2F3-BA21-4773-8DBA-335EC946EB8B"), ClassInterface(ClassInterfaceType.None)]
		public class CFileSaveDialog { }
	}
}