Поделиться через


Объявление команд и элементов управления с помощью разметки ленты

Платформа ленты Windows использует язык разметки на основе XAML для декларативной реализации внешнего вида приложения ленты.

Отделение презентации от командной логики

Разделение атрибутов представления и визуальных элементов от командной логики в платформе ленты осуществляется с помощью двух разных, но зависимых платформ разработки. Макеты элементов управления, поведение масштабирования, объявления команд и спецификации ресурсов — это область времени разработки декларативного синтаксиса разметки на основе спецификации XAML . Низкоуровневые функциональные возможности, перехватчики приложений и обработчики команд определяются в реализациях интерфейса на основе модели com.

Такое разделение представления и логики обеспечивает следующие преимущества:

  • Более эффективный цикл разработки приложений, который позволяет разработчикам пользовательского интерфейса и конструкторам реализовывать графический пользовательский интерфейс приложения ленты независимо от основных функциональных возможностей приложения. Эту основную функциональность можно оставить на выделенных разработчиков программного обеспечения.
  • Менее затратное обслуживание, так как изменения графического пользовательского интерфейса возможны без изменений в основных функциональных возможностях (и наоборот).
  • Простая спецификация строковых ресурсов и ресурсов изображений с помощью разметки.
  • Простота создания прототипов.

Структура разметки

В структуре разметки платформы ленты существуют две отдельные ветви.

Первая ветвь содержит манифест объявлений команд и ресурсов (строк и изображений). Каждая запись Command используется платформой для привязки элемента управления ленты с помощью идентификатора команды к обработчику команд, определенному в коде приложения.

Вторая ветвь содержит фактические объявления элементов управления. Каждый элемент управления связан с Command с помощью атрибута CommandName , который сопоставляется с атрибутом Name , указанным в каждом объявлении Command.

Компоненты ленты

Функциональность пользовательского интерфейса платформы ленты предоставляется через представления. Представление по сути является контейнером, например ribbon и ContextPopup, который используется для представления элементов управления платформы и команд, к которым они привязаны.

Представление ленты состоит из нескольких компонентов, которые включают меню приложения, панель быстрого доступа (QAT) для отображения часто используемых команд из пользовательского интерфейса ленты, основные и контекстные вкладки , содержащие группы элементов управления, а также полнофункциональная система контекстного меню ContextPopup.

Все компоненты ленты объявляются в отдельном файле разметки, который:

В следующих двух примерах разметки ленты показано, как набор элементов меню приложения ленты связан с именем и идентификатором команды.

  1. В этом разделе показаны объявления команд, необходимые для меню приложения с базовыми командами, такими как "Создать", "Открыть" и "Сохранить".

    <!-- Command declarations for the Application Menu. -->
    <Command Name="cmdFileMenu"
             Symbol="ID_FILE_MENU"
             Id="25000" />
    <!-- Command declaration for most recently used items. -->
    <Command Name="cmdMRUItems"
             Symbol="ID_FILE_MRUITEMS"
             Id="25050"/>
    <!-- Command declarations for Application Menu items. -->
    <Command Name="cmdNew"
             Symbol="ID_FILE_NEW"
             Comment="New"
             Id="25001"
             LabelTitle="&amp;New"/>
    <Command Name="cmdOpen"
             Symbol="ID_FILE_OPEN"
             Comment="Open"
             Id="25002"
             LabelTitle="&amp;&amp;Open"/>
    <Command>
      <Command.Name>cmdSave</Command.Name>
      <Command.Symbol>ID_FILE_SAVE</Command.Symbol>
      <Command.Comment>Save</Command.Comment>
      <Command.Id>25003</Command.Id>
      <Command.LabelTitle>
        <String>
          <String.Content>Label for Save</String.Content>
          <String.Id>59999</String.Id>
          <String.Symbol>strSave</String.Symbol>
        </String>
      </Command.LabelTitle>
      <Command.TooltipTitle>Tooltip title with &amp;&amp; for Save Command</Command.TooltipTitle>
      <Command.TooltipDescription>Tooltip description for Save Command.</Command.TooltipDescription>
      <Command.Keytip>s1</Command.Keytip>
    </Command>
    <Command Name="cmdPrint"
             Symbol="ID_FILE_PRINT"
             Comment="Save"
             Id="25004"
             LabelTitle="Print" />
    <Command Name="cmdExit"
             Symbol="ID_FILE_EXIT"
             Comment="Exit"
             Id="25005"
             LabelTitle="Exit" />
    
  2. В этом разделе показаны связанные объявления элемента управления.

    <!-- Control declarations for Application Menu items. -->
    <Ribbon.ApplicationMenu>
      <ApplicationMenu CommandName="cmdFileMenu">
        <!-- Most recently used items collection. -->
        <ApplicationMenu.RecentItems>
          <RecentItems CommandName="cmdMRUItems"/>
        </ApplicationMenu.RecentItems>
        <!-- Menu items collection. -->
        <MenuGroup>
          <Button CommandName="cmdNew" />
          <Button CommandName="cmdOpen" />
          <Button CommandName="cmdSave" />
        </MenuGroup>
        <MenuGroup>
          <Button CommandName="cmdPrint" />
          <Button CommandName="cmdExit" />
        </MenuGroup>
      </ApplicationMenu>
    </Ribbon.ApplicationMenu>
    

При компиляции разметки с помощью средства компилятора команд пользовательского интерфейса (UICC) имена и идентификаторы команд помещаются в файл заголовка, используемый ведущим приложением ленты.

Ниже приведен пример файла заголовка, созданного UICC.

// *****************************************************************************
// * This is an automatically generated header file for UI Element definition  *
// * resource symbols and values. Please do not modify manually.               *
// *****************************************************************************

#pragma once

#define cmdFileMenu 25000 
#define cmdNew 22001  /* New */ 
#define cmdNew_LabelTitle_RESID 60005
#define cmdOpen 22002  /* Open */ 
#define cmdOpen_LabelTitle_RESID 60006
#define cmdSave 22003  /* Save */ 
#define cmdSave_LabelTitle_RESID 60007
#define cmdSave_TooltipTitle_RESID 60008
#define cmdSave_TooltipDescription_RESID 60009

Язык XAML

Компиляция разметки ленты