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 в свойстве HwndSourceParameters значение true. Это свойство можно указать только во время создания и только с помощью сигнатуры HwndSource(HwndSourceParameters) конструктора, и оно накладывает ряд ограничений.

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

Время жизни объекта

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

Оконные процедуры

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

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

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

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

Конструкторы

Свойства

Методы

События

Явные реализации интерфейса

Применяется к

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

• HwndHost