макрос Animate_OpenEx (commctrl.h)

Статья
10/24/2024

Открывает клип AVI из ресурса в указанном модуле и отображает свой первый кадр в элементе управления анимацией. Этот макрос можно использовать или явно отправить сообщение ACM_OPEN.

Синтаксис

BOOL Animate_OpenEx(
   HWND      hwnd,
   HINSTANCE hInst,
   LPTSTR    szName
);

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления анимации.

hInst

Тип: HINSTANCE

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

szName

Тип: LPTSTR

Указатель на буфер, содержащий путь к файлу AVI или имени ресурса AVI. Кроме того, этот параметр может состоять из идентификатора ресурса AVI в LOWORD и ноль в HIWORD. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE. Элемент управления загружает ресурс AVI из модуля, указанного hInst. Файл AVI или ресурс, указанный szName, не должен содержать звук.

Если этот параметр значение NULL, система закрывает AVI-файл, который ранее был открыт для указанного элемента управления анимацией( если таковой имеется).

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

Тип: BOOL

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

Замечания

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

Поделиться через