Extensão (no tipo: CT_ApplicationExtensions)
Declara um ponto de extensibilidade para o aplicativo.
Hierarquia de elementos
- <Pacote>
-
- <Aplicativos>
-
- <Aplicativo>
-
- <Extensões>
- <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 ativatable. |
Uma cadeia de caracteres entre 1 e 256 caracteres, representando a tarefa que está tratando 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. | Não | |
| Executável | O executável de lançamento padrão. |
Uma cadeia de caracteres entre 1 e 256 caracteres que deve terminar com ".exe" e não pode conter estes caracteres: <, >, :, %, ", |, ?ou *. 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 runtime. 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 iniciar 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 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 autoPlay especificadas. |
| AutoPlayDevice | Declara um ponto de extensibilidade de aplicativo do tipo windows.autoPlayDevice. O aplicativo fornece as ações de dispositivo AutoPlay especificadas. |
| BackgroundTasks | Define um ponto de extensibilidade de aplicativo do tipo windows.backgroundTasks. As tarefas em segundo plano são executadas em um host em 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
| Elemento pai | Descrição |
|---|---|
| Extensões (tipo: CT_ApplicationExtensions) | Define um ou mais pontos de extensibilidade para o aplicativo. |
Elementos relacionados
Os elementos a seguir têm o mesmo nome que este, mas 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.
Exemplos
O exemplo a seguir é retirado do manifesto do pacote de um dos exemplos do SDK.
<Applications>
<Application Id="App" StartPage="default.html">
<VisualElements DisplayName="Assocation launching sample"
Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png"
Description="SDK sample"
ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
<DefaultTile ShowName="allLogos" />
<SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
</VisualElements>
<Extensions>
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name=".alsdkjs">
<SupportedFileTypes>
<FileType>.alsdkjs</FileType>
</SupportedFileTypes>
</FileTypeAssociation>
</Extension>
<Extension Category="windows.protocol">
<Protocol Name="alsdkjs" />
</Extension>
</Extensions>
</Application>
</Applications>
Confira também
ConceitosAplicativas e extensões
Requisitos
| Valor | |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/2010/manifest |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de