Compartilhar via


Extensão (tipo: CT_ApplicationExtension)

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Extensão>

Syntax

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

           RuntimeType? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
Categoria

O tipo de ponto de extensibilidade do aplicativo.

Esse atributo pode ter um dos seguintes valores:

  • Windows. fileTypeAssociation
  • Windows. Protocol
  • Windows. autoPlayContent
  • Windows. autoPlayDevice
  • Windows. shareTarget
  • Windows. Search
  • Windows. fileOpenPicker
  • Windows. fileSavePicker
  • Windows. cachedFileUpdater
  • Windows. contactPicker
  • Windows. backgroundTasks
  • Windows. cameraSettings
  • Windows. accountPictureProvider
  • Windows. printTaskSettings
Sim
EntryPoint

A ID da classe ativável.

Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento, representando a tarefa que manipula a extensão. Normalmente é o nome totalmente qualificado do namespace de um tipo do Windows Runtime. Se EntryPoint não for especificado, o EntryPoint definido para o aplicativo será usado em seu lugar. Não
Executável

O executável de inicialização padrão.

Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento que deve terminar com ".exe" e não pode conter estes caracteres: < , > ,:, ", |,? ou *. Ele especifica o executável padrão para a extensão. Se não for especificado, o executável definido para o aplicativo será usado. Se especificado, a propriedade EntryPoint também será usada. Se essa propriedade EntryPoint não for especificada, o EntryPoint definido para o aplicativo será usado. Não
RuntimeType

O provedor de tempo de execução. Esse atributo é usado normalmente quando há estruturas mistas em um aplicativo.

Uma cadeia de caracteres entre 1 e 255 caracteres de comprimento que não pode começar ou terminar com um ponto ou conter estes caracteres: < , > ,:, ",/, \, |,?, ou *. Não
StartPage

A página da Web que manipula o ponto de extensibilidade.

Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento que não pode conter estes caracteres: < , > ,:, ", |,? ou *. Não

 

Elementos filho

Elemento filho Descrição
AutoPlayContent

Declara um ponto de extensibilidade de aplicativo do tipo Windows. autoPlayContent. O aplicativo fornece as ações de conteúdo de reprodução automática especificadas.

AutoPlayDevice

Declara um ponto de extensibilidade de aplicativo do tipo Windows. autoPlayDevice. O aplicativo fornece as ações de dispositivo de reprodução automática especificadas.

BackgroundTasks

Define um ponto de extensibilidade de aplicativo do tipo Windows. backgroundTasks. As tarefas em segundo plano são executadas em um host de segundo plano dedicado; ou seja, sem uma interface do usuário.

FileOpenPicker

Declara um ponto de extensibilidade de aplicativo do tipo Windows. fileOpenPicker. O aplicativo permite que o usuário escolha e abra os tipos de arquivos especificados.

FileSavePicker

Declara um ponto de extensibilidade de aplicativo do tipo Windows. fileSavePicker. O aplicativo permite que o usuário escolha o nome do arquivo, a extensão e o local de armazenamento para os tipos de arquivos especificados.

FileTypeAssociation

Declara um ponto de extensibilidade de aplicativo do tipo Windows. fileTypeAssociation. Uma associação de tipo de arquivo indica que o aplicativo está registrado para manipular arquivos dos tipos especificados.

Protocolo

Declara um ponto de extensibilidade de aplicativo do tipo Windows. Protocol. Uma associação de URI indica que o aplicativo está registrado para lidar com URIs com o esquema especificado.

ShareTarget

Declara um ponto de extensão de aplicativo do tipo Windows. shareTarget. O aplicativo pode compartilhar os tipos de arquivos especificados.

 

Elementos pai

Esse elemento mais externo (documento) pode não estar contido em outros elementos.

Os elementos a seguir têm o mesmo nome que este, mas um conteúdo ou atributos diferentes:

Comentários

Esses pontos de extensibilidade podem ser declarados apenas uma vez por aplicativo:

  • Windows. accountPictureProvider
  • Windows. cachedFileUpdater
  • Windows. cameraSettings
  • Windows. contactPicker
  • Windows. fileOpenPicker
  • Windows. fileSavePicker
  • Windows. printTaskSettings
  • Windows. Search
  • windows.shareTarget

**Observação sobre regras semânticas para extensões: **Para qualquer elemento extension, as seguintes regras semânticas são impostas na API de manifesto:

Se /Application/@StartPage especificado, ele será um aplicativo Windows usando JavaScript e a Extensão de Aplicativo :

  • Pode estar vazio
  • Pode especificar apenas a StartPage
  • Pode especificar Executable e EntryPoint (RuntimeType opcional permitido), a menos que seja uma extensão BackgroundTask, caso em que ele pode omitir o executável e o padrão para o BackgroundTaskHost.exe executável.

Se /Application/@StartPage não for especificado, ele será um aplicativo UWP usando C# ou VB e XAML e a Extensão de Aplicativo :

  • Pode estar vazio
  • Pode especificar apenas a StartPage
  • Deve especificar EntryPoint se Executável ou RuntimeType for especificado.

Confira também

ConceitosAplicativas e extensões

Requisitos

Valor
Namespace http://schemas.microsoft.com/appx/2010/manifest