Консольные приложения (19): Вывод сообщений

Среди действий, которые можно привязать к элементам дерева в админке, есть и сообщения. В консольном приложении на основе файла определения дерева, можно использовать два типа сообщений:

• просто сообщения, или условно назовем их "информационными" (message box)
• подтверждающие сообщения (confirmation box)

Оба типа сообщения добавляются как и любое другое действие в элемент Actions.

В этом сообщении я рассмотрю простое сообщение, а в следующем - подтверждающее.

Пример простого сообщения я уже приводил в самом первом своем посте на тему консольных приложений.

<?xml version="1.0" encoding="utf-8" ?>

<ElementStructure

  xmlns="http://www.composite.net/ns/management/trees/treemarkup/1.0"

  xmlns:f="http://www.composite.net/ns/function/1.0">

  <ElementStructure.AutoAttachments>

    <DataType Type="Composite.Data.Types.IPage" />

  </ElementStructure.AutoAttachments>

  <ElementRoot>

    <Actions>

      <MessageBoxAction Label="GUID"

        MessageBoxTitle="${C1:Data:Composite.Data.Types.IPage:Title}"

        MessageBoxMessage="${C1:Data:Composite.Data.Types.IPage:Id}" />

    </Actions>

  </ElementRoot>

</ElementStructure>

Так как вы уже хорошо разбираетесь в таких определениях, то вы, наверняка увидите, что:

• сообщение привязывается к странице в админке: Composite.Data.Types.IPage указан как тип (Type)
• само приложение подключается в админке автоматически (ElementStructure.AutoAttachments)
• XML-элемент, который представляет простое сообщение -  MessageBoxAction, и добавляется он внутри XML-элемента Actions
• в качестве значений атрибутов (MessageBoxTitle и MessageBoxMessage) используются динамические поля.

Итак, обязательными атрибутами у MessageBoxAction являются:

• Label: надпись на кнопке на панели инструментов и пункте контекстного меню - для вызова сообщения
• MessageBoxTitle: заголовок окна сообщения
• MessageBoxMessage: текст сообщения

Необязательные атрибуты:

• MessageDialogType: тип сообщения. Одно из значений: “message” (сообщение), “question” (вопрос), “warning” (предупреждение), “error” (ошибка). По умолчанию - “message”.
• Icon: иконка для кнопки на панели инструментов и пункта контекстного меню. По умолчанию, используется системная иконка для этого действия. (Названия допустимых иконок можно посмотреть здесь /Composite/images/icons/StandardIcons.xml.)
• ToolTip: подсказка, всплывающая при наведении на кнопку или пункт меню. По умолчанию, используется значение атрибута Label.
• PermissionTypes: список разрешений для этого действия.

При помощи динамических полей, в заголовке окна сообщения мы указываем название страницы, а в тексте - идентификатор этой страницы.

По теме консольных приложений, я еще расскажу о подтверждающих сообщениях. И на этом - пока все.

(окончание следует...)