Microsoft KB Archive/179907

{|
 * width="100%"|

HOWTO: Display CAnimateCtrl with Transparent Background

 * }

Q179907

-

The information in this article applies to:


 * Microsoft Win32 Software Development Kit (SDK)
 * The Microsoft Foundation Classes (MFC), used with:
 * Microsoft Visual C++, 32-bit Editions, versions 4.0, 4.0a, 4.1, 4.2b
 * Microsoft Visual C++, 32-bit Enterprise Edition, version 4.2
 * Microsoft Visual C++, 32-bit Professional Edition, version 4.2
 * Microsoft Visual C++, 32-bit Enterprise Edition, version 5.0
 * Microsoft Visual C++, 32-bit Professional Edition, version 5.0

-

SUMMARY
This article shows how to display .avi files with a transparent background. The CAnimateCtrl control supports .avi files with a transparent background with a limitation of 16 colors. The first pixel in the first frame of an .avi file determines the background color of the CAnimateCtrl control.

MORE INFORMATION
To display an .avi file on CDialog or its derived classes, you need to set the style of CAnimateCtrl to ACM_TRANSPARENT. If the color of the first pixel in the first frame of an .avi file is different from the background color of the CDialog object, then the background color of the CDialog object is used as the background color of the .avi file. Thus, the CAminateCtrl control will have a transparent background.

To display an .avi file on CView or its derived classes, you must intercept the WM_CTLCOLOR message in the CView class and return a null brush (not to be confused with just returning NULL) for the CAnimateCtrl. In addition, you must set the style of CAnimateCtrl to ACM_TRANSPARENT. Otherwise, the default dialog box background color will be used as the background color for the animation control.

For example, if a CView derived class is CTestanimctrlView, you need to add the ACM_TRANSPARENT style to the CAnimateCtrl, add ON_WM_CTLCOLOR into the message map, and add an OnCtlColor message handler into the CTestanimctrlView class as described in the following steps:

Sample Code
Add the following code into the .h file of CTestanimctrlView:

  CAnimateCtrl* m_pMyAnimateCtrl; afx_msg HBRUSH OnCtlColor(CDC* pDC, CWnd* pWnd, UINT nCtlColor); Add the following code into the .cpp file of CTestanimctrlView:


 * 1) Add the following code in CTestanimctrlView::OnInitialUpdate:
 * 2) Add ON_MN_CTLCOLOR into the message map:
 * 3) Add the message handler for WM_CTLCOLOR:
 * 4) Free up the memory used by the animate control:

Additional query words:

Keywords : kbAnimation kbCtrl kbOSWinNT kbOSWin2000 kbSDKWin32 kbGrpDSUser kbVC400 kbVC410 kbVC420 kbVC500 kbOSWin

Issue type : kbhowto

Technology : kbWin32SDKSearch kbAudDeveloper kbMFC kbSDKSearch kbWin32sSearch