Compartilhar via

Método IInkDisp::HitTestWithRectangle (msinkaut.h)

  • Artigo

Recupera os traços contidos em um retângulo especificado.

Sintaxe

HRESULT HitTestWithRectangle(
  [in]          IInkRectangle *SelectionRectangle,
  [in]          float         IntersectPercent,
  [out, retval] IInkStrokes   **Strokes
);

Parâmetros

[in] SelectionRectangle

O retângulo de seleção, do tipo InkRectangle, em coordenadas de espaço à tinta.

[in] IntersectPercent

O valor float ou percentual único que determina quais traços estão incluídos na coleção. Os traços que cruzam o retângulo serão incluídos na coleção se a porcentagem de pontos nesses traços contidos no retângulo for maior ou igual à porcentagem IntersectPercent .

[out, retval] Strokes

Quando esse método retorna, contém um ponteiro para a coleção de traços que compõe a tinta.

Retornar valor

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_EXCEPTION
 Ocorreu uma exceção dentro do método .
E_INVALIDARG
 Identificador de exibição inválido.

Comentários

Para determinar quais pontos de um traço conhecido cruzam a área de teste, chame o método GetRectangleIntersections do objeto IInkStrokeDisp , que recupera os pontos em que um traço cruza um retângulo conhecido.

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

Confira também

Método HitTest(Point, Single)

Método HitTest(Point[], Single)

Iinkdisp

Classe InkDisp

Coleção InkStrokes