Метод 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	Не удается выделить вспомогательный объект обработчика инсульта.
E_INVALIDARG	Недопустимый параметр.
E_UNEXPECTED	Непредвиденный параметр или тип свойства.
E_INK_EXCEPTION	Исключение произошло внутри метода.

Замечания

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

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

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows XP Планшетный выпуск PC Edition [только классические приложения]
минимальный поддерживаемый сервер	Ни одна версия не поддерживается
целевая платформа	Windows
Header	msinkaut.h

См. также

Интерфейс IInkStrokeDisp