Freigeben über

Exemplarische Vorgehensweise: Ändern der Dokumentformatierung mithilfe von CheckBox-Steuerelementen

  • Artikel

In dieser exemplarischen Vorgehensweise wird die Verwendung von Windows Forms-Steuerelementen in einer Anpassung auf Dokumentebene für Microsoft Office Word zum Ändern der Textformatierung veranschaulicht.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Hinzufügen von Text und einem Steuerelement zum Dokument in einem Projekt auf Dokumentebene zur Entwurfszeit.

  • Formatieren des Texts, wenn eine Option ausgewählt ist.

    Informationen zum Anzeigen des Ergebnisses als abgeschlossenes Beispiel finden Sie im Word-Steuerelementbeispiel zu Office-Entwicklungsbeispielen und exemplarischen Vorgehensweisen.

    Hinweis

    Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

Im ersten Schritt wird ein Word-Dokumentprojekt erstellt.

Erstellen eines neuen Projekts

  1. Erstellen Sie ein Word-Dokumentprojekt mit dem Namen "Meine Word-Formatierung". Wählen Sie im Assistenten " Neues Dokument erstellen" aus.

    Weitere Informationen finden Sie unter How to: Create Office projects in Visual Studio.

    Visual Studio öffnet das neue Word-Dokument im Designer und fügt das Projekt "Meine Word-Formatierung" zu Projektmappen-Explorer hinzu.

Hinzufügen von Text und Steuerelementen zum Word-Dokument

Fügen Sie für diese exemplarische Vorgehensweise dem Word-Dokument drei Kontrollkästchen und text in einem Bookmark Steuerelement hinzu. Die Kontrollkästchen zeigen dem Benutzer Optionen zum Formatieren des Texts an.

Hinzufügen von drei Kontrollkästchen

  1. Stellen Sie sicher, dass das Dokument im Visual Studio-Designer geöffnet ist.

  2. Ziehen Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox das erste CheckBox Steuerelement in das Dokument.

  3. Ändern Sie im Fenster Eigenschaften die folgenden Eigenschaften:

    Eigenschaft Wert
    Name applyBoldFont
    Text Fett

  4. Drücken Sie die EINGABETASTE , um die Einfügemarke unterhalb des ersten Kontrollkästchens zu verschieben.

  5. Fügen Sie dem Dokument unterhalb des ApplyBoldFont Kontrollkästchens ein zweites Kontrollkästchen hinzu, und ändern Sie die folgenden Eigenschaften.

    Eigenschaft Wert
    Name applyItalicFont
    Text Kursiv

  6. Drücken Sie die EINGABETASTE , um die Einfügemarke unterhalb des zweiten Kontrollkästchens zu verschieben.

  7. Fügen Sie dem Dokument unterhalb des ApplyItalicFont Kontrollkästchens ein drittes Kontrollkästchen hinzu, und ändern Sie die folgenden Eigenschaften.

    Eigenschaft Wert
    Name applyUnderlineFont
    Text Unterstrich

Hinzufügen von Text und einem Lesezeichensteuerelement

  1. Verschieben Sie die Einfügemarke unter den Kontrollkästchen-Steuerelementen, und geben Sie den folgenden Text ein:

    Klicken Sie auf ein Kontrollkästchen, um die Formatierung dieses Texts zu ändern.

  2. Ziehen Sie auf der Registerkarte "Word-Steuerelemente " der Toolbox ein Bookmark Steuerelement in das Dokument.

    Das Dialogfeld "Lesezeichensteuerelement hinzufügen" wird angezeigt.

  3. Markieren Sie den Text, den Sie dem Dokument hinzugefügt haben, und klicken Sie auf "OK".

    Dem markierten Text im Dokument wird ein Bookmark Steuerelement namens Bookmark1 hinzugefügt.

  4. Ändern Sie im Eigenschaftenfenster den Wert der Eigenschaft (Name) in fontText.

    Schreiben Sie als Nächstes den Code, um den Text zu formatieren, wenn ein Kontrollkästchen aktiviert oder deaktiviert wird.

Formatieren des Texts, wenn ein Kontrollkästchen aktiviert oder deaktiviert ist

Wenn der Benutzer eine Formatierungsoption auswählt, ändern Sie das Format des Texts im Dokument.

Ändern der Formatierung, wenn ein Kontrollkästchen aktiviert ist

  1. Klicken Sie mit der rechten Maustaste ThisDocument in Projektmappen-Explorer, und klicken Sie dann im Kontextmenü auf "Code anzeigen".

  2. Fügen Sie für C# nur die folgenden Konstanten zur ThisDocument-Klasse hinzu.

    const int WordTrue = -1;
const int WordFalse = 0;

  3. Fügen Sie dem Ereignishandler des applyBoldFont Kontrollkästchens den Click folgenden Code hinzu.

    private void applyBoldFont_Click(object sender, System.EventArgs e)
{
    if (this.applyBoldFont.Checked == true)
    {
        this.fontText.Bold = WordTrue;
    }
    else
    {
        this.fontText.Bold = WordFalse;
    }
}

  4. Fügen Sie dem Ereignishandler des applyItalicFont Kontrollkästchens den Click folgenden Code hinzu.

    private void applyItalicFont_Click(object sender, System.EventArgs e)
{
    if (this.applyItalicFont.Checked == true)
    {
        this.fontText.Italic = WordTrue;
    }
    else
    {
        this.fontText.Italic = WordFalse;
    }
}

  5. Fügen Sie dem Ereignishandler des applyUnderlineFont Kontrollkästchens den Click folgenden Code hinzu.

    private void applyUnderlineFont_Click(object sender, System.EventArgs e)
{
    if (this.applyUnderlineFont.Checked == true)
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
    }
    else
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
    }
}

  6. In C# müssen Sie ereignishandler für die Textfelder zum Startup Ereignis hinzufügen. Informationen zum Erstellen von Ereignishandlern finden Sie unter How to: Create event handlers in Office projects.

    this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);

Testen der App

Sie können nun Ihr Dokument testen, um zu überprüfen, ob der Text korrekt formatiert ist, wenn Sie ein Kontrollkästchen aktivieren oder deaktivieren.

Testen Des Dokuments

  1. Drücken Sie F5, um das Projekt auszuführen.

  2. Aktivieren oder deaktivieren Sie ein Kontrollkästchen.

  3. Vergewissern Sie sich, dass der Text richtig formatiert ist.

Nächste Schritte

In dieser exemplarischen Vorgehensweise werden die Grundlagen der Verwendung von Kontrollkästchen und programmgesteuertes Ändern der Textformatierung in Word-Dokumenten gezeigt. Die folgenden Aufgaben könnten sich daran anschließen:

Zugehöriger Inhalt