NativeWindow Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

NativeWindow.cs

Proporciona una encapsulación de bajo nivel de un identificador de ventana y un procedimiento de ventana.

C#

public class NativeWindow : MarshalByRefObject, System.Windows.Forms.IWin32Window

Herencia

Object

MarshalByRefObject

NativeWindow

Implementaciones

IWin32Window

Ejemplos

En el ejemplo de código siguiente se muestra cómo interceptar mensajes de ventana del sistema operativo en un procedimiento de ventana y crear una ventana con un nombre de clase de ventana de sistema operativo específico. En el ejemplo se crean dos clases que heredan de NativeWindow esto.

La MyNativeWindowListener clase enlaza al procedimiento de ventana del formulario pasado al constructor e invalida el WndProc método para interceptar el mensaje de WM_ACTIVATEAPP ventana. La clase muestra el uso de los AssignHandle métodos y ReleaseHandle para identificar el identificador de ventana que NativeWindow usará. El identificador se asigna en función de los Control.HandleCreated eventos y Control.HandleDestroyed . Cuando se recibe el mensaje de WM_ACTIVATEAPP ventana, la clase llama al form1.ApplicationActivated método .

La MyNativeWindow clase crea una nueva ventana con el ClassName establecido en BUTTON. La clase muestra el uso del CreateHandle método y la invalidación del WndProc método para interceptar los mensajes de ventana que se reciben.

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using System.Runtime.InteropServices;

namespace NativeWindowApplication
{
    // Summary description for Form1.
    public class Form1 : System.Windows.Forms.Form
    {
        private MyNativeWindowListener nwl;
        private MyNativeWindow nw;

        internal void ApplicationActivated(bool ApplicationActivated)
        {
            // The application has been activated or deactivated
            System.Diagnostics.Debug.WriteLine("Application Active = " + ApplicationActivated.ToString());
        }

        private Form1()
        {
            this.Size = new System.Drawing.Size(300, 300);
            this.Text = "Form1";

            nwl = new MyNativeWindowListener(this);
            nw = new MyNativeWindow(this);
        }

        // The main entry point for the application.
        [STAThread]
        static void Main()
        {
            Application.Run(new Form1());
        }
    }

    // NativeWindow class to listen to operating system messages.
    internal class MyNativeWindowListener : NativeWindow
    {
        // Constant value was found in the "windows.h" header file.
        private const int WM_ACTIVATEAPP = 0x001C;

        private Form1 parent;

        public MyNativeWindowListener(Form1 parent)
        {

            parent.HandleCreated += new EventHandler(this.OnHandleCreated);
            parent.HandleDestroyed += new EventHandler(this.OnHandleDestroyed);
            this.parent = parent;
        }

        // Listen for the control's window creation and then hook into it.
        internal void OnHandleCreated(object sender, EventArgs e)
        {
            // Window is now created, assign handle to NativeWindow.
            AssignHandle(((Form1)sender).Handle);
        }
        internal void OnHandleDestroyed(object sender, EventArgs e)
        {
            // Window was destroyed, release hook.
            ReleaseHandle();
        }

        protected override void WndProc(ref Message m)
        {
            // Listen for operating system messages

            switch (m.Msg)
            {
                case WM_ACTIVATEAPP:

                    // Notify the form that this message was received.
                    // Application is activated or deactivated, 
                    // based upon the WParam parameter.
                    parent.ApplicationActivated(((int)m.WParam != 0));

                    break;
            }
            base.WndProc(ref m);
        }
    }

    // MyNativeWindow class to create a window given a class name.
    internal class MyNativeWindow : NativeWindow
    {

        // Constant values were found in the "windows.h" header file.
        private const int WS_CHILD = 0x40000000,
                          WS_VISIBLE = 0x10000000,
                          WM_ACTIVATEAPP = 0x001C;

        private int windowHandle;

        public MyNativeWindow(Form parent)
        {

            CreateParams cp = new CreateParams();

            // Fill in the CreateParams details.
            cp.Caption = "Click here";
            cp.ClassName = "Button";

            // Set the position on the form
            cp.X = 100;
            cp.Y = 100;
            cp.Height = 100;
            cp.Width = 100;

            // Specify the form as the parent.
            cp.Parent = parent.Handle;

            // Create as a child of the specified parent
            cp.Style = WS_CHILD | WS_VISIBLE;

            // Create the actual window
            this.CreateHandle(cp);
        }

        // Listen to when the handle changes to keep the variable in sync
        protected override void OnHandleChange()
        {
            windowHandle = (int)this.Handle;
        }

        protected override void WndProc(ref Message m)
        {
            // Listen for messages that are sent to the button window. Some messages are sent
            // to the parent window instead of the button's window.

            switch (m.Msg)
            {
                case WM_ACTIVATEAPP:
                    // Do something here in response to messages
                    break;
            }
            base.WndProc(ref m);
        }
    }
}

Comentarios

Esta clase administra automáticamente la creación y el registro de clases de ventana.

Una ventana no es apta para la recolección de elementos no utilizados cuando está asociada a un identificador de ventana. Para garantizar la recolección de elementos no utilizados adecuada, los identificadores deben destruirse manualmente mediante DestroyHandle o liberarse mediante ReleaseHandle.

Nota

Se ReleaseHandle llama al método cuando se procesa el mensaje de WM_NCDESTROY. Esto significa que hay casos en los que no es necesario llamar ReleaseHandlemanualmente a , pero es recomendable hacerlo.

La NativeWindow clase proporciona las siguientes propiedades y métodos para administrar los identificadores: Handle, CreateHandle, AssignHandle, DestroyHandley ReleaseHandle.

Constructores

NativeWindow()

Inicializa una instancia de la clase NativeWindow.

Propiedades

Handle

Obtiene el identificador de esta ventana.

Métodos

AssignHandle(IntPtr)	Asigna un identificador a esta ventana.
CreateHandle(CreateParams)	Crea una ventana y un identificador de dicha ventana con los parámetros de creación especificados.
DefWndProc(Message)	Invoca el procedimiento de ventana predeterminado que está asociado a esta ventana.
DestroyHandle()	Destruye la ventana y su identificador.
Finalize()	Libera los recursos asociados a esta ventana.
FromHandle(IntPtr)	Recupera la ventana asociada al identificador especificado.
OnHandleChange()	Especifica un método de notificación al que se llama cuando se cambia el identificador de una ventana.
OnThreadException(Exception)	Cuando se reemplaza en una clase derivada, administra una excepción de subproceso no controlada.
ReleaseHandle()	Libera el identificador asociado a esta ventana.
WmDpiChangedAfterParent(Message)	Proporciona una encapsulación de bajo nivel de un identificador de ventana y un procedimiento de ventana.
WmDpiChangedBeforeParent(Message)	Proporciona una encapsulación de bajo nivel de un identificador de ventana y un procedimiento de ventana.
WndProc(Message)	Invoca el procedimiento de ventana predeterminado que está asociado a esta ventana.

Se aplica a

Consulte también

• IntPtr
• Application
• AxHost
• Control
• Form
• IWin32Window
• Message