En un post anterior detallé los pasos básicos necesarios para la implementación de un ActiveX con .NET (C#). Pero faltó por describir aquellos necesarios para la interacción de la página HTML con el ActiveX y de este con la página.

Interacción de la página con el ActiveX

La interacción de la página con el ActiveX consiste en poder llamar a métodos del ActiveX o establecer y/o recuperar valores de propiedades públicas del mismo.

Para establecer el valor de una propiedad haremos lo siguiente:

  1. Marcar la propiedad, a la que queremos acceder desde la página, como visible para COM.
  2. [ComVisible(true)]
    public string Property1
    {
        get; set;
    }
  3. Establecer el valor de la propiedad pasándolo como parámetro del ActiveX
  4. <object id="MyActiveX" width="306px" height="167px" classid="clsid:D857B4F5-8684-453e-82C8-7F493CBE5592"
                viewastext style="border-style:dashed">
        <param name="Property1" value="desde Javascript" />
        <p>
            Pon el texto que quieras mostrar si se abre la página con un browser no compatible
            o si el ActiveX no está instalado correctamente.             
        </p>
    </object>
  5. Recuperar el valor de la propiedad del ActiveX
  6. <script type="text/javascript">
        function Method1() {
            alert(MyActiveX.Property1);
        }
    </script>

Para llamar a un método del ActiveX haremos lo siguiente:

  1. Marcar el método que queremos llamar como visible para COM.
  2. [ComVisible(true)]
    public void Method1()
    {
        MessageBox.Show("Hola Mundo desde Javascript");
    }
  3. Llamar el método desde la página.
  4. <script type="text/javascript">
        function Method2() {
            MyActiveX.Method1();
        }
    </script>
    y si abrimos la página en Internet Explorer y hacemos clic en el nuevo botón veremos lo siguiente
    LlamadaDesdeJS

Interaccion del ActiveX con la página

La interacción del ActiveX con la página consiste en poder ejecutar código javascript desde el ActiveX. Esta funcionalidad esta muy bien descrita en este artículo de microsoft y en esencia se trata de crear eventos en .NET y suscribirse a estos desde javascript.

Para ello implementamos la siguiente interface.

using System.Runtime.InteropServices;

namespace MyActiveX
{
    public delegate void ControlEventHandler(string eventArgs);

    [Guid("0422D916-C11A-474e-947D-45A107038D12")]
    [InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
    [ComVisible(true)]
    public interface IControlEvents
    {
        [DispId(0x60020000)]
        void Execute(string handler);
    }
}

Marcamos el control tal como sigue

[ClassInterface(ClassInterfaceType.AutoDispatch), ComSourceInterfaces(typeof(IControlEvents))]
[ComVisible(true), Guid("D857B4F5-8684-453e-82C8-7F493CBE5592")]
public partial class MyUserControl : UserControl
{
    ...
}

Luego creamos un evento y el método que lo dispara

public event ControlEventHandler Execute;

private void OnExecute(string handler)
{
    if (Execute != null)
        Execute(handler);
}

Una vez hecho esto en la página HTML nos suscribimos al evento de la siguiente forma

<script type="text/javascript">        
    function MyActiveX::Execute(param)
    {
        alert(param)
    }
</script>

y ya solo los queda llamarlo cuando haga falta. Para este ejemplo la llamada la haremos al hacer click en un botón del control.

mapping_events

y esto ha sido todo. Creo que solo quedaría lo relacionado con marcar el ActiveX como seguro para scripting pero eso es algo que podemos retomar en otro post. Mientras tanto aquí les dejo el código fuente.


Hay muchas formas de hacer que una aplicación de escritorio (Windows Form, WPF) ejecute una y solo una instancia a la vez. Existen muy buenos artículos en internet que hablan de este tema, pero en este post quiero mostrar la que para mi es la manera mas fácil y rápida de lograr esta funcionalidad.

Lo primero que tenemos que hacer cuando creamos el proyecto donde queremos implementar esta característica es agregar la referencia a ensamblado “Microssoft.VisualBasic.dll”

Microsoft.VisualBasic.dll

Luego creamos una clase que herede de WindowsFormsApplicationBase para ello necesitamos incluir el siguiente usgin

using Microsoft.VisualBasic.ApplicationServices;

La implementación de la clase puede ser algo como lo que sigue:

class MyApp : WindowsFormsApplicationBase
{
    //Creamos el constructor y especificamos la forma en que 
    //la aplicación inicializará el objeto My.User de VisualBasic
    public MyApp() : base(AuthenticationMode.ApplicationDefined)
    {
        //Especificamos que solo queremos que se ejecute una solo instancia de la aplicación
        IsSingleInstance = true;
    }

    protected override void OnCreateMainForm()
    {
        //Indicamos cual será el formulario principal de la aplicación
        MainForm = new Form1();
		base.OnCreateMainForm();
    }
}

Una vez hecho esto solo hay que sustituir la llamada a Form1 en el método inicial de la aplicación por la llamada al método Run de la clase que hemos creado.

static class Program
{
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        
        //Application.Run(new Form1()); esto es lo que sustituimos por la línea que sigue a continuación

        new MyApp().Run(new string[0]);
    }
}

y con esto garantizamos que la aplicación solo ejecute una solo instancia.

Pasando Argumentos

Existen ocasiones donde es necesario pasarle argumentos a la aplicación para que esta tenga un comportamiento especial en función de los dichos parámetros. En este caso podríamos pasar los argumentos en la llamada al método Run de la aplicación.

static class Program
{
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main(string[] args)
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        
        //Application.Run(new Form1());
        new MyApp().Run(args);
    }
}

y luego en los métodos OnStartup y OnStartupNextInstance manejar el comportamiento de la aplicación en función de dichos parámetros.

protected override bool OnStartup(StartupEventArgs eventArgs)
{
    //Hacer algo con los parámetros recibidos (eventArgs.CommandLine)
    return base.OnStartup(eventArgs);
}

protected override void OnStartupNextInstance(StartupNextInstanceEventArgs eventArgs)
{
    //Hacer algo con los parámetros recibidos (eventArgs.CommandLine)
    base.OnStartupNextInstance(eventArgs);
}

Como hemos podido ver esta es una forma muy sencilla de implementar una aplicación que solo abra una instancia a la vez. Más información sobre la clase WindowsFormsApplicationBase en MSDN

Puedes descargarte el código fuente desde aquí


 |