Método IInkRenderer::D rawStroke (msinkaut.h)

Artigo
03/08/2023

Desenha o objeto IInkStrokeDisp usando o contexto de dispositivo conhecido e, opcionalmente, desenha o objeto IInkStrokeDisp com o objeto InkDrawingAttributes conhecido.

Sintaxe

HRESULT DrawStroke(
  [in]           LONG_PTR              hDC,
  [in]           IInkStrokeDisp        *Stroke,
  [in, optional] IInkDrawingAttributes *DrawingAttributes
);

Parâmetros

[in] hDC

O hWnd do contexto do dispositivo no qual desenhar.

[in] Stroke

O traço a ser desenhado.

[in, optional] DrawingAttributes

Opcional. Especifica o InkDrawingAttributes a ser usado no desenho. O valor padrão é NULL. Se InkDrawingAttributes for especificado, eles substituirão DrawingAttributes no IInkStrokeDisp.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Um parâmetro continha um ponteiro inválido.
E_INK_MISMATCHED_INK_OBJECT	O parâmetro strokes está associado a um objeto InkDisp diferente.
E_INVALIDARG	Identificador de exibição inválido.
E_INK_INCOMPATIBLE_OBJECT	O traço ou o parâmetro drawingAttributes não aponta para um objeto válido.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .
E_UNEXPECTED	Parâmetro ou tipo de propriedade inesperado.

Comentários

A largura da caneta é multiplicada (ou dimensionada) pela raiz quadrada do determinante da transformação de exibição.

Nota Se você não tiver definido a largura da caneta explicitamente, ela será 53 por padrão. Você deve multiplicar a largura da caneta pela raiz quadrada do determinante para produzir a caixa delimitadora correta. A altura e a largura da caixa delimitadora são expandidas pela metade desse valor em cada direção.

Por exemplo, considere que a largura da caneta é 53, a raiz quadrada do determinante é 50 e a caixa delimitadora é (0,0.1000.1000). O ajuste de largura da caneta para a caixa delimitadora em cada direção é calculado como (53*50)/2, e os lados direito e inferior são incrementados em um. Isso resulta em uma caixa delimitadora renderizada de (-1325,-1325.2326.2326).

O InkRenderer força as origens do visor e da janela a 0, 0. Todas as configurações existentes são salvas e restauradas, mas não são usadas pelo InkRenderer. Para executar a rolagem, use a exibição do objeto InkRenderer e os métodos de transformação de objeto.

Requisitos


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	msinkaut.h
Biblioteca	InkObj.dll