mobile:Extension (Windows 10)

Artículo
07/20/2023

Declara un punto de extensibilidad para la aplicación.

Jerarquía de elemento

<mobile:Extension>

Syntax

<mobile:Extension
    Category = 'A string that can have one of the following values: "windows.aowApp", "windows.mobileMultiScreenProperties", "windows.communicationBlockingProvider", or "windows.phoneCallOriginProvider".'
    Executable = 'An optional string with a value 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 isnt specified, the EntryPoint defined for the app is used.'
    EntryPoint = 'An optional string with a value 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
    ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
    StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' >

  <!-- Child elements -->
  mobile:AowApp
  mobile:MobileMultiScreenProperties?

</mobile:Extension>

Clave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio
Categoría	Tipo de punto de extensibilidad de la aplicación.	Cadena que puede tener uno de los siguientes valores: windows.aowApp, windows.mobileMultiScreenProperties, windows.communicationBlockingProvider o windows.phoneCallOriginProvider.	Sí
Executable	Ejecutable de inicio predeterminado.	Cadena opcional con un valor de entre 1 y 256 caracteres de longitud que debe terminar con `.exe` y no puede contener estos caracteres: `<`, `>`, `":`, `\|`, `?`, o `*`. Especifica el archivo ejecutable predeterminado para la extensión. Si no se especifica, se usa el archivo ejecutable definido para la aplicación. Si se especifica, también se usa la propiedad EntryPoint. Si no se especifica esa propiedad EntryPoint, se usa entryPoint definido para la aplicación.	No
EntryPoint	Identificador de clase activable.	Cadena opcional con un valor entre 1 y 256 caracteres de longitud, que representa la tarea que controla la extensión. Suele ser el nombre completo en el espacio de nombres de un tipo de Windows en tiempo de ejecución. Si no se especifica EntryPoint, en su lugar se usa entryPoint definido para la aplicación.	No
RuntimeType	Proveedor en tiempo de ejecución. Este atributo se usa normalmente cuando hay marcos mixtos en una aplicación.	Una cadena opcional con un valor de entre 1 y 255 caracteres de longitud que no puede iniciar o terminar con un punto o contener estos caracteres: `<`, `>`, `/\"\|:`, `?`o .`*`	No
ResourceGroup	Etiqueta que puede usar para agrupar activaciones de extensión con fines de administración de recursos (por ejemplo, CPU y memoria). El valor que puede establecer ResourceGroup es de forma libre y flexible. Consulte Application@ResourceGroup.	Cadena alfanumérica opcional con un valor entre 1 y 255 caracteres de longitud. Debe comenzar con una letra.	No
StartPage	La página web que administra el punto de extensibilidad.	Cadena opcional con un valor entre 1 y 256 caracteres de longitud que no puede contener estos caracteres: `<`, , `:>`, `"\|`, , `?`o `*`.	No

Elementos secundarios

Elemento secundario	Descripción
mobile:AowApp	Declara un punto de extensibilidad de la aplicación de tipo windows.aowApp.
mobile:MobileMultiScreenProperties	Declara un punto de extensibilidad de la aplicación de ventanas de tipo . MobileMultiScreenProperties.

Elementos primarios

Elemento primario	Descripción
Extensiones (tipo: CT_ApplicationExtensions)	Define uno o varios puntos de extensibilidad para la aplicación.

Ejemplos

En el ejemplo siguiente se muestra cómo impedir que la aplicación móvil se muestre en una pantalla conectada. Este marcado hará que el icono de la aplicación se deshabilite en el menú Inicio de la pantalla conectada.

<Package
    xmlns:mobile="http://schemas.microsoft.com/appx/manifest/mobile/windows10"
    IgnorableNamespaces="... mobile">
    <Applications>
        <Application>
            <Extensions>
                <mobile:Extension
                    Category="windows.mobileMultiScreenProperties">
                    <mobile:MobileMultiScreenProperties
                        RestrictToInternalScreen="true"/>
                </mobile:Extension>
            </Extensions>
        </Application>
    </Applications>
</Package>

Requisitos

Elemento	Value
Espacio de nombres	`http://schemas.microsoft.com/appx/manifest/mobile/windows10`
Minimum OS Version	Windows 10 versión 1511 (compilación 10586)