Método NamedRange.BorderAround

Artigo
08/01/2011

Adiciona uma borda para um NamedRange controle e define o Color, LineStyle, e Weight Propriedades para a nova borda.

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

Sintaxe

'Declaração
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
)

Parâmetros

LineStyle
Tipo: System.Object
O estilo de linha para a borda.Pode ser uma das seguintes XlLineStyle valores:
xlContinuous
xlDash
xlDashDot
xlDashDotDot
xlDot
xlDouble
xlSlantDashDot
xlLineStyleNone

Weight
Tipo: Microsoft.Office.Interop.Excel.XlBorderWeight
A espessura da borda.Pode ser uma das seguintes XlBorderWeight constantes:
xlHairline
xlMedium
xlThick
xlThin

ColorIndex
Tipo: Microsoft.Office.Interop.Excel.XlColorIndex
A cor da borda, como um índice na paleta de cores atual ou como um XlColorIndex constante.Pode ser uma das seguintes XlColorIndex constantes:
xlColorIndexAutomatic
xlColorIndexNone

Color
Tipo: System.Object
A cor da borda, como um valor RGB.

Valor de retorno

Tipo: System.Object

Comentários

Você deve especificar ColorIndex ou Color, mas não ambos.

Você pode especificar um LineStyle ou Weight, mas não ambos. Se você não especificar um argumento, o Excel de Microsoft Office usa o estilo de linha padrão e peso.

Esse método descreve todo o intervalo sem preenchê-lo. Para definir as bordas de todas as células, você deve definir o Color, LineStyle, e Weight Propriedades para o Borders coleção. Para limpar a borda, você deve definir o LineStyle propriedade para xlLineStyleNone de todas as células no intervalo.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir demonstra como definir uma série de formatação e exibir as características de um NamedRange controle chamado NamedRange1. Em particular, este exemplo usa o BorderAround método para desenhar uma borda espessa em torno de NamedRange1.

Este exemplo é para uma personalização em nível de 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();
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via