DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

Предоставляет стандартную FORMATETC структуру, которая логически эквивалентна более сложной структуре. Используйте этот метод, чтобы определить, будут ли две разные FORMATETC структуры возвращать одни и те же данные, удаляя необходимость дубликатной отрисовки.

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcOut) = System::Runtime::InteropServices::ComTypes::IDataObject::GetCanonicalFormatEtc;

int IDataObject.GetCanonicalFormatEtc(ref System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcIn, out System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcOut);

abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

Function GetCanonicalFormatEtc (ByRef pformatetcIn As FORMATETC, ByRef pformatetcOut As FORMATETC) As Integer Implements IDataObject.GetCanonicalFormatEtc

Параметры

pformatetcIn

FORMATETC

Указатель на FORMATETC структуру, передаваемую по ссылке, которая определяет формат, средний и целевой устройства, которые вызывающий объект хотел бы использовать для получения данных в последующем вызове GetData(FORMATETC, STGMEDIUM). Член TYMED не является значительным в этом случае и должен быть проигнорирован.

pformatetcOut

FORMATETC

При возврате этого метода содержит указатель на FORMATETC структуру, содержащую наиболее общие сведения, возможные для определенной отрисовки, что делает его канонически эквивалентным formatetcIn. Вызывающий объект должен выделить эту структуру, и GetCanonicalFormatEtc(FORMATETC, FORMATETC) метод должен заполнить данные. Для получения данных в последующем вызове, например GetData(FORMATETC, STGMEDIUM), вызывающий использует предоставленное значение formatOut, если не указано nullзначение. Это значение имеет значение null , если метод возвращается DATA_S_SAMEFORMATETC. Член TYMED не является значительным в этом случае и должен быть проигнорирован. Этот параметр передается неинициализирован.

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

Int32

Этот метод поддерживает стандартные возвращаемые значения E_INVALIDARG, E_UNEXPECTED и E_OUTOFMEMORY, а также следующие:

Ценность	Описание
S_OK	Возвращаемая FORMATETC структура отличается от переданной.
DATA_S_SAMEFORMATETC	Структуры FORMATETC одинаковы и null возвращаются в параметре pformatetcOut .
DV_E_LINDEX	В настоящее время имеется недопустимое значение lindex; поддерживается только -1.
DV_E_FORMATETC	Для параметра имеется недопустимое значение pformatetcIn .
OLE_E_NOTRUNNING	Приложение не запущено.

Реализации

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Комментарии

Этот член является явной реализацией элемента интерфейса. Его можно использовать только в том случае, если DataObject экземпляр приведение к интерфейсу IDataObject .