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

Статья
08/25/2023

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

Синтаксис

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

Share via