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