MoveToEx: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
Zeile 8: Zeile 8:
 
                 ByVal Y As Long, _
 
                 ByVal Y As Long, _
 
                 ByRef lpPoint As POINTAPI) As Long
 
                 ByRef lpPoint As POINTAPI) As Long
               
+
 
Declare Function MoveToEx Lib "gdi32.dll" ( _
+
Declare Function MoveTo Lib "gdi32.dll" _
 +
                Alias "MoveToEx" ( _
 
                 ByVal hdc As Long, _
 
                 ByVal hdc As Long, _
 
                 ByVal X As Long, _
 
                 ByVal X As Long, _
 
                 ByVal Y As Long, _
 
                 ByVal Y As Long, _
                 ByVal lpPoint As Long) As Long
+
                 Optional ByVal lpPoint As Long) As Long
 +
 
 
</pre>
 
</pre>
  
 
'''Anmerkungen:'''
 
'''Anmerkungen:'''
  
Optional kann im Parameter lpPoint vom Typ [[PointApi]] die letzte aktuelle Position abgerufen werden. Wird im Parameter lpPoint ein Null-Zeiger übergeben, dann wird die letzte aktuelle Position nicht zurückgegeben.
+
Im Parameter lpPoint vom Typ [[PointApi]] kann die vorherige Ausgabeposition abgerufen werden. Wird im Parameter lpPoint ein Null-Zeiger übergeben, dann wird die letzte Position nicht zurückgegeben. Da die vorherige Position nur selten benötigt wird, empfiehlt sich eine Deklaration nach obigem Muster zu verwenden, in welcher der letzte Parameter nur Optional anzugeben ist. Hier kann auch der einfachere Name MoveTo als Alias deklariert werden.
  
 
'''Beispiel:'''
 
'''Beispiel:'''
Zeile 27: Zeile 29:
  
 
' ohne Rückgabe der letzten aktuellen Position (zweite Deklaration)
 
' ohne Rückgabe der letzten aktuellen Position (zweite Deklaration)
MoveToEx hdc, X, Y, 0
+
MoveTo hdc, X, Y
 
</pre>
 
</pre>
  

Version vom 27. Februar 2007, 22:07 Uhr

Legt den aktuellen Startpunkt (X, Y) für die nächste Grafikoperation fest.

Deklarationen:

Declare Function MoveToEx Lib "gdi32.dll" ( _
                 ByVal hdc As Long, _
                 ByVal X As Long, _
                 ByVal Y As Long, _
                 ByRef lpPoint As POINTAPI) As Long

Declare Function MoveTo Lib "gdi32.dll" _
                 Alias "MoveToEx" ( _
                 ByVal hdc As Long, _
                 ByVal X As Long, _
                 ByVal Y As Long, _
                 Optional ByVal lpPoint As Long) As Long

Anmerkungen:

Im Parameter lpPoint vom Typ PointApi kann die vorherige Ausgabeposition abgerufen werden. Wird im Parameter lpPoint ein Null-Zeiger übergeben, dann wird die letzte Position nicht zurückgegeben. Da die vorherige Position nur selten benötigt wird, empfiehlt sich eine Deklaration nach obigem Muster zu verwenden, in welcher der letzte Parameter nur Optional anzugeben ist. Hier kann auch der einfachere Name MoveTo als Alias deklariert werden.

Beispiel:

' mit Rückgabe der letzten aktuellen Position (erste Deklaration)
Dim Pt as PointApi
MoveToEx hdc, X, Y, Pt

' ohne Rückgabe der letzten aktuellen Position (zweite Deklaration)
MoveTo hdc, X, Y

War die Funktion erfolgreich, so erfolgt eine Übergabe eines Wertes ungleich 0. Sollte die Funktion fehlschlagen, so kann die Fehlerursache mittels GetLastError festgestellt werden.

Nicht alle Grafikbefehle ändern die aktuelle Position. Die Position wird geändert durch LineTo, Pset und PolygonTo. Sie wird hingegen nicht geändert durch Polyline, Polygon, Rectangle, Ellipse.