Método IOleControlSite::TransformCoords (ocidl.h)

  • Artigo

Converte coordenadas expressas em unidades HIMETRIC (como é padrão em OLE) para as unidades especificadas pelo contêiner.

Sintaxe

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

Parâmetros

[in, out] pPtlHimetric

Endereço de uma estrutura POINTL que contém coordenadas expressas em unidades HIMETRIC . Esse é um parâmetro [in] quando dwFlags contém XFORMCOORDS_HIMETRICTOCONTAINER; é um parâmetro [out] com XFORMCOORDS_CONTAINERTOHIMETRIC. No último caso, o conteúdo é indefinido em caso de erro.

[in, out] pPtfContainer

Endereço de uma estrutura POINTF alocada pelo chamador que recebe as coordenadas convertidas. Esse é um parâmetro [in] quando dwFlags contém XFORMCOORDS_CONTAINERTOHIMETRIC; é um parâmetro [out] com XFORMCOORDS_HIMETRICTOCONTAINER. No último caso, o conteúdo é indefinido em caso de erro.

[in] dwFlags

Sinalizadores que indicam a conversão exata a ser executada. Esse parâmetro pode ser qualquer combinação dos valores a seguir, exceto conforme indicado.

Valor Significado
XFORMCOORDS_POSITION
0x1
 As coordenadas a serem convertidas representam um ponto de posição. Não pode ser usado com XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE
0x2
 As coordenadas a serem convertidas representam um conjunto de dimensões. Não pode ser usado com XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER
0x4
 A operação converte pptlHimetric em pptfContainer. Não pode ser usado com XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC
0x8
 A operação converte pptfContainer em pptlHimetric. Não pode ser usado com XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT
0x10
 A operação mantém a compatibilidade com um evento.

Valor retornado

Esse método pode retornar os valores retornados padrão E_INVALIDARG e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_NOTIMPL
 O contêiner não requer conversões de coordenadas especiais. O contêiner lida completamente com HIMETRIC.
E_POINTER
 O endereço em pPtlHimetric ou pPtfContainer não é válido. Por exemplo, pode ser NULL.

Comentários

Um controle usa esse método quando precisa enviar coordenadas para um contêiner dentro de um evento ou alguma outra chamada personalizada ou quando o controle tem coordenadas de contêiner que precisa converter em unidades HIMETRIC .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Iolecontrolsite