Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

HwndSource (Clase)

Muestra el contenido de Windows Presentation Foundation (WPF) en una ventana de Win32 .

Espacio de nombres:  System.Windows.Interop
Ensamblado:  PresentationCore (en PresentationCore.dll)

public class HwndSource : PresentationSource, IDisposable, 
	IWin32Window, IKeyboardInputSink

El tipo HwndSource expone los siguientes miembros.

  NombreDescripción
Método públicoHwndSource(HwndSourceParameters)Inicializa una nueva instancia de la clase de HwndSource mediante una estructura que contiene la configuración inicial.
Método públicoHwndSource(Int32, Int32, Int32, Int32, Int32, String, IntPtr)Inicializa una nueva instancia de la clase de HwndSource con un estilo especificado de la clase, un estilo, estilo extendido, la posición x-y, nombre, y la ventana primaria.
Método públicoHwndSource(Int32, Int32, Int32, Int32, Int32, Int32, Int32, String, IntPtr)Inicializa una nueva instancia de la clase de HwndSource con un estilo especificado de la clase, un estilo, estilo extendido, la posición x-y, el ancho, alto, el nombre, y la ventana primaria.
Método públicoHwndSource(Int32, Int32, Int32, Int32, Int32, Int32, Int32, String, IntPtr, Boolean)Inicializa una nueva instancia de la clase de HwndSource con un estilo especificado de la clase, un estilo, estilo extendido, la posición x-y, el ancho, alto, el nombre, y la ventana primaria, y especificar si la ventana autosized.
Arriba

  NombreDescripción
Propiedad públicaAcquireHwndFocusInMenuModeObtiene el valor que determina si adquirir el foco de Win32 para WPF que contiene la ventana para este HwndSource.
Propiedad públicaChildKeyboardInputSinksObtiene una secuencia de receptores registrados de entrada.
Propiedad públicaCompositionTargetObtiene el administrador visual de la ventana hospedada.
Propiedad públicaMiembro estáticoDefaultAcquireHwndFocusInMenuModeobtiene o establece el valor predeterminado de AcquireHwndFocusInMenuMode para las nuevas instancias de HwndSource.
Propiedad públicaDispatcherObtiene Dispatcher que este DispatcherObject es asociado. (Se hereda de DispatcherObject).
Propiedad públicaHandleobtiene el identificador de ventana para este HwndSource.
Propiedad públicaIsDisposedObtiene un valor que indica si Dispose se ha en este HwndSource. (Invalida a PresentationSource.IsDisposed).
Propiedad protegidaKeyboardInputSiteCoreObtiene o establece una referencia a la interfaz de IKeyboardInputSite del contenedor del componente.
Propiedad públicaRestoreFocusModeobtiene RestoreFocusMode para la ventana.
Propiedad públicaRootVisualobtiene o establece RootVisual de la ventana. (Invalida a PresentationSource.RootVisual).
Propiedad públicaSizeToContentObtiene o establece si y cómo la ventana se ajusta a su contenido.
Propiedad públicaUsesPerPixelOpacityObtiene un valor que declara si la opacidad del píxel del contenido de la ventana de origen está respetada.
Arriba

  NombreDescripción
