Metodo NamedRange.BorderAround

Articolo
08/11/2011

Aggiunge un bordo a un controllo NamedRange e imposta le proprietà Color, LineStyle e Weight per il nuovo bordo.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function BorderAround ( _
    LineStyle As Object, _
    Weight As XlBorderWeight, _
    ColorIndex As XlColorIndex, _
    Color As Object _
) As Object

Object BorderAround(
    Object LineStyle,
    XlBorderWeight Weight,
    XlColorIndex ColorIndex,
    Object Color
)

Parametri

LineStyle
Tipo: System.Object
Stile della linea per il bordo.Può essere uno dei seguenti valori di XlLineStyle:
xlContinuous
xlDash
xlDashDot
xlDashDotDot
xlDot
xlDouble
xlSlantDashDot
xlLineStyleNone

Weight
Tipo: Microsoft.Office.Interop.Excel.XlBorderWeight
Spessore del bordo.Può essere una delle seguenti costanti di XlBorderWeight:
xlHairline
xlMedium
xlThick
xlThin

ColorIndex
Tipo: Microsoft.Office.Interop.Excel.XlColorIndex
Colore del bordo, come indice della tavolozza dei colori corrente o come costante di XlColorIndex.Può essere una delle seguenti costanti di XlColorIndex:
xlColorIndexAutomatic
xlColorIndexNone

Color
Tipo: System.Object
Colore del bordo come valore RGB.

Valore restituito

Tipo: System.Object

Note

È necessario specificare il parametro ColorIndex oppure Color, ma non entrambi.

È possibile specificare il parametro LineStyle oppure Weight, ma non entrambi. Se non si specifica alcun argomento, verranno utilizzati lo stile e lo spessore di linea predefiniti.

Questo metodo applica una struttura all'intero intervallo senza riempirlo. Per impostare i bordi di tutte le celle, è necessario impostare le proprietà Color, LineStyle e Weight per l'insieme Borders. Per cancellare il bordo, è necessario impostare la proprietà LineStyle su xlLineStyleNone per tutte le celle dell'intervallo.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come impostare diverse caratteristiche di formattazione e visualizzazione di un controllo NamedRange denominato NamedRange1. In particolare, viene utilizzato il metodo BorderAround per disegnare un bordo spesso intorno a NamedRange1.

Questo esempio è valido per una personalizzazione a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via