MAPIFolder.SetCustomIcon(StdPicture) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает настраиваемый значок, указанный Picture для папки.
public:
void SetCustomIcon(stdole::StdPicture ^ Picture);public void SetCustomIcon (stdole.StdPicture Picture);Public Sub SetCustomIcon (Picture As StdPicture)Параметры
- Picture
- StdPicture
Указывает пользовательский значок для папки.
Комментарии
Объект, указанный StdPicture параметром , Picture должен иметь свойство Type , равное PICTYPE_ICON или PICTYPE_BITMAP. Максимальный размер ресурса значка или растрового изображения — 32 x 32. Также поддерживаются значки 16x16 или 24 x 24, и Microsoft Outlook может увеличить масштаб значка 16x16, если Outlook работает в режиме высокого уровня точек на дюйм (DPI). Значки других размеров приводят к возврату ошибки SetCustomIcon .
Можно задать настраиваемый значок для папки поиска и для всех папок, которые не представляют папку по умолчанию или специальную папку. При попытке задать пользовательский значок для папки, которая принадлежит одной из следующих групп папок, SetCustomIcon вернет ошибку:
Метод GetCustomIcon можно вызывать только из кода, который выполняется в процессе как Outlook. Объект StdPicture не может быть маршалирован через границы процесса. При попытке вызвать GetCustomIcon из внепроцессного кода возникает исключение. Дополнительные сведения см. в статье Сервер автоматизации не может передать указатель на реализацию IPictureDisp объекта рисунка через границы процесса.
Значок пользовательской папки, который предоставляет этот метод, не сохраняется за пределами запущенного сеанса Outlook. Поэтому надстройки должны задавать настраиваемый значок папки при каждой загрузке Outlook.
Значок пользовательской папки не отображается в других клиентах Exchange, таких как Outlook Web Access, и не отображается в Outlook, работающем на устройстве Windows Mobile.