Ссылка администратора приложений

Обсуждение

Эта функция позволяет вовлечь приложение мозаика Прикрепления в разрешении кроме 128x128, который является размером всех мозаик Прикрепления до OS X v10.5. Когда масштабный коэффициент пользовательского интерфейса не 1.0, в OS X v10.5 и позже, мозаики прикрепления могут использовать различные размеры.

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

Поскольку размер мозаики Прикрепления может измениться динамично, приложения, использующие эту функцию, должны быть подготовлены перерисовать свою мозаику Прикрепления по мере необходимости. A kEventAppUpdateDockTile Когда приложение должно перерисовать свою мозаику Прикрепления, событие Carbon отправляется.

Эта функция блокирует приложение мозаика Прикрепления, чтобы препятствовать тому, чтобы Прикрепление рисовало в мозаике. Когда Вы закончены с помощью контекста, необходимо вызвать функцию EndCGContextForApplicationDockTile выпускать контекст и блокировку. Не использовать CGEndContext или CFRelease с этой целью. Чтобы гарантировать, что рисование к контексту появляется на экране, необходимо вызвать CGContextFlush прежде, чем выпустить контекст.

Обсуждение

Эта функция позволяет вовлечь приложение мозаика Прикрепления в разрешении 128x128, который является размером всех мозаик Прикрепления до OS X v10.5. Если масштабный коэффициент пользовательского интерфейса не будет 1.0, то получение будет масштабироваться к фактическому размеру мозаики.

Эта функция блокирует приложение мозаика Прикрепления, чтобы препятствовать тому, чтобы Прикрепление рисовало в мозаике. Когда Вы закончены с помощью контекста, необходимо вызвать функцию EndCGContextForApplicationDockTile выпускать контекст и блокировку. Не использовать CGEndContext или CFRelease с этой целью. Чтобы гарантировать, что рисование к контексту появляется на экране, необходимо вызвать CGContextFlush прежде, чем выпустить контекст.

Обсуждение

Эта функция также выпускает блокировку на приложении мозаика Прикрепления, сигнализируя Прикрепление, которое Вы сделаны, таща в мозаике.

Обсуждение

Эта функция блокирует приложение мозаика Прикрепления, чтобы препятствовать тому, чтобы Прикрепление рисовало в мозаике. Когда Вы закончены с помощью графического порта, необходимо вызвать функцию EndQDContextForApplicationDockTile выпускать порт и блокировку. Не использовать DisposePort с этой целью.

Обсуждение

Эта функция также выпускает блокировку на приложении мозаика Прикрепления, сигнализируя Прикрепление, которое Вы сделаны, таща в мозаике.

Обсуждение

Когда Вы располагаете курсор по приложению мозаика Прикрепления и удерживаете кнопку мыши, контекстное меню автоматически выводит на экран список окон документа приложения и стандартное приложение пункты меню Dock такой как Открытые при Входе в систему, и Покажите в Средстве поиска. Можно использовать функцию SetApplicationDockTileMenu добавить пункты меню к контекстному меню вывело на экран для Вашего приложения мозаика Прикрепления. Элементы в меню, которое Вы передаете этой функции, вставляются в Ваше приложение меню мозаики Прикрепления между списком окон документа и стандартными товарами.

Эта функция постепенно увеличивает подсчет ссылок меню, которое Вы передаете ему. Прежде чем меню выведено на экран, оно получает события Carbon kEventMenuPopulate, kEventMenuOpening, и kEventMenuEnableItems, таким образом, любые обработчики событий для этих событий могут обновить меню соответственно. Можно получить уведомления об и обработать выборы от использования меню kEventCommandProcess Обработчики событий углерода установлены в цели события приложения. Необходимо удостовериться, что каждый пункт меню имеет команду ID, как kEventCommandProcess событие, отправленное в Ваше приложение, обеспечивает команду ID пункта меню.

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

• Информация о том, является ли элемент текстовым элементом или разделителем

• Текст элемента (если элемент не является разделителем),

• Команда ID элемента

• Модификаторы командной клавиши элемента (но не сама командная клавиша)

• Метка элемента

• Отступ элемента

• Стиль элемента

• Значок элемента, если значок был указан с kMenuSystemIconSelectorType или kMenuIconResourceType

• Подменю элемента

• Эти атрибуты пункта меню:

  • kMenuItemAttrNotPreviousAlternate

  • kMenuItemAttrSectionHeader

  • kMenuItemAttrDisabled

  • kMenuItemAttrIconDisabled

  • kMenuItemAttrSubmenuParentChoosable

  • kMenuItemAttrDynamic

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

