Click here to Skip to main content
15,397,981 members
Articles / Mobile Apps / Windows Mobile
Posted 19 Feb 2009


99 bookmarked

ATL Windowless ActiveX Media Container

Rate me:
Please Sign up or sign in to vote.
5.00/5 (20 votes)
5 Mar 2009Apache7 min read
Full-fledged ATL Windowless ActiveX Container. Ideal for hosting Windows Media Player, Transparent Flash and Silverlight Animations.


Silverlight ActiveX Control


COM/ActiveX control has been around for more than a decade. In spite of all, it is very difficult to get a complete Windowless container. MFC dialog has its own Windowless container that is truly windowless compared to ATL but if your project can't afford to depend on MFC, you are on your own. The container I am presenting in this article offers complete support to Windowless controls. It is developed especially for ATL/WTL projects and can be used to create composite controls. That means, you can combine multiple Windowless Controls to create your own component.
Imagine being able to encapsulate Adobe Flash, Windows Media Player and Silverlight into your own component. Another advantage you will find with these classes is that the learning curve is quasi zero if you have any previous experiences with ATL. You simply derive your dialog from the new dialog class to get the full power of this container.


Having a full-blown windowless container can be very useful. I hope that you will find some great uses for it. I will describe the process necessary to integrate the container in your own project. Later, in other articles, we'll explore how we can take some of this to a new level.

Think about this, wouldn't it be great if you could integrate Silverlight and Flash contents seamlessly and interact with them within your C++ application?
The more you think about it, this is quite possible after all that's what a web browser does in a large part. But before we go too deep, let's do a quick refresh about ActiveX control container and see how powerful the whole concept was and is, even today. If you are already comfortable with ActiveX and Windowless or don't need a memory refresh, you can jump directly to Using ActiveXContainerImpl Class.

ActiveX Control Container

If you want to be proficient at developing Windowless controls and their container, you have to rely on the OC96 Specification. Basically, you need to know and understand several things.

Apartment-Model Awareness

ActiveX Controls should be developed to conform to apartment-model rules to ensure they behave correctly. That is, you have to think in term of UI thread and make sure that your object is thread safe. If your object uses global variables, it should synchronize access to them.


By supporting the windowless control specification, a control can make efficient use of its container's window rather than having a window of its own. This results in using fewer system resources and improves performance through faster activation/deactivation. Providing windowless support not only provides transparency for interesting visual effects, but also further improves the performance of the control.

Hit Detection

Hit detection is provided so that a windowless control can have an irregular shape and to complete the visual benefits of transparency. The container calls IViewObjectEx::QueryHitPoint of the control. In return, the control determines if it has been hit and returns an indication to the container.

Control Persistent Data

A control can use any of IPersistStreamInit, IPersistStorage, IPersistMemory, and IPersistPropertyBag as a Persistent Embedding mechanism. A control may implement more than one of these interfaces if it wants to. The container being presented with this article supports only IPersistStreamInit but IPersistPropertyBag may be added in the future in order to support a wider range of controls.

Interacting with Container

Because the container interface is passed to the control, the entire object model of the container is available and can be manipulated by the control. Consider for example this same scenario with Internet Explorer, a control access the entire DOM tree (IHTMLDocument) and change background color of the document.

CComPtr<IOleContainer> spContainer; 
CComQIPtr<IHTMLDocument2, &IID_IHTMLDocument2> spDoc(spContainer); 
if (spDoc)

What this means is if you develop a custom container or composite control, any control that is hosted into your dialog surface can get access to the methods and properties that your object model supports.
The following diagram shows the main interfaces that come into play.

ActiveX Container Object Model

Basically, to host an ActiveX component, the container must:

  • Call the object SetClientSite to inform the object of its display location, called a "Client Site".
  • Initialize the object properties; It uses IPersistStreamInit, IPersistPropertyBag for this purpose.
  • Call the object SetAdvise method in order to be notified of compound document events.
  • Then, call the object DoVerb method with OLEIVERB_INPLACEACTIVATE to activate the object.

The object then proceeds by:

  • Negotiating its activation by calling CanWindowlessActivate to find out if it can be activated "windowlessly"; if not possible, the control creates its own window.
  • Then, it calls OnInPlaceActivateEx but uses the activate flag to indicate whether it wants windowless activation.
  • Windowless object also calls GetWindowContext to find its position within the container.
  • Finally, the control calls the container ShowObject; This indicates to the container that the control is ready to be shown.

The container is also responsible for managing input focus, mouse capture and associating moniker for the object. The container dispatches mouse and keyboard messages to the windowless control by calling the OnWindowMessage method of the IOleInPlaceObjectWindowless interface. That way, the control may respond to regular inputs when it has focus. This is about all there is to it but the ActiveXContainerImpl class makes this process really transparent. Now, let's see some of it in action.

