Función OleLoadPictureEx (olectl.h)

Crea un nuevo objeto de imagen e inicializa a partir del contenido de una secuencia. Esto equivale a llamar a OleCreatePictureIndirect con NULL como primer parámetro, seguido de una llamada a IPersistStream::Load.

Sintaxis

WINOLECTLAPI OleLoadPictureEx(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [in]  DWORD    xSizeDesired,
  [in]  DWORD    ySizeDesired,
  [in]  DWORD    dwFlags,
  [out] LPVOID   *lplpvObj
);

Parámetros

[in] lpstream

Puntero a la secuencia que contiene los datos de la imagen.

[in] lSize

Número de bytes que se deben leer desde la secuencia o cero si se debe leer toda la secuencia.

[in] fRunmode

Lo contrario al valor inicial de la propiedad KeepOriginalFormat . Si es TRUE, KeepOriginalFormat se establece en FALSE y viceversa.

[in] riid

Referencia al identificador de la interfaz que describe el tipo de puntero de interfaz que se va a devolver en ppvObj.

[in] xSizeDesired

Ancho deseado del icono o cursor. Los valores válidos son 16, 32 y 48. Pase LP_DEFAULT a ambos parámetros de tamaño para usar el tamaño predeterminado del sistema.

[in] ySizeDesired

Alto deseado del icono o cursor. Los valores válidos son 16, 32 y 48. Pase LP_DEFAULT a ambos parámetros de tamaño para usar el tamaño predeterminado del sistema.

[in] dwFlags

Profundidad de color deseada para el icono o cursor. Los valores son LP_MONOCHROME (monocromo), LP_VGACOLOR (16 colores), LP_COLOR (256 colores) o LP_DEFAULT (selecciona la mejor profundidad para la pantalla actual).

[out] lplpvObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvObj contiene el puntero de interfaz solicitado en el almacenamiento del objeto identificado por el moniker. Si *ppvObj no es NULL, esta función llama a IUnknown::AddRef en la interfaz; es responsabilidad del autor de la llamada llamar a IUnknown::Release. Si se produce un error, *ppvObj se establece en NULL.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Comentarios

La secuencia debe estar en formato BMP (mapa de bits), WMF (metarchivo) o ICO (icono). Un objeto de imagen creado con OleLoadPictureEx siempre tiene la propiedad de sus recursos internos (fOwn==TRUE está implícito).

Además de permitir la especificación de tamaño de cursor o icono, OleLoadPictureEx admite la carga de cursores de color.

Requisitos

Consulte también

OleCreatePictureIndirect

PICTDESC