Функция OleUIPasteSpecialA (oledlg.h)

Статья
11/20/2024

Вызывает диалоговое окно "Стандартный вставки специальных", что позволяет пользователю выбрать формат объекта буфера обмена, который будет вставлен или связан.

Синтаксис

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру OLEUIPASTESPECIAL.

Возвращаемое значение

Стандартные определения успешности и ошибок

Возвращаемый код	Описание
OLEUI_FALSE	Неизвестный сбой (неиспользуемый).
OLEUI_OK	Пользователь нажимал кнопку "ОК".
OLEUI_SUCCESS	Нет ошибок, аналогичных OLEUI_OK.
OLEUI_CANCEL	Пользователь нажимал кнопку "Отмена".

Ошибки проверки стандартных полей

Возвращаемый код	Описание
OLEUI_ERR_STANDARDMIN	Ошибки, распространенные для всех диалоговых окон, лежат в диапазоне OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.
OLEUI_ERR_STRUCTURENULL	Указатель на структуру OLEUIXXX, переданную в функцию, был null.
OLEUI_ERR_STRUCTUREINVALID	Недостаточно разрешений для доступа на чтение или запись к структуре OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	Неверное значение cbstruct.
OLEUI_ERR_HWNDOWNERINVALID	Недопустимое значение hWndOwner.
OLEUI_ERR_LPSZCAPTIONINVALID	Значение lpszCaption недопустимо.
OLEUI_ERR_LPFNHOOKINVALID	Недопустимое значение lpfnHook.
OLEUI_ERR_HINSTANCEINVALID	Недопустимое значение hInstance.
OLEUI_ERR_LPSZTEMPLATEINVALID	Недопустимое значение lpszTemplate.
OLEUI_ERR_HRESOURCEINVALID	Недопустимое значение hResource.

Ошибки инициализации

Возвращаемый код	Описание
OLEUI_ERR_FINDTEMPLATEFAILURE	Не удалось найти шаблон диалогового окна.
OLEUI_ERR_LOADTEMPLATEFAILURE	Не удалось загрузить шаблон диалогового окна.
OLEUI_ERR_DIALOGFAILURE	Сбой инициализации диалогового окна.
OLEUI_ERR_LOCALMEMALLOC	Сбой вызова LocalAlloc или стандартного IMalloc распределителя.
OLEUI_ERR_GLOBALMEMALLOC	Сбой вызова GlobalAlloc или стандартного распределителя IMalloc.
OLEUI_ERR_LOADSTRING	Не удалось вызвать LoadString, чтобы получить локализованные ресурсы из библиотеки.
OLEUI_ERR_OLEMEMALLOC	Сбой вызова стандартного IMalloc распределителя.

Ошибки, связанные с конкретной функцией

Возвращаемый код	Описание
OLEUI_ERR_STANDARDMAX	Ошибки, распространенные для всех диалоговых окон, лежат в диапазоне OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.
OLEUI_IOERR_SRCDATAOBJECTINVALID	Недопустимый элемент LPSrcDataObject OLEUIPASTESPECIAL.
OLEUI_IOERR_ARRPASTEENTRIESINVALID	Элемент arrPasteEntries OLEUIPASTESPECIAL является недопустимым.
OLEUI_IOERR_ARRLINKTYPESINVALID	Недопустимый элемент arrLinkTypesOLEUIPASTESPECIAL.
OLEUI_PSERR_CLIPBOARDCHANGED	Содержимое буфера обмена изменилось во время отображения диалогового окна.
OLEUI_PSERR_GETCLIPBOAARDFAILED	Элемент lpSrcDataObj неверный.

Замечания

В диалоговом окне Вставка специального предполагается, что если вы хотите разрешить пользователю связаться с объектом, вы также готовы разрешить пользователю внедрить этот объект. По этой причине, если задано любое из флагов OLEUIPASTE_LINKTYPE, связанных с перечислением OLEUIPASTEF LAG, то флаг OLEUIPASTE_PASTE также должен быть установлен, чтобы форматы данных отображались в диалоговом окне Вставка специальных.

Текст, отображаемый в поле исходного стандартного диалогового окна вставки специального, реализованного в Oledlg32.dll, представляет собой строку, завершающую значение NULL, смещение в байтах, указанное в dwSrcofCopy член структуры OBJECTDESCRIPTOR для вставленного объекта. Если объект OBJECTDESCRIPTOR структура недоступна для этого объекта, диалоговое окно отображает любой текст, который может быть связан с CF_LINKSOURCEDESCRIPTOR. Если ни в той или иной структуре нет, диалоговое окно ищет CF_FILENAME. Если CF_FILENAME не найдено, в диалоговом окне отображается строка "Неизвестный источник".

Чтобы освободить HMETAFILEPICT, возвращенных из диалогового окна вставки объекта или вставить специальные, удалите вложенный метафайл в дескриптор, как показано ниже.

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);
    }
}

Заметка

Заголовок oledlg.h определяет OLEUIPASTESPECIAL как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	oledlg.h
библиотеки	OleDlg.lib
DLL	OleDlg.dll

См. также

OLEUIPASTEFLAG

Поделиться через