الإرشادات التفصيلية: استضافة WPF مركبة التحكم في نماذج Windows

مقالة
11/01/2010

توضح هذه الإرشادات التفصيلية كيفية إنشاء عنصر تحكم مركب WPF واستضافته في النماذج وعناصر التحكم Windows Forms باستخدام عنصر التحكم ElementHost.

في هذه الإرشادات التفصيلية سيتم تطبيق WPFUserControl والذى يحتوي على عنصرى تحكم تابعين. يعرض UserControl مخروط ثلاثي الأبعاد. عرض الكائنات ثلاثية أسهل بكثير مع WPF عنه مع Windows Forms. لذلك،فمن المنطقى استضافة الفئة WPFUserControl لإنشاء الرسومات ثلاثية الأبعاد في Windows Forms.

تتضمن المهام الموضحة في هذه الإرشادات التفصيلية ما يلي:

إنشاء WPFUserControl.
إنشاء نماذج الاطارات للمشروع المضيف.
استضافة WPFUserControl.

للحصول على قائمة كاملة من التعليمات البرمجية للمهام الموضحة في هذه الإرشادات التفصيلية راجع Hosting a WPF Composite Control in Windows Froms .

لاحظ . قد تختلف مربعات الحوار وأوامر القائمة التي تشاهدها عن تلك الموصوفة في التعليمات اعتماداً على الإعدادات النشطة أو الإصدار الخاص بك. لتغيير الإعدادات الخاصة بك, اختر إعدادات الاستيراد و التصدير ضمن القائمة أدوات . لمزيد من المعلومات، راجع العمل مع إعدادات.

المتطلبات الأساسية

تحتاج إلى المكونات التالية لاستكمال هذه الإرشادات التفصيلية:

Visual Studio 2008.

إنشاء عنصر تحكم المستخدم UserControl

لإنشاء عنصر تحكم المستخدم

قم بإنشاء مشروع مكتبة تحكم المستخدم WPF باسم HostingWpfUserControlInWf.
قم بفتح UserControl1. xaml في مصمم WPF.

استبدل هذه التعليمات البرمجية بالتعليمات البرمجية التالية:

تقوم هذه التعليمات البرمجية بتعريف System.Windows.Controls.UserControl الذى يحتوي عنصرى تحكم تابعين. أول عنصر تحكم تابع هو System.Windows.Controls.Label; والثاني هو عنصر التحكم Viewport3D الذى يعرض مخروط ثلاثي الأبعاد.

