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

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

Панель инструментов Фильма обеспечивает две стандартных функции файла, позволяющие, Вы к предварительным просмотрам дисплейного файла в диалоговом окне Open с помощью стандартного файла отвечаете структурам: SFGetFilePreview и SFPGetFilePreview. SFGetFilePreview функция соответствует существующему SFGetFile функция; SFPGetFilePreview функция соответствует существующему SFPGetFile функция.

SFGetFilePreview функционируйте использует диалоговое окно, показанное на рисунке 8-1. SFPGetFilePreview если Вы не предоставляете свое собственное, функция может также использовать это диалоговое окно.

Вы используете эти новые функции вместо существующих стандартных функций файла, чтобы указать, хотите ли Вы позволить пользователю отображать предварительные просмотры во время диалогового окна Open. Пользователь выводит на экран предварительный просмотр файла путем выбора файла в диалоговом окне и щелчка по Show Preview. Когда пользователь делает так, функции выводят на экран предварительный просмотр для файла, как показано на рисунке 8-2.

Область предварительного просмотра диалогового окна выведена на экран каждый раз, когда включен предварительный просмотр.

Настройка Вашего интерфейса

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

 Рисунок 8-3 показывает стандартное диалоговое окно, используемое SFPGetFilePreview и SFGetFilePreview. Ваше диалоговое окно и диалоговая функция фильтра должны поддерживать, по крайней мере, эти диалоговые элементы.

Элементы налево от элемента 13 видимы только при предварительном просмотре. Если Вы хотите определить элементы, которые видимы только во время предварительного просмотра файла, размещают их налево от элемента 13 в Вашем пользовательском диалоговом окне.

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

enum

{

/* dialog items to include in dialog box definition for use

   with SFPGetFilePreview function

*/

    sfpItemPreviewAreaUser              = 11,       /* user preview area */

    sfpItemPreviewStaticText            = 12,       /* static text preview */

    sfpItemPreviewDividerUser           = 13,       /* user divider preview */

    sfpItemCreatePreviewButton          = 14,       /* create preview button */

    sfpItemShowPreviewButton            = 15        /* show preview button */

};

Предварительный просмотр файлов Используя стандартные структуры ответа файла

Панель инструментов Фильма обеспечивает две стандартных функции файла, standardGetFilePreview и CustomGetFilePreview, это позволяет Вам предварительным просмотрам дисплейного файла в диалоговом окне Open с помощью стандартных структур ответа файла (типа StandardFileReply). StandardGetFilePreview функция соответствует существующему StandardGetFile функция; CustomGetFilePreview функция соответствует существующему CustomGetFile функция. Обе из этих новых функций берут те же параметры в качестве своих существующих дубликатов.

StandardGetFilePreview функционируйте использует диалоговое окно, показанное на рисунке 8-4. CustomGetFilePreview если Вы не предоставляете свое собственное, функция может также использовать это диалоговое окно.

Вы используете эти новые функции вместо существующих стандартных функций файла каждый раз, когда Вы хотите позволить пользователю отображать предварительные просмотры во время диалогового окна Open. Пользователь заставляет предварительный просмотр файла быть выведенным на экран путем выбора файла в диалоговом окне и щелчка по Show Preview. Когда пользователь делает так, функции выводят на экран предварительный просмотр для файла, как показано на рисунке 8-5.

Часть предварительного просмотра диалогового окна выведена на экран только, когда диалоговое окно показывает предварительный просмотр файла.

SFGetFilePreview, SFPGetFilePreview, StandardGetFilePreview, и CustomGetFilePreview функции позволяют пользователю автоматически преобразовывать файлы в фильмы если Ваши фильмы запросов приложения. Если существует файл, который может быть преобразован в файл ролика с помощью компонента импорта фильма, то файл показан в диалоговом окне Standard File в дополнение к любым фильмам. Когда пользователь выбирает файл, изменения кнопки Open в кнопке Convert. Рисунок 8-6 обеспечивает пример этого диалогового окна.

Выбор Convert выводит на экран диалоговое окно, позволяющее пользователю выбирать, где должен быть сохранен преобразованный файл. Рисунок 8-7 показывает это диалоговое окно.

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

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

Функции для создания предварительных просмотров файла

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

Можно использовать MakeFilePreview функция для создания предварительного просмотра для файла. AddFilePreview функция позволяет Вам добавлять предварительный просмотр, который Вы создали к файлу.