XmlMappedRange.BorderAround-Methode

Artikel
08/10/2011

Fügt einem XmlMappedRange-Steuerelement einen Rahmen hinzu und legt die Eigenschaften Color, LineStyle sowie Weight für den neuen Rahmen fest.

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

Syntax

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

Parameter

LineStyle
Typ: System.Object
Die Linienart für den Rahmen.Kann einer der folgenden XlLineStyle-Werte sein:
xlContinuous
xlDash
xlDashDot
xlDashDotDot
xlDot
xlDouble
xlSlantDashDot
xlLineStyleNone

Weight
Typ: Microsoft.Office.Interop.Excel.XlBorderWeight
Die Rahmenstärke.Kann eine der folgenden XlBorderWeight-Konstanten sein:
xlHairline
xlMedium
xlThick
xlThin

ColorIndex
Typ: Microsoft.Office.Interop.Excel.XlColorIndex
Die Rahmenfarbe als Index für die aktuelle Farbpalette oder als XlColorIndex-Konstante.Kann eine der folgenden XlColorIndex-Konstanten sein:
xlColorIndexAutomatic
xlColorIndexNone

Color
Typ: System.Object
Die Rahmenfarbe als ein RGB-Wert.

Rückgabewert

Typ: System.Object

Hinweise

Sie müssen entweder ColorIndex oder Color angeben. Sie können jedoch nicht beide angeben.

Sie können entweder LineStyle oder Weight angeben. Sie können jedoch nicht beide angeben. Wenn Sie kein Argument angeben, wird von Microsoft Office Excel die Standardlinienart und Standardlinienstärke verwendet.

Mit dieser Methode wird das XmlMappedRange-Steuerelement umrahmt, es wird jedoch nicht ausgefüllt.

Um den Rahmen zu entfernen, können Sie die LineStyle-Eigenschaft für das XmlMappedRange-Steuerelement auf xlLineStyleNone festlegen.

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird die BorderAround-Methode verwendet, um einen starken Rahmen um einen XmlMappedRange zu erstellen. Im Beispiel wird der Benutzer aufgefordert, den Rahmen mithilfe der ClearFormats Methode zu entfernen. In diesem Codebeispiel wird davon ausgegangen, dass das aktuelle Arbeitsblatt einen XmlMappedRange mit dem Namen CustomerLastNameCell enthält.

Private Sub SetBorder()
    Me.CustomerLastNameCell.BorderAround( _
        Weight:=Excel.XlBorderWeight.xlThick, _
        ColorIndex:=Excel.XlColorIndex.xlColorIndexAutomatic)

    If MessageBox.Show("Clear the border?", "Test", MessageBoxButtons.YesNo) = _
        DialogResult.Yes Then
        Me.CustomerLastNameCell.ClearFormats()
    End If
End Sub

private void SetBorder()
{
    this.CustomerLastNameCell.BorderAround(missing, 
        Excel.XlBorderWeight.xlThick, 
        Excel.XlColorIndex.xlColorIndexAutomatic, missing);

    if (MessageBox.Show("Clear the border?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        this.CustomerLastNameCell.ClearFormats();
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über