Método públicoAddHookAgrega un controlador de eventos que recibe todos los mensajes de la ventana.
Método protegidoAddSourceAgrega una instancia de la clase derivada de PresentationSource a la lista de orígenes conocidos de presentación. (Se hereda de PresentationSource).
Método públicoCheckAccessdetermina si el subproceso de la llamada tiene acceso a este DispatcherObject. (Se hereda de DispatcherObject).
Método protegidoClearContentRenderedListenersEstablece la lista de agentes de escucha para el evento de ContentRendered a null. (Se hereda de PresentationSource).
Método públicoCreateHandleRefobtiene el identificador de ventana para HwndSource. el identificador de ventana se empaqueta como parte de una estructura de HandleRef .
Método públicoDisposeLibera todos incluye los recursos utilizados por HwndSource, y produce el evento de Disposed .
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoMiembro estáticoFromHwnddevuelve el objeto de HwndSource de la ventana especificada.
Método protegidoGetCompositionTargetCoreobtiene el destino visual de la ventana. (Invalida a PresentationSource.GetCompositionTargetCore()).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoHasFocusWithinCoreObtiene un valor que indica si el receptor o uno de sus componentes contenidos tiene el foco.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnMnemonicCoreLlamado cuando una de las teclas aceleradoras (teclas de acceso) para este receptor se invoca.
Método protegidoRegisterKeyboardInputSinkCoreregistra la interfaz de IKeyboardInputSink de un componente contenido.
Método públicoRemoveHookQuitar los controladores de eventos agregados por AddHook.
Método protegidoRemoveSourceQuita una instancia de la clase derivada de PresentationSource de la lista de orígenes conocidos de presentación. (Se hereda de PresentationSource).
Método protegidoRootChangedProporciona notificación que la raíz Visual ha cambiado. (Se hereda de PresentationSource).
Método protegidoTabIntoCoreLos conjuntos se centran en la primera tabuladores o tabulación del receptor.
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoTranslateAcceleratorCoreprocesa entrada de teclado en el nivel de mensaje de la tecla-abajo.
Método protegidoTranslateCharCoreLos mensajes de entrada de los procesos WM_CHAR, WM_SYSCHAR, de WM_DEADCHAR, y de WM_SYSDEADCHAR antes del método de OnMnemonic se llaman.
Método públicoVerifyAccessSe aplica al subproceso de llamada tiene acceso a este DispatcherObject. (Se hereda de DispatcherObject).
Arriba

  NombreDescripción
Evento públicoAutoResizedSe produce cuando el diseño representa HwndSource automáticamente para cambiar el tamaño.
Evento públicoContentRenderedSe produce cuando se genera el contenido y listo para la interacción con el usuario. (Se hereda de PresentationSource).
Evento públicoDisposedSe produce cuando el método de Dispose se llama en este objeto.
Evento públicoSizeToContentChangedSe produce cuando el valor de la propiedad de SizeToContent .
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIKeyboardInputSink.HasFocusWithinPara obtener una descripción de este miembro, vea IList.Remove.
Implementación explícita de interfacesPropiedad privadaIKeyboardInputSink.KeyboardInputSitePara obtener una descripción de este miembro, vea KeyboardInputSite.
Implementación explícita de interfacesMétodo privadoIKeyboardInputSink.OnMnemonicPara obtener una descripción de este miembro, vea el OnMnemonic.
Implementación explícita de interfacesMétodo privadoIKeyboardInputSink.RegisterKeyboardInputSinkPara obtener una descripción de este miembro, vea RegisterKeyboardInputSink.
Implementación explícita de interfacesMétodo privadoIKeyboardInputSink.TabIntoPara obtener una descripción de este miembro, vea TabInto.
Implementación explícita de interfacesMétodo privadoIKeyboardInputSink.TranslateAcceleratorPara obtener una descripción de este miembro, vea el TranslateAccelerator.
Implementación explícita de interfacesMétodo privadoIKeyboardInputSink.TranslateCharPara obtener una descripción de este miembro, vea el TranslateChar.
Arriba

Nota de seguridadNota sobre la seguridad

Muchos miembros de esta clase no están disponibles en la zona de seguridad de Internet.

HwndSource implementa una ventana de Win32 que puede contener el contenido de WPF . el contenido de WPF en la ventana se organiza, se mide, y se genera; y es interactivo ENTRAR. Dado que HwndSource está diseñado específicamente para interoperar con Win32, expone de esta clase varias características bajas de Win32 . Puede utilizar esta clase para hacer lo siguiente:

  • Especifique los estilos de ventana, los estilos de clase de ventana, y los estilos de ventana extendidas.

  • enlace el procedimiento de ventana.

  • Proporciona acceso al identificador de ventana (HWND).

  • destruya la ventana.

