Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Classe HwndSource

presente Windows Presentation Foundation (WPF) contenuto in un oggetto Win32 finestra.

Spazio dei nomi:  System.Windows.Interop
Assembly:  PresentationCore (in PresentationCore.dll)

public class HwndSource : PresentationSource, IDisposable, 
	IWin32Window, IKeyboardInputSink

Il tipo HwndSource espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoHwndSource(HwndSourceParameters)Inizializza una nuova istanza di HwndSource classe tramite una struttura contenente le impostazioni iniziali.
Metodo pubblicoHwndSource(Int32, Int32, Int32, Int32, Int32, String, IntPtr)Inizializza una nuova istanza di HwndSource classe con un determinato stile della classe, uno stile, uno stile esteso, la posizione del piano x-y, il nome e la finestra padre.
Metodo pubblicoHwndSource(Int32, Int32, Int32, Int32, Int32, Int32, Int32, String, IntPtr)Inizializza una nuova istanza di HwndSource classe con un determinato stile della classe, uno stile, uno stile esteso, la posizione del piano x-y, la larghezza, l'altezza, il nome e la finestra padre.
Metodo pubblicoHwndSource(Int32, Int32, Int32, Int32, Int32, Int32, Int32, String, IntPtr, Boolean)Inizializza una nuova istanza di HwndSource classe con un determinato stile della classe, uno stile, uno stile esteso, la posizione del piano x-y, la larghezza, l'altezza, il nome e la finestra padre e specificando se la finestra autosized.
In alto

  NomeDescrizione
