embedding/browser/activex/src/pluginhostctrl/README.txt

   1 ActiveX control for hosting Netscape plugins in IE
   2 ==================================================
   3
   4 This folder contains an ActiveX control that allows you to host
   5 NP API compatible plugins within Internet Explorer. It's pretty simple to
   6 use and is a self-contained DLL called pluginhostctrl.dll. It has no runtime
   7 or build dependencies on any other
   8 part of the Mozilla
   9
  10
  11 To build
  12 ========
  13
  14 1. Open pluginhostctrl.dsp
  15 2. Build "Win32 Debug" or another target
  16 3. Open some of the test files in IE to verify it works
  17
  18 The control currently reads plugins from your most current Netscape 4.x
  19 installation. There is no support for Mozilla or NS 6.x yet.
  20
  21 A note to developers: If you intend to modify this control IN ANY WAY then
  22 you MUST also change the CLSID. This is necessary to prevent your control
  23 from registering itself over this control or vice versa.
  24
  25 Use a tool such as guidgen.exe or uuidgen.exe to create a new CLSID.
  26
  27
  28 Manual installation
  29 ===================
  30
  31 Assuming you have the precompiled DLL and wish to install it on a machine,
  32 you must register it:
  33
  34 regsvr32 pluginhostctrl.dll
  35
  36 You must have administrator privileges to install a new control on
  37 operating systems such as Windows NT, 2000 & XP.
  38
  39
  40 Usage
  41 =====
  42
  43 Insert some HTML like this into your content:
  44
  45 <OBJECT CLASSID="CLSID:DBB2DE32-61F1-4F7F-BEB8-A37F5BC24EE2"
  46      WIDTH="500" HEIGHT="300">
  47   <PARAM name="type" value="video/quicktime"/>
  48   <PARAM name="src" value="http://www.foobar.com/some_movie.mov"/>
  49   <!-- Custom arguments -->
  50   <PARAM name="loop" value="true"/>
  51 </OBJECT>
  52
  53 The CLSID attribute tells IE to create an instance of the plugin hosting
  54 control, the width and height specify the dimensions in pixels.
  55
  56 The following <EMBED> attributes have <PARAM> tag equivalents:
  57
  58 * <PARAM name="type" ...> is equivalent to TYPE
  59   Specifies the MIME type of the plugin. The control uses this value to
  60   determine which plugin it should create to handle the content.
  61
  62 * <PARAM name="src" ...> is equivalent to SRC
  63   Specifies an URL for the initial stream of data to feed the plugin.
  64   If you havent't specified a "type" PARAM, the control will attempt to use
  65   the MIME type of this stream to create the correct plugin.
  66
  67 * <PARAM name="pluginspage" ...> is equivalent to PLUGINSPAGE
  68   Specifies a URL where the plugin may be installed from. The default
  69   plugin will redirect you to this page when you do not have the correct
  70   plugin installed.
  71
  72 You may also supply any custom plugin parameters as additional <PARAM>
  73 elements.
  74
  75
  76 Still to do
  77 ===========
  78
  79 * Only hosts windowed plugins.
  80 * Doesn't work for the Adobe Acrobat plugin yet.
  81 * No progress indication to show when there is network activity
  82 * Plugins cannot create writeable streams.
  83 * Package pluginhostctrl.dll into a CAB file automatic installation in IE.