Compartir a través de


COleControl::OnRenderGlobalData

Llamado por el marco para recuperar datos en el formato especificado cuando el medio de almacenamiento especificado es memoria global.

virtual BOOL OnRenderGlobalData( 
   LPFORMATETC lpFormatEtc, 
   HGLOBAL* phGlobal  
);

Parámetros

  • lpFormatEtc
    Señala la estructura de FORMATETC que especifica el formato en el que se solicita información.

  • phGlobal
    Señala un identificador a memoria global en el que los datos debe volver. Si no se ha asignado ninguna memoria, este parámetro puede ser NULL.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

El formato especificado es uno colocado previamente en el objeto de control mediante la función miembro de DelayRenderData para generar retrasada. La implementación predeterminada de esta función simplemente devuelve FALSO.

Si phGlobal es NULL, después nuevo HGLOBAL se debe asignar y devolver en phGlobal. Si no, HGLOBAL especificado por phGlobal se debe rellenar con datos. La cantidad de datos guardados en HGLOBAL no debe superar el tamaño actual del bloque de memoria. Además, el bloque no se puede reasignar a un tamaño.

Invalide esta función para proporcionar los datos en el formato y mediano solicitados. Dependiendo de los datos, puede que desee reemplazar una de las otras versiones de esta función en su lugar. Si desea controlar los medios de almacenamiento múltiples, reemplace OnRenderData. Si los datos se encuentra en un archivo, o es de tamaño variable, reemplace OnRenderFileData.

Para obtener más información, vea la estructura de FORMATETC en Windows SDK.

Requisitos

encabezado: afxctl.h

Vea también

Referencia

COleControl Class

Gráfico de jerarquías

COleControl::OnRenderFileData

COleControl::OnRenderData