Udostępnij za pośrednictwem

Metoda NamedRange.AutoFormat —

  • Artykuł

Automatycznie formatuje NamedRange kontroli, przy użyciu formatu wstępnie zdefiniowanego.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
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
)

Parametry

  • Number
    Typ: System.Object
    true Aby dołączyć formaty liczbowe Autoformatowania.Wartość domyślna to true.
  • Font
    Typ: System.Object
    true Aby dołączyć formaty czcionek Autoformatowania.Wartością domyślną jest true.
  • Alignment
    Typ: System.Object
    true Aby dołączyć wyrównanie Autoformatowania.Wartością domyślną jest true.
  • Border
    Typ: System.Object
    true Aby dołączyć formaty obramowania Autoformatowania.Wartością domyślną jest true.
  • Pattern
    Typ: System.Object
    true Aby dołączyć wzór formaty Autoformatowania.Wartością domyślną jest true.
  • Width
    Typ: System.Object
    true Aby dołączyć kolumny szerokości i wysokości wiersza Autoformatowania.Wartością domyślną jest true.

Wartość zwracana

Typ: System.Object

Uwagi

Jeśli zakres znajduje się pojedynczą komórkę, Metoda ta również formatuje aktywnego regionu otaczające komórki.

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

Poniższy przykład kodu demonstruje sposób ustawiania różnych formatowania i wyświetlania właściwości NamedRange kontrolki o nazwie NamedRange1.W szczególności, w tym przykładzie użyto AutoFormat metoda formatowania NamedRange1 za pomocą xlRangeAutoFormat3DEffects1 format.

Ten przykład dotyczy dostosowywania poziomie dokumentu.

    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();
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel