Método IInkStrokeDisp::FindIntersections (msinkaut.h)

  • Artigo

Recupera os pontos em que esse objeto IInkStrokeDisp cruza outros objetos IInkStrokeDisp em uma coleção inkStrokes conhecida.

Sintaxe

HRESULT FindIntersections(
  [in]          IInkStrokes *Strokes,
  [out, retval] VARIANT     *Intersections
);

Parâmetros

[in] Strokes

A coleção conhecida de traços que são usados para calcular os pontos em que esse traço cruza traços na coleção. Se FOR NULL, use todos os traços no objeto InkDisp .

Nota A coleção conhecida de traços deve vir do mesmo objeto InkDisp que o traço que está sendo testado para interseção. Se não for do mesmo objeto InkDisp , E_INK_MISMATCHED_INK_OBJECT será retornado (consulte "Valor HRESULT" abaixo). O método FindIntersections é a única API (interface de programação de aplicativo) do Tablet PC que exige que a coleção conhecida de traços venha do mesmo objeto InkDisp .
 

[out, retval] Intersections

Quando esse método retorna, contém uma matriz de valores de índice de ponto flutuante que indicam os locais em que esse traço cruza traços dentro de uma coleção conhecida de traços.

Um índice de ponto flutuante é um valor float que representa um local em algum lugar entre dois pontos no traço. Como exemplos, se 0,0 for o primeiro ponto no traço e 1,0 for o segundo ponto no traço, 0,5 estará no meio do caminho entre o primeiro e o segundo pontos. Da mesma forma, um valor de índice de ponto flutuante de 37,25 representa um local de 25% ao longo da linha entre os pontos 37 e 38 do traço.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

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_OUTOFMEMORY
 Não é possível alocar um objeto auxiliar do identificador IInkStrokeDisp .
E_UNEXPECTED
 Parâmetro inesperado ou tipo de propriedade.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .
E_INK_INCOMPATIBLE_OBJECT
 O parâmetro strokes não aponta para um objeto InkDisp compatível.
E_INK_MISMATCHED_INK_OBJECT
 O objeto InkDisp da coleção InkStrokes e esse objeto IInkStrokeDisp não correspondem.

Comentários

Esse método pode determinar apenas os pontos de interseção.

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

Confira também

Método GetRectangleIntersections

IInkStrokeDisp Interface

Coleção InkStrokes