Compartilhar via

Método IPicture::get_hPal (ocidl.h)

  • Artigo

Recupera uma cópia da paleta usada atualmente pelo objeto de imagem.

Sintaxe

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

Parâmetros

[out] phPal

Um ponteiro para uma variável que recebe o identificador de paleta. A variável é definida como NULL em caso de falha.

Valor retornado

Esse método dá suporte aos valores retornados padrão E_FAIL e E_OUTOFMEMORY, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 A altura foi retornada com êxito.
S_FALSE
 Esta imagem não tem paleta. A variável para a qual phpal aponta foi definida como NULL.
E_POINTER
 O valor de phPal não é válido. Por exemplo, pode ser NULL.

Comentários

Anotações para chamadores

Se o objeto de imagem tiver a propriedade da imagem, ele também terá a propriedade da paleta e o destruirá quando o objeto for destruído. Caso contrário, o chamador possui a paleta. O parâmetro fOwn para OleCreatePictureIndirect determina a propriedade. OleLoadPicture define fOwn como TRUE para indicar que o objeto de imagem possui a paleta.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Ipicture