Übersicht über Windows Forms-Steuerelemente in Office-Dokumenten
Aktualisiert: Juli 2008
Betrifft |
|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekte auf Dokumentebene
Projekte auf Anwendungsebene
Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Windows Forms-Steuerelemente stellen Objekte dar, mit denen Benutzer arbeiten können, um Daten einzugeben oder zu ändern. In Projekten auf Dokumentebene für Microsoft Office Excel und Microsoft Office Word können Sie dem Dokument oder der Arbeitsmappe im Projekt Windows Forms-Steuerelemente zur Entwurfszeit oder auch programmgesteuert zur Laufszeit hinzufügen. Ab Visual Studio 2008 Service Pack 1 (SP1) können Sie diese Steuerelemente in einem Add-In auf Anwendungsebene für Excel 2007 oder Word 2007 beliebigen geöffneten Dokumenten oder Arbeitsmappen zur Laufzeit programmgesteuert hinzufügen.
Weitere Informationen hierzu finden Sie unter Gewusst wie: Hinzufügen von Windows Forms-Steuerelementen zu Office-Dokumenten.
Verwenden von Windows Forms-Steuerelementen
Sie können Windows Forms-Steuerelemente Dokumenten und benutzerdefinierbaren Benutzeroberflächenelementen (z. B. Aktionsbereiche, benutzerdefinierte Aufgabebereiche und Windows Forms) hinzufügen. In den meisten Fällen verhalten sich Windows Forms-Steuerelemente in Dokumenten genauso wie in diesen anderen Benutzeroberflächenelementen, es bestehen jedoch einige Unterschiede. Weitere Informationen finden Sie unter Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten.
Die Entscheidung, ob Sie Windows Forms-Steuerelemente einem Dokument oder einem anderen Benutzeroberflächenelement hinzufügen, ist von verschiedenen Faktoren abhängig. Berücksichtigen Sie beim Entwerfen Ihrer Lösung die in der folgenden Tabelle beschriebenen Kriterien für die Verwendung von Windows Forms-Steuerelementen.
Dokument
Wenn Sie die Steuerelemente ständig anzeigen möchten.
Wenn Sie möchten, dass Benutzer Daten direkt im Dokument eingeben, beispielsweise in formularbasierte Dokumente, bei denen die Bearbeitungsoberfläche gesperrt ist.
Wenn die Steuerelemente an den Daten im Dokument ausgerichtet angezeigt werden sollen. Wenn Sie z. B. jeder Zeile eines Listenobjekts Schaltflächen hinzufügen, sollten diese an den einzelnen Listenelementen ausgerichtet sein.
Aktionsbereich oder benutzerdefinierter Aufgabenbereich
Wenn Sie dem Benutzer Kontextinformationen geben möchten.
Wenn Sie nur die Ergebnisse im Dokument anzeigen möchten, nicht die Abfrage-Steuerelemente und -daten.
Wenn Sie sicherstellen möchten, dass die Steuerelemente nicht mit dem Dokument gedruckt werden.
Wenn Sie dafür sorgen möchten, dass die Ansicht des Dokuments nicht von den Steuerelementen blockiert wird.
Windows Form
Wenn Sie die Größe der Benutzeroberfläche steuern möchten.
Wenn Sie verhindern möchten, dass Benutzer Steuerelemente ausblenden oder löschen.
Wenn der Benutzer Daten eingeben soll und Sie verhindern möchten, dass das Dokument vor Empfang der Eingabe anderweitig bearbeitet wird.
Programmgesteuertes Hinzufügen von Windows Forms-Steuerelementen
Sie können Word-Dokumenten und Excel-Arbeitsmappen zur Laufzeit Windows Forms-Steuerelemente hinzufügen. Visual Studio Tools for Office stellt Hilfsmethoden zum Hinzufügen der gängigsten Windows Forms-Steuerelemente bereit. Mit diesen Hilfsmethoden können Sie Office-Dokumenten schnell Steuerelemente hinzufügen und auf die Kombination aus Windows Forms-Steuerelementfunktionalität und Office-bezogener Funktionalität dieser Steuerelemente zugreifen.
Weitere Informationen hierzu finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.
Verwenden von Windows Forms-Steuerelementen in Projekten auf Dokumentebene
Einige Aspekte der Verwendung von Windows Forms-Steuerelementen für Dokumente gelten nur für Projekte auf Dokumentebene, die es Ihnen ermöglichen, die Benutzeroberfläche Ihres Dokuments mit Visual Studio-Designer zu entwerfen.
Erstellen benutzerdefinierter Benutzersteuerelemente
Sie können ein Benutzersteuerelement dem Projekt und dann der Toolbox hinzufügen. Dann können Sie das Benutzersteuerelement dem Dokument hinzufügen, indem Sie es (wie ein Windows Forms-Steuerelement) direkt auf das Dokument ziehen. Bei der Erstellung von Benutzersteuerelementen sind einige Punkte zu berücksichtigen:
Erstellen Sie kein versiegeltes (sealed) Benutzersteuerelement. Visual Studio Tools for Office generiert eine aus dem Benutzersteuerelement abgeleitete Wrapperklasse, die das Benutzersteuerelement erweitert und seine Verwendung im Dokument unterstützt. Das Ableiten einer sealed-Klasse ist Visual Studio Tools for Office nicht möglich.
Für Benutzersteuerelemente muss das ComVisibleAttribute-Attribut auf true festgelegt sein. Bei Benutzersteuerelementen, die in einem Visual Studio Tools for Office-Projekt erstellt werden, ist dieses Attribut standardmäßig auf true festgelegt. Bei Benutzersteuerelementen hingegen, die aus anderen Projekten stammen, ist dieses Attribut möglicherweise nicht auf true festgelegt.
Nachdem Sie dem Dokument ein Benutzersteuerelement hinzugefügt haben, dürfen Sie die UserControl-Klasse nicht umbenennen oder aus dem Projekt löschen. Wenn Sie ein Benutzersteuerelement umbenennen möchten, müssen Sie es zuerst aus dem Dokument löschen. Dann können Sie es umbenennen und erneut hinzufügen.
Anordnen von Steuerelementen zur Entwurfszeit
Wenn Sie Word- und Excel-Dokumenten zur Entwurfszeit mehrere Steuerelemente hinzufügen, können Sie die Ausrichtung aller ausgewählten Steuerelemente in Visual Studio schnell mit den Symbolleisten Microsoft Office Word und Microsoft Office Excel festlegen. Diese Symbolleisten sind nur verfügbar, wenn ein Dokument oder Arbeitsblatt im Designer geöffnet ist.
Beim Auswählen mehrerer Steuerelemente im Designer können Sie diese mit den folgenden Schaltflächen auf diesen Symbolleisten anordnen:
Links ausrichten
Zentriert
Rechts ausrichten
Oben ausrichten
Mittig ausrichten
Unten ausrichten
Horizontalen Abstand angleichen
Vertikalen Abstand angleichen
.gif "Hinweis") Hinweis: |
|---|
In Word-Projekten sind diese Schaltflächen nur verfügbar, wenn die ausgewählten Steuerelemente nicht am Text ausgerichtet sind. Standardmäßig werden Steuerelemente, die Sie dem Dokument zur Entwurfszeit hinzufügen, am Text ausgerichtet. Weitere Informationen hierzu finden Sie unter Verwenden von Windows Forms-Steuerelementen in einem Word-Dokument. |
Verhindern der Anzeige alter Daten beim Laden von Excel-Arbeitsmappen
Wenn Sie Dokumenten oder Arbeitsmappen zur Entwurfszeit Windows Forms-Steuerelemente hinzufügen, bleiben die Steuerelemente beim Schließen des Dokuments durch den Benutzer im Dokument erhalten. Steuerelemente, die Sie zur Entwurfszeit hinzufügen, werden auch als statische Steuerelemente bezeichnet.
Beim Öffnen einer Excel-Arbeitsmappe, die ein statisches Steuerelement enthält, wird in der Arbeitsmappe solange eine Bitmap des Steuerelements in einem ActiveX-Steuerelement angezeigt, bis der Anpassungscode ausgeführt und das tatsächliche Steuerelement geladen wird. Diese Bitmap wird von Excel erstellt und bei jedem Speichern der Arbeitsmappe in der Arbeitsmappe gespeichert. Das Steuerelement wird in der Bitmap so angezeigt, wie es zum Zeitpunkt der letzten Speicherung der Arbeitsmappe angezeigt wurde, einschließlich aller vom Steuerelement angezeigten Daten. Weitere Informationen zum ActiveX-Steuerelement, das Windows Forms-Steuerelemente und Bitmaps enthält, finden Sie unter Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten.
Unter bestimmten Bedingungen wird der Code nicht geladen und nur die Bitmap angezeigt, beispielsweise wenn der Benutzer die Arbeitsmappe im Entwurfsmodus öffnet. Wenn der Benutzer die Arbeitsmappe auf einem Computer öffnet, auf dem die Visual Studio Tools for Office-Laufzeit nicht installiert ist, kann die Anpassung zum Laden der Steuerelemente nicht ausgeführt werden. Es wird daher nur die Bitmap des Steuerelements angezeigt. Sie sollten persönliche Informationen stets aus Steuerelementen in einer Arbeitsmappe entfernen, bevor Sie die Arbeitsmappe speichern und an andere Benutzer senden, damit Sie nicht versehentlich vertrauliche Informationen preisgeben.
Hinzufügen von Komponenten zur Entwurfszeit
Bestimmte Steuerelemente und Komponenten sind im Dokument nicht sichtbar und werden stattdessen in einem Komponentenfach angezeigt. Visual Studio Tools for Office stellt ein Komponentenfach für jedes Dokumentfenster bereit. Das Komponentenfach wird nur auf dem Bildschirm angezeigt, sofern Komponenten im Dokument vorhanden sind.
Siehe auch
Aufgaben
Gewusst wie: Hinzufügen von Windows Forms-Steuerelementen zu Office-Dokumenten
Gewusst wie: Ändern der Größe von Steuerelementen innerhalb der Arbeitsblattzellen
Gewusst wie: Ausblenden von Steuerelementen auf Arbeitsblättern beim Drucken
Exemplarische Vorgehensweise: Ändern der Dokumentformatierung mit CheckBox-Steuerelementen
Konzepte
Verwenden von Windows Forms-Steuerelementen in einem Word-Dokument
Verwenden von Windows Forms-Steuerelementen in Excel-Arbeitsblättern
Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit
Übersicht über Hostelemente und Hoststeuerelemente
Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten
Referenz
Weitere Ressourcen
Steuerelemente für Office-Dokumente
Steuerelemente für Windows Forms
Änderungsprotokoll
Date |
Versionsgeschichte |
Grund |
|---|---|---|
|
Juli 2008 |
Informationen über das Hinzufügen von Steuerelementen zu Dokumenten mit Add-Ins auf Anwendungsebene hinzugefügt. |
SP1-Featureänderung. |