HwndSource Třída

Definice

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

Dědičnost

Object

DispatcherObject

PresentationSource

HwndSource

Implementuje

IDisposable IKeyboardInputSink IWin32Window

Poznámky

Implementuje HwndSource okno Win32, které může obsahovat obsah WPF. Obsah WPF v okně je uspořádán, měřen a vykreslen; a je interaktivní pro zadávání. Vzhledem k tomu, že HwndSource je speciálně navržen pro spolupráci s Win32, tato třída zveřejňuje několik funkcí Win32 nízké úrovně. Pomocí této třídy můžete provádět následující akce:

• Zadejte styly oken, styly tříd oken a rozšířené styly oken.

• Zahodí proceduru okna.

• Poskytněte přístup k popisovači okna (HWND).

• Zničte okno.

Třída je navržena HwndSource pro obecnou interoperabilitu a není navržena jako spravovaná obálka HWND. Obecně neposkytuje spravované metody pro manipulaci s oknem ani vlastnosti pro kontrolu jeho stavu. Místo toho HwndSource třída poskytuje přístup k popisovači okna Win32 (HWND) prostřednictvím Handle vlastnosti, která může být předána prostřednictvím PInvoke techniky rozhraní API Win32 za účelem manipulace s oknem.

Stavebnictví

Mnoho aspektů je HwndSource možné zadat pouze v době výstavby. Pokud chcete vytvořit HwndSource, nejprve vytvořte HwndSourceParameters strukturu a naplňte ji požadovanými parametry. Mezi tyto parametry patří:

• Třída, okno a rozšířené styly oken. Ke změně stylů po vytvoření okna je nutné použít PInvoke. Ne všechny styly je možné po vytvoření okna změnit. Před změnou stylů oken si projděte dokumentaci k Win32.

• Počáteční pozice okna.

• Počáteční velikost okna, která zahrnuje, zda je velikost zadaná nebo by měla být určena z určené velikosti obsahu WPF.

• Nadřazené okno.

• Řetězec HwndSourceHook , který se má zahrnout do řetězce procedur okna. Pokud zadáte háček v době výstavby, obdrží všechny zprávy pro okno. Můžete použít AddHook k přidání háku po vytvoření okna.

• Nastavení průhlednosti. Okno nejvyšší úrovně lze nakonfigurovat tak, aby se splývá s ostatními okny na ploše v závislosti na průhlednosti obsahu WPF podle pixelů. Pokud to chcete povolit, nastavte UsesPerPixelOpacity vlastnost v na trueHwndSourceParameters . Tuto vlastnost lze zadat pouze v době výstavby a pouze prostřednictvím podpisu konstruktoru HwndSource(HwndSourceParameters) a má několik omezení.

Po naplnění HwndSourceParameters struktury ji předejte konstruktoru HwndSource(HwndSourceParameters)HwndSourcepro .

Doba života objektu

Je HwndSource běžný objekt modulu CLR (Common Language Runtime) a jeho životnost spravuje systém uvolňování paměti. Protože objekt HwndSource představuje nespravovaný prostředek, HwndSource implementuje IDisposable. Synchronní volání Dispose okamžitě zničí okno Win32, pokud je volána z vlákna vlastníka. Pokud je volána z jiného vlákna, okno Win32 je zničen asynchronně. Pro určité scénáře vzájemné spolupráce může být nutné explicitní volání Dispose z interoperačního kódu.

Procedury okna

Třída HwndSource implementuje vlastní proceduru okna. Tato procedura okna se používá ke zpracování důležitých zpráv okna, jako jsou zprávy související s rozložením, vykreslováním a vstupem. Můžete ale také připojit proceduru okna pro vlastní použití. Můžete zadat vlastní hák během výstavby nastavením HwndSourceParameters.HwndSourceHook vlastnosti, nebo můžete také použít AddHook a RemoveHook přidat a odebrat háčky po vytvoření okna. Háky se volají v pořadí, ve kterém se poprvé vyvolají, což umožňuje, aby se vaše háky spustily před integrovaným zpracováním. Skutečné háčky jsou drženy slabým odkazem. Proto se ujistěte, že spravujete životnost delegáta háku.

Další informace o třídách a dalších třídách pro spolupráci najdete v tématu WpF a Win32 Interoperation.For more information about HwndSource and other interoperation classes, see WPF and Win32 Interoperation.

Všimněte si, jak konstruktory pro HwndSource převzetí parametrů, které se podobají parametrům pro funkce Win32, například CreateWindowEx.

Transformace škálování by neměly být použity u objektu RootVisualHwndSource. Viz Poznámky pro RootVisual.

Konstruktory

Vlastnosti

Metody

Událost

Explicitní implementace rozhraní

Platí pro

Viz také

• HwndHost