Метод IInkAnalyzer::SetStrokesType

Статья
06/13/2023

Изменяет тип указанных штрихов.

Синтаксис

HRESULT SetStrokesType(
  [in] ULONG      strokeIdCount,
  [in] LONG       *plStrokes,
  [in] StrokeType StrokeType
);

Параметры

strokeIdCount [in]: Количество идентификаторов штрихов в plStrokes.
plStrokes [in]: Массив, содержащий идентификаторы штрихов, которым присваивается StrokeType.
StrokeType [in]: Значение StrokeType , присваиваемое штрихам.

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

Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.

Если тип росчерка является значением StrokeTypeStrokeType_Unclassified, IInkAnalyzer классифицирует росчерк во время анализа рукописного ввода. В противном случае IInkAnalyzer использует тип, заданный для росчерка.

IInkAnalyzer не задает значение типа росчерка в рамках анализа рукописного ввода. Чтобы указать или изменить тип штриха, используйте метод IInkAnalyzer::SetStrokeType или метод IInkAnalyzer::SetStrokesType.

Если росчерк связан с IContextNode , который не является неклассифицированным узлом рукописного ввода (см. раздел IContextNode::GetType), этот метод перемещает росчерк на неклассифицированный узел рукописного ввода, содержащий штрихи того же языка. Если такого узла контекста не существует, этот метод создает новый неклассифицированный узел рукописного ввода и добавляет в него росчерк. Неклассифицированный узел рукописного ввода — это IContextNode типа UnclassifiedInk.

Если этот метод перемещает штрих из IContextNode, который не является неклассифицированным узлом рукописного ввода, этот метод также добавляет ограничивающий прямоугольник росчерка в область грязное анализатора рукописного ввода (см. раздел Метод IInkAnalyzer::GetDirtyRegion).

Этот метод не перемещает штрих, если параметр StrokeType соответствует текущему типу штриха.

Если штрих, определенный в strokeIds, не связан с IInkAnalyzer, этот метод игнорирует идентификатор.

Если ни один из указанных штрихов не идентифицирует штрих, связанный с IInkAnalyzer, этот метод возвращает без обновления IInkAnalyzer.

Установка типа росчерка для штрихов, связанных с ContextNode с подтверждением NodeTypeAndProperties, вызовет исключение InvalidOperationException.

Этот метод возвращает код ошибки, если plStrokes имеет значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Заголовок	IACom.h (также требуется IACom_i.c)
DLL	IACom.dll

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

IInkAnalyzer
Метод IInkAnalyzer::GetStrokeType
Метод IInkAnalyzer::SetStrokeType
Справочник по анализу рукописного ввода

Share via