Руководство по размещению визуальных объектов в приложении Win32
Обновлен: Ноябрь 2007
Клиент Windows Presentation Foundation (WPF) предоставляет среду с широкими возможностями для создания приложений. Однако, если имеются существенные преимущества в коде Win32, возможно, более эффективным будет добавление функциональности WPF в приложение вместо переписывания вашего кода. Для обеспечения поддержки графических подсистем Win32 и WPF, одновременно используемых в приложении, WPF предоставляет механизм для размещения объектов в окне Win32.
Это руководство описывает написание приложения, Пример проверки нажатий, включающий взаимодействие с Win32, которое размещает визуальные объекты WPF в окне Win32.
В этом разделе содержатся следующие подразделы.
- Требования
- Создание главного окна Win32
- Добавление визуального объекта в главное окно Win32
- Реализация фильтра сообщений Win32
- Обработка сообщений Win32
- Связанные разделы
Требования
Это руководство предполагает начальное знакомство с программированием WPF и Win32. Введение в программирование WPF см. в разделе Введение в Windows Presentation Foundation. Введение в программирование Win32 содержится в любой из многочисленных книг на данную тему, в частности, Programming Windows Charles Petzold.
Примечание. |
---|
Это руководство включает ряд примеров кода из сопровождающего его образца. Тем не менее, для удобства чтения, он не включает в себя полный код примера. Полный пример кода см. в разделе Пример проверки нажатий, включающий взаимодействие с Win32. |
Создание главного окна Win32
Ключом для размещению объектов WPF в окне Win32 является класс HwndSource. Этот класс переносит объекты WPF в окне Win32, позволяя им присоединиться к вашему пользовательский интерфейс в качестве дочернего окна.
В следующем примере показан код для создания объекта HwndSource в качестве контейнера окна Win32 для визуальных объектов. Для задания стиля окна, положения и других параметров окна Win32 используйте объект HwndSourceParameters.
// Constant values from the "winuser.h" header file.
internal const int WS_CHILD = 0x40000000,
WS_VISIBLE = 0x10000000;
internal static void CreateHostHwnd(IntPtr parentHwnd)
{
// Set up the parameters for the host hwnd.
HwndSourceParameters parameters = new HwndSourceParameters("Visual Hit Test", _width, _height);
parameters.WindowStyle = WS_VISIBLE | WS_CHILD;
parameters.SetPosition(0, 24);
parameters.ParentWindow = parentHwnd;
parameters.HwndSourceHook = new HwndSourceHook(ApplicationMessageFilter);
// Create the host hwnd for the visuals.
myHwndSource = new HwndSource(parameters);
// Set the hwnd background color to the form's background color.
myHwndSource.CompositionTarget.BackgroundColor = System.Windows.Media.Brushes.OldLace.Color;
}
Примечание. |
---|
Значению свойства ExtendedWindowStyle не может быть равно WS_EX_TRANSPARENT. Это означает, что главное окно Win32 не может быть прозрачным. По этой причине цвету фона главного окна Win32 задается тот же цвет фона, что и у родительского окна. |
Добавление визуального объекта в главное окно Win32
После создания главного окна контейнера Win32 для визуальных объектов на него можно добавить визуальные объекты. Необходимо убедиться, что любые преобразования визуальных объектов, такие как анимация, не выходят за пределы ограничивающего прямоугольника главного окна Win32.
В следующем примере показан код для создания объекта HwndSource и добавления визуальных объектов к нему.
Примечание. |
---|
Свойство RootVisual объекта HwndSource установлено в значение первого визуального объекта, добавленного в главное окно Win32. Корневой визуальный объект определяет самый верхний узел дерева визуальных объектов. Все последующие визуальные объекты, добавленные в главное окно Win32, добавляются как дочерние объекты. |
public static void CreateShape(IntPtr parentHwnd)
{
// Create an instance of the shape.
MyShape myShape = new MyShape();
// Determine whether the host container window has been created.
if (myHwndSource == null)
{
// Create the host container window for the visual objects.
CreateHostHwnd(parentHwnd);
// Associate the shape with the host container window.
myHwndSource.RootVisual = myShape;
}
else
{
// Assign the shape as a child of the root visual.
((ContainerVisual)myHwndSource.RootVisual).Children.Add(myShape);
}
}
Реализация фильтра сообщений Win32
Для главного окна Win32 визуальных объектов требуется процедура фильтрации сообщений окна для обработки сообщений, отправляемых из очереди приложения окну. Процедура окна получает сообщения из системы Win32. Это могут быть входные сообщения или сообщения от управления окнами. Можно дополнительно обработать сообщение в процедуре окна или передать сообщение системе для обработки по умолчанию.
На объект HwndSource, который определен вами как родительский для визуальных объектов, должна ссылаться предоставленная вами процедура фильтрации сообщении. При создании объекта HwndSource, установите свойству HwndSourceHook значение ссылки на процедуру окна.
parameters.HwndSourceHook = new HwndSourceHook(ApplicationMessageFilter);
В следующем примере показан код для обработки сообщений при нажатии левой и правой кнопок мыши. Значение координаты положения мыши содержатся в значении параметра lParam.
// Constant values from the "winuser.h" header file.
internal const int WM_LBUTTONUP = 0x0202,
WM_RBUTTONUP = 0x0205;
internal static IntPtr ApplicationMessageFilter(
IntPtr hwnd, int message, IntPtr wParam, IntPtr lParam, ref bool handled)
{
// Handle messages passed to the visual.
switch (message)
{
// Handle the left and right mouse button up messages.
case WM_LBUTTONUP:
case WM_RBUTTONUP:
System.Windows.Point pt = new System.Windows.Point();
pt.X = (uint)lParam & (uint)0x0000ffff; // LOWORD = x
pt.Y = (uint)lParam >> 16; // HIWORD = y
MyShape.OnHitTest(pt, message);
break;
}
return IntPtr.Zero;
}
Обработка сообщений Win32
В коде следующего примера показано, как выполняется проверка посещение по иерархии визуальных объектов, содержащихся в главном окне Win32. Можно определить, расположена ли точка внутри визуального объекта, с помощью метода HitTest, указав корневой визуальный объект и значение координаты, которую следует проверить. В этом случае корневой визуальный объект является значением свойства RootVisual объекта HwndSource.
// Constant values from the "winuser.h" header file.
public const int WM_LBUTTONUP = 0x0202,
WM_RBUTTONUP = 0x0205;
// Respond to WM_LBUTTONUP or WM_RBUTTONUP messages by determining which visual object was clicked.
public static void OnHitTest(System.Windows.Point pt, int msg)
{
// Clear the contents of the list used for hit test results.
hitResultsList.Clear();
// Determine whether to change the color of the circle or to delete the shape.
if (msg == WM_LBUTTONUP)
{
MyWindow.changeColor = true;
}
if (msg == WM_RBUTTONUP)
{
MyWindow.changeColor = false;
}
// Set up a callback to receive the hit test results enumeration.
VisualTreeHelper.HitTest(MyWindow.myHwndSource.RootVisual,
null,
new HitTestResultCallback(CircleHitTestResult),
new PointHitTestParameters(pt));
// Perform actions on the hit test results list.
if (hitResultsList.Count > 0)
{
ProcessHitTestResultsList();
}
}
Дополнительные сведения о тестировании на посещение визуальных объектов содержатся в разделе Проверка попадания на визуальном уровне.
См. также
Задачи
Пример проверки нажатий, включающий взаимодействие с Win32
Основные понятия
Проверка попадания на визуальном уровне