Función OleCreateStaticFromData (ole2.h)

Crea un objeto estático, que contiene solo una representación, sin datos nativos, a partir de un objeto de transferencia de datos.

Sintaxis

HRESULT OleCreateStaticFromData(
  [in]  LPDATAOBJECT    pSrcDataObj,
  [in]  REFIID          iid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     pFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Parámetros

[in] pSrcDataObj

Puntero a la interfaz IDataObject en el objeto de transferencia de datos que contiene los datos desde los que se creará el objeto.

[in] iid

Referencia al identificador de la interfaz con la que el autor de la llamada se comunica con el nuevo objeto (normalmente IID_IOleObject, definido en los encabezados OLE como identificador de interfaz para IOleObject).

[in] renderopt

Valor de la enumeración OLERENDER que indica las capacidades de dibujo o recuperación de datos almacenadas localmente en caché que el contenedor quiere en el componente recién creado. Es un error pasar las opciones de representación OLERENDER_NONE o OLERENDER_ASIS a esta función.

[in] pFormatEtc

Dependiendo de cuál de las marcas OLERENDER se use como valor de renderopt, puede ser un puntero a uno de los valores de enumeración FORMATETC . Consulte la enumeración OLERENDER para ver las restricciones.

[in] pClientSite

Puntero a una instancia de IOleClientSite, la interfaz principal a través de la cual el objeto solicitará servicios de su contenedor. Este parámetro puede ser NULL.

[in] pStg

Puntero a la interfaz IStorage para el almacenamiento del objeto. Este parámetro no puede ser NULL.

[out] ppvObj

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 objeto recién creado.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente.

Comentarios

La función OleCreateStaticFromData puede convertir cualquier objeto, siempre y cuando proporcione una interfaz IDataObject , a un objeto estático. Resulta útil para implementar la opción Convertir en imagen para vincular o insertar OLE.

Los objetos estáticos solo se pueden crear si el origen admite uno de los formatos del Portapapeles representados por OLE: CF_METAFILEPICT, CF_DIB o CF_ BITMAP y CF_ENHMETAFILE.

También puede llamar a OleCreateStaticFromData para pegar un objeto estático desde el Portapapeles. Para determinar si un objeto es estático, llame a la función OleQueryCreateFromData , que devuelve OLE_S_STATIC si uno de CF_METAFILEPICT, CF_DIB, CF_BITMAP o CF_ENHMETAFILE está presente y no hay un formato OLE. Esto indica que debe llamar a OleCreateStaticFromData en lugar de a la función OleCreateFromData para crear el objeto.

El nuevo objeto estático es de clase CLSID_StaticMetafile en el caso de CF_METAFILEPICT, CLSID_StaticDib en el caso de CF_DIB o CF_BITMAP, o CLSID_Picture_EnhMetafile en el caso de CF_ENHMETAFILE. El objeto estático establece el OLEMISC_STATIC y OLE_CANTLINKINSIDE bits devueltos de IOleObject::GetMiscStatus. El objeto estático tendrá el aspecto DVASPECT_CONTENT y un LINDEX de -1.

PSrcDataObject sigue siendo válido después de que OleCreateStaticFromData devuelva. Es responsabilidad del autor de la llamada liberar pSrcDataObject - OLE no lo libera.

No puede haber más de una secuencia de presentación en un objeto estático.

Requisitos

Consulte también

OleCreateFromData