다음을 통해 공유

IOleControlSite::TransformCoords 메서드(ocidl.h)

  • 아티클

HIMETRIC 단위로 표현된 좌표(OLE의 표준)를 컨테이너에서 지정한 단위로 변환합니다.

구문

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

매개 변수

[in, out] pPtlHimetric

HIMETRIC 단위로 표현된 좌표를 포함하는 POINTL 구조체의 주소입니다. dwFlags에 XFORMCOORDS_HIMETRICTOCONTAINER 포함된 경우 [in] 매개 변수입니다. XFORMCOORDS_CONTAINERTOHIMETRIC 있는 [out] 매개 변수입니다. 후자의 경우 콘텐츠는 오류 발생 시 정의되지 않습니다.

[in, out] pPtfContainer

변환된 좌표를 수신하는 호출자가 할당한 POINTF 구조체의 주소입니다. dwFlags에 XFORMCOORDS_CONTAINERTOHIMETRIC 포함된 경우 [in] 매개 변수입니다. XFORMCOORDS_HIMETRICTOCONTAINER 있는 [out] 매개 변수입니다. 후자의 경우 콘텐츠는 오류 발생 시 정의되지 않습니다.

[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
헤더 ocidl.h

추가 정보

IOleControlSite