Función OleUIPasteSpecialA (oledlg.h)

Artículo
11/20/2024

Invoca el cuadro de diálogo estándar Pegar especial, lo que permite al usuario seleccionar el formato del objeto del Portapapeles para pegar o pegar.

Sintaxis

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA unnamedParam1
);

Parámetros

[in] unnamedParam1

Puntero a una estructura OLEUIPASTESPECIAL.

Valor devuelto

Definiciones de errores y correctos estándar

Código devuelto	Descripción
OLEUI_FALSE	Error desconocido (sin usar).
OLEUI_OK	El usuario ha presionado el botón Aceptar.
OLEUI_SUCCESS	No hay ningún error, igual que OLEUI_OK.
OLEUI_CANCEL	El usuario ha presionado el botón Cancelar.

Errores de validación de campos estándar

Código devuelto	Descripción
OLEUI_ERR_STANDARDMIN	Los errores comunes a todos los cuadros de diálogo se encuentran en el intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Este valor permite a la aplicación probar los mensajes estándar para mostrar los mensajes de error al usuario.
OLEUI_ERR_STRUCTURENULL	El puntero a una estructura OLEUIXXX pasada a la función era NULL.
OLEUI_ERR_STRUCTUREINVALID	Permisos insuficientes para el acceso de lectura o escritura a una estructura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	El valor cbstruct es incorrecto.
OLEUI_ERR_HWNDOWNERINVALID	El hWndOwner no es válido.
OLEUI_ERR_LPSZCAPTIONINVALID	El valor de lpszCaption no es válido.
OLEUI_ERR_LPFNHOOKINVALID	El valor de lpfnHook no es válido.
OLEUI_ERR_HINSTANCEINVALID	El hInstance no es válido.
OLEUI_ERR_LPSZTEMPLATEINVALID	El valor de lpszTemplate no es válido.
OLEUI_ERR_HRESOURCEINVALID	El valor de hResource no es válido.

Errores de inicialización

Código devuelto	Descripción
OLEUI_ERR_FINDTEMPLATEFAILURE	No se puede encontrar la plantilla del cuadro de diálogo.
OLEUI_ERR_LOADTEMPLATEFAILURE	No se puede cargar la plantilla del cuadro de diálogo.
OLEUI_ERR_DIALOGFAILURE	Error de inicialización del cuadro de diálogo.
OLEUI_ERR_LOCALMEMALLOC	Error de llamada a localAlloc o al asignador estándar IMalloc.
OLEUI_ERR_GLOBALMEMALLOC	No se pudo realizar una llamada a GlobalAlloc o al asignador estándar IMalloc.
OLEUI_ERR_LOADSTRING	No se puede llamar a LoadString para obtener recursos localizados de la biblioteca.
OLEUI_ERR_OLEMEMALLOC	Error en una llamada al asignador estándar IMalloc.

Errores específicos de la función

Código devuelto	Descripción
OLEUI_ERR_STANDARDMAX	Los errores comunes a todos los cuadros de diálogo se encuentran en el intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Este valor permite a la aplicación probar los mensajes estándar para mostrar los mensajes de error al usuario.
OLEUI_IOERR_SRCDATAOBJECTINVALID	El miembro lpSrcDataObject de OLEUIPASTESPECIAL no es válido.
OLEUI_IOERR_ARRPASTEENTRIESINVALID	El miembro arrPasteEntries de OLEUIPASTESPECIAL no es válido.
OLEUI_IOERR_ARRLINKTYPESINVALID	El miembro arrLinkTypes de oleUIPASTESPECIAL no es válido.
OLEUI_PSERR_CLIPBOARDCHANGED	El contenido del Portapapeles cambió mientras se mostraba el cuadro de diálogo.
OLEUI_PSERR_GETCLIPBOAARDFAILED	El miembro lpSrcDataObj es incorrecto.

Observaciones

El diseño del cuadro de diálogo Pegar especial supone que si está dispuesto a permitir que un usuario vincule a un objeto, también está dispuesto a permitir que el usuario inserte ese objeto. Por este motivo, si se establece alguna de las marcas de OLEUIPASTE_LINKTYPE asociadas a la enumeración OLEUIPASTEFLAG, la marca OLEUIPASTE_PASTE también debe establecerse para que los formatos de datos aparezcan en el cuadro de diálogo Pegar especial.

El texto que se muestra en el campo origen del cuadro de diálogo especial pegar estándar , que se implementa en Oledlg32.dll, es la cadena terminada en null cuyo desplazamiento en bytes se especifica en el dwSrcofCopy miembro del OBJECTDESCRIPTOR para el objeto que se va a pegar. Si una estructura OBJECTDESCRIPTOR no está disponible para este objeto, el cuadro de diálogo muestra cualquier texto asociado a CF_LINKSOURCEDESCRIPTOR. Si ninguna estructura está disponible, el cuadro de diálogo busca CF_FILENAME. Si no se encuentra CF_FILENAME, el cuadro de diálogo muestra la cadena "Origen desconocido".

Para liberar una HMETAFILEPICT devuelta desde el de Insertar objeto o cuadro de diálogo Pegar especial, elimine el metarchivo adjunto en el identificador, como se indica a continuación.

void FreeHmetafilepict(HMETAFILEPICT hmfp)
{
    if (hmfp != NULL)
    {
        LPMETAFILEPICT pmfp = GlobalLock(hmfp);
 
        DeleteMetaFile(pmfp->hMF);
        GlobalUnlock(hmfp);
        GlobalFree(hmfp);
    }
    else
    {
        // Handle null pointers here.
        exit(0);
    }
}

Nota

El encabezado oledlg.h define OLEUIPASTESPECIAL como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	oledlg.h
biblioteca de	OleDlg.lib
DLL de	OleDlg.dll

Consulte también

OLEUIPASTEFLAG

Compartir a través de