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

Метод IOleControlSite::TransformCoords (ocidl.h)

  • Статья

Преобразует координаты, выраженные в единицах HIMETRIC (как это стандартно в OLE), в единицы измерения, заданные контейнером.

Синтаксис

HRESULT TransformCoords(
  [in, out] POINTL *pPtlHimetric,
  [in, out] POINTF *pPtfContainer,
  [in]      DWORD  dwFlags
);

Параметры

[in, out] pPtlHimetric

Адрес структуры POINTL , содержащей координаты, выраженные в единицах HIMETRIC . Это параметр [in], если dwFlags содержит XFORMCOORDS_HIMETRICTOCONTAINER; это параметр [out] с XFORMCOORDS_CONTAINERTOHIMETRIC. В последнем случае содержимое не определено при ошибке.

[in, out] pPtfContainer

Адрес структуры POINTF , выделенной вызывающим объектом, которая получает преобразованные координаты. Это параметр [in], если dwFlags содержит XFORMCOORDS_CONTAINERTOHIMETRIC; Это параметр [out] с XFORMCOORDS_HIMETRICTOCONTAINER. В последнем случае содержимое не определено при ошибке.

[in] dwFlags

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

Значение Значение
XFORMCOORDS_POSITION
0x1
 Преобразуемая координата представляет точку положения. Не может использоваться с XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE
0x2
 Преобразуемая координата представляет собой набор измерений. Не может использоваться с XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER
0x4
 Операция преобразует pptlHimetric в pptfContainer. Не может использоваться с XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC
0x8
 Операция преобразует pptfContainer в pptlHimetric. Не может использоваться с XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT
0x10
 Операция поддерживает совместимость с событием.

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.
E_NOTIMPL
 Контейнеру не требуются специальные преобразования координат. Контейнер полностью использует HIMETRIC.
E_POINTER
 Недопустимый адрес в pPtlHimetric или pPtfContainer . Например, он может иметь значение NULL.

Комментарии

Элемент управления использует этот метод, когда ему необходимо отправить координаты в контейнер в рамках события или другого пользовательского вызова или если элемент управления имеет координаты контейнера, которые ему необходимо преобразовать в единицы HIMETRIC .

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

См. также раздел

IOleControlSite