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

Artigo
02/29/2024

Recupera os traços dentro de uma área de seleção de polilinha.

Sintaxe

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Parâmetros

[in] Points

Os pontos usados na ferramenta de seleção para selecionar os traços. A área de seleção é a área dentro do limite de seleção em que o limite se cruza pela primeira vez. Se o limite não se cruzar, o método adicionará um ponto ao final da matriz para criar uma linha reta do primeiro ao último ponto. Se o limite for uma linha reta (nenhuma área dentro do limite de seleção), nenhum traço será selecionado.

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

[in] IntersectPercent

O percentual de pontos de traço que devem estar contidos na ferramenta de seleção para incluir o traço na coleção resultante de traços. Se zero (0), todos os traços contidos ou interseccionados pela ferramenta de seleção serão incluídos na coleção resultante de traços. Se 100, apenas traços totalmente contidos na ferramenta de seleção serão incluídos na coleção. Os traços que cruzam a ferramenta de seleção serão incluídos na coleção se o percentual de pontos nesses traços contidos na ferramenta de seleção for maior ou igual à porcentagem percentIntersect . Porcentagens fracionárias são arredondadas para cima.

[in, out, optional] LassoPoints

Opcional. Recupera a parte específica da ferramenta de seleção usada para a seleção. Como um usuário pode desenhar muitos tipos diferentes de ferramentas de seleção, algumas das quais se sobrepõem várias vezes, isso pode ser útil para ilustrar qual parte da ferramenta de seleção foi usada para seleção. O valor padrão é um ponteiro NULL , o que significa que nenhuma informação é retornada.

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

[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.
E_OUTOFMEMORY	Não é possível alocar a operação de memória.

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(Rectangle, Single)

Iinkdisp

Classe InkDisp

Coleção InkStrokes

Compartilhar via