Proprietà pubblicaAcquireHwndFocusInMenuModeOttiene il valore che determina se acquisire lo stato attivo Win32 per WPF che contiene la finestra per questo HwndSource.
Proprietà pubblicaChildKeyboardInputSinksottiene una sequenza di sink di input registrati.
Proprietà pubblicaCompositionTargetOttiene il gestore visualizzazione della finestra di hosting.
Proprietà pubblicaMembro staticoDefaultAcquireHwndFocusInMenuModeOttiene o imposta l'oggetto predefinito AcquireHwndFocusInMenuMode valore per le nuove istanze di HwndSource.
Proprietà pubblicaDispatcher ottiene l'oggetto Dispatcher al quale l'oggetto DispatcherObject è associato. (Ereditato da DispatcherObject)
Proprietà pubblicaHandleOttiene un handle di finestra per questo HwndSource.
Proprietà pubblicaIsDisposedottiene un valore che indica se Dispose è stato chiamato su l HwndSource. (Esegue l'override di PresentationSource.IsDisposed).
Proprietà protetta.KeyboardInputSiteCoreOttiene o imposta un riferimento al contenitore del componente IKeyboardInputSite interfaccia.
Proprietà pubblicaRestoreFocusModeottiene RestoreFocusMode per la finestra.
Proprietà pubblicaRootVisualottiene o imposta RootVisual la finestra. (Esegue l'override di PresentationSource.RootVisual).
Proprietà pubblicaSizeToContentOttiene o imposta se la finestra viene ridimensionata in base al contenuto.
Proprietà pubblicaUsesPerPixelOpacityOttiene un valore che indica se l'opacità del per-pixel del contenuto della finestra di origine viene rispettata.
In alto

  NomeDescrizione
Metodo pubblicoAddHookAggiungere un gestore eventi che vengono ricevuti tutti i messaggi della finestra.
Metodo protettoAddSourceAggiunge un oggetto PresentationSource istanza della classe derivata all'elenco di origini noti di presentazione. (Ereditato da PresentationSource)
Metodo pubblicoCheckAccessdetermina se il thread chiamante ha accesso a questo DispatcherObject. (Ereditato da DispatcherObject)
Metodo protettoClearContentRenderedListenersImposta l'elenco di listener per ContentRendered evento a null. (Ereditato da PresentationSource)
Metodo pubblicoCreateHandleRefOttiene un handle di finestra per HwndSource. L'handle della finestra sono incluse come parte di un'istruzione HandleRef struttura.
Metodo pubblicoDisposeLibera tutte le risorse gestite utilizzate da l HwndSourcee aumenta Disposed evento.
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoMembro staticoFromHwndrestituisce HwndSource oggetto della finestra specificata.
Metodo protettoGetCompositionTargetCoreOttiene il database di destinazione visivo della finestra. (Esegue l'override di PresentationSource.GetCompositionTargetCore()).
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (Ereditato da Object)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo protettoHasFocusWithinCoreOttiene un valore che indica se il sink o quello dei relativi componenti contenute ha lo stato attivo.
Metodo protettoMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protettoOnMnemonicCoreChiamato quando uno dei tasti di scelta (tasti di scelta per il sink viene richiamato.
Metodo protettoRegisterKeyboardInputSinkCoreregistra IKeyboardInputSink interfaccia di un componente contenuto.
Metodo pubblicoRemoveHookRimuove i gestori eventi che sono stati aggiunti da AddHook.
Metodo protettoRemoveSourceRimuove un oggetto PresentationSource istanza della classe derivata dall'elenco di origini noti di presentazione. (Ereditato da PresentationSource)
Metodo protettoRootChangedfornisce la notifica che la radice Visual è stata modificata. (Ereditato da PresentationSource)
Metodo protettoTabIntoCoreImposta lo stato attivo sulla prima tabulazione oultima tabulazione del sink.
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo protettoTranslateAcceleratorCoreElabora l'input della tastiera a livello di messaggio di chiave-giù.
Metodo protettoTranslateCharCoreMessaggi di input di processi WM_CHAR, di WM_SYSCHAR, di WM_DEADCHAR e di WM_SYSDEADCHAR prima di OnMnemonic viene chiamato il metodo.
Metodo pubblicoVerifyAccess Impone che il thread chiamante abbia accesso a questo DispatcherObject. (Ereditato da DispatcherObject)
In alto

  NomeDescrizione
Evento pubblicoAutoResizedsi verifica quando il layout causa HwndSource per ridimensionare automaticamente.
Evento pubblicoContentRenderedSi verifica quando viene eseguito il rendering del contenuto e pronto per l'interazione utente. (Ereditato da PresentationSource)
Evento pubblicoDisposedsi verifica quando Dispose il metodo viene chiamato su questo oggetto.
Evento pubblicoSizeToContentChangedSi verifica quando il valore di SizeToContent modifiche delle proprietà.
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoIKeyboardInputSink.HasFocusWithinPer una descrizione del membro, vedere IList.Remove.
Implementazione esplicita dell'interfacciaProprietà privataIKeyboardInputSink.KeyboardInputSitePer una descrizione del membro, vedere KeyboardInputSite.
Implementazione esplicita dell'interfacciaMetodo privatoIKeyboardInputSink.OnMnemonicPer una descrizione del membro, vedere OnMnemonic.
Implementazione esplicita dell'interfacciaMetodo privatoIKeyboardInputSink.RegisterKeyboardInputSinkPer una descrizione del membro, vedere RegisterKeyboardInputSink.
Implementazione esplicita dell'interfacciaMetodo privatoIKeyboardInputSink.TabIntoPer una descrizione del membro, vedere TabInto.
Implementazione esplicita dell'interfacciaMetodo privatoIKeyboardInputSink.TranslateAcceleratorPer una descrizione del membro, vedere TranslateAccelerator.
Implementazione esplicita dell'interfacciaMetodo privatoIKeyboardInputSink.TranslateCharPer una descrizione del membro, vedere TranslateChar.
In alto

Nota sulla sicurezzaNota sulla sicurezza

Molti membri di questa classe non sono disponibili nell'area Internet security handbook.

HwndSource implementa un oggetto Win32 finestra che può contenere WPF contenuto. WPF il contenuto della finestra viene disposto, misurato e viene eseguito il rendering; ed è interattivo introdurre. Poiché HwndSource specificamente progettato per interagire con Win32, questa classe espone diversi di basso livello Win32 funzionalità. È possibile utilizzare questa classe per eseguire le operazioni seguenti:

  • Specificare gli stili della finestra, gli stili della classe della finestra e gli stili estesi della finestra.

  • Associare la routine della finestra.

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

  • Eliminare la finestra.

HwndSource la classe è progettata per un'interoperabilità generale e non è progettato come wrapper gestito di HWND. Non fornisce in genere i metodi gestiti per modificare la finestra o le proprietà per controllare lo stato. invece, HwndSource la classe fornisce l'accesso a Win32 l'handle di finestra (HWND) con Handle proprietà, che può essere passato tramite tecniche di pInvoke Win32 API per modificare la finestra.

costruzione

Molti aspetti di HwndSource può essere specificato solo in fase di costruzione. Per creare HwndSource, creare innanzitutto HwndSourceParameters strutturarla e popolare con i parametri desiderati. Questi parametri sono inclusi i seguenti:

  • La classe, la finestra e gli stili estesi della finestra. È necessario utilizzare pInvoke per modificare gli stili dopo che la finestra viene creata. Non tutti gli stili possono essere modificati dopo la finestra viene creata. consultare Win32 documentazione prima di modificare gli stili della finestra.

  • La posizione iniziale della finestra.

  • La dimensione iniziale della finestra, che include se la dimensione è specificata oppure deve essere determinata dalla dimensioni determinazione di WPF contenuto.

  • la finestra padre.

  • HwndSourceHook per importare nella catena di routine della finestra. Se si specifica un hook in fase di costruzione, vengono ricevuti tutti i messaggi per la finestra. È possibile utilizzare AddHook per aggiungere un hook dopo la finestra viene creato.

  • Le impostazioni di trasparenza. Una finestra di livello superiore può essere configurata questo con le altre finestre sul desktop come la trasparenza di per-pixel di WPF contenuto. A tale scopo, impostare UsesPerPixelOpacity proprietà di HwndSourceParameters in true. Questa proprietà può essere specificato solo in fase di costruzione e solo con HwndSource(HwndSourceParameters) la firma del costruttore e comporta alcune limitazioni.

Dopo avere inserito HwndSourceParameters la struttura, la passa a HwndSource(HwndSourceParameters) costruttore per HwndSource.

Durata

HwndSource è un normale Common Language Runtime (CLR) oggetto e la relativa durata è gestita dal Garbage Collector. Poiché HwndSource rappresenta una risorsa non gestita, HwndSource implementa IDisposable. in modo sincrono chiamando Dispose immediatamente eliminato Win32 finestra se viene chiamato dal thread proprietario. Se viene chiamato da un altro thread, Win32 la finestra viene distrutta in modo asincrono. chiamare Dispose in modo esplicito dal codice interoperante potrebbe essere necessario per determinati scenari di interoperabilità.

procedure di finestra

HwndSource la classe implementa la propria routine della finestra. Questa routine della finestra viene utilizzata per elaborare i messaggi importanti della finestra, come quelle correlate al layout, rendering e di. Tuttavia, è anche possibile associare la routine della finestra per il proprio utilizzo. È possibile specificare il proprio hook durante la costruzione impostando HwndSourceParameters.HwndSourceHook la proprietà, o è anche possibile utilizzare AddHook e RemoveHook per aggiungere e rimuovere gli hook dopo la finestra viene creato. Gli hook vengono chiamati da ultimo-nell'ordine out), che consente agli hook per eseguire prima di elaborazione incorporata. Gli effettivi hook vengono utilizzati da un riferimento debole. Di conseguenza, assicurarsi di gestire la durata del delegato hook.

per ulteriori informazioni su HwndSource e altre classi di interoperabilità, vedere Interoperatività di WPF e Win32.

Si noti come i costruttori per HwndSource accettano i parametri cui simile ai parametri per Win32 funzioni come CreateWindowEx.

Le trasformazioni di scala non devono essere applicata a RootVisual oggetto HwndSource. Vedere le note per RootVisual.

.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro pubblico static (Shared in Visual Basic) di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft