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

Метод IPicture::get_hPal (ocidl.h)

  • Статья

Извлекает копию палитры, которая в настоящее время используется объектом picture.

Синтаксис

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

Параметры

[out] phPal

Указатель на переменную, которая получает дескриптор палитры. При сбое переменной присваивается значение NULL .

Возвращаемое значение

Этот метод поддерживает стандартные возвращаемые значения E_FAIL и E_OUTOFMEMORY, а также следующие значения.

Код возврата Описание
S_OK
 Высота была успешно возвращена.
S_FALSE
 На этом рисунке нет палитры. Переменная, на которую указывает phpal , имеет значение NULL.
E_POINTER
 Недопустимое значение phPal . Например, он может иметь значение NULL.

Комментарии

Примечания к вызывающим абонентам

Если объект рисунка является владельцем рисунка, он также владеет палитрой и уничтожит его при уничтожении самого объекта. В противном случае палитрой владеет вызывающий объект. Параметр fOwn для OleCreatePictureIndirect определяет владение. OleLoadPicture задает для параметра FOwnзначение TRUE , чтобы указать, что объект рисунка владеет палитрой.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

См. также раздел

IPicture