Compartilhar via

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

  • Artigo

Define os pontos do IInkStrokeDisp usando uma matriz de valores X e Y.

Sintaxe

HRESULT SetPoints(
  [in]           VARIANT Points,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPointsSet
);

Parâmetros

[in] Points

A matriz de novos pontos para substituir os pontos no traço que começa no índice. Esta é uma VARIANT que contém uma matriz de Long com os pontos representados por valores alternados do formato x0, y0, x1, y1, x2, y2 e assim por diante.

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

[in, optional] Index

Opcional. O índice baseado em zero do primeiro ponto no traço a ser modificado. O valor padrão ISC_FirstElement, definido no tipo de enumeração ItemSelectionConstants , especifica que o primeiro ponto no traço é modificado.

[in, optional] Count

Opcional. A contagem de pontos no traço a ser modificado. O valor padrão ISC_AllElements, definido no tipo de enumeração ItemSelectionConstants , especifica que todos os pontos no traço são modificados.

[out, retval] NumberOfPointsSet

Quando esse método retorna, contém o número real de pacotes definidos.

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_INVALIDARG
 Índice inválido (fora do intervalo) ou parâmetro de pontos. Não estava no formato correto.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .

Comentários

Esse método não altera o número de pontos no traço. Para alterar o número de pontos no traço, um novo traço deve ser criado ou o traço deve ser dividido.

Esse método não fornece para truncar o traço. Se a matriz de pontos contiver menos pontos do que o traço, o restante dos pontos no traço não será modificado.

Esse método não fornece para estender o traço. Se a matriz de pontos contiver mais pontos do que o traço, os pontos extras não serão usados. Se a contagem exceder o número de pontos na matriz, somente o número de pontos na matriz será modificado.

Para desenhar o traço depois de chamar SetPoints, chame a função InvalidateRect .

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

Confira também

IInkStrokeDisp Interface

Enumeração ItemSelectionConstants