Método IStrokeBuilder::CreateStroke (rtscom.h)

Artigo
03/13/2024

Cria traços em um objeto de tinta usando dados de pacote provenientes de um objeto Classe RealTimeStylus .

Sintaxe

HRESULT CreateStroke(
  [in]      ULONG                 cPktBuffLength,
  [in]      const LONG            *pPackets,
  [in]      ULONG                 cPacketProperties,
  [in]      const PACKET_PROPERTY *pPacketProperties,
  [in]      FLOAT                 fInkToDeviceScaleX,
  [in]      FLOAT                 fInkToDeviceScaleY,
  [in, out] IInkStrokeDisp        **ppIInkStroke
);

Parâmetros

[in] cPktBuffLength

O número de LONGs na matriz pPackets não o tamanho em bytes. Os valores válidos estão entre 0 e 0x000FFFFF, inclusive.

[in] pPackets

Um ponteiro para o início dos dados do pacote.

[in] cPacketProperties

A contagem de longs no buffer pPacketProperties . Esse é o número de pacotes multiplicados pelo número de propriedades. Os valores válidos estão entre 0 e 32, inclusive.

[in] pPacketProperties

O buffer que contém as propriedades do pacote.

[in] fInkToDeviceScaleX

O fator de conversão horizontal, ou eixo x, para o eixo horizontal, do espaço à tinta para as coordenadas do digitalizador.

[in] fInkToDeviceScaleY

O fator de conversão vertical ou do eixo y para o eixo vertical, do espaço à tinta para as coordenadas do digitalizador.

[in, out] ppIInkStroke

Um ponteiro para o traço recém-criado. Esse valor pode ser NULL.

Retornar valor

Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.

Comentários

Os parâmetros fInkToDeviceScaleX e fInkToDeviceScaleY afetam a representação interna de traços criados com o método método IStrokeBuilder::CreateStroke . Multiplique a coordenada x no espaço à tinta por fInkToDeviceScaleX para obter a coordenada x em unidades de digitalizador. Multiplique a coordenada y no espaço à tinta por fInkToDeviceScaleY para obter a coordenada y em unidades de digitalizador.

Para recuperar os parâmetros de escala, use o Método IRealTimeStylus::GetPacketDescriptionData.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	rtscom.h
DLL	RTSCom.dll