Лаунчактион (в Контактлаунчактионс)

  • Статья

Описывает действие содержимого контактлаунчактионс .

Иерархия элементов

<Продлен>
<Contact>
<ContactLaunchActions>
<LaunchAction>

Синтаксис

<LaunchAction Verb         = "call" | "map" | "message" | "post" | "videoCall"
              DesiredView? = "default" | "useLess" | "useHalf" | "useMore" | "useMinimum" >

  <!-- Child elements -->
  ServiceId{0,100}

</LaunchAction>

Ключ

? Необязательный (ноль или один) {} конкретный диапазон вхождений

Атрибуты и элементы

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
десиредвиев

Требуемый объем пространства экрана, используемый при запуске контакта.

Windows Phone: десиредвиев не поддерживается для Windows Phone.

Этот атрибут может иметь одно из следующих значений:

  • значение по умолчанию
  • Бесполезны
  • усехалф
  • усеморе
  • усеминимум
 Нет
Команда

Уникальный идентификатор, который передается в приложение при его запуске. Приложение может использовать эту строку, чтобы определить, какой обработчик контактлаунчактионс активировал его запуск. Он уникален для каждого приложения в пакете и учитывает регистр.

Этот атрибут может иметь одно из следующих значений:

  • вызывает
  • карта
  • message
  • post
  • видеокалл
 Да

 

Дочерние элементы

Дочерний элемент Описание
ServiceId

Определяет службу для действия контакта.

 

Родительские элементы

Родительский элемент Описание
ContactLaunchActions

Объявляет действия, выполняемые при запуске контакта.

 

Следующие элементы имеют то же имя, что и это одно, но различное содержимое или атрибуты:

Remarks

Дополнительные сведения о действиях запуска, принимаемых поставщиком контактов, см. в разделе контактлаунчактионвербс.

Манифест применяет эти семантические проверки для атрибута verb для действия содержимого контактлаунчактионс .

  • Если для verb задано значение Map, то он не должен объявлять какие-либо элементы ServiceId . Все остальные значения для verb должны объявлять ServiceId.
  • Если для команды задано значение Call или Message, можно указать ServiceId в качестве хорошо известного значения телефона.

Определение лаунчактион (in контактлаунчактионс) содержит следующие инструкции:

            <xs:element name="LaunchAction" maxOccurs="50">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="ServiceId" type="CT_ServiceId" minOccurs="0" maxOccurs="100"/>
                </xs:sequence>
                <xs:attribute name="Verb" type="ST_ContactLaunchActionVerbs" use="required"/>
                <xs:attribute name="DesiredView" type="ST_DesiredView" use="optional"/>
                <xs:attributeGroup ref="m:ExtensionBaseAttributes"/>
              </xs:complexType>
              <xs:unique name="Service_Id">
                <xs:selector xpath="m2:ServiceId"/>
                <xs:field xpath="."/>
              </xs:unique>
            </xs:element>

Предшествующий оператор ref указывает, что лаунчактион (в контактлаунчактионс) наследует все эти базовые атрибуты расширения :

  <xs:attributeGroup name="ExtensionBaseAttributes">
    <xs:attribute name="Executable" type="ST_Executable" use="optional"/>
    <xs:attribute name="EntryPoint" type="ST_EntryPoint" use="optional"/>
    <xs:attribute name="RuntimeType" type="ST_ActivatableClassId" use="optional"/>
    <xs:attribute name="StartPage" type="ST_FileName" use="optional"/>
  </xs:attributeGroup>

Поскольку лаунчактион (в контактлаунчактионс) допускает базовые атрибуты расширения , он имеет следующие семантические проверки, не охваченные схемой манифеста XSD:

  • Базовые атрибуты расширения должны соответствовать следующим правилам:

    • Если указан атрибут StartPage , завершится ошибкой, если указан атрибут EntryPoint, Executableили RuntimeType .
    • В противном случае завершится ошибкой, если атрибут Executable или RuntimeType указан без указания точки входа .

  • Если лаунчактион определяет атрибут EntryPoint , то этот лаунчактион или родительский модуль или элемент приложения должны указывать исполняемый атрибут.

Требования

Значение
Пространство имен http://schemas.microsoft.com/appx/2013/manifest