Report.Line-Methode (Access)

Die Line-Methode zeichnet Linien und Rechtecke für ein Report-Objekt , wenn das Print-Ereignis auftritt.

Syntax

Ausdruck. Linie (Schritt (x1, y1) - Schritt (x2, y2), Farbe, BF)

Ausdruck: Erforderlich. Eine Variable, die ein Report-Objekt darstellt. Ein Ausdruck, der eines der Objekte in der Liste Wird angewendet auf zurückgibt.

Parameter

Name	Datentyp	Beschreibung
Schritt	Schlüsselwort	Gibt an, dass die Startpunktkoordinaten relativ zur aktuellen Grafikposition sind, die von den aktuellen Einstellungen für die Eigenschaften CurrentX und CurrentY des Arguments Object angegeben wird.
x1, y1	Single	Gibt die Koordinaten des Startpunkts für die Linie oder das Rechteck an. Die Scale-Eigenschaften (ScaleMode, ScaleLeft, ScaleTop, ScaleHeight und ScaleWidth) des vom Argument Object angegebenen Report-Objekts bestimmen die verwendete Maßeinheit. Wenn dieses Argument nicht angegeben wird, beginnt die Zeile an der Position, die durch die Eigenschaften CurrentX und CurrentY angegeben wird.
x2, y2	Single	Erforderlich. Gibt die Koordinaten des Endpunkts für die Linie oder das Rechteck an. Stellen Sie sicher, dass der Startpunkt und der Endpunkt durch einen Bindestrich ( - ) getrennt sind.
Color	Long	Gibt die RGB-Farbe (Rot-Grün-Blau) an, die zum Zeichnen der Linie verwendet wird. Wird dieses Argument nicht angegeben, so wird der Wert der ForeColor -Eigenschaft verwendet. Sie können für die Farbangabe auch die RGB -Funktion oder die QBColor -Funktion verwenden.
B		Eine Option, mit der ein Rechteck erstellt wird, indem die Koordinaten als gegenüberliegende Ecken des Rechtecks verwendet werden.
F		F kann nicht ohne B verwendet werden. Wenn die Option B verwendet wird, gibt die Option F an, dass das Rechteck mit der gleichen Farbe gefüllt ist, die zum Zeichnen des Rechtecks verwendet wird. Wird B ohne F verwendet, wird das Rechteck mit der Farbe gefüllt, die von den aktuellen Einstellungen der Eigenschaften FillColor und BackStyle angegeben wird. Der Standardwert für die BackStyle-Eigenschaft ist für Rechtecke und Linien „Normal“.

HinwBemerkungeneise

Verwenden Sie diese Methode nur in einer Ereignisprozedur oder einem Makro, das durch die OnPrint - oder OnFormat-Ereigniseigenschaft für einen Berichtsabschnitt oder die OnPage-Ereigniseigenschaft für einen Bericht angegeben wird.

Stellen Sie beim Verbinden von zwei gezeichneten Linien sicher, dass eine Linie am Endpunkt der vorhergehenden Linie beginnt.

Die Breite der gezeichneten Linie hängt von der Einstellung der DrawWidth-Eigenschaft ab. Die Art und Weise, wie eine Linie oder ein Rechteck im Hintergrund gezeichnet wird, hängt von den Einstellungen der Eigenschaften DrawMode und DrawStyle ab.

Wenn Sie die Line-Methode anwenden, werden die Eigenschaften CurrentX und CurrentY erneut auf den Endpunkt festgelegt, der durch die Argumente x2 und y2 angegeben wird.

Beispiel

Im folgenden Beispiel wird die Line-Methode verwendet, um ein rotes Rechteck mit fünf Pixeln innerhalb des Rands eines Berichts mit dem Namen EmployeeReport zu zeichnen. Mithilfe der RGB-Funktion wird die Linie rot dargestellt.

Um dieses Beispiel in Microsoft Access auszuprobieren, erstellen Sie einen neuen Bericht mit dem Namen EmployeeReport. Fügen Sie den folgenden Code in den Abschnitt Deklarationen des Berichtsmoduls ein, und wechseln Sie dann zur Seitenansicht.

Private Sub Detail_Print(Cancel As Integer, PrintCount As Integer) 
    ' Call the Drawline procedure 
    DrawLine 
End Sub 
 
Sub DrawLine() 
    Dim rpt As Report, lngColor As Long 
    Dim sngTop As Single, sngLeft As Single 
    Dim sngWidth As Single, sngHeight As Single 
 
    Set rpt = Reports!EmployeeReport 
    ' Set scale to pixels. 
    rpt.ScaleMode = 3 
    ' Top inside edge. 
    sngTop = rpt.ScaleTop + 5 
    ' Left inside edge. 
    sngLeft = rpt.ScaleLeft + 5 
    ' Width inside edge. 
    sngWidth = rpt.ScaleWidth - 10 
    ' Height inside edge. 
    sngHeight = rpt.ScaleHeight - 10 
    ' Make color red. 
    lngColor = RGB(255,0,0) 
    ' Draw line as a box. 
    rpt.Line(sngTop, sngLeft) - (sngWidth, sngHeight), lngColor, B 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.