<UserControl x:Class="HostingWpfUserControlInWf.UserControl1"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    >

    <Grid>

      <!-- Place a Label control at the top of the view. -->
      <Label 
                HorizontalAlignment="Center" 
                TextBlock.TextAlignment="Center" 
                FontSize="20" 
                Foreground="Red" 
                Content="Model: Cone"/>

      <!-- Viewport3D is the rendering surface. -->
      <Viewport3D Name="myViewport" >

        <!-- Add a camera. -->
        <Viewport3D.Camera>
          <PerspectiveCamera 
                        FarPlaneDistance="20" 
                        LookDirection="0,0,1" 
                        UpDirection="0,1,0" 
                        NearPlaneDistance="1" 
                        Position="0,0,-3" 
                        FieldOfView="45" />
        </Viewport3D.Camera>

        <!-- Add models. -->
        <Viewport3D.Children>

          <ModelVisual3D>
            <ModelVisual3D.Content>

              <Model3DGroup >
                <Model3DGroup.Children>

                  <!-- Lights, MeshGeometry3D and DiffuseMaterial objects are added to the ModelVisual3D. -->
                  <DirectionalLight Color="#FFFFFFFF" Direction="3,-4,5" />

                  <!-- Define a red cone. -->
                  <GeometryModel3D>

                    <GeometryModel3D.Geometry>
                      <MeshGeometry3D 
    Positions="0.293893 -0.5 0.404509  0.475528 -0.5 0.154509  0 0.5 0  0.475528 -0.5 0.154509  0 0.5 0  0 0.5 0  0.475528 -0.5 0.154509  0.475528 -0.5 -0.154509  0 0.5 0  0.475528 -0.5 -0.154509  0 0.5 0  0 0.5 0  0.475528 -0.5 -0.154509  0.293893 -0.5 -0.404509  0 0.5 0  0.293893 -0.5 -0.404509  0 0.5 0  0 0.5 0  0.293893 -0.5 -0.404509  0 -0.5 -0.5  0 0.5 0  0 -0.5 -0.5  0 0.5 0  0 0.5 0  0 -0.5 -0.5  -0.293893 -0.5 -0.404509  0 0.5 0  -0.293893 -0.5 -0.404509  0 0.5 0  0 0.5 0  -0.293893 -0.5 -0.404509  -0.475528 -0.5 -0.154509  0 0.5 0  -0.475528 -0.5 -0.154509  0 0.5 0  0 0.5 0  -0.475528 -0.5 -0.154509  -0.475528 -0.5 0.154509  0 0.5 0  -0.475528 -0.5 0.154509  0 0.5 0  0 0.5 0  -0.475528 -0.5 0.154509  -0.293892 -0.5 0.404509  0 0.5 0  -0.293892 -0.5 0.404509  0 0.5 0  0 0.5 0  -0.293892 -0.5 0.404509  0 -0.5 0.5  0 0.5 0  0 -0.5 0.5  0 0.5 0  0 0.5 0  0 -0.5 0.5  0.293893 -0.5 0.404509  0 0.5 0  0.293893 -0.5 0.404509  0 0.5 0  0 0.5 0  " 
    Normals="0.7236065,0.4472139,0.5257313  0.2763934,0.4472138,0.8506507  0.5308242,0.4294462,0.7306172  0.2763934,0.4472138,0.8506507  0,0.4294458,0.9030925  0.5308242,0.4294462,0.7306172  0.2763934,0.4472138,0.8506507  -0.2763934,0.4472138,0.8506507  0,0.4294458,0.9030925  -0.2763934,0.4472138,0.8506507  -0.5308242,0.4294462,0.7306172  0,0.4294458,0.9030925  -0.2763934,0.4472138,0.8506507  -0.7236065,0.4472139,0.5257313  -0.5308242,0.4294462,0.7306172  -0.7236065,0.4472139,0.5257313  -0.858892,0.429446,0.279071  -0.5308242,0.4294462,0.7306172  -0.7236065,0.4472139,0.5257313  -0.8944269,0.4472139,0  -0.858892,0.429446,0.279071  -0.8944269,0.4472139,0  -0.858892,0.429446,-0.279071  -0.858892,0.429446,0.279071  -0.8944269,0.4472139,0  -0.7236065,0.4472139,-0.5257313  -0.858892,0.429446,-0.279071  -0.7236065,0.4472139,-0.5257313  -0.5308242,0.4294462,-0.7306172  -0.858892,0.429446,-0.279071  -0.7236065,0.4472139,-0.5257313  -0.2763934,0.4472138,-0.8506507  -0.5308242,0.4294462,-0.7306172  -0.2763934,0.4472138,-0.8506507  0,0.4294458,-0.9030925  -0.5308242,0.4294462,-0.7306172  -0.2763934,0.4472138,-0.8506507  0.2763934,0.4472138,-0.8506507  0,0.4294458,-0.9030925  0.2763934,0.4472138,-0.8506507  0.5308249,0.4294459,-0.7306169  0,0.4294458,-0.9030925  0.2763934,0.4472138,-0.8506507  0.7236068,0.4472141,-0.5257306  0.5308249,0.4294459,-0.7306169  0.7236068,0.4472141,-0.5257306  0.8588922,0.4294461,-0.27907  0.5308249,0.4294459,-0.7306169  0.7236068,0.4472141,-0.5257306  0.8944269,0.4472139,0  0.8588922,0.4294461,-0.27907  0.8944269,0.4472139,0  0.858892,0.429446,0.279071  0.8588922,0.4294461,-0.27907  0.8944269,0.4472139,0  0.7236065,0.4472139,0.5257313  0.858892,0.429446,0.279071  0.7236065,0.4472139,0.5257313  0.5308242,0.4294462,0.7306172  0.858892,0.429446,0.279071  "                   TriangleIndices="0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 " />
                    </GeometryModel3D.Geometry>

                    <GeometryModel3D.Material>
                      <DiffuseMaterial>
                        <DiffuseMaterial.Brush>
                          <SolidColorBrush 
                            Color="Red" 
                            Opacity="1.0"/>
                        </DiffuseMaterial.Brush>
                      </DiffuseMaterial>
                    </GeometryModel3D.Material>

                  </GeometryModel3D>

                </Model3DGroup.Children>
              </Model3DGroup>

            </ModelVisual3D.Content>

          </ModelVisual3D>

        </Viewport3D.Children>

      </Viewport3D>
    </Grid>