Using ActiveXContainerImpl Class

ActiveXContainerImpl class supports the following features:

  • Hosting both Windowless and window controls
  • Hosting multiple ActiveX controls in one container
  • Restrict mouse or keyboard input for individual controls (window or windowless)
  • Change control Z-Order (controls can be sent to: back, top, top-most)
  • Supports data moniker (controls are allowed to load data via the http://, file:///, res://)
  • Transparency Support (governed by Z-order position)
  • Rendering Windowless controls to memory DC or printer (not screen)

Hosting ActiveX controls inside of a dialog is basically the same as you did with ATL. You can safely rename your base class from CAxDialogImpl to CAxWindowlessHost. This class inherits from CDialogImplBaseT, thus, will have the same capabilities as any Windows dialog.

class CMainDlg : public CAxWindowlessHost<CMainDlg>
    enum { IDD = IDD_MAINDLG };


    LRESULT OnInitDialog(UINT /*uMsg*/, WPARAM /*wParam*/, 
		LPARAM /*lParam*/, BOOL& /*bHandled*/);
        LRESULT OnAppAbout(WORD /*wNotifyCode*/, WORD /*wID*/, 
		HWND /*hWndCtl*/, BOOL& /*bHandled*/);
        LRESULT OnOK(WORD /*wNotifyCode*/, WORD wID, 
		HWND /*hWndCtl*/, BOOL& /*bHandled*/);
        LRESULT OnCancel(WORD /*wNotifyCode*/, WORD wID, 
		HWND /*hWndCtl*/, BOOL& /*bHandled*/);

Let's get this started with some examples. The examples below assume that the controls are inserted using 'Insert ActiveX Control' from the dialog editor. You still have the flexibility to create everything manually at runtime.

Hosting Microsoft Windows Media Player

Windows Media Player supports windowless activation. Assuming you inserted a media player onto your dialog, the example below shows how you can turn it to windowless mode. Note that in the case of Windows Media Player, a custom property dialog is also available so you can configure your control at design time.

ActiveXSite* pSite;
pSite = CAxWindowlessHost<CMainDlg>::GetControlSite(IDC_WMP11);
if ( pSite != NULL )
    pSite->SetAllowResize(false); 	// turn-off resize or media will 
				// resize itself to match its content
    CComQIPtr<IWMPCore> wmp = pSite->ActiveXControl();
    CComQIPtr<IWMPPlayer4> wmp4 = pSite->ActiveXControl();
    if ( wmp4 ) {
        hr = wmp4->put_windowlessVideo( VARIANT_TRUE );
        hr = wmp4->put_uiMode( CComBSTR("Full") );
    hr = wmp->put_URL( CComBSTR("enter resource URL") );

Silverlight ActiveX Control

Hosting Adobe Flash Player

You can also host Flash content. Flash animations can be loaded for external file resources or retrieved from the internet. For example, you can add support for YouTube video provided that you correctly specify the URL of the resources. The example below shows how to initialize Adobe Flash player to host an animation or video.

ActiveXSite* pSite;
pSite = CAxWindowlessHost<CMainDlg>::GetControlSite(IDC_SHOCKWAVEFLASH);
if ( pSite != NULL )
    CComQIPtr<IShockwaveFlash> spFlash = pSite->ActiveXControl();
    hr = spFlash->put_WMode( CComBSTR("Transparent") );
    hr = spFlash->put_Movie( CComBSTR("enter resource URL") );

Setting Transparent mode is necessary to turn Adobe Flash to Windowless mode.

Hosting Microsoft Silverlight

XAML and Silverlight application package (*.xap) can be hosted using Microsoft Silverlight ActiveX control. For security reasons, you can only load data from file:/// or http:// moniker. It would have been nice to support the resource protocol (res://). The example below shows how to configure Silverlight to load external resources.

ActiveXSite* pSite;
pSite = CAxWindowlessHost<CMainDlg>::GetControlSite(IDC_AGCONTROL1);
if ( pSite != NULL )
    CComBSTR bstrUrl("enter resource URL");
    CComQIPtr<IXcpControl2> slight = pSite->ActiveXControl();
    hr = slight->put_Source(bstrUrl);

In this example, the control is prevented from receiving right clicks so the context menu is never shown.
The demo shows how to use Silverlight in Windowless mode.
A huge number of demos would have to be presented if I had to consider all the ActiveX controls that we have at our disposal. Windows Form ActiveX controls can be hosted by your application as well. A demo is provided here as well.


This article presents a complete and real solution for the ATL windowless ActiveX container issue. I've described the steps necessary to integrate three popular controls in your own dialog. It is quite easy to use other ActiveX controls as well. The container may be used to develop custom composite control. Probably the most interesting part was to show how you can integrate Silverlight Application package (*.xap,*.xaml) within your solution with little effort. I hope you will consider the features that it offers and put them to use in your own program.



  • 02/19/2009: Initial Release + Windows CE port
  • 03/05/2009: Updated for Silverlight in Windowless and Viewer mode


This article, along with any associated source code and files, is licensed under The Apache License, Version 2.0


About the Author

Ernest Laurentin
Software Developer (Senior)
United States United States
Ernest is a multi-discipline software engineer.
Skilled at software design and development for all Windows platforms.
Interests: User Interface, GDI/GDI+, Scripting, Android, iOS, Windows Mobile.
Programming Skills: C/C++, C#, Java (Android), VB and ASP.NET.

I hope you will enjoy my contributions.

Comments and Discussions

QuestionChange Z-Order Pin
Member 1295515126-Jan-17 22:15
MemberMember 1295515126-Jan-17 22:15 
QuestionI when start debugging, it is crashed in atlctl.h m_spInplaceSite->InvalidateRect(NULL, TRUE) Pin
maoliangwu20-Dec-16 1:12
Membermaoliangwu20-Dec-16 1:12 
QuestionBroken by C++11 / MSVC 2015 Pin
llothar2-Feb-16 22:10
Memberllothar2-Feb-16 22:10 
QuestionHow to implement a windowless ActiveX control? Pin
carlosrt26-Apr-13 1:16
Membercarlosrt26-Apr-13 1:16 
AnswerRe: How to implement a windowless ActiveX control? Pin
Ernest Laurentin26-Apr-13 5:03
MemberErnest Laurentin26-Apr-13 5:03 
QuestionRe: How to implement a windowless ActiveX control? Pin
carlosrt26-Apr-13 5:40
Membercarlosrt26-Apr-13 5:40 
AnswerRe: How to implement a windowless ActiveX control? Pin
Ernest Laurentin26-Apr-13 6:03
MemberErnest Laurentin26-Apr-13 6:03 
GeneralRe: How to implement a windowless ActiveX control? Pin
carlosrt30-Apr-13 0:50
Membercarlosrt30-Apr-13 0:50 
GeneralRe: How to implement a windowless ActiveX control? Pin
Ernest Laurentin30-Apr-13 6:56
MemberErnest Laurentin30-Apr-13 6:56 
AnswerRe: How to implement a windowless ActiveX control? Pin
carlosrt2-May-13 4:32
Membercarlosrt2-May-13 4:32 
QuestionControl Cursor Can not be displayed Pin
xwanger12-Mar-13 21:36
Memberxwanger12-Mar-13 21:36 
QuestionHow to use WFlashPlayer to play youtube videos where URL is hidden??? Pin
ramanujamkv22-Sep-11 20:37
Memberramanujamkv22-Sep-11 20:37 
GeneralRender to texture Pin
texel3d6-Mar-11 23:24
Membertexel3d6-Mar-11 23:24 
QuestionCreating Flash Containers at runtime? Pin
AhmedZI26-Nov-10 22:44
MemberAhmedZI26-Nov-10 22:44 
AnswerRe: Creating Flash Containers at runtime? Pin
Ernest Laurentin6-Dec-10 4:57
MemberErnest Laurentin6-Dec-10 4:57 
QuestionHow to make the background of the MainDlg tranparent? Pin
itmagina27-Jul-10 19:35
Memberitmagina27-Jul-10 19:35 
QuestionWhere can I find the sources at ..\Windowless\? Pin
Homero De la Garza2-Feb-10 11:50
MemberHomero De la Garza2-Feb-10 11:50 
AnswerRe: Where can I find the sources at ..\Windowless\? Pin
Ernest Laurentin2-Feb-10 12:25
MemberErnest Laurentin2-Feb-10 12:25 
GeneralRe: Where can I find the sources at ..\Windowless\? --- Sorry, my fault :| Pin
Homero De la Garza2-Feb-10 12:46
MemberHomero De la Garza2-Feb-10 12:46 
Generalwhen MAXIMIZE the View, cause crush Pin
crystalice543296112-Jan-10 1:02
Membercrystalice543296112-Jan-10 1:02 
GeneralHost multiple ActiveX controls Pin
crystalice54329619-Jan-10 22:36
Membercrystalice54329619-Jan-10 22:36 
GeneralRe: Host multiple ActiveX controls Pin
crystalice543296110-Jan-10 1:52
Membercrystalice543296110-Jan-10 1:52 
Questionport to WinCE ? Pin
christophegr31110-Dec-09 23:56
Memberchristophegr31110-Dec-09 23:56 
AnswerRe: port to WinCE ? Pin
Ernest Laurentin11-Dec-09 3:23
MemberErnest Laurentin11-Dec-09 3:23 
QuestionWhy the maindlg will not receive WM_CTLCOLORDLG message? Pin
kcynic26-Nov-09 0:02
Memberkcynic26-Nov-09 0:02 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.