Freigeben über


NamedRange.AutoFormat-Methode

Formatiert das NamedRange-Steuerelement automatisch unter Verwendung eines vordefinierten Formats.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Function AutoFormat ( _
    Format As XlRangeAutoFormat, _
    Number As Object, _
    Font As Object, _
    Alignment As Object, _
    Border As Object, _
    Pattern As Object, _
    Width As Object _
) As Object
Object AutoFormat(
    XlRangeAutoFormat Format,
    Object Number,
    Object Font,
    Object Alignment,
    Object Border,
    Object Pattern,
    Object Width
)

Parameter

  • Number
    Typ: System.Object
    true , um Zahlenformate in AutoFormat einzuschließen.Standardwert: true.
  • Font
    Typ: System.Object
    true , um Schriftartformate in AutoFormat einzuschließen.Der Standardwert ist true.
  • Alignment
    Typ: System.Object
    true , um die Ausrichtung in AutoFormat einzuschließen.Der Standardwert ist true.
  • Border
    Typ: System.Object
    true , um Rahmenformate in AutoFormat einzuschließen.Der Standardwert ist true.
  • Pattern
    Typ: System.Object
    true , um Musterformate in AutoFormat einzuschließen.Der Standardwert ist true.
  • Width
    Typ: System.Object
    true , um Spaltenbreite und Zeilenhöhe in AutoFormat einzuschließen.Der Standardwert ist true.

Rückgabewert

Typ: System.Object

Hinweise

Wenn der Bereich aus einer einzelnen Zelle besteht, wird mit dieser Methode auch der aktive Bereich formatiert, der die Zelle umgibt.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie verschiedene Formatierungs- und Anzeigeeigenschaften eines NamedRange-Steuerelements mit dem Namen NamedRange1 festgelegt werden.Insbesondere wird bei diesem Beispiel die AutoFormat-Methode verwendet, um NamedRange1 mit dem xlRangeAutoFormat3DEffects1-Format zu formatieren.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    Private Sub SetRangeFormats()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        namedRange1.NoteText("This is a Formatting test", , )
        namedRange1.Value2 = "Martha"
        namedRange1.Font.Name = "Verdana"
        namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
        namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
        namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
            Excel.XlColorIndex.xlColorIndexAutomatic, )
        namedRange1.AutoFormat( _
            Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
            True, False, True, False, True, True)

        If MessageBox.Show("Clear the formatting and notes?", _
            "Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
            namedRange1.ClearFormats()
            namedRange1.ClearNotes()
        End If
    End Sub

private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.NoteText("This is a Formatting test");
    namedRange1.Value2 = "Martha";
    namedRange1.Font.Name = "Verdana";
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
    namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick, 
        Excel.XlColorIndex.xlColorIndexAutomatic);
    namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
        true, false, true, false, true, true);

    if (MessageBox.Show("Clear the formatting and notes?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.ClearFormats();
        namedRange1.ClearNotes();
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace