HwndSource Класс

Определение

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

Наследование

Object

DispatcherObject

PresentationSource

HwndSource

Реализации

IDisposable IKeyboardInputSink IWin32Window

Комментарии

Реализует HwndSource окно Win32, которое может содержать содержимое WPF. Содержимое WPF в окне упорядочено, измеряется и отрисовывается; и является интерактивным для ввода. Так как этот HwndSource класс специально предназначен для взаимодействия с Win32, этот класс предоставляет несколько низкоуровневых функций Win32. Этот класс можно использовать для выполнения следующих действий:

• Укажите стили окон, стили классов окон и расширенные стили окон.

• Перехватчик процедуры окна.

• Предоставьте доступ к дескриптору окна (HWND).

• Уничтожить окно.

Класс HwndSource предназначен для общего взаимодействия и не предназначен в качестве управляемой оболочки HWND. Как правило, он не предоставляет управляемые методы для управления окном или свойствами для проверки его состояния. Вместо этого HwndSource класс предоставляет доступ к дескриптору окна Win32 (HWND) через Handle свойство, которое можно передать с помощью методов PInvoke в API Win32 для управления окном.

Создание экземпляра

Во время строительства можно указать только многие аспекты HwndSource . Чтобы создать структуру, сначала создайте HwndSourceструктуру HwndSourceParameters и заполните ее нужными параметрами. К этим параметрам относятся следующие параметры:

• Класс, окно и расширенные стили окон. Чтобы изменить стили после создания окна, необходимо использовать PInvoke. Не все стили можно изменить после создания окна. Перед изменением стилей окон обратитесь к документации по Win32.

• Начальная позиция окна.

• Начальный размер окна, который включает, указан или должен быть определен из определенного размера содержимого WPF.

• Родительское окно.

• Значение HwndSourceHook для включения в цепочку процедур окна. Если указать крючок во время строительства, он получает все сообщения для окна. После создания окна можно добавить AddHook перехватчик.

• Параметры прозрачности. Окно верхнего уровня можно настроить для смешивания с другими окнами на рабочем столе в соответствии с прозрачностью содержимого WPF на пикселях. Чтобы включить это, задайте UsesPerPixelOpacity для свойства значение HwndSourceParameterstrue. Это свойство можно указать только во время строительства, и только с помощью HwndSource(HwndSourceParameters) подписи конструктора, и оно накладывает несколько ограничений.

После заполнения HwndSourceParameters структуры передайте его HwndSource(HwndSourceParameters) конструктору для объекта HwndSource.

Время существования объекта

Это HwndSource обычный объект среды CLR, и его время существования управляет сборщик мусора. Так как представляет HwndSource неуправляемый ресурс, HwndSource реализуется IDisposable. Синхронно вызывая Dispose немедленно уничтожает окно Win32 при вызове из потока владельца. При вызове из другого потока окно Win32 уничтожается асинхронно. Для определенных сценариев взаимодействия может потребоваться явное вызов Dispose из кода взаимодействия.

Процедуры окна

Класс HwndSource реализует собственную процедуру окна. Эта процедура окна используется для обработки важных сообщений окна, таких как связанные с макетом, отрисовкой и входными данными. Однако можно также подключить процедуру окна для собственного использования. Вы можете указать собственный крючок во время строительства, задав HwndSourceParameters.HwndSourceHook свойство, или вы также можете использовать AddHook и RemoveHook добавлять и удалять перехватчики после создания окна. Перехватчики вызываются в порядке последней очереди, что позволяет перехватчикам выполняться до встроенной обработки. Фактические крючки удерживаются слабой ссылкой. Поэтому убедитесь, что вы управляете временем существования делегата перехватчика.

Дополнительные сведения и другие классы взаимодействия см. в HwndSource разделе WPF и Win32 Interoperation.

Обратите внимание, как конструкторы для HwndSource принятия параметров, похожих на параметры для функций Win32, таких как CreateWindowEx.

Преобразования масштабирования не должны применяться к RootVisual объекту HwndSource. См. примечания.RootVisual

См. также раздел

• HwndHost