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

Artigo
03/05/2024

Corta ou copia traços de um objeto InkDisp existente e cola-os em um novo objeto InkDisp , usando o retângulo conhecido para determinar quais traços extrair.

Sintaxe

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

Parâmetros

[in] Rectangle

Especifica o objeto InkRectangle que delimita a tinta a ser extraída do objeto InkDisp .

[in, optional] extractFlags

Opcional. Especifica o tipo de enumeração InkExtractFlags , que determina se a tinta deve ser recortada ou copiada do objeto InkDisp existente. O valor padrão é IEF_DEFAULT, que corta os traços do objeto InkDisp existente.

[out, retval] ExtractedInk

Quando este método retorna, contém um ponteiro para um objeto InkDisp que contém a coleção extraída de traços.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Um parâmetro continha um ponteiro inválido.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .
E_INK_SOME_STROKES_NOT_EXTRACTED	Nem todos os traços foram extraídos.
E_OUTOFMEMORY	Não é possível alocar memória para concluir a operação.
E_INVALIDARG	Sinalizadores de extração inválidos.
REGDB_CLASSNOTREG	O objeto Ink não foi registrado.

Comentários

O novo objeto InkDisp retém os atributos de desenho, as propriedades e as coordenadas do objeto InkDisp original.

Esse método é útil para criar um novo objeto InkDisp sem os traços excluídos ou cortados do objeto original.

Para extrair traços de uma coleção conhecida de traços, chame o Método ExtractStrokes.

Somente a parte de um traço que está dentro do retângulo é adicionada ao novo objeto InkDisp .

Quando o parâmetro extractFlags é RemoveFromOriginal ou Default, todos os traços que cruzam o retângulo são divididos e a parte dentro do retângulo é removida do objeto InkDisp existente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	msinkaut.h
Biblioteca	InkObj.dll