Método ShapeElement.DoHitTest (PointD, DiagramHitTestInfo, Boolean)

Artigo
05/22/2013

Retorna true se o ponto especificado estiver dentro da forma.

Namespace: Microsoft.VisualStudio.Modeling.Diagrams
Assembly: Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0 (em Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0.dll)

Sintaxe

'Declaração
Public Overridable Function DoHitTest ( _
    point As PointD, _
    hitTestInfo As DiagramHitTestInfo, _
    includeTolerance As Boolean _
) As Boolean

public virtual bool DoHitTest(
    PointD point,
    DiagramHitTestInfo hitTestInfo,
    bool includeTolerance
)

Parâmetros

point
Tipo: Microsoft.VisualStudio.Modeling.Diagrams.PointD
Um ponto no diagrama, em relação à forma pai.

hitTestInfo
Tipo: Microsoft.VisualStudio.Modeling.Diagrams.DiagramHitTestInfo
O objeto que receberá os resultados de teste de visita, mostrando qual forma filha ou campo sofreu hit.

includeTolerance
Tipo: System.Boolean
True para incluir a área ao redor da forma de limite, quando for realizado o teste de ocorrência; Caso contrário, false.

Valor de retorno

Tipo: System.Boolean
VERDADEIRO se a forma foi atingida; Caso contrário, false.

Comentários

Se o método retorna true, a hitTestInfo indica o DiagramItem que realmente foi atingido, o que pode ser um filho da forma.

Em vez de chamar isso diretamente a partir de um comando, considere substituindo OnClick() ou OnDoubleClick(), no qual o HitTestInfo é incluído o argumento.

Exemplos

public override global::System.Windows.Forms.Cursor GetCursor(global::System.Windows.Forms.Cursor currentCursor, DslDiagrams::DiagramClientView diagramClientView, DslDiagrams::PointD mousePosition)
{
if (this.MouseDownHitShape == null && currentCursor != global::System.Windows.Forms.Cursors.No)
{
DslDiagrams::DiagramHitTestInfo hitTestInfo = new DslDiagrams::DiagramHitTestInfo(diagramClientView);
this.Diagram.DoHitTest(mousePosition, hitTestInfo);
DslDiagrams::ShapeElement shape = hitTestInfo.HitDiagramItem.Shape;
}
return base.GetCursor(currentCursor, diagramClientView, mousePosition);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ShapeElement Classe

Sobrecargas DoHitTest

Namespace Microsoft.VisualStudio.Modeling.Diagrams

Partilhar via