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

Artículo
02/29/2024

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.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .
E_INK_SOME_STROKES_NOT_EXTRACTED	No se extrajeron todos los trazos.
E_OUTOFMEMORY	No se puede asignar memoria para completar la operación.
E_INVALIDARG	Marcas de extracción no válidas.
REGDB_CLASSNOTREG	El objeto Ink no se registró.

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

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