Freigeben über

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

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 Funktionen verfügbar nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Hinzufügen von Text und einem Steuerelement zu einem Dokument in einem Projekt auf Dokumentebene während der Entwurfsphase.

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

    Informationen, um das Ergebnis als vollständiges Beispiel zu sehen, finden Sie im Beispiel für Word-Steuerelemente unter Office-Entwicklungsbeispiele und exemplarische 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

Sie benötigen die folgenden Komponenten, um diese Schritt-für-Schritt-Anleitung abzuschließen.

Erstelle das Projekt

Der erste Schritt besteht darin, ein Word-Dokumentprojekt zu erstellen.

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 "Mein Word-Formatierung" zum 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 Eigenschaftenfenster die folgenden Eigenschaften.

    Eigentum Wert
    Name applyBoldFont
    Text Bold

  4. Drücken Sie die Enter-Taste, 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.

    Eigentum Wert
    Name applyItalicFont
    Text Italic

  6. Drücken Sie die EINGABETASTE, um die Einfügemarke unter das zweite Kontrollkästchen zu verschieben.

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

    Eigentum Wert
    Name applyUnderlineFont
    Text Unterstreichen

Hinzufügen von Text und einem Lesezeichensteuerelement

  1. Verschieben Sie die Einfügemarke unterhalb der Kontrollkästchen 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 auf ThisDocument im Projektmappen-Explorer, und klicken Sie dann auf Code anzeigen im Kontextmenü.

  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 den folgenden Code dem Click Ereignishandler des applyBoldFont Kontrollkästchens 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 Click Kontrollkästchens den applyItalicFont 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 Click Kontrollkästchens den applyUnderlineFont 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 Ihr 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. Im Folgenden sind einige Aufgaben aufgeführt, die als Nächstes ausgeführt werden können:

Verwandte Inhalte

  • Last updated on