Функции прогресса

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

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

Вы присваиваете функцию прогресса фильму путем вызова SetMovieProgressProc функция. Необходимо присвоить функцию прогресса при открытии фильма; Панель инструментов Фильма вызовет Вашу функцию, когда будет надлежащим сделать так. Одна функция прогресса может поддерживать больше чем один фильм. Когда Панель инструментов Фильма вызывает Вашу функцию, она предоставляет Вам идентификатор фильма так, чтобы можно было различить между различными фильмами.

Функции покрытия

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

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

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

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

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

Используйте SetMovieCoverProcs функционируйте для установки обоих типов функций покрытия.

Функции уведомления об ошибке

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

SetMoviesErrorProc функция позволяет Вам идентифицировать функцию уведомления об ошибке своего приложения в errProc параметр.

Функции выноски фильма

PlayMoviePreview функционируйте играет предварительный просмотр фильма. Вы обеспечиваете указатель на функцию выноски фильма в callOutProc параметре.

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

Функции фильтра файла

Функция фильтра файла фильтрует файлы, выведенные на экран пользователю в диалоговом окне. Вы указываете эту функцию в fileFilter параметр SFGetFilePreview, StandardGetFilePreview, и CustomGetFilePreview подпрограммы. Если этот параметр не nil, SFGetFilePreview вызывает функцию для каждого файла, чтобы определить, вывести ли на экран файл пользователю. SFGetFilePreview функционируйте предоставляет Вас информацию, которую это получает от подпрограммы GetFileInfo Файлового менеджера.

Пользовательские диалоговые функции

Диалоговая функция рычага обрабатывает пользовательские выборы в диалоговом окне. Пользовательская диалоговая функция позволяет Вам поддерживать шаблон в пользовательском диалоговом шаблоне, который Вы указали с подпрограммой CustomGetFilePreview. Эта функция соответствует Файловому менеджеру CustomGetFile подпрограмма.

Вы указываете свою диалоговую функцию в dlgHook параметре CustomGetFilePreview. Можно использовать этот параметр для поддержки пользовательской функции диалогового окна, которую Вы предоставили путем указания диалогового шаблонного ресурса в файле ресурсов. Вы указываете ресурс диалогового шаблона ID с dlgID параметр. Если Вы не предоставляете пользовательскую диалоговую функцию, установите этот параметр на nil.

Модально-диалоговые функции фильтра

CustomGetFilePreview подпрограмма представляет диалоговое окно Open пользователю и позволяет пользователю просматривать предварительные просмотры файла. Эта функция отличается от StandardGetFilePreview в этом можно обеспечить пользовательский диалоговый шаблон и функции для поддержки шаблона. Эта функция соответствует существующему CustomGetFile подпрограмма.

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

Стандартные функции активации файла

CustomGetFilePreview функционируйте представляет диалоговое окно Open пользователю и позволяет пользователю просматривать предварительные просмотры файла. Эта функция отличается от StandardGetFilePreview функция в этом можно обеспечить пользовательский диалоговый шаблон и функции для поддержки шаблона. CustomGetFilePreview функция соответствует Файловому менеджеру CustomGetFile подпрограмма.

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

Функции события обратного вызова

CallMeWhen функционируйте планирует событие обратного вызова. Вы указываете событие обратного вызова в callBackProc параметр.

Текстовые функции

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