NamedRange.BorderAround (Método)

Agrega un borde a un control NamedRange y establece las propiedades Color, LineStyle y Weight del nuevo borde.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
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
  Estilo de línea para el borde.Puede ser uno de los siguientes valores de XlLineStyle:
  xlContinuous
  xlDash
  xlDashDot
  xlDashDotDot
  xlDot
  xlDouble
  xlSlantDashDot
  xlLineStyleNone

• Weight
  Tipo: Microsoft.Office.Interop.Excel.XlBorderWeight
  El grosor del borde.Puede ser una de las siguientes constantes de XlBorderWeight:
  xlHairline
  xlMedium
  xlThick
  xlThin

• ColorIndex
  Tipo: Microsoft.Office.Interop.Excel.XlColorIndex
  Color del borde, como índice en la paleta de colores actual o como constante de XlColorIndex.Puede ser una de las siguientes constantes de XlColorIndex:
  xlColorIndexAutomatic
  xlColorIndexNone

• Color
  Tipo: System.Object
  Color del borde, como valor RGB.

Valor devuelto

Tipo: System.Object

Comentarios

Debe especificar ColorIndex o Color, pero no ambos.

Puede especificar LineStyle o Weight, pero no ambos. Si no especifica ninguno de los argumentos, Microsoft Office Excel utiliza el estilo y el grosor de línea predeterminados.

Este método describe el intervalo completo sin rellenarlo. Para establecer los bordes de todas las celdas, debe establecer las propiedades Color, LineStyle y Weight para la colección Borders. Para borrar el borde, debe establecer la propiedad LineStyle en xlLineStyleNone para todas las celdas del rango.

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

En el siguiente ejemplo de código se indica cómo se establecen diversas características de presentación y formato de un control NamedRange denominado NamedRange1. En particular, este ejemplo utiliza el método BorderAround para dibujar un borde grueso alrededor de NamedRange1.

Se trata de un ejemplo para una personalización en el nivel del 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();
    }
}

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

NamedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)