How To Enumerate OLE and VB Controls from an OLE Control

转载 2006年05月26日 12:34:00
This article was previously published under Q141414


For an OLE control to communicate with another control placed on the same Visual Basic form, the OLE control needs access to at least one interface pointer of the other control. This article illustrates a technique you can use to enumerate both OLE and Visual Basic controls present on a particular form and retrieve an interface pointer to these controls. Note that the same technique could be applied to enumerate controls placed on other control containers, provided that container exposes the functionality required to implement the technique.


Given a pointer to IOleClientSite, it is possible to enumerate through all of the other controls on a form by making use of the following interfaces:
Note that most of these interfaces are container-side interfaces, so the technique mentioned here is container dependent. For this method to work, the container must provide support for IOleContainer, which is currently defined as a mandatory interface in the OLE control container guidelines. Both MFC version 4.0 and greater and Visual Basic version 4.0 and greater OLE control containers provide support for this interface. Before using this method with another control container, ensure that it provides support for IOleContainer.

The method itself is illustrated by the sample code listed in this article. You can incorporate the code into an OLE control generated using ControlWizard. Use the code to enumerate all the controls, internal Visual Basic controls as well OLE controls, by calling IOleContainer::EnumObjects, and passing the following flags as its first parameter:
   OLECONTF_EMBEDDINGS: is used to retrieve OLE Controls.
   OLECONTF_OTHERS    : is used to retrieve other objects such as Visual
                        Basic internal controls.

   hr = lpContainer->EnumObjects(OLECONTF_EMBEDDINGS | OLECONTF_OTHERS,
The differentiating aspect between OLE controls and other objects such as internal Visual Basic controls is that only OLE controls support the IOleObject interface. Hence, if a QueryInterface for IID_IOleObject fails for an object, then it is a different type of object. Also, if the control container provides support for Extended controls as does Visual Basic 4.0, the Extended control for a particular OLE control can also be retrieved using the method illustrated by the sample code.

Note that most of the functionality provided by the following sample code depends solely on the extent of the functionality exposed by the control container itself.

Also note that the LPOLECLIENTSITE pointer can be obtained through a call to COleControl::GetClientSite().

Sample Code

void EnumAllControlNames(LPOLECLIENTSITE lpSite)
   LPOLECONTAINER lpContainer;

   // Note that the IOleContainer interface is currently defined as
   // mandatory. It must be implemented by control containers,
   // in the OLE Control Containers Guidelines.
   HRESULT hr = lpSite->GetContainer(&lpContainer);
   if(FAILED(hr)) {
      OutputDebugString(_T("Unable to get to the container./n"));

   // OLECONTF_EMBEDDINGS is used to retrieve OLE Controls.
   // OLECONTF_OTHERS is used to retrieve other objects such as
   // Visual Basic internal controls
   hr = lpContainer->EnumObjects(
   if(FAILED(hr)) {

   while (lpEnumUnk->Next(1, &lpUnk, NULL) == S_OK) {
      LPOLEOBJECT lpObject = NULL;
      LPOLECLIENTSITE lpClientSite = NULL;
      LPDISPATCH lpDisp;

      hr = lpUnk->QueryInterface(
                    IID_IOleObject, (LPVOID*)&lpObject);
      if(SUCCEEDED(hr)) {
         // This is an OLE control.
         // Navigate to the Extended Control because Visual Basic 4.0 uses
         // Extended controls.
         hr = lpObject->GetClientSite(&lpClientSite);
         if(SUCCEEDED(hr)) {
            // You have the IOleClientSite interface
            hr = lpClientSite->QueryInterface(
                       IID_IOleControlSite, (LPVOID*)&lpTargetSite);
            if(SUCCEEDED(hr)) {
               // You have the IOleControlSite interface
               // Get the IDispatch for the extended control.
               // Note that Extended controls are optional in the OLE
               // specifications for OLE Control Containers.
               hr = lpTargetSite->GetExtendedControl(&lpDisp);
      else {
         // This is either an internal VB control or the
         // VB form itself.
         hr = lpUnk->QueryInterface(
                       IID_IDispatch, (LPVOID*)&lpDisp);

      if(SUCCEEDED(hr)) {
         VARIANT va;
         DISPID dispid;
         DISPPARAMS dispParams = { NULL, NULL, 0, 0 };

         // Get the names of all the controls present in a VB form.
         LPWSTR lpName[1] = { (WCHAR *)L"Name" };
         hr = lpDisp->GetIDsOfNames(IID_NULL, lpName, 1,
                                      LOCALE_SYSTEM_DEFAULT, &dispid);

         if(SUCCEEDED(hr)) {
            hr = lpDisp->Invoke(dispid/*0x80010000*/, IID_NULL,
                                  DISPATCH_PROPERTYGET |
                                  &dispParams, &va, NULL, NULL);
            if(SUCCEEDED(hr)) {
               CString szTmp((LPCWSTR)va.bstrVal);
               // szTmp now has the name.
               OutputDebugString(_T("And the name is ... ") + szTmp +

      // Release interface pointers.
      if(lpObject)     lpObject->Release();
      if(lpTargetSite) lpTargetSite->Release();
      if(lpClientSite) lpClientSite->Release();

   }    // End of While statement

   // Final clean up
Additional words: VB VC visualc cdk ocx


How to Use OLE in Rich Edit Controls

This section contains information about using object linking and embedding (OLE) in rich edit contro...

转载:how to automate Microsoft Excel and return the values from a multi-cell range to an array

how to automate Microsoft Excel and return the values from a multi-cell range to an array.
  • buyicn
  • buyicn
  • 2011年05月01日 16:30
  • 469

How to get an X11 Window from a Process ID? Under Linu...

How To Create manually an ASM Instance From Scratch

        This note will explain how to create an ASM instance from scratch instead of using DBCA. 步骤如...

How to design an FPGA from scratch-1_FPGA_8_24

Editor's Note: As you will soon discover, the author – Sven – has created the most fantastic on-goin...

How to manually remove an infected file from your computer

How to manually remove an infected file from your computer In order to manually remove an infected ...

How to Copy an Assembly From the GAC to the File System Som...
  • lJean
  • lJean
  • 2011年06月03日 17:35
  • 764

How to Convert An audio From m4a to pcm

您举报文章:How To Enumerate OLE and VB Controls from an OLE Control