</UserControl>

إنشاء نماذج الاطارات للمشروع المضيف.

لإنشاء المشروع المضيف.

يسمى مشروع تطبيق Windows WpfUserControlHost إلى الحل. لمزيد من المعلومات، راجع كيفية: إنشاء مشروع تطبيق WPF جديد.
في "مستكشف الحلول" قم بإضافة مرجع إلى تجميع WindowsFormsIntegration يسمى WindowsFormsIntegration.dll.
قم بإضافة مراجع إلى تجميعات WPF التالية:
- PresentationCore
- PresentationFramework
- WindowsBase
قم بإضافة مرجع إلى المشروع HostingWpfUserControlInWf
في مستكشف الحلول Solution Explorer قم بتعيين المشروع WpfUserControlHost ليكون مشروع بدء التشغيل.

استضافة عنصر تحكم Windows Presentation Foundation

لاستضافة UserControl

افتح Form1 في مصمم Windows Forms .
في إطار الخصائص، انقر فوق Eventsثم انقر نقراً مزدوجاً فوق الحدث Load لإنشاء معالج الحدث.

يفتح محرر التعليمات البرمجية معالج الحدث Form1_Load المنشأ حديثاً.

قم باستبدال التعليمات البرمجية في Form1.cs بالتعليمات البرمجية التالية.

Form1_Loadمعالج الأحداث بإنشاء مثيل من UserControl1وإضافته إلى ElementHostمجموعة عنصر التحكم من عناصر التحكم التابعة. تتم اضافة عنصر التحكم ElementHost الى مجموعة من عناصر التحكم التابعة للنموذج.

Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms

Imports System.Windows.Forms.Integration

Public Class Form1
    Inherits Form

    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        ' Create the ElementHost control for hosting the
        ' WPF UserControl.
        Dim host As New ElementHost()
        host.Dock = DockStyle.Fill

        ' Create the WPF UserControl.
        Dim uc As New HostingWpfUserControlInWf.UserControl1()

        ' Assign the WPF UserControl to the ElementHost control's
        ' Child property.
        host.Child = uc

        ' Add the ElementHost control to the form's
        ' collection of child controls.
        Me.Controls.Add(host)
    End Sub

End Class

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

using System.Windows.Forms.Integration;

namespace WpfUserControlHost
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            // Create the ElementHost control for hosting the
            // WPF UserControl.
            ElementHost host = new ElementHost();
            host.Dock = DockStyle.Fill;

            // Create the WPF UserControl.
            HostingWpfUserControlInWf.UserControl1 uc =
                new HostingWpfUserControlInWf.UserControl1();

            // Assign the WPF UserControl to the ElementHost control's
            // Child property.
            host.Child = uc;

            // Add the ElementHost control to the form's
            // collection of child controls.
            this.Controls.Add(host);
        }
    }
}

اضغط F5 لإنشاء التطبيق وتشغيله.

راجع أيضًا:

مشاركة عبر

الإرشادات التفصيلية: استضافة WPF مركبة التحكم في نماذج Windows

المتطلبات الأساسية

إنشاء عنصر تحكم المستخدم UserControl

لإنشاء عنصر تحكم المستخدم

إنشاء نماذج الاطارات للمشروع المضيف.

لإنشاء المشروع المضيف.

استضافة عنصر تحكم Windows Presentation Foundation

لاستضافة UserControl

راجع أيضًا:

المرجع

المبادئ

موارد أخرى

الموارد الإضافية