Beispiel für benutzerdefinierten BitmapEffect: RGBFilter
Aktualisiert: November 2007
In diesem Beispiel wird das Erstellen eines benutzerdefinierten BitmapEffect und die Verwendung des Effekts in einer Windows Presentation Foundation (WPF)-Anwendung veranschaulicht.
Das Beispiel ist in drei Projekte aufgeteilt: eine nicht verwaltete Component Object Model (COM)-Bibliothek, eine verwaltete Assembly und ein verwaltetes Verwendungsbeispiel. Das nicht verwaltete Bibliotheksprojekt führt die tatsächliche Effektänderung durch und implementiert die erforderlichen Schnittstellen für einen benutzerdefinierten Effekt. Mit der verwalteten Assembly wird der Effekt für die Verwendung im verwalteten Code definiert, und es werden die erforderlichen Interaktionen mit der Effektbibliothek ausgeführt. Im Verwendungsbeispiel wird anhand der Assembly der benutzerdefinierte Effekt veranschaulicht.
In diesem Beispiel soll nur ein bestimmtes Feature des Windows Presentation Foundation (WPF) veranschaulicht werden, daher werden die bewährten Methoden für die Anwendungsentwicklung nicht befolgt. Ausführliche Informationen über empfohlene Vorgehensweisen bei der Anwendungsentwicklung für Windows Presentation Foundation (WPF) und Microsoft .NET Framework finden Sie unter folgenden Themen:
Eingabehilfen – Bewährte Methoden für Eingabehilfen
Sicherheit - Windows Presentation Foundation-Sicherheit
Lokalisierung – Übersicht über WPF-Globalisierung und -Lokalisierung
Erstellen des Beispiels
Installieren Sie das Windows Software Development Kit (SDK) und öffnen Sie dessen Buildumgebungs-Befehlsfenster. Zeigen Sie im Startmenü auf Alle Programme und Microsoft Windows SDK, und klicken Sie dann auf CMD Shell.
Aktualisieren Sie den Header und die Bibliothekspfade. Folgen Sie den Anweisungen in Abschnitt 6.2 in der Windows SDK-Infodatei, um die Pfade für die Entwicklungsumgebung zu aktualisieren.
Laden Sie das Beispiel, normalerweise aus der Software Development Kit (SDK)-Dokumentation, auf Ihre Festplatte herunter.
Erstellen Sie das Beispiel.
Um das Beispiel mit in Microsoft Visual Studio zu erstellen, laden Sie die Projektmappe oder Projektdatei des Beispiels, und drücken Sie STRG+UMSCHALT+B.
Navigieren Sie zum Projektmappenordner, um das vollständige Beispiel aus dem Befehlsfenster der Buildumgebung zu erstellen. Geben Sie an der Eingabeaufforderung MSBUILD ein:
Navigieren Sie zum Erstellen der einzelnen Projekte aus dem Befehlsfenster der Buildumgebung zu den einzelnen Projektordnern. Geben Sie an der Eingabeaufforderung MSBUILD ein:
Ausführen des Beispiels
Registrieren Sie die nicht verwaltete Bibliothek. Führen Sie im Befehlsfenster regsvr32 für Dynamic Link Library (DLL) im Ordner Debug oder Release im Quellordner RGBFilterEffectLib aus.
Ausführen des Beispiels
Wenn Sie das Beispiel mit Microsoft Visual Studio 2005 ausführen möchten, wählen Sie RGBFilterEffectTest aus, und drücken Sie dann F5.
Um das Beispiel vom Befehlsfenster der Buildumgebung auszuführen, führen Sie die EXE-Datei im Ordner Bin\Debug bzw. Bin\Release im Ordner RGBFilterEffectTest aus.
Hinweise
Wenn Sie dieses Beispiel unter Windows Vista erstellen, benötigen Sie zum Registrieren der Dynamic Link Library (DLL) Administratorrechte. Möglicherweise muss das Befehlsfenster mit Administratorrechten ausgeführt werden. Klicken Sie hierzu mit der rechten Maustaste auf die Befehlsverknüpfung, und wählen Sie "Als Administrator ausführen" aus.