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

Corta o copia trazos de un objeto InkDisp existente y los pega en un nuevo objeto InkDisp , mediante el rectángulo conocido para determinar qué trazos se van a extraer.

Sintaxis

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

Parámetros

[in] Rectangle

Especifica el objeto InkRectangle que delimita la entrada de lápiz que se va a extraer del objeto InkDisp .

[in, optional] extractFlags

Opcional. Especifica el tipo de enumeración InkExtractFlags , que determina si la entrada de lápiz se debe cortar o copiar del objeto InkDisp existente. El valor predeterminado es IEF_DEFAULT, que corta los trazos del objeto InkDisp existente.

[out, retval] ExtractedInk

Cuando este método vuelve, contiene un puntero a un objeto InkDisp que contiene la colección extraída de trazos.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

El nuevo objeto InkDisp conserva los atributos, propiedades y coordenadas de dibujo del objeto InkDisp original.

Este método es útil para crear un nuevo objeto InkDisp sin los trazos eliminados o cortados del objeto original.

Para extraer trazos de una colección conocida de trazos, llame al método ExtractStrokes.

Solo se agrega la parte de un trazo dentro del rectángulo al nuevo objeto InkDisp .

Cuando el parámetro extractFlags es RemoveFromOriginal o Default, los trazos que cruzan el rectángulo se dividen y la parte del rectángulo se quita del objeto InkDisp existente.

Requisitos

Consulte también

ExtractStrokes (método)

IInkDisp

Clase InkDisp

InkExtractFlags (enumeración)

Clase InkRectangle

InkStrokes (colección)