сообщение ACM_OPEN

Открывает клип AVI и отображает его первый кадр в элементе управления анимацией. Это сообщение можно отправить явно или использовать макрос Animate_Open или Animate_OpenEx. Мы рекомендуем использовать версию этого сообщения Юникода ACM_OPENW.

Параметры

wParam

Версия 4.71 и более поздняя. Дескриптор экземпляра в модуль, из которого должен быть загружен ресурс. Задайте для этого значения значение NULL, чтобы элемент управления использовал значение HINSTANCE, используемое для создания окна. Обратите внимание, что если окно создается библиотекой DLL, значением по умолчанию для wParam является значение HINSTANCE библиотеки DLL, а не приложение, которое вызывает библиотеку DLL.

lParam

Указатель на буфер, содержащий путь к файлу AVI или имени ресурса AVI. Кроме того, этот параметр может состоять из идентификатора ресурса AVI в LOWORD и ноль в HIWORD. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE . Элемент управления загружает ресурс AVI из модуля, указанного дескриптором экземпляра, переданным в функцию CreateWindow, макрос Animate_Create или функцию создания диалогового окна, которая создала элемент управления. В версии 4.71 и более поздних версиях ресурс загружается из модуля, указанного wParam. Ресурс AVI должен иметь тип AVI. Если этот параметр имеет значение NULL, система закрывает AVI-файл, который ранее был открыт для указанного элемента управления анимацией( если таковой имеется).

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

Возвращает ненулевое значение в случае успешного выполнения или нуля.

Замечания

Файл AVI или ресурс, указанный lpszName, не должен содержать звук.

Мы рекомендуем использовать версию этого сообщения Юникода ACM_OPENW.

Вы можете открывать только автоматические клипы AVI. ACM_OPEN и Animate_Open сбой, если lParam задает клип AVI, содержащий звук.

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

Requirements

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхний колонтитул	Commctrl.h
Имена Юникода и ANSI	ACM_OPENW (Юникод) и ACM_OPENA (ANSI)