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

Establece los puntos de IInkStrokeDisp mediante una matriz de valores X e Y.

Sintaxis

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

Parámetros

[in] Points

Matriz de nuevos puntos para reemplazar los puntos del trazo que comienza en el índice. Se trata de una VARIANTE que contiene una matriz de Long con los puntos representados por valores alternados de la forma x0, y0, x1, y1, x2, y2, etc.

Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.

[in, optional] Index

Opcional. Índice de base cero del primer punto del trazo que se va a modificar. El valor predeterminado ISC_FirstElement, definido en el tipo de enumeración ItemSelectionConstants , especifica que se modifica el primer punto del trazo.

[in, optional] Count

Opcional. Recuento de puntos del trazo que se va a modificar. El valor predeterminado ISC_AllElements, definido en el tipo de enumeración ItemSelectionConstants , especifica que se modifican todos los puntos del trazo.

[out, retval] NumberOfPointsSet

Cuando este método vuelve, contiene el número real de paquetes establecidos.

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_INVALIDARG	Índice no válido (fuera del intervalo) o parámetro points. No estaba en el formato correcto.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .

Comentarios

Este método no cambia el número de puntos del trazo. Para cambiar el número de puntos del trazo, se debe crear un nuevo trazo o el trazo debe dividirse.

Este método no proporciona para truncar el trazo. Si la matriz de puntos contiene menos puntos que el trazo, el resto de los puntos del trazo no se modificarán.

Este método no proporciona para extender el trazo. Si la matriz de puntos contiene más puntos que el trazo, no se usan los puntos adicionales. Si el recuento supera el número de puntos de la matriz, solo se modifica el número de puntos de la matriz.

Para dibujar el trazo después de llamar a SetPoints, llame a la función InvalidateRect .

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

Consulte también

IInkStrokeDisp (Interfaz)

ItemSelectionConstants (enumeración)