Указание значков, отображаемых в области формы

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

Значки указываются как ресурсы в dll-файле ресурсов Win32. См. файл значка в стандартной нотации встроенного значка Win32. Например:

• <default>c:\myicon.ico<.default> загружает значок по умолчанию из указанного пути c:\

• <unread>c:\myresource.dll,101</unread> загружает ресурс значка с идентификатором ресурса 101 из файла ресурсов myresource.dll по указанному пути c:\

Обратите внимание, что переменные среды можно указать в именах путей к файлам, но нельзя указать пути в универсальном соглашении об именовании (UNC). По умолчанию, если не указать пользовательские значки, будут использоваться значки, назначенные родительскому классу сообщений. Например, если не указать значки для области формы для IPM. Примечание. Клиент, а затем значки для IPM. Будет использоваться примечание .

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

В следующей таблице показаны состояния элемента, который можно идентифицировать с помощью пользовательских значков в обозревателе, инспекторе или на ленте. Все настраиваемые значки для области формы указываются в элементе icons в XML-файле манифеста области формы для этой области формы. Каждое состояние сопоставляется с дочерним XML-элементом элемента icons . Этот XML-файл манифеста области формы указывается при регистрации области формы в реестре Windows. Дополнительные сведения о регистрации области формы см. в разделе Указание областей формы в реестре Windows.

Состояние элемента	Дочерний xml-элемент	Пример
Любое состояние, которое применяется к элементу, если для этого состояния не определен другой пользовательский значок.	default	<default>c:\default.ico</default>
Значок, указывающий в обозревателе, что элемент был зашифрован.	Зашифрованные	<encrypted>c:\encryptedicon.ico</encrypted>
Значок, указывающий в обозревателе, что элемент был переадресован.	Пересылаются	<forwarded>c:\forwardedicon.ico</forwarded>
Значок, указывающий на ленте, что элемент относится к определенному производном классу сообщений.	Страницы	<page>c:\pageicon.ico</page>
Значок, указывающий в обозревателе, что элемент был прочитан.	Прочитать	<read>c:\readicon.ico</read>
Значок, указывающий в обозревателе, что элемент является повторяющимся.	Повторяющиеся	<recurring>c:\recurringicon.ico</recurring>
Значок для идентификации в обозревателе, на который был ответ на элемент.	Ответил	<replied>c:\repliedicon.ico</replied>
Значок, указывающий в обозревателе, что элемент подписан цифровой подписью.	Подписал	<signed>c:\signedicon.ico</signed>
Значок, указывающий в обозревателе, что элемент отправлен.	Представлены	<submitted>c:\submittedicon.ico</submitted>
Значок, указывающий в обозревателе, что элемент еще не прочитан.	Непрочитанных	<unread>c:\unreadicon.ico</unread>
Значок, указывающий в обозревателе, что элемент находится в ожидании и еще не отправлен.	Неотправленные	<unsent>c:\unsenticon.ico</unsent>
Значок, отображаемый в инспекторе при открытии этого типа элемента.	Окно	<window>c:\windowicon.ico</window>

Указание настраиваемого значка для области формы

1. В XML-файле манифеста области формы в элементе icons укажите дочерний элемент, который сопоставляется с состоянием, которое требуется настроить.

2. В зависимости от того, как вы хотите указать файл пользовательского значка, выполните одно из следующих действий:

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

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

<icons> 
 <default>c:\icons\MyIcon.ico</default> 
 <unread>c:\icons\MyUnReadIcon.ico</unread> 
 <read>c:\icons\MyReadIcon.ico</read> 
 <encrypted>%windir%\myresource.dll,101</encrypted> 
</icons>

К четырем пользовательским значкам относятся:

• Файл пользовательского значка для состояния чтения
• Файл пользовательского значка для непрочитанных состояний
• Расположение в файле ресурсов для зашифрованного состояния
• Файл значка по умолчанию для всех остальных состояний, применимых к элементу

Примечание.

Значение дочернего элемента может быть выражено как путь к файлу значка или файлу ресурсов, либо как addin. Путь к файлу может быть выражен как полный путь или путь относительно расположения XML-файла манифеста области формы и может включать системные переменные. Дополнительные сведения об указании значка с помощью надстройки см. в разделе Практическое руководство. Использование надстройки для указания значков для области формы.

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.