desktop2:DesktopPreviewHandler

  • Article

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

Element hierarchy

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <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 Default value
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)