Обсуждение

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

Обсуждение

Можно наложить изображение, такое как значок, для указания состояния приложения пользователю.

Обсуждение

Если Вы вызвали функции SetApplicationDockTileImage или OverlayApplicationDockTileImage, можно использовать функцию RestoreApplicationDockTileImage восстановить Значок панелей к значку исходного приложения.

Обсуждение

Функция CreateCGImageFromPixMaps использует маску в качестве альфа-канала для получающегося изображения. Это позволяет Вам иметь любой уровень прозрачности в получающемся изображении. Можно передать Кварцевое изображение в качестве параметра любому Кварцу 2D функция получения, а также Прикреплять функции мозаики, такие как функции SetApplicationDockTileImage и OverlayApplicationDockTileImage. Можно использовать CreateCGImageFromPixMaps создать изображение для значка, и затем применить значок к Вашему значку панелей приложений.

Обсуждение

Ваше приложение должно получить сценарий приложений, когда это использует функцию, такой как UseThemeFont, это берет код сценария в качестве параметра.

Обсуждение

То, когда эта функция вызвана, она выводит на экран окно, вызвало о поле, содержащем Ваш значок приложения, имя, версию программного обеспечения и другую дополнительную информацию. В Углероде основанное на событии приложение стандартный обработчик событий приложения отвечает на kHICommandAbout команда путем вызывания функции HIAboutBox для Вас. Если Ваше меню приложения будет иметь пункт меню About, то Вы получите это поведение бесплатно. Вы не должны вызывать эту функцию, если Вы не хотите настроить содержание о поле.

В дополнение к имени приложения и версии, эта функция разработана для отображения двух дополнительных строк в о поле, строке авторского права и строке описания. Можно настроить то, что эта функция выводит на экран путем передачи в различных вариантах в inOptions параметр:

• Можно передать NULL вывести на экран информацию приложений, определенную в Info.plist файл или Ваш ресурс пакета (не рекомендуемый). Эта функция смотрит Info.plist файл для трех ключей для завоевывания репутацию присвойте версию, и строки авторского права: CFBundleName, CFBundleVersion, и CFBundleGetInfoString.

• Можно передать словарь с заменяющими значениями для одной или более строк. Посмотрите “About Box Keys” для списка допустимых ключей в этом словаре. Если замещающая строка не передается, поведение по умолчанию применяется. Например, Вы могли передать некоторый вариант своего имени приложения в словаре, но не передать заменяющую строку версии или строку авторского права. Функция вывела бы на экран Вашу замещающую строку и отступила бы к заглядыванию Info.plist файл для других строк.

• Можно передать словарь с единственной записью, именем файла локализованных строк, содержащего заменяющие значения для одной или более строк. Ключ словаря kHIAboutBoxStringFileKey, и значение является именем строкового файла без .strings расширение. Эта функция автоматически использует тот файл для нахождения строк для о поле. Этот пример показывает пары ключ/значение в типичном строковом файле:

  • HIAboutBoxName = "AboutBox";
  • HIAboutBoxVersion = "v1.0";
  • HIAboutBoxCopyright = "© Apple Computer, 2006";
  • HIAboutBoxDescription = "An Example Application";

  Снова, если строка не найдена в том файле, эта функция отступает к поиску строки в словаре, и затем наконец Info.plist файл.

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

Обсуждение

В OS X v10.5 и позже, можно использовать эту функцию для установки собственных делегатов HIObject на объекте приложения.

Функция GetApplicationEventTarget возвращает цель события, связанную с объектом приложения.

Обсуждение

С введением модального штабеля фокуса в OS X v10.5, приложение может иметь два различных фокусируемых окна: немодальный фокус (окно последний раз передало функции SetUserFocusWindow), и эффективный фокус (или немодальный фокус или, если существует непустой модальный штабель фокуса, самое верхнее окно в штабеле фокуса). Эта функция возвращает любое окно.

Приложения могут использовать эту функцию, чтобы определить, являются ли немодальным фокусом и эффективным фокусом различные окна. Приложение с пользовательским HIView может также использовать эту функцию, чтобы определить, должно ли приложение показать точку вставки. Если представление в эффективном фокусе, точка вставки должна только быть видима.

Обратите внимание на то, что функция GetUserFocusWindow возвращает немодальный фокус — то же окно возвратилось, когда Вы передаете false к HIApplicationGetFocus.