La clase de HwndSource está diseñado para la interoperabilidad general y no está diseñado como contenedor administrado de HWND. No proporciona normalmente métodos administrados para manipular la ventana o propiedades para inspeccionar su estado. En su lugar, la clase de HwndSource proporciona acceso al identificador de ventana de Win32 (HWND) mediante la propiedad de Handle , que se puede pasar mediante las técnicas de PInvoke a  Win32API para manipular la ventana.

construcción

Muchos aspectos de HwndSource solo se pueden especificar en el momento de la construcción. Para crear HwndSource, crear primero una estructura de HwndSourceParameters y rellenarla con los parámetros deseados. Estos parámetros incluyen:

  • La clase, la ventana, y los estilos de ventana extendidas. Debe utilizar PInvoke para cambiar los estilos después de crear la ventana. No todos los estilos pueden cambiar después de crear la ventana. Vea la documentación de Win32 antes de cambiar estilos de ventana.

  • la posición inicial de la ventana.

  • El tamaño inicial de la ventana, que incluye si el tamaño está especificado o se debe determinar el tamaño resuelto del contenido de WPF .

  • la ventana primaria.

  • HwndSourceHook a incluir en la cadena de procedimiento de ventana. Si especifica un enlace en tiempo de construcción, recibe todos los mensajes de la ventana. Puede utilizar AddHook para agregar un enlace después de crear la ventana.

  • Los valores de transparencia. Una ventana de nivel superior se puede configurar para combinar con otras ventanas del escritorio según la transparencia de píxel de contenido de WPF . para habilitar esto, establezca la propiedad de UsesPerPixelOpacity en HwndSourceParameters a true. Esta propiedad solo se puede especificar en el momento de la construcción, y sólo a través de la firma del constructor de HwndSource(HwndSourceParameters) , e impone varias limitaciones.

Una vez rellenado la estructura de HwndSourceParameters , pásela al constructor de HwndSource(HwndSourceParameters) para HwndSource.

Duración del objeto

HwndSource es un objeto regular de common language runtime (CLR) , y su duración es administrada por el recolector de elementos no utilizados. Dado que HwndSource representa un recurso no administrado, HwndSource implementa IDisposable. Sincrónicamente llamar Dispose inmediatamente destruye la ventana de Win32 si se llama desde el subproceso propietario. Si se llama desde otro subproceso, la ventana de Win32 se destruye de forma asincrónica. La llamada Dispose explícitamente de código que interoperaba podría ser para ciertos escenarios necesarias de interoperación.

procedimientos de ventana

la clase de HwndSource implementa su propio procedimiento de ventana. Este procedimiento de ventana se utiliza para procesar mensajes importantes de la ventana, como los relacionados con el diseño, la presentación, y la entrada. Sin embargo, también puede enlazar el procedimiento de ventana para su propio uso. Puede especificar dispone el enlace durante la construcción estableciendo la propiedad de HwndSourceParameters.HwndSourceHook , o también puede utilizar AddHook y RemoveHook para agregar y quitar enlaces después de crear la ventana. El orden de último en entrar, primero en salir se llama a los enlaces, que permite enlaces se ejecute antes que el procesamiento integrado. Una referencia parcial retienen enlaces reales. Por consiguiente, asegúrese de que se pueden administrar la duración del delegado de enlace.

Para obtener más información sobre HwndSource y otras clases de interoperación, vea Interoperabilidad de WPF y Win32.

El anuncio cómo los constructores para HwndSource toman los parámetros que se parecen a los parámetros para Win32 funciona CreateWindowExcomo.

Las transformaciones de escala no se deben aplicar a RootVisual de HwndSource. Vea las notas de RootVisual.

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft