desktop2:DesktopPreviewHandler

Article
10/30/2023

Enables declaration of a preview handler for a file type association.

Element hierarchy

<uap:Extension>

<uap:FileTypeAssociation>

<desktop2:DesktopPreviewHandler>

Syntax

<desktop2:DesktopPreviewHandler
  Clsid = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
  ManualSafeSave = 'An optional boolean value.'
  EnableShareDenyNone = 'An optional boolean value.'
  EnableShareDenyWrite = 'An optional boolean value.'
  NoOplock = 'An optional boolean value.' 
  desktop10:DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.' />

Attributes and elements

Attributes

Attribute	Description	Data type	Required
Clsid	The ID of the class in the app's package.	A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Yes
ManualSafeSave	Sets STGM_TRANSACTED (true = off).	An optional boolean value.	No
EnableShareDenyNone	Sets STGM_SHARE_DENY_NONE.	An optional boolean value.	No
EnableShareDenyWrite	Sets STGM_SHARE_DENY_WRITE.	An optional boolean value.	No
NoOplock	Disables oplock logic. This is used to close the file if another process attempts to access the file.	An optional boolean value.	No
desktop10:DisplayName	The display name for the preview handler.	An optional string with a value between 1 and 256 characters in length. This string is localizable.	No

Child elements

None.

Parent elements

Parent element	Description
uap:FileTypeAssociation	Declares an app extensibility point of type windows.fileTypeAssociation. A file type association indicates that the app is registered to handle files of the specified types.

Remarks

Note that the Clsid attribute from PreviewHandler must match the ID attribute under the Class element in the SurrogateServer element from the COM registration in the app manifest.

Requirements

Item	Value
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/2`
desktop10	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/10`
Minimum OS Version	Windows 10 version 1703 (Build 15063)

Share via