Поделиться через


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

Разбивает росчерк в указанном расположении на росчерке.

Синтаксис

HRESULT Split(
  [in]          float          SplitAt,
  [out, retval] IInkStrokeDisp **NewStroke
);

Параметры

[in] SplitAt

Значение индекса с плавающей запятой, представляющее место разделения росчерка.

Примечание Индекс с плавающей запятой — это значение с плавающей запятой, представляющее расположение где-то между двумя точками росчерка. Например, если 0,0 — первая точка в росчерке, а 1,0 — вторая точка в росчерке, 0,5 — на полпути между первой и второй точками. Аналогичным образом значение индекса с плавающей запятой 37,25 представляет собой расположение, которое составляет 25 процентов вдоль линии между точками 37 и 38 штриха.
 

[out, retval] NewStroke

При возврате этого метода содержит указатель на новый объект IInkStrokeDisp , созданный из операции разделения.

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

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

Код возврата Описание
S_OK
Успешно.
E_POINTER
Параметр содержал недопустимый указатель.
E_OUTOFMEMORY
Не удается выделить вспомогательный объект обработчика stroke.
E_INVALIDARG
Недопустимый параметр.
E_UNEXPECTED
Непредвиденный тип параметра или свойства.
E_INK_EXCEPTION
В методе произошло исключение.

Комментарии

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

При разделении IInkStrokeDisp начальная часть штриха остается идентификатором исходного IInkStrokeDisp. Конечная часть IInkStrokeDisp становится новым IInkStrokeDisp с идентификатором, который на один больше, чем самый высокий идентификатор IInkStrokeDisp . Если исходный IInkStrokeDisp находился в коллекции InkStrokes (кроме Ink.Strokes), в этой коллекции остается только начальная часть.

Требования

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

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

Интерфейс IInkStrokeDisp