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:
|
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.
Elementos relacionados
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 |