Report.Line-Methode (Access)

Die Line-Methode zeichnet Linien und Rechtecke in einem Report-Objekt , wenn das Print-Ereignis auftritt.

Syntax

Ausdruck verwendet werden. Linie (Schritt (x1, y1) – Schritt (x2, y2), Farbe, BF)

expression 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 durch die aktuellen Einstellungen für die Eigenschaften CurrentX und CurrentY des Object-Arguments angegeben wird.
x1, y1 Single Gibt die Koordinaten des Startpunkts für die Linie oder das Rechteck an. Die Skalierungseigenschaften (ScaleMode, ScaleLeft, ScaleTop, ScaleHeight und ScaleWidth) des Berichtsobjekts, das mit dem Argument Objekt Object angegeben wird, bestimmen die verwendete Maßeinheit. Wenn Sie dieses Argument auslassen, 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. Achte darauf, dass Anfangs- und 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 derselben Farbe gefüllt wird, 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“.

Hinweise

Verwenden Sie diese Methode nur in einer Ereignisprozedur oder einem Makro, die durch die Ereigniseigenschaft OnPrint oder OnFormat für einen Berichtsabschnitt oder die Ereigniseigenschaft OnPage 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 . Wie eine Linie oder ein Rechteck auf dem 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 auf den Endpunkt zurückgesetzt, der durch die Argumente x2 und y2 angegeben wird.

Beispiel

Im folgenden Beispiel wird mithilfe der Line-Methode ein rotes Rechteck gezeichnet, das fünf Pixel innerhalb des Rands eines Berichts mit dem Namen "EmployeeReport" liegt. Mithilfe der RGB-Funktion wird die Linie rot dargestellt.

Wenn Sie dieses Beispiel in Microsoft Access testen möchten, erstellen Sie einen neuen Bericht mit dem Namen "Mitarbeiterbericht". Fügen Sie den folgenden Code in den Abschnitt "Deklarationen" des Berichtsmoduls ein, und wechseln Sie dann in die 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.

  • Last updated on