Método IInkDisp::HitTestCircle (msinkaut.h)
Recupera a coleção InkStrokes que está completamente dentro ou interseccionada por um círculo conhecido.
Sintaxe
HRESULT HitTestCircle(
[in] long X,
[in] long Y,
[in] float radius,
[out, retval] IInkStrokes **Strokes
);
Parâmetros
[in] X
A posição x do centro do círculo de teste de clique em unidades de espaço à tinta.
[in] Y
A posição y do centro do círculo de teste de ocorrência em unidades de espaço à tinta.
[in] radius
O raio do círculo a ser usado no teste de ocorrência, em unidades de espaço à tinta.
[out, retval] Strokes
Quando esse método retorna, contém a coleção de traços que estão completamente dentro ou intersecionados pelo círculo especificado.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Um parâmetro continha um ponteiro inválido. |
|
Ocorreu uma exceção dentro do método . |
|
Identificador de exibição inválido. |
|
Parâmetro inesperado ou tipo de propriedade. |
Comentários
Se um traço cruzar o círculo, o traço completo será retornado.
O método calcula a interseção, considerando o conjunto completo de atributos de desenho que se aplicam ao traço, incluindo a largura completa da caneta, a suavização de Bezier (se presente) e a forma da ponta da caneta.
Depois que uma rotação ou transformação de tesoura tiver sido executada em um traço ou em uma coleção de traços, as coordenadas transformadas x- e y- não serão mais concêntricas com as coordenadas originais. Por isso, o radius argumento não deve ser calculado com base nas x- coordenadas ou y- .
Para determinar quais pontos de um traço conhecido cruzam a área de teste, chame o método HitTest do objeto IInkStrokeDisp .
O aplicativo deve sempre passar um ponteiro de destino para a coleção resultante de traços. Se não houver interseções, a coleção terá uma contagem de zero.
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)