Share via

Método IInkStrokeDisp::GetFlattenedBezierPoints (msinkaut.h)

  • Artigo

Recupera a caixa delimitadora em coordenadas de espaço à tinta para todos os traços em um objeto InkDisp , um traço individual ou uma coleção InkStrokes .

Sintaxe

HRESULT GetFlattenedBezierPoints(
  [in, optional] long    FittingError,
  [out, retval]  VARIANT *FlattenedBezierPoints
);

Parâmetros

[in, optional] FittingError

Opcional. A distância máxima (precisão), usando unidades de espaço à tinta, entre os pontos de controle Bezier e os pontos do traço. Isso também é conhecido como o nível de erro de ajuste de curva. O valor padrão é 0.

[out, retval] FlattenedBezierPoints

Quando esse método retorna, contém uma matriz de pontos que indica os pontos que foram usados para desenhar a representação de curva de Bezier do objeto IInkStrokeDisp . O resultado variant contém uma matriz no formato x1, y1, x2, y2 e assim por diante, dos pontos bezier.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
TPC_E_INVALID_STROKE
 O traço é inválido.
E_POINTER
 Um parâmetro continha um ponteiro inválido.
E_FAIL
 Ocorreu um erro não especificado.
E_OUTOFMEMORY
 Não é possível alocar o objeto auxiliar do manipulador stroke.
E_INVALIDARG
 O erro de ajuste estava fora do intervalo.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .
E_UNEXPECTED
 Parâmetro inesperado ou tipo de propriedade.

Comentários

O ideal é definir o parâmetro fittingError entre 0 e 500. Se o valor for maior que 500, um traço poderá parecer distorcido ou grosseiro quando desenhado. Os traços parecem mais suaves quando o nível de erro de ajuste é definido como 0, mas o desempenho do desenho é mais lento nesse nível.

Requisitos

   
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

Confira também

IInkStrokeDisp Interface

Propriedade IInkStrokeDisp::BezierPoints