(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

IUIService-Schnittstelle

Ermöglicht die Interaktion mit der Benutzeroberfläche des Entwicklungsumgebungsobjekts, das als Host für den Designer fungiert.

Namespace:  System.Windows.Forms.Design
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[GuidAttribute("06A9C74B-5E32-4561-BE73-381B37869F4F")]
public interface IUIService

Der IUIService-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche EigenschaftStylesRuft die Auflistung der spezifischen Formate der Hostumgebung ab.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeCanShowComponentEditorGibt an, ob die Komponente ein ComponentEditorForm anzeigen kann.
Öffentliche MethodeGetDialogOwnerWindowRuft das Fenster ab, das beim Anzeigen von Dialogfeldern als Besitzer verwendet werden soll.
Öffentliche MethodeSetUIDirtyLegt ein Flag fest, das eine Änderung der Benutzeroberfläche angibt.
Öffentliche MethodeShowComponentEditorVersucht, ein ComponentEditorForm für eine Komponente anzuzeigen.
Öffentliche MethodeShowDialogVersucht, das angegebene Formular in einem Dialogfeld anzuzeigen.
Öffentliche MethodeShowError(Exception)Zeigt die angegebene Ausnahme und die Informationen darüber in einem Meldungsfeld an.
Öffentliche MethodeShowError(String)Zeigt die angegebene Fehlermeldung in einem Meldungsfeld an.
Öffentliche MethodeShowError(Exception, String)Zeigt die angegebene Ausnahme und die Informationen darüber in einem Meldungsfeld an.
Öffentliche MethodeShowMessage(String)Zeigt die angegebene Meldung in einem Meldungsfeld an.
Öffentliche MethodeShowMessage(String, String)Zeigt die angegebene Meldung in einem Meldungsfeld mit der angegebenen Beschriftung an.
Öffentliche MethodeShowMessage(String, String, MessageBoxButtons)Zeigt die angegebene Meldung in einem Meldungsfeld mit der angegebenen Beschriftung und den im Dialogfeld zu platzierenden Schaltflächen an.
Öffentliche MethodeShowToolWindowZeigt das angegebene Toolfenster an.
Zum Seitenanfang

IUIService kann Fehlermeldungen und Dialogfelder anzeigen sowie Ambient-Eigenschaften des Hosts, z. B. die Schriftart für Dialogfelder und Farbschemas, über die Styles-Wörterbucheigenschaft abrufen.

Im folgenden Codebeispiel wird ein Designer erstellt, der Designerverb-Menübefehle für Aufrufe von Methoden des IUIService bereitstellt. Sie können das Beispiel verwenden, indem Sie den Beispielcode in eine Assembly kompilieren und einer Windows Forms-Anwendung einen Verweis auf die Assembly hinzufügen. Wenn Sie Visual Studio verwenden, wird das IUIServiceExampleControl automatisch der Toolbox hinzugefügt. Fügen Sie einem Form eine Instanz des IUIServiceExampleControl hinzu. Sie können auf die Designerverbbefehle zugreifen, die IUIService-Methoden aufrufen, indem Sie entweder mit der rechten Maustaste auf die Steuerelementoberfläche klicken oder indem Sie auf das Smarttagsymbol des Steuerelements klicken und ein Element aus dem Smarttagbereich auswählen.


using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Windows.Forms;
using System.Windows.Forms.Design;

// This designer provides a set of designer verb shortcut menu commands
// that call methods of the IUIService.
public class IUIServiceTestDesigner : System.Windows.Forms.Design.ControlDesigner
{
    public IUIServiceTestDesigner()
    {
    }

    // Provides a set of designer verb menu commands that call 
    // IUIService methods.
    public override System.ComponentModel.Design.DesignerVerbCollection Verbs
    {
        get
        {
            return new DesignerVerbCollection( new DesignerVerb[] 
            {
                new DesignerVerb( 
                    "Show a test message box using the IUIService", 
                     new EventHandler(this.showTestMessage)),
                new DesignerVerb( 
                    "Show a test error message using the IUIService", 
                     new EventHandler(this.showErrorMessage)),
                new DesignerVerb( 
                    "Show an example Form using the IUIService", 
                     new EventHandler(this.showDialog)),
                new DesignerVerb( 
                     "Show the Task List tool window using the IUIService", 
                     new EventHandler(this.showToolWindow)) 
            });
        }
    }

    // Displays a message box with message text, caption text 
    // and buttons of a particular MessageBoxButtons style.
    private void showTestMessage(object sender, EventArgs e)
    {
        IUIService UIservice = (IUIService)this.GetService( 
            typeof( System.Windows.Forms.Design.IUIService ) );
        if( UIservice != null )            
            UIservice.ShowMessage("Test message", "Test caption", 
                System.Windows.Forms.MessageBoxButtons.AbortRetryIgnore);
    }

    // Displays an error message box that displays the message
    // contained in a specified exception.
    private void showErrorMessage(object sender, EventArgs e)
    {       
        IUIService UIservice = (IUIService)this.GetService( 
            typeof( System.Windows.Forms.Design.IUIService ) );
        if( UIservice != null )            
            UIservice.ShowError( new Exception(
                "This is a message in a test exception, " + 
                "displayed by the IUIService", 
                 new ArgumentException("Test inner exception")));
    }

    // Displays an example Windows Form using the 
    // IUIService.ShowDialog method.
    private void showDialog(object sender, EventArgs e)
    {
        IUIService UIservice = (IUIService)this.GetService( 
            typeof( System.Windows.Forms.Design.IUIService ) );
        if( UIservice != null )            
            UIservice.ShowDialog(new ExampleForm());
    }

    // Displays a standard tool window using the 
    // IUIService.ShowToolWindow method.
    private void showToolWindow(object sender, EventArgs e)
    {
        IUIService UIservice = (IUIService)this.GetService( 
            typeof( System.Windows.Forms.Design.IUIService ) );
        if( UIservice != null )            
            UIservice.ShowToolWindow(StandardToolWindows.TaskList);
    }
}

// Provides an example Form class used by the 
// IUIServiceTestDesigner.showDialog method.
internal class ExampleForm : System.Windows.Forms.Form
{
    public ExampleForm()
    {
        this.Text = "Example Form";
        System.Windows.Forms.Button okButton = new System.Windows.Forms.Button();
        okButton.Location = new Point(this.Width-70, this.Height-70);
        okButton.Size = new Size(50, 20);
        okButton.Anchor = AnchorStyles.Right | AnchorStyles.Bottom;
        okButton.DialogResult = DialogResult.OK;
        okButton.Text = "OK";
        this.Controls.Add( okButton );
    }
}

// This control is associated with the IUIServiceTestDesigner, 
// and can be sited in design mode to use the sample.
[DesignerAttribute(typeof(IUIServiceTestDesigner), typeof(IDesigner))]
public class IUIServiceExampleControl : UserControl
{
    public IUIServiceExampleControl()
    {
        this.BackColor = Color.Beige;
        this.Width = 255;
        this.Height = 60;
    }

    protected override void OnPaint(System.Windows.Forms.PaintEventArgs e)
    {
        if( this.DesignMode )
        {
            e.Graphics.DrawString(
                "Right-click this control to display a list of the", 
                 new Font("Arial", 9), Brushes.Black, 5, 6);
            e.Graphics.DrawString(
                "designer verb menu commands provided", 
                 new Font("Arial", 9), Brushes.Black, 5, 20);
            e.Graphics.DrawString( 
                "by the IUIServiceTestDesigner.", 
                 new Font("Arial", 9), Brushes.Black, 5, 34);
        }
    }
}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft