Ссылка служб чернил

Чернила являются технологией, позволяющей пользователям вводить текст путем записи со стилусом на графическом планшете, не требуя никаких модификаций к приложению, получающему текст. Поскольку текст записан на планшете, он автоматически распознан и введен как поток ключевых вниз событий в документ или текстовое поле.

Прикладной программный интерфейс Ink Services обеспечивает ряд функций, который позволяет Вам настроить ввод Чернил для своего приложения. Используя Ink Services API, Вы можете:

Программно включите или выключите распознавание рукописного текста для своего приложения
Данные Чернил доступа на многократных уровнях (как точки и распознанный текст)
Жесты поддержки, позволяющие пользователю управлять текстом непосредственно
Установите задержанное распознавание или используйте по требованию распознавание
Интерпретации дополнительного текста доступа
Управляйте опциями для рисования Чернил
Создайте и завершите фразу Чернил

Ink Services предоставляет входные данные Чернил (текстовые интерпретации, жесты, и т.д) через менеджер событий Углерода. Ваше приложение должно установить один или несколько обработчиков, чтобы получить Связанные с чернилами события и извлечь соответствующие параметры от мероприятий до Вашего приложения.

Функции

Customizing Ink Services


    
    InkSetApplicationWritingMode (_:)
    InkSetApplicationWritingMode

Средства управления, где пользователю разрешают записать в текущем приложении.

Объявление

Swift

func InkSetApplicationWritingMode(_ iWriteWhere: InkApplicationWritingModeType)

Objective C

void InkSetApplicationWritingMode ( InkApplicationWritingModeType iWriteWhere );

Параметры


      iWriteWhere

Режимы Приложения, постоянные, который указывает режим записи Чернил для использования для приложения. Передача kInkWriteAnywhereInApp если Вы хотите, чтобы Ваше приложение позволило ввод Чернил и распознавание и получило события Ink, когда пользовательский режим записи установлен в kInkWriteInkAwareOnly. Когда Вы вызываете эту функцию с iWriteWhere набор параметра к kInkWriteAnywhereInApp, Ваше приложение может получить события Ink, расположения на экране которых лежат вне окон приложения. Передача kInkWriteNowhereInApp отключить ввод Чернил временно, такой как тогда, когда пользователь использует инструмент рисования.

Обсуждение

Можно вызвать функцию InkSetApplicationWritingMode управлять, когда ввод Чернил и распознавание позволяются в Вашем приложении. Используя эту функцию, можно включить или выключить Ink Services для приложения. Обратите внимание на то, что ввод Чернил доступен для Вашего приложения только, когда Ваше приложение является frontmost и когда пользователь включил распознавание в предпочтительной области Чернил.

Если Ваше приложение вызывает функцию InkSetApplicationWritingMode с параметром kInkWriteNowhereInApp отключить управление Ink Services перьевыми событиями, потому что Вы хотите накопить данные Чернил сами, знать, что Вы, возможно, должны управлять событием от нажатия мыши, объединяющим себя. Можно использовать функцию Кормушки События Углерода SetMouseCoalescingEnabled с этой целью. Посмотрите Using Ink Services в Своем Приложении для обсуждения объединения мыши.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkSetApplicationRecognitionMode (_:)
    InkSetApplicationRecognitionMode

Указывает, должен ли ввод Чернил быть интерпретирован как текст, жесты, оба или ни один.

Объявление

Swift

func InkSetApplicationRecognitionMode(_ iRecognitionType: InkRecognitionType)

Objective C

void InkSetApplicationRecognitionMode ( InkRecognitionType iRecognitionType );

Параметры


      iRecognitionType

Режим распознавания Вы хотите, чтобы Ink Services использовала. Передача kInkRecognitionGesture указать распознавание жеста, kInkRecognitionText указать распознавание текста, kInkRecognitionNone выключить распознавание, или kInkRecognitionDefault (который является kInkRecognitionGesture | kInkRecognitionText) указать и жест и распознавание текста. Посмотрите Режимы Распознавания для получения дополнительной информации о константах, которые можно предоставить.

Обсуждение

Эта функция только влияет на распознавание Чернил, происходящих от пользователя. Это не влияет на распознавание Чернил, происходящих из Вашего приложения и распознанных с помощью функции InkAddStrokeToCurrentPhrase. Обратите внимание на то, что только распознавание текста (не распознавание жеста) выполняется на потоке данных Чернил, происходящем из Вашего приложения.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkSetPhraseTerminationMode (_: _:)
    InkSetPhraseTerminationMode

Устанавливает условия, определяющие завершение фразы.

Объявление

Swift

func InkSetPhraseTerminationMode(_ iSource: InkSourceType, _ iAllowedTerminationTypes: InkTerminationType)

Objective C

void InkSetPhraseTerminationMode ( InkSourceType iSource, InkTerminationType iAllowedTerminationTypes );

Параметры


      iSource

