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

Quita partes de un objeto IInkStrokeDisp o una colección InkStrokes que están fuera de un rectángulo.

Sintaxis

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Parámetros

[in] Rectangle

Especifica el rectángulo fuera del cual se recortan los trazos o trazos. El rectángulo se especifica en coordenadas de espacio de entrada de lápiz.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Un parámetro contenía un puntero no válido.
REGDB_CLASSNOTREG	El objeto InkDisp no está registrado.
E_INVALIDARG	Rectángulo de clip no válido.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .
E_FAIL	Se ha producido un error no especificado.

Comentarios

Para un objeto InkDisp , todos los trazos intersecados por el rectángulo se dividen en los puntos de intersección. Todas las partes de trazos fuera del rectángulo se quitan del objeto InkDisp . El método puede agregar nuevos puntos a un trazo en el punto donde el trazo interseca el rectángulo. Después de llamar al método Clip en un objeto InkDisp , se garantiza que los identificadores de los trazos de la colección strokes del objeto InkDisp sean únicos, pero no se garantiza que conserven otra información.

Este método no tiene en cuenta el ancho del lápiz al recortar. Solo se recortan los datos reales de lápiz o trazo.

Para un objeto IInkStrokeDisp o una colección InkStrokes , el método Clip actualiza el objeto Primario InkDisp . Cada vez que se quita la entrada de lápiz de un objeto InkDisp , se pueden invalidar los objetos IInkStrokeDisp o las colecciones InkStrokes definidas para ese objeto InkDisp .

Para obtener más información sobre los datos de entrada de lápiz, consulte Datos de entrada de lápiz.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll

Consulte también

HitTest(Rectangle, Single) (Método)

IInkDisp

InkDisp (clase)

InkRectangle (clase)