Nasıl yapılır: UI Döndüren Eklenti Oluşturma
Bu örnekte, bir konak WPF tek başına uygulamasına bir Windows Presentation Foundation (WPF) döndüren bir eklentinin nasıl oluşturularak ilgili bilgi ve içerikler yer amektedir.
Eklenti, WPF kullanıcı denetimi olan bir kullanıcı arabirimi döndürür. Kullanıcı denetimi içeriği, tıkıldığında bir ileti kutusu görüntüleyen tek bir düğmedir. WPF tek başına uygulaması eklentiyi barındırarak kullanıcı denetimi (eklenti tarafından döndürülen) ana uygulama penceresinin içeriği olarak görüntüler.
Önkoşullar
Bu örnek, bu senaryoyu etkinleştiren .NET Framework için WPF uzantılarını vurgular ve şunları varsayıyor:
İşlem hattı, .NET Framework ve konak geliştirme dahil olmak üzere farklı eklenti modeli hakkında bilgi. Bu kavramlara yabancısanız bkz. Eklentiler ve Genişletilebilirlik. İşlem hattı, eklenti ve konak uygulaması uygulamasını gösteren bir öğretici için bkz. Adım adım: Genişletilebilir Uygulama Oluşturma.
.NET Framework modele WPF uzantıları hakkında bilgi, burada bulunabilir: WPF Add-Ins Genel Bakış.
Örnek
WPF kullanıcı arabirimi döndüren bir eklenti oluşturmak için her işlem hattı segmenti, eklenti ve konak uygulaması için belirli bir kod gerekir.
Sözleşme İşlem Hattı Segmentini Uygulama
Bir yöntemin kullanıcı arabirimini döndüren sözleşme tarafından tanımlandığı ve dönüş değerinin türünde olması INativeHandleContract gerekir. Bu, aşağıdaki GetAddInUI kodda IWPFAddInContract sözleşmenin yöntemiyle gösterildi.
using System.AddIn.Contract;
using System.AddIn.Pipeline;
namespace Contracts
{
/// <summary>
/// Defines the services that an add-in will provide to a host application
/// </summary>
[AddInContract]
public interface IWPFAddInContract : IContract
{
// Return a UI to the host application
INativeHandleContract GetAddInUI();
}
}
Imports System.AddIn.Contract
Imports System.AddIn.Pipeline
Namespace Contracts
''' <summary>
''' Defines the services that an add-in will provide to a host application
''' </summary>
<AddInContract>
Public Interface IWPFAddInContract
Inherits IContract
' Return a UI to the host application
Function GetAddInUI() As INativeHandleContract
End Interface
End Namespace
Add-In İşlem Hattı Kesimini Uygulama
Eklenti, sağladığı UI'leri alt sınıfları olarak uygulayan eklenti görünümündeki ile ilişkili yöntemi türünde bir FrameworkElementIWPFAddInView.GetAddInUI değer dönüşletir. FrameworkElement Aşağıdaki kod, arabirim olarak uygulanan sözleşmenin eklenti görünümünü gösterir.
using System.AddIn.Pipeline;
using System.Windows;
namespace AddInViews
{
/// <summary>
/// Defines the add-in's view of the contract
/// </summary>
[AddInBase]
public interface IWPFAddInView
{
// The add-in's implementation of this method will return
// a UI type that directly or indirectly derives from
// FrameworkElement.
FrameworkElement GetAddInUI();
}
}
Imports System.AddIn.Pipeline
Imports System.Windows
Namespace AddInViews
''' <summary>
''' Defines the add-in's view of the contract
''' </summary>
<AddInBase>
Public Interface IWPFAddInView
' The add-in's implementation of this method will return
' a UI type that directly or indirectly derives from
' FrameworkElement.
Function GetAddInUI() As FrameworkElement
End Interface
End Namespace
Add-In-Side Adapter Pipeline Segmentini Uygulama
Sözleşme yöntemi bir INativeHandleContract döndürür, ancak eklenti bir döndürür FrameworkElement (eklenti görünümü tarafından belirtilen şekilde). Sonuç olarak, FrameworkElement yalıtım sınırını geçmeden önce , olarak INativeHandleContract dönüştürülmesi gerekir. Bu çalışma, aşağıdaki kodda gösterildiği gibi çağrısı ViewToContractAdapter yaparak eklenti tarafı bağdaştırıcısı tarafından gerçekleştirilir.
using System.AddIn.Contract;
using System.AddIn.Pipeline;
using System.Windows;
using AddInViews;
using Contracts;
namespace AddInSideAdapters
{
/// <summary>
/// Adapts the add-in's view of the contract to the add-in contract
/// </summary>
[AddInAdapter]
public class WPFAddIn_ViewToContractAddInSideAdapter : ContractBase, IWPFAddInContract
{
IWPFAddInView wpfAddInView;
public WPFAddIn_ViewToContractAddInSideAdapter(IWPFAddInView wpfAddInView)
{
// Adapt the add-in view of the contract (IWPFAddInView)
// to the contract (IWPFAddInContract)
this.wpfAddInView = wpfAddInView;
}
public INativeHandleContract GetAddInUI()
{
// Convert the FrameworkElement from the add-in to an INativeHandleContract
// that will be passed across the isolation boundary to the host application.
FrameworkElement fe = this.wpfAddInView.GetAddInUI();
INativeHandleContract inhc = FrameworkElementAdapters.ViewToContractAdapter(fe);
return inhc;
}
}
}
Imports System.AddIn.Contract
Imports System.AddIn.Pipeline
Imports System.Windows
Imports AddInViews
Imports Contracts
Namespace AddInSideAdapters
''' <summary>
''' Adapts the add-in's view of the contract to the add-in contract
''' </summary>
<AddInAdapter>
Public Class WPFAddIn_ViewToContractAddInSideAdapter
Inherits ContractBase
Implements IWPFAddInContract
Private wpfAddInView As IWPFAddInView
Public Sub New(ByVal wpfAddInView As IWPFAddInView)
' Adapt the add-in view of the contract (IWPFAddInView)
' to the contract (IWPFAddInContract)
Me.wpfAddInView = wpfAddInView
End Sub
Public Function GetAddInUI() As INativeHandleContract Implements IWPFAddInContract.GetAddInUI
' Convert the FrameworkElement from the add-in to an INativeHandleContract
' that will be passed across the isolation boundary to the host application.
Dim fe As FrameworkElement = Me.wpfAddInView.GetAddInUI()
Dim inhc As INativeHandleContract = FrameworkElementAdapters.ViewToContractAdapter(fe)
Return inhc
End Function
End Class
End Namespace
Konak Görünümü İşlem Hattı Kesimini Uygulama
Konak uygulaması bir görüntüleyişle, ile ilişkili konak görünümündeki FrameworkElement yöntemi türünde bir değer IWPFAddInHostView.GetAddInUIFrameworkElement getirmektedir. Aşağıdaki kod, arabirim olarak uygulanan sözleşmenin ana bilgisayar görünümünü gösterir.
using System.Windows;
namespace HostViews
{
/// <summary>
/// Defines the host's view of the add-in
/// </summary>
public interface IWPFAddInHostView
{
// The view returns as a class that directly or indirectly derives from
// FrameworkElement and can subsequently be displayed by the host
// application by embedding it as content or sub-content of a UI that is
// implemented by the host application.
FrameworkElement GetAddInUI();
}
}
Imports System.Windows
Namespace HostViews
''' <summary>
''' Defines the host's view of the add-in
''' </summary>
Public Interface IWPFAddInHostView
' The view returns as a class that directly or indirectly derives from
' FrameworkElement and can subsequently be displayed by the host
' application by embedding it as content or sub-content of a UI that is
' implemented by the host application.
Function GetAddInUI() As FrameworkElement
End Interface
End Namespace
Host-Side Bağdaştırıcısı İşlem Hattı Kesimini Uygulama
Sözleşme yöntemi bir INativeHandleContract döndürür, ancak konak uygulaması bir bekler FrameworkElement (konak görünümü tarafından belirtilen şekilde). Sonuç olarak, INativeHandleContract yalıtım sınırını aştıktan sonra , olarak FrameworkElement dönüştürülmesi gerekir. Bu çalışma, aşağıdaki kodda gösterildiği gibi ContractToViewAdapter çağrılarak konak tarafı bağdaştırıcısı tarafından gerçekleştirilir.
using System.AddIn.Contract;
using System.AddIn.Pipeline;
using System.Windows;
using Contracts;
using HostViews;
namespace HostSideAdapters
{
/// <summary>
/// Adapts the add-in contract to the host's view of the add-in
/// </summary>
[HostAdapter]
public class WPFAddIn_ContractToViewHostSideAdapter : IWPFAddInHostView
{
IWPFAddInContract wpfAddInContract;
ContractHandle wpfAddInContractHandle;
public WPFAddIn_ContractToViewHostSideAdapter(IWPFAddInContract wpfAddInContract)
{
// Adapt the contract (IWPFAddInContract) to the host application's
// view of the contract (IWPFAddInHostView)
this.wpfAddInContract = wpfAddInContract;
// Prevent the reference to the contract from being released while the
// host application uses the add-in
this.wpfAddInContractHandle = new ContractHandle(wpfAddInContract);
}
public FrameworkElement GetAddInUI()
{
// Convert the INativeHandleContract that was passed from the add-in side
// of the isolation boundary to a FrameworkElement
INativeHandleContract inhc = this.wpfAddInContract.GetAddInUI();
FrameworkElement fe = FrameworkElementAdapters.ContractToViewAdapter(inhc);
return fe;
}
}
}
Imports System.AddIn.Contract
Imports System.AddIn.Pipeline
Imports System.Windows
Imports Contracts
Imports HostViews
Namespace HostSideAdapters
''' <summary>
''' Adapts the add-in contract to the host's view of the add-in
''' </summary>
<HostAdapter>
Public Class WPFAddIn_ContractToViewHostSideAdapter
Implements IWPFAddInHostView
Private wpfAddInContract As IWPFAddInContract
Private wpfAddInContractHandle As ContractHandle
Public Sub New(ByVal wpfAddInContract As IWPFAddInContract)
' Adapt the contract (IWPFAddInContract) to the host application's
' view of the contract (IWPFAddInHostView)
Me.wpfAddInContract = wpfAddInContract
' Prevent the reference to the contract from being released while the
' host application uses the add-in
Me.wpfAddInContractHandle = New ContractHandle(wpfAddInContract)
End Sub
Public Function GetAddInUI() As FrameworkElement Implements IWPFAddInHostView.GetAddInUI
' Convert the INativeHandleContract that was passed from the add-in side
' of the isolation boundary to a FrameworkElement
Dim inhc As INativeHandleContract = Me.wpfAddInContract.GetAddInUI()
Dim fe As FrameworkElement = FrameworkElementAdapters.ContractToViewAdapter(inhc)
Return fe
End Function
End Class
End Namespace
Uygulama Add-In
Add-in-side bağdaştırıcısı ve eklenti görünümü oluşturulduktan sonra, eklenti ( ) bir nesnesi (bu örnekte bir) dönmek için WPFAddIn1.AddInIWPFAddInView.GetAddInUI yöntemini FrameworkElementUserControl uygulamalı. , uygulaması UserControlAddInUI aşağıdaki kod tarafından gösterilir.
<UserControl
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="WPFAddIn1.AddInUI">
<StackPanel>
<Button Click="clickMeButton_Click" Content="Click Me!" />
</StackPanel>
</UserControl>
using System.Windows;
using System.Windows.Controls;
namespace WPFAddIn1
{
public partial class AddInUI : UserControl
{
public AddInUI()
{
InitializeComponent();
}
void clickMeButton_Click(object sender, RoutedEventArgs e)
{
MessageBox.Show("Hello from WPFAddIn1");
}
}
}
Imports System.Windows
Imports System.Windows.Controls
Namespace WPFAddIn1
Partial Public Class AddInUI
Inherits UserControl
Public Sub New()
InitializeComponent()
End Sub
Private Sub clickMeButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
MessageBox.Show("Hello from WPFAddIn1")
End Sub
End Class
End Namespace
aşağıdaki kodda gösterildiği gibi, eklenti tarafından uygulamasının yalnızca yeni bir IWPFAddInView.GetAddInUIAddInUI örneği dönmesi gerekir.
using System.AddIn;
using System.Windows;
using AddInViews;
namespace WPFAddIn1
{
/// <summary>
/// Add-In implementation
/// </summary>
[AddIn("WPF Add-In 1")]
public class WPFAddIn : IWPFAddInView
{
public FrameworkElement GetAddInUI()
{
// Return add-in UI
return new AddInUI();
}
}
}
Imports System.AddIn
Imports System.Windows
Imports AddInViews
Namespace WPFAddIn1
''' <summary>
''' Add-In implementation
''' </summary>
<AddIn("WPF Add-In 1")>
Public Class WPFAddIn
Implements IWPFAddInView
Public Function GetAddInUI() As FrameworkElement Implements IWPFAddInView.GetAddInUI
' Return add-in UI
Return New AddInUI()
End Function
End Class
End Namespace
Konak Uygulamasını Uygulama
Konak tarafı bağdaştırıcısı ve konak görünümü oluşturulduktan sonra, konak uygulaması işlem hattını açmak .NET Framework eklentinin ana bilgisayar görünümünü almak ve yöntemini çağıran .NET Framework eklenti modelini IWPFAddInHostView.GetAddInUI kullanabilir. Bu adımlar aşağıdaki kodda gösterilmiştir.
// Get add-in pipeline folder (the folder in which this application was launched from)
string appPath = Environment.CurrentDirectory;
// Rebuild visual add-in pipeline
string[] warnings = AddInStore.Rebuild(appPath);
if (warnings.Length > 0)
{
string msg = "Could not rebuild pipeline:";
foreach (string warning in warnings) msg += "\n" + warning;
MessageBox.Show(msg);
return;
}
// Activate add-in with Internet zone security isolation
Collection<AddInToken> addInTokens = AddInStore.FindAddIns(typeof(IWPFAddInHostView), appPath);
AddInToken wpfAddInToken = addInTokens[0];
this.wpfAddInHostView = wpfAddInToken.Activate<IWPFAddInHostView>(AddInSecurityLevel.Internet);
// Get and display add-in UI
FrameworkElement addInUI = this.wpfAddInHostView.GetAddInUI();
this.addInUIHostGrid.Children.Add(addInUI);
' Get add-in pipeline folder (the folder in which this application was launched from)
Dim appPath As String = Environment.CurrentDirectory
' Rebuild visual add-in pipeline
Dim warnings() As String = AddInStore.Rebuild(appPath)
If warnings.Length > 0 Then
Dim msg As String = "Could not rebuild pipeline:"
For Each warning As String In warnings
msg &= vbLf & warning
Next warning
MessageBox.Show(msg)
Return
End If
' Activate add-in with Internet zone security isolation
Dim addInTokens As Collection(Of AddInToken) = AddInStore.FindAddIns(GetType(IWPFAddInHostView), appPath)
Dim wpfAddInToken As AddInToken = addInTokens(0)
Me.wpfAddInHostView = wpfAddInToken.Activate(Of IWPFAddInHostView)(AddInSecurityLevel.Internet)
' Get and display add-in UI
Dim addInUI As FrameworkElement = Me.wpfAddInHostView.GetAddInUI()
Me.addInUIHostGrid.Children.Add(addInUI)