Исходные Типы Чернил, постоянные, который указывает источник потока данных Чернил. Можно использовать одну из этих констант для получения независимого контроля над завершением данных, происходящих с пользователем по сравнению с данными, передающимися от приложения до Ink Services. Для управления завершением фразы для ввода данных пользователем передайте константу kInkSourceUser. Управлять завершением фразы для ввода приложения (который распознан с помощью функции InkAddStrokeToCurrentPhrase, передайте константу kInkSourceApplication.


      iAllowedTerminationTypes

Константа, указывающая условия, определяющие завершение фразы. Выключить автоматическое завершение фразы, передачу kInkTerminationNone. Можно восстановить поведение завершения фразы по умолчанию путем передачи константы kInkTerminationDefault. Посмотрите Режимы Завершения Фразы для получения дополнительной информации о константах, которые можно предоставить.

Обсуждение

Когда одно из следующих событий имеет место, поведение по умолчанию для Ink Services для завершения фразы:

Пользователь удаляет стилус из близости планшета
Установленный период времени протекает, в котором стилус не нажимается к планшету (Пользователь может управлять промежутком времени в предпочтительной области Чернил.)
Пользователь пишет достаточно далеко от предыдущих Чернил — или горизонтально, или на новой строке

Можно использовать функцию InkSetPhraseTerminationMode когда фразы Чернил завершаются, если Ваше приложение не хочет поведения по умолчанию или хочет полный контроль. Если Вы выключаете автоматическое завершение фразы, необходимо удостовериться, что Вы управляете завершением фразы соответственно для Вашего приложения.

Например, если Вы хотите вынудить Чернила, нарисованные в определенном входном окне быть обработанными как единственная фраза, пока пользователь не нажимает «законченный записанную» кнопку, Вы вызвали бы InkSetPhraseTerminationMode с параметром kInkTerminationNone выключить автоматическое завершение фразы. Тогда необходимо было бы установить обработчик событий Углерода для события kEventInkPoint. Ваш обработчик исследовал бы kEventInkPoint события, заметьте, когда перьевое вниз событие имеет место на «законченный записанной» кнопке, и затем завершите фразу путем вызывания функции InkTerminateCurrentPhrase. Посмотрите Using Ink Services в Своем Приложении для подробных данных о записи кода для обработки завершения фразы.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkSetDrawingMode (_:)
    InkSetDrawingMode

Средства управления, что нарисовано, когда пишет пользователь.

Объявление

Swift

func InkSetDrawingMode(_ iDrawingMode: InkDrawingModeType)

Objective C

void InkSetDrawingMode ( InkDrawingModeType iDrawingMode );

Параметры


      iDrawingMode

Режимы Получения, постоянные, который указывает режим получения для использования для приложения. Значение по умолчанию (kInkDrawInkAndWritingGuides) для Ink Services для рисования и руководств по записи Чернил и Чернил. Передача kInkDrawInkOnly если Вы хотите, чтобы Ink Services нарисовала только Чернила. Передача kInkDrawNothing выключить получение и руководств по записи Чернил и Чернил.

Обсуждение

Normally Ink Services рисует руководства по записи, подобный в смотрят на переменные сплошные и прерывистые линии, используемые на многой бумаге, пишущий планшеты. Сами Чернила нарисованы сглаженные и шкала полутонов. Ваше приложение может вызвать функцию InkSetDrawingMode запрашивать, чтобы Ink Services не нарисовала руководства по записи или не нарисовала или Чернила или руководства по записи. Если Рисунок тушью отключен, Ваше приложение должно получить очки (путем установки обработчика для kEventInkPoint события), и рисуют Чернила.

Вы не должны вызывать функцию InkSetDrawingMode запрещать получение, если Вы вызвали функцию InkSetApplicationWritingMode, передача значения kInkWriteNowhereInApp. Кроме того, Ink Services не нарисует точки для который a kEventInkPoint Возвраты обработчика событий углерода noErr.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.

Получение информации о службах чернил

InkUserWritingMode () InkUserWritingMode

Возвращает режим записи Чернил, установленный пользователем в предпочтительной области Чернил.

Объявление

Swift

func InkUserWritingMode() -> InkUserWritingModeType

Objective C

InkUserWritingModeType InkUserWritingMode ( void );

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

Значение, указывающее текущие настройки пользовательских настроек для Чернил: kInkWriteInInkAwareAppsOnly, kInkWriteAnywhere, или kInkWriteNowhere. В целом службы Ink не доступны если kInkWriteNowhere возвращается (указание, что пользователь выключил Чернила полностью). Посмотрите, что Пользователь Пишет Режимы для получения дополнительной информации о каждой из этих констант.

Обсуждение

Пользовательские настройки для Чернил установлены пользователем в области Ink Установок системы. Ваше приложение может только считать эти значения, не установить их.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
InkIsPhraseInProgress () InkIsPhraseInProgress

Возвраты, инициировала ли Ink Services и в настоящее время поддерживает фразу Чернил, источник которой является вводом данных пользователем.

Объявление

Swift

func InkIsPhraseInProgress() -> Boolean

Objective C

Boolean InkIsPhraseInProgress ( void );

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

Возвраты TRUE если пользователь в настоящее время занят вводом Чернил; FALSE иначе.

Обсуждение

Если Ваше приложение управляет своим собственным завершением фразы, необходимо использовать эту функцию, чтобы удостовериться, что существует фраза, которая может быть завершена, прежде чем Вы вызовете функцию InkTerminateCurrentPhrase. Не вызывайте эту функцию, если поток данных Чернил происходит из Вашего приложения, а не непосредственно из ввода данных пользователем. Поток данных приложения абсолютно независим от пользовательского потока данных. Если Ваше приложение создает свои собственные фразы Чернил путем вызывания функции InkAddStrokeToCurrentPhrase, это должно быть в состоянии дорожка, происходит ли такая фраза или нет.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.

Обработка фраз чернил


    
    InkAddStrokeToCurrentPhrase (_: _:)
    InkAddStrokeToCurrentPhrase

Добавляет штрих к текущей фразе Чернил.

Объявление

Swift

func InkAddStrokeToCurrentPhrase(_ iPointCount: UInt, _ iPointArray: UnsafeMutablePointer<InkPoint>)

Objective C

void InkAddStrokeToCurrentPhrase ( unsigned long iPointCount, InkPoint *iPointArray );

Параметры

`iPointCount`	Число элементов в `iPointArray` массив.
`iPointArray`	Указатель на массив `InkPoint` структуры, указывающие путь стилуса, начиная с точки, определяющей первое расположение стилуса вниз и заканчивающийся точкой, определяющей последнее расположение стилуса вниз.

Обсуждение

Эта функция воздействует на источник Чернил из приложения, а не на этом от прямого ввода данных пользователем. Таким образом, нет никакой потребности указать источник Чернил как kInkSourceApplication. Посмотрите Исходные Типы Чернил для получения дополнительной информации об источниках.

Вы не должны вызывать эту функцию, если у Вас нет необработанных данных для обработки, или Вы выключили автоматическое распознавание (путем вызывания функции InkSetApplicationWritingMode) и установили Ваше приложение для обработки входных событий Чернил само. Например, если Ваше приложение должно получить перьевые данные специфичным для устройства способом, Вы, возможно, должны были бы обработать ввод Чернил.

Если Ваше приложение обрабатывает входные события Чернил, оно может все еще использовать в своих интересах услугу распознавания, предоставленную Ink Services. Для этого Ваше приложение должно вызвать функцию InkAddStrokeToCurrentPhase добавить один штрих за один раз к текущей фразе. Вы тогда завершаете фразу в подходящее время путем вызывания функции InkTerminateCurrentPhrase. Обратите внимание на то, что вызов InkAddStrokeToCurrentPhase добавляет штрих к текущей фразе, но не рисует штрих. Посмотрите Using Ink Services в Своем Приложении для подробных данных о записи кода, использующего функцию InkAddStrokeToCurrentPhase реализовать задержанное распознавание.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTerminateCurrentPhrase (_:)
    InkTerminateCurrentPhrase

Завершает текущую фразу.

Объявление

Swift

func InkTerminateCurrentPhrase(_ iSource: InkSourceType)

Objective C

void InkTerminateCurrentPhrase ( InkSourceType iSource );

Параметры


      iSource

Исходные Типы Чернил, постоянные, который указывает источник потока данных Чернил. Завершать фразу, происходящую из ввода приложения (который распознан с помощью функции InkAddStrokeToCurrentPhrase), передайте константу kInkSourceApplication.

Если Вы управляете завершением фразы, происходящим из прямого ввода данных пользователем, можно передать константу kInkSourceUser. Обратите внимание на то, что эта функция обычно не используется этим способом, поскольку большинство приложений может позволить Ink Services завершить такие фразы автоматически.

Обсуждение

Вы не должны вызывать эту функцию, если Вы не выключили автоматическое завершение фразы (путем вызывания функции InkSetPhraseTerminationMode) и установили Ваше приложение для управления завершением фразы. Когда Вы вызываете функцию InkTerminateCurrentPhrase, любые Чернила, нарисованные Ink Services, стираются. Если Ваше приложение обрабатывает завершение фразы, оно может все еще использовать в своих интересах услугу распознавания, предоставленную Ink Services.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.

Работа с интерпретациями дополнительного текста


    
    InkTextAlternatesCount (_:)
    InkTextAlternatesCount

Возвращает число интерпретаций дополнительного текста, доступных для фразы Чернил.

Объявление

Swift

func InkTextAlternatesCount(_ iTextRef: InkText!) -> CFIndex

Objective C

CFIndex InkTextAlternatesCount ( InkTextRef iTextRef );

Параметры


      iTextRef

На вводе, ссылке на текстовый объект Чернил, указывающий слово Чернил, альтернативное количество которого Вы хотите получить. Необходимо получить ссылку текстового объекта Чернил (InkTextRef) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода kEventClassInk и вид события kEventInkText. Параметр события kEventParamInkTextRef то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.

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

Возвращает число интерпретаций, доступных для указанной фразы Чернил.

Обсуждение

Можно получить строку, связанную с текстовой интерпретацией путем вызывания функции InkTextCreateCFString. Если Вы хотите вывести на экран список интерпретаций дополнительного текста пользователю, вызовите функцию InkTextInsertAlternatesInMenu.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTextCreateCFString (_: _:)
    InkTextCreateCFString

Получает строку, связанную с текстовой интерпретацией фразы Чернил.

Объявление

Swift

func InkTextCreateCFString(_ iTextRef: InkText!, _ iIndex: CFIndex) -> Unmanaged<CFString>!

Objective C

CFStringRef InkTextCreateCFString ( InkTextRef iTextRef, CFIndex iAlternateIndex );

Параметры


      iTextRef

На вводе, ссылке на текстовый объект Чернил, указывающий слово Чернил, для которого Вы хотите создать строку. Необходимо получить ссылку текстового объекта Чернил (InkTextRef) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода kEventClassInk и вид события kEventInkText. Параметр события kEventParamInkTextRef то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.


      iIndex

Индекс, что specfies текстовая интерпретация, для которой Вы хотите получить a CFString. Текстовые интерпретации сохранены в массиве в оцениваемом порядке с наиболее вероятной интерпретацией в индексном нуле.

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

A CFStringRef это указывает интерпретацию для данной текстовой фразы Чернил. Возвраты NULL . Если индекс, который Вы обеспечиваете недопустим, Ваше приложение ответственно за выпуск возвращенного CFStringRef.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTextInsertAlternatesInMenu
    InkTextInsertAlternatesInMenu

Вставляет список интерпретаций дополнительного текста в меню.

Объявление

Objective C

ItemCount InkTextInsertAlternatesInMenu ( InkTextRef iTextRef, MenuRef iMenuRef, MenuItemIndex iAfterItem );

Параметры

`iTextRef`	На вводе, ссылке на текстовый объект Чернил, указывающий слово Чернил, для которого Вы хотите обеспечить список интерпретаций дополнительного текста. Необходимо получить ссылку текстового объекта Чернил (`InkTextRef`) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода `kEventClassInk` и вид события `kEventInkText`. Параметр события `kEventParamInkTextRef` то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.
`iMenuRef`	Ссылка на меню, в которое Вы хотите вставить список интерпретаций дополнительного текста. Ink Services присоединяет обработчики событий меню к этому меню, таким образом, необходимо использовать это `MenuRef` непосредственно, вместо того, чтобы скопировать элементы от ссылки меню до другого меню.
`iAfterItem`	Значение, указывающее пункт меню, после которого Вы хотите вставить список интерпретаций дополнительного текста. Если указанный пункт меню `0`, текстовые альтернативы вставляются во главе меню. Если указанный пункт меню больше, чем или равен существующему числу пунктов меню, текстовые альтернативы добавляются до конца меню. Помните, что пронумерован первый элемент в массиве пункта меню `1`, нет `0`.

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

Возвращает число пунктов меню, добавленных к меню. Возвраты 0 если работа не успешна.

Обсуждение

Функция InkTextInsertAlternatesInMenu позволяет Вашему приложению вставлять список текстовых интерпретаций для данной текстовой фразы Чернил в существующее контекстное меню. Необходимо обработать список интерпретаций дополнительного текста как стандартное контекстное меню с помощью менеджера по Меню функция ContextualMenuSelect.

Когда пользователь выбирает элемент из списка альтернатив, список альтернатив, сохраняемых Ink Services, переупорядочиваются автоматически. Если Вы вызываете функцию, это означает это InkTextCreateCFString с параметром iIndex набор к 0, Вы получаете недавно выбранный пункт.

Таким образом выбор пользователя сохраняется во внутренних системных структурах данных, не требуя, чтобы Ваше приложение вызвало дополнительные функции. Однако, Ваше приложение должно обновить свои собственные внутренние структуры данных соответственно.

Необходимо восстановить меню для отражения выбора пользователя. После того, как пользователь делает выбор и затем вновь открывает меню, необходимо удостовериться, что недавно-выбранный-пункт обнаруживается как первый элемент в меню. Элементы в меню должны зеркально отразить список альтернатив, сохраняемых Ink Services.

По возврату из функции ContextualMenuSelect, Ваше приложение может определить, сделал ли пользователь выбор путем проверки значения параметра outUserSelectionType. Значение указывает элемент, который пользователь выбрал из контекстного меню. Если существует выбор, Ваше приложение может исследовать outMenuID и outMenuItem параметры функции ContextualMenuSelect, и используйте эти значения для получения интерпретации дополнительного текста путем вызывания менеджера по Меню функция CopyMenuItemTextAsCFString.

Пункты меню для ряда альтернатив, первая буква которых является алфавитным символом всегда, включают альтернативу, первая буква которой является противоположным lettercase. Пункты меню для ряда альтернатив, первая буква которых является неалфавитным символом, не включают альтернативу lettercase.

Когда пункты меню переупорядочиваются автоматически, текст, который был первым в списке, перемещается во второе или третью позицию, в зависимости от того, является ли первая буква алфавитной или неалфавитной. Например, следующий список пунктов меню:

катастрофический отказ, Катастрофический отказ, давка, корка, wrash

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

давка, Давка, катастрофический отказ, корка, wrash

Заметьте, что список альтернатив сведен к длине пять. В то время как прописной альтернативный Катастрофический отказ отбрасывается, альтернатива lettercase для давки добавляется к меню.

Для неалфавитного первого символа, однако, такого как число, исходные перемещения к второй позиции. Таким образом для следующего меню:

1239, 1234, 1289, 1284

Если пользователь выбирает 1234, меню становится:

1234, 1239, 1289, 1284

Если для Вашего приложения важно поддержать первоначальный порядок альтернатив, то это должно использовать свои собственные внутренние структуры данных для отслеживания исходный список.

Посмотрите Using Ink Services в Своем Приложении для подробных данных о записи кода, использующего функцию InkTextInsertAlternatesInMenu реализовать модель исправления.

Оператор импорта

Objective C

@import Carbon;

Доступность

Доступный в OS X v10.3 и позже.

Не доступный 64-разрядным приложениям.

Работа с текстовыми объектами чернил


    
    InkTextKeyModifiers (_:)
    InkTextKeyModifiers

Возвращает значение, указывающее, что ключевые модификаторы применились к фразе Чернил.

Объявление

Swift

func InkTextKeyModifiers(_ iTextRef: InkText!) -> UInt32

Objective C

UInt32 InkTextKeyModifiers ( InkTextRef iTextRef );

Параметры


      iTextRef

На вводе, ссылке на текстовый объект Чернил, ключевые модификаторы которого Вы хотите получить. Необходимо получить ссылку текстового объекта Чернил (InkTextRef) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода kEventClassInk и вид события kEventInkText. Параметр события kEventParameterInkTextRef то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.

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

Возвращает значение, указывающее, какие модифицирующие клавиши снизились во время ввода фразы Чернил. Это значение находится в той же форме как используемый менеджером событий Углерода для параметра события kEventParamKeyModifiers.

Обсуждение

Если те ключи удерживаются больше чем для 50% точек штриха, Ink Services присваивает модифицирующие клавиши клавиатуры штриху. Ink Services присваивает модифицирующие клавиши, связанные с первым штрихом фразы ко всей фразе. Ink Services присваивает модифицирующие клавиши, связанные с фразой ко всем текстовым интерпретациям, полученным из фразы Чернил.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTextCopy (_:)
    InkTextCopy

Копирует существующий текстовый объект Чернил.

Объявление

Swift

func InkTextCopy(_ iTextRef: InkText!) -> Unmanaged<InkText>!

Objective C

InkTextRef InkTextCopy ( InkTextRef iTextRef );

Параметры


      iTextRef

На вводе ссылке на текстовый объект Чернил Вы хотите скопировать. Необходимо получить ссылку текстового объекта Чернил (InkTextRef) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода kEventClassInk и вид события kEventInkText. Параметр события kEventParameterInkTextRef то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.

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

Ссылка на недавно создаваемый текстовый объект Чернил.

Обсуждение

Когда текст копируется и вставляется, можно использовать эту функцию для реализации функций копии-и-вставки в задержанном приложении для распознавания, или в текстовом приложении для сохранения Чернил. Количество отставания нового InkTextRef 1.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTextBounds (_:)
    InkTextBounds

Возвращает границы текстового объекта Чернил.

Объявление

Swift

func InkTextBounds(_ iTextRef: InkText!) -> HIRect

Objective C

HIRect InkTextBounds ( InkTextRef iTextRef );

Параметры


      iTextRef

На вводе, ссылке на текстовый объект Чернил, границы которого Вы хотите получить. Необходимо получить ссылку текстового объекта Чернил (InkTextRef) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода kEventClassInk и вид события kEventInkText. Параметр события kEventParameterInkTextRef то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.

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

HIRect структура данных, определяющая границы указанного текстового объекта Чернил.

Обсуждение

Границы являются первоначально глобальными координатами и могут расшириться вне окон Вашего приложения.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTextDraw (_: _: _: _:)
    InkTextDraw

Перемасштабы и вовлекают текст Чернил в указанные границы.

Объявление

Swift

func InkTextDraw(_ iTextRef: InkText!, _ iContext: CGContext!, _ iBounds: UnsafePointer<CGRect>, _ iFlags: InkTextDrawFlagsType)

Objective C

void InkTextDraw ( InkTextRef iTextRef, CGContextRef iContext, const CGRect *iBounds, InkTextDrawFlagsType iFlags );

Параметры

`iTextRef`	На вводе, ссылке на текстовый объект Чернил, текст которого Вы хотите повторно масштабировать и нарисовать. Необходимо получить ссылку текстового объекта Чернил (`InkTextRef`) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода `kEventClassInk` и вид события `kEventInkText`. Параметр события `kEventParameterInkTextRef` то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.
`iContext`	`CGContext` в который Вы хотите нарисовать. Получение относительно указанного `CGContextRef`, и подвергающийся обычному окну и ограничениям отсечения. Передача `NULL` если Вы хотите нарисовать к каноническому контексту текущего порта.
`iBounds`	На вводе, a `CGRect` структура данных, указывающая границы, в которые Вы хотите, чтобы был нарисован текстовый объект Чернил.
`iFlags`	Текстовые Флаги Получения, постоянные, который указывает настройки получения. Передача `kInkTextDrawDefault` использовать параметры настройки системы по умолчанию при рисовании, `kInkTextDrawIgnorePressure` если Вы не хотите использовать давление чувствительные градиенты, и `kInkTextDrawHonorContext` t o используют текущие Кварцевые настройки контекста.

Обсуждение

Функция InkTextDraw полезно для приложений, реализующих задержанное распознавание или доступные для поиска Чернила. Исходные точки и границы текстового объекта Чернил масштабируются и смещаются для адаптации указанным границам, таким образом, последующие вызовы к функции InkTextBounds возвратите перемасштабированные границы.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.

InkTextGetTypeID () InkTextGetTypeID

Возвраты CFTypeID из InkTextRef объект.

Объявление

Swift

func InkTextGetTypeID() -> CFTypeID

Objective C

CFTypeID InkTextGetTypeID ( void );

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

CFTypeID из InkStrokeRef объект.

Обсуждение

Данный InkTextRef, эта функция возвращает CFTypeID.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.

Выравнивание и невыравнивание текстовых объектов чернил


    
    InkTextFlatten (_: _: _:)
    InkTextFlatten

Сглаживает текстовый объект Чернил для архивации.

Объявление

Swift

func InkTextFlatten(_ iTextRef: InkText!, _ ioDataRef: CFMutableData!, _ iIndex: CFIndex) -> CFIndex

Objective C

CFIndex InkTextFlatten ( InkTextRef iTextRef, CFMutableDataRef ioDataRef, CFIndex iIndex );

Параметры

`iTextRef`	На вводе ссылке на текстовый объект Чернил Вы хотите сгладиться. Необходимо получить ссылку текстового объекта Чернил (`InkTextRef`) через обработчик событий Чернил Вашего приложения. Ваш обработчик должен заботиться о классе событий Углерода `kEventClassInk` и вид события `kEventInkText`. Параметр события `kEventParameterInkTextRef` то, что Вы получаете из этого вида события, является ссылкой на текстовый объект Чернил.
`ioDataRef`	На вводе, ссылке на a `CFMutableData` тип данных. На выводе, относится к сглаженным данным. Ваше приложение ответственно за создание и выпуск `CFMutableDataRef`.
`iIndex`	Индекс, в котором Вы хотите, чтобы были записаны данные.

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

Возвращает число байтов, добавленных к ioDataRef. Возвраты 0 если работа неуспешна или iTextRef NULL или пустой.

Обсуждение

CFMutableData объекты расширяемы, что означает, что можно сгладить больше чем один текстовый объект Чернил в a CFMutableData объект. Вы храните данные в a CFMutableData объект путем указания индекса, в котором должны храниться данные. Функция InkTextFlatten принимает начальное значение индекса как входной параметр, пишут все данные текстового объекта Чернил в указанное CFMutableData объект и возвраты счет байта для объема данных, который фактически сохранен.

Сглаживать дополнительный текстовый объект Чернил в то же CFMutableData объект, необходимо предоставить значение для iIndex параметр, указывающий расположение байта, в котором можно начать писать данные для дополнительного текстового объекта Чернил. Можно вычислить это значение путем подведения итогов количества байта, возвращенного предыдущим вызовом со значением iIndex параметр Вы обеспечили в предыдущем вызове.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


    
    InkTextCreateFromCFData (_: _:)
    InkTextCreateFromCFData

Создает текстовый объект Чернил из ранее сглаженного текстового объекта Чернил.

Объявление

Swift

func InkTextCreateFromCFData(_ iFlattenedInkText: CFData!, _ iIndex: CFIndex) -> Unmanaged<InkText>!

Objective C

InkTextRef InkTextCreateFromCFData ( CFDataRef iFlattenedInkText, CFIndex iIndex );

Параметры

`iFlattenedInkText`	На вводе, ссылке на a `CFData` структура данных, содержащая данные от ранее сглаженного текстового объекта Чернил.
`iIndex`	Индекс, в котором можно начать считывать данные.

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

Возвращает ссылку на недавно создаваемый текстовый объект Чернил. Количество отставания недавно создаваемого текстового объекта Чернил равняется 1.

Обсуждение

Можно не сгладить текстовый объект Чернил, ранее сглаженный с помощью функции InkTextFlatten. Если Вы сгладили больше чем один текстовый объект Чернил к CFMutableData тип данных, тогда необходимо вызвать функцию InkTextCreateFromCFData для каждого текстового объекта Чернил Вы хотите не сгладиться, указывая индекс, определяющий запуск текстовых данных Чернил, которые Вы хотите не сгладить.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.

Работа с объектами штриха чернил


    
    InkTextGetStroke (_: _:)
    InkTextGetStroke

Возвращает ссылку на указанный штрих в InkTextRef.

Объявление

Swift

func InkTextGetStroke(_ iTextRef: InkText!, _ iStrokeIndex: CFIndex) -> Unmanaged<InkStroke>!

Objective C

InkStrokeRef InkTextGetStroke ( InkTextRef iTextRef, CFIndex iStrokeIndex );

Параметры

`iTextRef`	`InkTextRef` получить штрих от.
`iStrokeIndex`	Индекс штриха, для которого Вы хотите добраться `InkStrokeRef`.

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

InkStrokeRef для указанного штриха указанного InkTextRef.

Обсуждение

Данный InkTextRef и штриховой индекс (между 0 и InkTextGetStrokeCount( iTextRef ) - 1), эта функция возвращается InkStrokeRef соответствие указанному штриховому индексу. Для получения дополнительной информации посмотрите InkTextGetStrokeCount.

Возвращенный InkStrokeRef как гарантируют, сохранится только для жизни InkTextRef из которого это было получено. Если Вы хотите использовать InkStrokeRef после InkTextRef был выпущен, необходимо вызвать функцию CFRetain и передача InkStrokeRef к нему.

Когда любая ссылка на объект Чернил будет получена из события Carbon, она, как гарантируют, сохранится только для жизни обработчика событий. Если Вы хотите использовать объект в некоторое более позднее время, необходимо вызвать функцию CFRetain и передайте объект ему.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.

InkTextGetStrokeCount (_:) InkTextGetStrokeCount

Возвращает число штрихов в указанном InkTextRef.

Объявление

Swift

func InkTextGetStrokeCount(_ iTextRef: InkText!) -> CFIndex

Objective C

CFIndex InkTextGetStrokeCount ( InkTextRef iTextRef );

Параметры

iTextRef

InkTextRef получить штриховое количество от.

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

Число топит в указанном InkTextRef.

Обсуждение

Данный InkTextRef, эта функция возвращает число штрихов InkTextRef содержит.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.
InkStrokeGetPointCount (_:) InkStrokeGetPointCount

Возвращает число очков в указанном InkStrokeRef.

Объявление

Swift

func InkStrokeGetPointCount(_ iStrokeRef: InkStroke!) -> CFIndex

Objective C

CFIndex InkStrokeGetPointCount ( InkStrokeRef iStrokeRef );

Параметры

iStrokeRef

InkStrokeRef понять количество от.

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

A CFIndex указание числа очков содержится в указанном InkStrokeRef.

Обсуждение

Данный InkStrokeRef, эта функция возвращает число очков, которое содержит штрих. Используйте эту функцию для вычисления, надлежащий размер буфера передал InkStrokeGetPoints.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.


    
    InkStrokeGetPoints (_: _:)
    InkStrokeGetPoints

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

Объявление

Swift

func InkStrokeGetPoints(_ iStrokeRef: InkStroke!, _ oPointBuffer: UnsafeMutablePointer<InkPoint>) -> UnsafeMutablePointer<InkPoint>

Objective C

InkPoint * InkStrokeGetPoints ( InkStrokeRef iStrokeRef, InkPoint *oPointBuffer );

Параметры

`iStrokeRef`	`InkStrokeRef` понимать мысли от.
`oPointBuffer`	Буфер, в который должны быть скопированы данные точки.

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

Указатель на скопированный массив данных точки от указанного InkStrokeRef; это значение совпадает с oPointBuffer адрес, предоставленный приложением.

Обсуждение

Данный InkStrokeRef и буфер точки, эта функция заливки, буферизующие с точками, принадлежащими тому штриху.

Размер буфера точки должен быть, по крайней мере, размером InkStrokeGetPointCount( iStrokeRef ) * sizeof( InkPoint ). Для получения дополнительной информации посмотрите InkStrokeGetPointCount. Указатель на блок памяти, содержащей точки чернил, возвращается как результат.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.

InkStrokeGetTypeID () InkStrokeGetTypeID

Возвраты CFTypeID из InkStrokeRef объект.

Объявление

Swift

func InkStrokeGetTypeID() -> CFTypeID

Objective C

CFTypeID InkStrokeGetTypeID ( void );

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

CFTypeID из InkStrokeRef объект.

Обсуждение

Данный InkStrokeRef, эта функция возвращает CFTypeID.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.

Типы данных

InkTextRef InkTextRef

Определяет тип данных для ссылки на непрозрачный текстовый объект Чернил.

Объявление

Swift

typealias InkTextRef = InkText

Objective C

typedef struct OpaqueInkTextRef * InkTextRef;

Обсуждение

Необходимо использовать Базовые функции Основы CFRetain и CFRelease управлять отставанием и выпуском текстовых объектов Чернил. Когда текстовая ссылка Чернил будет получена из события Carbon, она, как гарантируют, сохранится только для жизни обработчика событий. Если Ваше приложение должно использовать текстовый объект Чернил в некоторое более позднее время, необходимо вызвать функцию CFRetain, передача объекта Вы хотите сохранить в качестве параметра.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
InkStrokeRef InkStrokeRef

Определяет тип данных для ссылки на непрозрачный объект штриха Чернил.

Объявление

Swift

typealias InkStrokeRef = InkStroke

Objective C

typedef struct OpaqueInkStrokeRef * InkStrokeRef;

Обсуждение

Необходимо использовать Базовые функции Основы CFRetain и CFRelease для управления отставанием и выпуском Чернил перечеркивают объекты. Когда ссылка штриха Чернил будет получена из события Carbon, она, как гарантируют, сохранится только для жизни обработчика событий. Если Ваше приложение должно использовать объект штриха Чернил в некоторое более позднее время, необходимо вызвать функцию CFRetain, передача объекта Вы хотите сохранить в качестве параметра.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.4 и позже.
InkAlternateCount InkAlternateCount

Определяет тип данных, указывающий число интерпретаций дополнительного текста фразы Чернил.

Объявление

Swift

typealias InkAlternateCount = CFIndex

Objective C

typedef unsigned long InkAlternateCount;

Обсуждение

Значения type InkAlternateCount возвращаются функцией InkTextAlternatesCount и передал в качестве параметра функции InkTextCreateCFString.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.


      
      InkPoint

Содержит данные, описывающие точку Чернил.

Объявление

Swift

struct InkPoint { var point: HIPoint var tabletPointData: TabletPointRec var keyModifiers: UInt32 }

Objective C

struct InkPoint { HIPoint point; TabletPointRec tabletPointData; UInt32 keyModifiers; }; typedef struct InkPoint InkPoint; typedef InkPoint * InkPointPtr;

Поля

`point`	Определяет точку в координатах с плавающей точкой. Эти значения обычно находятся в глобальных координатах с полной субпиксельной точностью. Эта координата - то, что Вы получаете для события от нажатия мыши из параметра события Углерода `kEventParamMouseLocation`, который также содержит a `typeHIPoint` значение.
`tabletPointData`	Структура точки планшета, содержащая давление, наклон, вращение и координату (в пространстве планшета) данные для пера. Значение давления является мерой того, как трудно перо нажимается, в пределах от от 0 до 65 535. Некоторые производители планшета позволяют пользователям корректировать перьевую чувствительность. В этих случаях нулевое значение всегда соответствует порогу, установленному пользователем, и значение давления относительно того порога. Посмотрите Ссылку менеджера событий Углерода для получения информации о `TabletPointRec` тип данных.
`keyModifiers`	Значение, указывающее модифицирующую клавишу клавиатуры, нажимающуюся, когда выбирается точка. Это значение находится в той же форме как используемый менеджером событий Углерода для параметра события `kEventParamKeyModifiers`.

Обсуждение

InkPoint структура данных содержит чрезвычайно полный набор данных на точку. Ink Services в настоящее время только требует, чтобы точка (x, y) координаты и давление выполнила распознавание и нарисовала чернила, но будущие службы распознавания могут запросить другую информацию от TabletPointRec.

Доступность

Доступный в OS X v10.3 и позже.

Константы

Пользовательские режимы записи
Укажите режим записи Чернил, установленный пользователем в области Ink Установок системы.

Объявление

Swift

typealias InkUserWritingModeType = FourCharCode

Objective C

enum { kInkWriteNowhere = 'nowh', kInkWriteAnywhere = 'anyw', kInkWriteInInkAwareAppsOnly = 'iapp' }; typedef FourCharCode InkUserWritingModeType;

Константы
- kInkWriteNowhere
  
  kInkWriteNowhere
  
  Указывает, что пользователь отключил Чернила или что Ink Services не доступна (например, планшет не присоединяется).
  
  Доступный в OS X v10.3 и позже.
- kInkWriteAnywhere
  
  kInkWriteAnywhere
  
  Указывает, что пользователь позволил Чернилам позволить писать где угодно на экране. Точки чернил потоков Ink Services и распознавание заканчиваются к frontmost приложению. Когда пользователь включает Чернила, это - ситуация по умолчанию.
  
  Доступный в OS X v10.3 и позже.
- kInkWriteInInkAwareAppsOnly
  
  kInkWriteInInkAwareAppsOnly
  
  Указывает, что пользователь позволил Чернилам только позволить писать в приложении, включившем Ink Services путем вызывания функции InkSetApplicationWritingMode с kInkWriteAnywhereInApp параметр.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Эти константы возвращаются функцией InkUserWritingMode.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
Режимы приложения
Укажите режим ввода Чернил для использования для приложения.

Объявление

Objective C

enum { kInkWriteNowhereInApp = 'nowa', kInkWriteAnywhereInApp = 'anya' }; typedef FourCharCode InkApplicationModeType;

Константы
- kInkWriteNowhereInApp
  
  kInkWriteNowhereInApp
  
  Указывает для не разрешения ввода Чернил в приложении.
  
  Доступный в OS X v10.3 и позже.
- kInkWriteAnywhereInApp
  
  kInkWriteAnywhereInApp
  
  Указывает для разрешения ввода Чернил где угодно на экране для приложения.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Можно предоставить эти константы как параметры к функции InkSetApplicationWritingMode. Если нет доступного устройства ввода данных Чернил, то вызов, если пользователь не включил Чернил или InkSetApplicationWritingMode с параметром kInkWriteAnywhereInApp не имеет никакого эффекта.
Рисование режимов
Укажите то, что должна нарисовать Ink Services.

Объявление

Swift

typealias InkDrawingModeType = UInt32

Objective C

enum { kInkDrawNothing = 0, kInkDrawInkOnly = 1, kInkDrawInkAndWritingGuides = 2 }; typedef unsigned long InkDrawingModeType;

Константы
- kInkDrawNothing
  
  kInkDrawNothing
  
  Указывает для не рисования Чернил или руководств по записи.
  
  Доступный в OS X v10.3 и позже.
- kInkDrawInkOnly
  
  kInkDrawInkOnly
  
  Указывает для рисования Чернил, но не руководств по записи.
  
  Доступный в OS X v10.3 и позже.
- kInkDrawInkAndWritingGuides
  
  kInkDrawInkAndWritingGuides
  
  Указывает для рисования и Чернил и руководств по записи. Это - значение по умолчанию.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Можно передать эти константы как параметры к функции InkSetDrawingMode.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
Режимы завершения фразы
Определяет условия, при которых должна быть завершена фраза Чернил.

Объявление

Swift

typealias InkTerminationType = UInt32

Objective C

enum InkTerminationType { kInkTerminationNone = 0, kInkTerminationTimeOut = 1, kInkTerminationOutOfProximity = 1 << 1, kInkTerminationRecognizerHorizontalBreak = 1 << 2, kInkTerminationRecognizerVerticalBreak = 1 << 3, kInkTerminationStroke = 1 << 4, kInkTerminationAll = (unsigned long) 0xFFFFFFFF, kInkTerminationDefault = 0x0F }; typedef unsigned long InkTerminationType;

Константы
- kInkTerminationNone
  
  kInkTerminationNone
  
  Указывает для запрещения автоматического завершения фразы Ink Services.
  
  Доступный в OS X v10.3 и позже.
- kInkTerminationTimeOut
  
  kInkTerminationTimeOut
  Когда все следующее является истиной, указывает для завершения фразы:
  
  Пользователь прекращает писать и снимает стилус
  
  Пользователь сохраняет стилус в диапазоне близости планшета
  
  Пользователь не продолжает писать в течение времени, определенного пользователем в области Ink Установок системы
  Доступный в OS X v10.3 и позже.
- kInkTerminationOutOfProximity
  
  kInkTerminationOutOfProximity
  
  Когда пользователь прекращает писать и снимает стилус полностью из диапазона близости планшета, указывает для завершения фразы. Это идет по умолчанию. Однако пользователи могут выключить завершение близости в области Ink Установок системы, если они находят, что это вмешивается в их стиль записи.
  
  Если пользователь выключает завершение близости, Ваше приложение не может включить его, даже если Вы вызываете функцию InkSetPhraseTerminationMode с параметром kInkTerminationOutOfProximity.
  
  Доступный в OS X v10.3 и позже.
- kInkTerminationRecognizerHorizontalBreak
  
  kInkTerminationRecognizerHorizontalBreak
  
  Когда пользователь оставляет большое горизонтальное пространство между словами (приблизительно две ширины символов или больше), указывает для завершения фразы.
  
  Доступный в OS X v10.3 и позже.
- kInkTerminationRecognizerVerticalBreak
  
  kInkTerminationRecognizerVerticalBreak
  
  Когда пользователь заканчивает одну строку и начинает писать на следующем, указывает для завершения фразы.
  
  Доступный в OS X v10.3 и позже.
- kInkTerminationStroke
  
  kInkTerminationStroke
  
  Фразы причин, которые будут завершены в конце каждого штриха (каждый раз, когда перо снято с планшета при записи). Только полезный для одно-штрихового ввода жеста, не для текста.
  
  Доступный в OS X v10.4 и позже.
- kInkTerminationAll
  
  kInkTerminationAll
  
  Указывает для восстановления автоматического завершения фразы Ink Services. В этом случае Ink Services использует все режимы завершения (кроме kInkTerminationNone) описанный ранее. Осуждаемый в OS X v10.4. С OS X v10.4, это значение переопределяется для поведения как kInkTerminationDefault.
  
  Доступный в OS X v10.3 и позже.
- kInkTerminationDefault
  
  kInkTerminationDefault
  
  Завершение фразы значения по умолчанию восстановлений, соответствующее текущие пользовательские настройки (kInkTerminationTimeOut | kInkTerminationOutOfProximity | kInkTerminationRecognizerHorizontalBreak | kInkTerminationRecognizerVerticalBreak). См. также kInkTerminationOutOfProximity.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

Фраза Чернил (представленный как InkTextRef в Вашем приложении), обычно слово на римском языке. Ink Services использует фразы для определения, когда стереть экранные Чернила и инициировать распознавание. Можно передать константы завершения фразы Чернил как параметры функции InkSetPhraseTerminationMode. Можно объединить две или больше константы для получения точного управления завершением фразы.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
Режимы распознавания
Укажите, как интерпретировать ввод Чернил для приложения.

Объявление

Swift

typealias InkRecognitionType = UInt32

Objective C

enum InkRecognitionType { kInkRecognitionNone = 0, kInkRecognitionText = 1, kInkRecognitionGesture = 1 << 1, kInkRecognitionDefault = 3 }; typedef unsigned long InkRecognitionType;

Константы
- kInkRecognitionNone
  
  kInkRecognitionNone
  
  Указывает для выключения распознавания Чернил.
  
  Доступный в OS X v10.3 и позже.
- kInkRecognitionText
  
  kInkRecognitionText
  
  Указывает для разрешения интерпретации ввода Чернил как текст.
  
  Доступный в OS X v10.3 и позже.
- kInkRecognitionGesture
  
  kInkRecognitionGesture
  
  Указывает для разрешения интерпретации ввода Чернил как жесты.
  
  Доступный в OS X v10.3 и позже.
- kInkRecognitionDefault
  
  kInkRecognitionDefault
  
  Указывает настройку по умолчанию, которая должна интерпретировать ввод Чернил как текст или жесты.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Константы типа распознавания используются в качестве параметров за функцию InkSetApplicationRecognitionMode. Можно использовать эти константы, чтобы указать, что Ink Services интерпретирует ввод и как текст и как жесты или как любой тип индивидуально.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
Редактирование жестов
Определите действия редактирования.

Объявление

Swift

typealias InkGestureKind = FourCharCode

Objective C

enum InkGestureKind { kInkGestureUndo = 'undo', kInkGestureCut = 'cut ', kInkGestureCopy = 'copy', kInkGesturePaste = 'past', kInkGestureClear = 'cler', kInkGestureSelectAll = 'sall', kInkGestureLeftSpace = 'lspc', kInkGestureRightSpace = 'rspc', kInkGestureTab = 'tab ', kInkGestureLeftReturn = 'lrtn', kInkGestureRightReturn = 'rrtn', kInkGestureDelete = 'del ', kInkGestureEscape = 'esc ', kInkGestureJoin = 'join' }; typedef FourCharCode InkGestureKind;

Константы
- kInkGestureUndo
  
  kInkGestureUndo
  
  Указывает для отмены последнего действия.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureCut
  
  kInkGestureCut
  
  Указывает для сокращения.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureCopy
  
  kInkGestureCopy
  
  Указывает для копирования.
  
  Доступный в OS X v10.3 и позже.
- kInkGesturePaste
  
  kInkGesturePaste
  
  Указывает для вставки.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureClear
  
  kInkGestureClear
  
  Указывает для очистки.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureSelectAll
  
  kInkGestureSelectAll
  
  Указывает для выбора всех элементов в области, сделавшей, чтобы фокусировался пользователь.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureLeftSpace
  
  kInkGestureLeftSpace
  
  Указывает для вставки символа одиночного пробела. «Левое» различие указывает, что жест нарисован с длинным, горизонтальным хвостом, находится на левой стороне.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureRightSpace
  
  kInkGestureRightSpace
  
  Указывает для вставки символа одиночного пробела. «Правильное» различие указывает, что жест нарисован с длинным, горизонтальным хвостом, находится на правой стороне.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureTab
  
  kInkGestureTab
  
  Указывает для вставки символа табуляции.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureLeftReturn
  
  kInkGestureLeftReturn
  
  Указывает для вставки возврата (новая строка) символ. «Левое» различие указывает, что жест нарисован с маленькой угловой скобкой, указывающей на левую сторону.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureRightReturn
  
  kInkGestureRightReturn
  
  Указывает для вставки возврата (новая строка) символ. «Правильное» различие указывает, что жест нарисован с маленькой угловой скобкой, указывающей на правую сторону.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureDelete
  
  kInkGestureDelete
  
  Указывает для удаления. Это соответствует нажатию клавиши Delete.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureEscape
  
  kInkGestureEscape
  
  Это соответствует нажатию Клавиши выхода.
  
  Доступный в OS X v10.3 и позже.
- kInkGestureJoin
  
  kInkGestureJoin
  
  Указывает для присоединения к двум словам в отдельное слово, игнорируя пространство между ними, и может быть применен к редактируемым объектам кроме текста. Жест подобен в форме букве «v». Слова, к которым присоединяются, - те самые близкие к самым верхним точкам жеста. Это - предварительное, всегда предназначаемое, жест, означая, что система обрабатывает связанные Чернила экспериментально как жест до Вашего приложения или подтверждает, что Чернила являются действительно жестом или возвратами eventNotHandledErr, информирование системы Чернила не является жестом.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Эти константы возвращаются в параметре события Углерода kEventParamInkGestureKind. Класс событий Углерода для этого параметра kEventClassInk и вид события kEventInkGesture. Константы определяют полный набор жестов, распознанных Ink Services. Когда событие жеста получено Вашим приложением, Ваше приложение должно определить вид жеста и затем принять соответствующие меры. Для получения дополнительной информации посмотрите Using Ink Services в Своем Приложении.

Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

Доступный в OS X v10.3 и позже.
Команда меню альтернатив IDs
Укажите команду меню IDs, присвоенную элементам, вставленным в меню альтернатив.

Объявление

Swift

var kInkAlternateCommand: Int { get } var kInkSeparatorCommand: Int { get } var kInkDrawingCommand: Int { get }

Objective C

enum { kInkAlternateCommand = 'inka', kInkSeparatorCommand = 'inks', kInkDrawingCommand = 'inkd' };

Константы
- kInkAlternateCommand
  
  kInkAlternateCommand
  
  Указывает команду меню ID, присвоенную пунктам меню, вставленным функцией InkTextInsertAlternatesInMenu. Можно использовать эту константу для определения, какие пункты меню в меню предоставляются Ink Services.
  
  Доступный в OS X v10.3 и позже.
- kInkSeparatorCommand
  
  kInkSeparatorCommand
  
  Указывает команду меню ID, присвоенную элементу разделителя между альтернативами и Рисунком тушью.
  
  Доступный в OS X v10.3 и позже.
- kInkDrawingCommand
  
  kInkDrawingCommand
  
  Указывает команду меню ID, присвоенную пункту меню, содержащему рисунок тушью.
  
  Доступный в OS X v10.3 и позже.
Текстовые флаги получения
Укажите настройки для использования при рисовании текста Чернил.

Объявление

Swift

var kInkTextDrawDefault: Int { get } var kInkTextDrawIgnorePressure: Int { get } var kInkTextDrawHonorContext: Int { get }

Objective C

enum unsigned long InkTextDrawFlagsType { kInkTextDrawDefault = 0, kInkTextDrawIgnorePressure = 1, kInkTextDrawHonorContext = 1 << 1 };

Константы
- kInkTextDrawDefault
  
  kInkTextDrawDefault
  
  Указывает для использования параметров настройки системы по умолчанию при рисовании. По умолчанию Чернила нарисованы с давлением чувствительные градиенты, и Кварцевые настройки контекста переопределяются для цвета линии и ширины.
  
  Доступный в OS X v10.3 и позже.
- kInkTextDrawIgnorePressure
  
  kInkTextDrawIgnorePressure
  
  Указывает для не использования давления чувствительные градиенты при рисовании.
  
  Доступный в OS X v10.3 и позже.
- kInkTextDrawHonorContext
  
  kInkTextDrawHonorContext
  
  Указывает для использования текущих Кварцевых настроек контекста для цвета линии и ширины.
  
  Доступный в OS X v10.3 и позже.
Исходные типы чернил
Укажите источники для потока данных Чернил.

Объявление

Swift

var kInkSourceUser: Int { get } var kInkSourceApplication: Int { get }

Objective C

enum unsigned long InkSourceType { kInkSourceUser = 1, kInkSourceApplication = 2 };

Константы
- kInkSourceUser
  
  kInkSourceUser
  
  Указывает источник Чернил от прямого ввода данных пользователем.
  
  Доступный в OS X v10.3 и позже.
- kInkSourceApplication
  
  kInkSourceApplication
  
  Указывает источник Чернил из приложения.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Можно использовать эти константы для указания, каким потоком данных в настоящее время управляют вызовы к функциям InkTerminateCurrentPhrase и InkSetPhraseTerminationMode. Можно управлять завершением фразы для обоих поток данных ввода данных пользователем (kInkSourceUser) и введенный приложением поток данных (kInkSourceApplication) независимо.
Перьевые константы чернил
Укажите перьевые константы чернил.

Объявление

Swift

var kInkPenTipButtonMask: Int { get } var kInkPenLowerSideButtonMask: Int { get } var kInkPenUpperSideButtonMask: Int { get }

Objective C

enum { kInkPenTipButtonMask = NX_TABLET_BUTTON_PENTIPMASK + 0, kInkPenLowerSideButtonMask = NX_TABLET_BUTTON_PENLOWERSIDEMASK + 0, kInkPenUpperSideButtonMask = NX_TABLET_BUTTON_PENUPPERSIDEMASK + 0 };

Константы
- kInkPenTipButtonMask
  
  kInkPenTipButtonMask
  
  Запись или подсказка по средству стирания.
  
  Доступный в OS X v10.4 и позже.
- kInkPenLowerSideButtonMask
  
  kInkPenLowerSideButtonMask
  
  Более низкая перьевая кнопка пера.
  
  Доступный в OS X v10.4 и позже.
- kInkPenUpperSideButtonMask
  
  kInkPenUpperSideButtonMask
  
  Верхняя перьевая кнопка пера.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

Перья, используемые с современными графическими планшетами часто, имеют многократные кнопки пера, которые могут быть присвоенным особым значением драйвером планшета или приложением. Кроме того, запись или подсказка по средству стирания могут быть заняты в любой данный момент. Путем выполнения операции И этих contsants с тем из a buttons элемент a TabletPointRec в Углероде или значении, возвращенном buttonMask сообщение отправило к событиям планшета (или события от нажатия мыши, содержащие данные планшета) в Какао, можно определить, который (если таковые имеются) в настоящее время удерживаются перьевая подсказка или кнопки пера. Эти кнопки и buttonMask данные только доступны для событий точки планшета (не события близости планшета).

Для обеспечения непротиворечивости между значениями, используемыми писателями драйвера и значениями, используемыми приложениями, эти константы определяются с точки зрения NX_ константы от IOKit/hidsystem/IOLLEvent.h.

Доступность

Доступный в OS X v10.4 и позже.
Константы планшета чернил
Укажите константы планшета чернил.

Объявление

Swift

var kInkTabletPointerUnknown: Int { get } var kInkTabletPointerPen: Int { get } var kInkTabletPointerCursor: Int { get }

Objective C

enum { kInkTabletPointerUnknown = NX_TABLET_POINTER_UNKNOWN + 0, kInkTabletPointerPen = NX_TABLET_POINTER_PEN + 0, kInkTabletPointerCursor = NX_TABLET_POINTER_CURSOR + 0, kInkTabletPointerEraser = NX_TABLET_POINTER_ERASER + 0 };

Константы
- kInkTabletPointerUnknown
  
  kInkTabletPointerUnknown
  
  Тип указателя планшета неизвестен; наличие неизвестного типа указателя планшета не должно происходить.
  
  Доступный в OS X v10.4 и позже.
- kInkTabletPointerPen
  
  kInkTabletPointerPen
  
  Конец записи подобного стилусу устройства.
  
  Доступный в OS X v10.4 и позже.
- kInkTabletPointerCursor
  
  kInkTabletPointerCursor
  
  Любое подобное шайбе устройство.
  
  Доступный в OS X v10.4 и позже.
- kInktabletPointerEraser
  
  kInktabletPointerEraser
  
  Конец средства стирания подобного стилусу устройства.
Обсуждение

Перья, используемые с современными графическими планшетами часто, имеют подсказку по записи и подсказку по средству стирания. Некоторые планшеты также поддерживают шайбы в дополнение к, или вместо, подобные стилусу устройства. Путем сравнения этих констант с содержанием pointerType элемент a TabletProximityRec в Углероде или к значению, возвращенному pointerType обменивайтесь сообщениями к событиям планшета (или события от нажатия мыши с данными планшета в них) в Какао, можно определить, какое указывающее устройство и какая подсказка подобного стилусу устройства используется с графическим планшетом. Они pointerType данные только доступны в событиях близости планшета (не события точки планшета).

Для обеспечения непротиворечивости между значениями, используемыми писателями драйвера и значениями, используемыми приложениями, эти константы определяются с точки зрения NX_ константы от IOKit/hidsystem/IOLLEvent.h.

Доступность

Доступный в OS X v10.4 и позже.

Коды результата

Нет никаких кодов результатов, определенных для Ink Services. Вместо возврата OSStatus значения, возврат функций NULL или определенные, предопределенные недопустимые ответы, когда Вы передаете недопустимые параметры им. Разработка API таким образом позволяет Вам объединять в цепочку вызовы функции и код записи, который более компактен.