Partilhar via


CRect::PtInRect

Determina se o ponto especificado está dentro de CRect.

BOOL PtInRect( 
   POINT point  
) const throw( );

Parâmetros

  • point
    Contém uma estrutura de PONTO ou um objeto de CPoint .

Valor de retorno

Diferente de zero se o ponto está dentro de CRect; se não 0.

Comentários

Um ponto está dentro de CRect se encontra no lado esquerdo ou superior ou está dentro de todos os quatro lados.Um ponto para o lado ou direita inferior é CRectexterno.

ObservaçãoObservação

O retângulo deve ser normalizado ou essa função pode falhar.Você pode chamar NormalizeRect para normalizar o retângulo antes de chamar a função.

Exemplo

CRect rect(5, 5, 100, 100);
CPoint pt1(35, 50);
CPoint pt2(125, 298);

// this is true, because pt1 is inside the rectangle
ASSERT(rect.PtInRect(pt1));

// this is NOT true, because pt2 is outside the rectangle
ASSERT(!rect.PtInRect(pt2));

// note that the right and the bottom aren't inside
ASSERT(!rect.PtInRect(CPoint(35, 100)));
ASSERT(!rect.PtInRect(CPoint(100, 98)));

// but the top and the left are inside
ASSERT(rect.PtInRect(CPoint(5, 65)));
ASSERT(rect.PtInRect(CPoint(88, 5)));

// and that PtInRect() works against a POINT, too
POINT pt;
pt.x = 35;
pt.y = 50;
ASSERT(rect.PtInRect(pt));   

Requisitos

Cabeçalho: atltypes.h

Consulte também

Referência

Classe de CRect

Gráfico de hierarquia

CRect::NormalizeRect

PtInRect