Share via

Метод IInkStrokeDisp::SetPoints (msinkaut.h)

  • Статья

Задает точки IInkStrokeDisp с помощью массива значений X, Y.

Синтаксис

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

Параметры

[in] Points

Массив новых точек для замены точек в росчерке, начинающегося с индекса. Это variant, содержащий массив Long с точками, представленными чередующимися значениями x0, y0, x1, y1, x2, y2 и т. д.

Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.

[in, optional] Index

Необязательный элемент. Отсчитываемый от нуля индекс первой точки в штрихе, который необходимо изменить. Значение по умолчанию ISC_FirstElement, определенное в типе перечисления ItemSelectionConstants , указывает, что первая точка в росчерке изменяется.

[in, optional] Count

Необязательный элемент. Количество точек в штрихе, который необходимо изменить. Значение по умолчанию ISC_AllElements, определенное в типе перечисления ItemSelectionConstants , указывает, что все точки в росчерке изменяются.

[out, retval] NumberOfPointsSet

При возврате этим методом содержит фактическое количество пакетов, заданное.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
E_POINTER
 Параметр содержит недопустимый указатель.
E_INVALIDARG
 Недопустимый индекс (вне диапазона) или параметр points . Не в правильном формате.
E_INK_EXCEPTION
 В методе произошло исключение.

Комментарии

Этот метод не изменяет количество точек в росчерке. Чтобы изменить количество точек в росчерке, необходимо создать новый росчерк или разделить его.

Этот метод не обеспечивает усечение росчерка. Если массив точек содержит меньше точек, чем обводка, остальные точки в росчерке не изменяются.

Этот метод не обеспечивает расширение росчерка. Если массив точек содержит больше точек, чем штрих, дополнительные точки не используются. Если количество точек превышает количество точек в массиве, изменяется только количество точек в массиве.

Чтобы нарисовать росчерк после вызова SetPoints, вызовите функцию InvalidateRect .

Требования

Требование Значение
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header msinkaut.h
Библиотека InkObj.dll

См. также раздел

Интерфейс IInkStrokeDisp

Перечисление ItemSelectionConstants