HwndSource Classe

Definizione

public ref class HwndSource : System::Windows::PresentationSource, IDisposable, System::Windows::Interop::IKeyboardInputSink, System::Windows::Interop::IWin32Window

public class HwndSource : System.Windows.PresentationSource, IDisposable, System.Windows.Interop.IKeyboardInputSink, System.Windows.Interop.IWin32Window

type HwndSource = class
    inherit PresentationSource
    interface IDisposable
    interface IWin32Window
    interface IKeyboardInputSink

type HwndSource = class
    inherit PresentationSource
    interface IDisposable
    interface IKeyboardInputSink
    interface IWin32Window

Public Class HwndSource
Inherits PresentationSource
Implements IDisposable, IKeyboardInputSink, IWin32Window

Ereditarietà

Object

DispatcherObject

PresentationSource

HwndSource

Implementazioni

IDisposable IKeyboardInputSink IWin32Window

Commenti

Implementa HwndSource una finestra Win32 che può contenere contenuto WPF. Il contenuto WPF nella finestra viene disposto, misurato e sottoposto a rendering; ed è interattivo per l'input. Poiché è HwndSource progettato specificamente per interagire con Win32, questa classe espone diverse funzionalità Win32 di basso livello. È possibile usare questa classe per eseguire le operazioni seguenti:

• Specificare gli stili delle finestre, gli stili della classe finestra e gli stili delle finestre estese.

• Associare la procedura della finestra.

• Fornire l'accesso all'handle di finestra (HWND).

• Eliminare la finestra.

La HwndSource classe è progettata per l'interoperabilità generale e non è progettata come wrapper HWND gestito. In generale, non fornisce metodi gestiti per modificare la finestra o le proprietà per controllarne lo stato. La classe fornisce invece HwndSource l'accesso all'handle della finestra Win32 (HWND) tramite la Handle proprietà , che può essere passata tramite tecniche PInvoke alle API Win32 per modificare la finestra.

Edilizia

Molti aspetti di HwndSource possono essere specificati solo in fase di costruzione. Per creare un oggetto HwndSource, creare prima una HwndSourceParameters struttura e popolarla con i parametri desiderati. Questi parametri includono quanto segue:

• Classe, finestra e stili di finestra estesi. È necessario usare PInvoke per modificare gli stili dopo la creazione della finestra. Non tutti gli stili possono essere modificati dopo la creazione della finestra. Consultare la documentazione di Win32 prima di modificare gli stili delle finestre.

• Posizione iniziale della finestra.

• Le dimensioni iniziali della finestra, che includono se le dimensioni sono specificate o devono essere determinate dalle dimensioni determinate del contenuto WPF.

• Finestra padre.

• Oggetto HwndSourceHook da includere nella catena di procedure della finestra. Se si specifica un hook in fase di costruzione, riceve tutti i messaggi per la finestra. È possibile usare AddHook per aggiungere un hook dopo la creazione della finestra.

• Impostazioni di trasparenza. Una finestra di primo livello può essere configurata per la fusione con le altre finestre sul desktop in base alla trasparenza per pixel del contenuto WPF. Per abilitare questa impostazione, impostare la UsesPerPixelOpacity proprietà in su HwndSourceParameterstrue. Questa proprietà può essere specificata solo in fase di costruzione e solo tramite la firma del HwndSource(HwndSourceParameters) costruttore e impone diverse limitazioni.

Dopo aver popolato la HwndSourceParameters struttura, passarla al HwndSource(HwndSourceParameters) costruttore per .HwndSource

Durata dell'oggetto

Un HwndSource è un normale oggetto COMMON Language Runtime (CLR) e la relativa durata viene gestita dal Garbage Collector. Poiché rappresenta HwndSource una risorsa non gestita, HwndSource implementa IDisposable. La chiamata Dispose sincrona elimina immediatamente la finestra Win32 se viene chiamata dal thread proprietario. Se viene chiamato da un altro thread, la finestra Win32 viene eliminata definitivamente in modo asincrono. La chiamata Dispose esplicita dal codice di interoperabilità potrebbe essere necessaria per determinati scenari di interoperabilità.

Procedure finestra

La HwndSource classe implementa la propria routine finestra. Questa procedura della finestra viene usata per elaborare messaggi di finestra importanti, ad esempio quelli correlati al layout, al rendering e all'input. Tuttavia, è anche possibile collegare la procedura della finestra per il proprio uso. È possibile specificare il proprio gancio durante la costruzione impostando la HwndSourceParameters.HwndSourceHook proprietà oppure è anche possibile usare AddHook e RemoveHook aggiungere e rimuovere ganci dopo la creazione della finestra. Gli hook vengono chiamati dall'ordine last-in first-out, che consente agli hook di eseguire prima dell'elaborazione predefinita. I ganci effettivi sono mantenuti da un riferimento debole. Assicurarsi quindi di gestire la durata del delegato hook.

Per altre informazioni su HwndSource e altre classi di interoperabilità, vedere Interoperabilità WPF e Win32.

Si noti come i costruttori per prendere parametri simili ai parametri per HwndSource le funzioni Win32, ad esempio CreateWindowEx.

Le trasformazioni di scalabilità non devono essere applicate all'oggetto RootVisual di un HwndSourceoggetto . Vedere Osservazioni per RootVisual.

Costruttori

Proprietà

Metodi

Eventi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• HwndHost