MoveToEx: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
Zeile 1: Zeile 1:
 
Legt den aktuellen Startpunkt (X, Y) für die nächste Grafikoperation fest.
 
Legt den aktuellen Startpunkt (X, Y) für die nächste Grafikoperation fest.
 +
 +
'''Deklarationen:'''
 
<pre>
 
<pre>
Private Declare Function MoveToEx Lib "gdi32.dll" ( _
+
Declare Function MoveToEx Lib "gdi32.dll" ( _
                        ByVal hdc As Long, _
+
                ByVal hdc As Long, _
                        ByVal X As Long, _
+
                ByVal X As Long, _
                        ByVal Y As Long, _
+
                ByVal Y As Long, _
                        ByRef lpPoint As POINTAPI) As Long
+
                ByRef lpPoint As POINTAPI) As Long
                       
+
               
Private Declare Function MoveToEx Lib "gdi32.dll" ( _
+
Declare Function MoveToEx Lib "gdi32.dll" ( _
                        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
+
                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.
 
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.
  
Beispiel:
+
'''Beispiel:'''
 
<pre>
 
<pre>
 
' mit Rückgabe der letzten aktuellen Position (erste Deklaration)
 
' mit Rückgabe der letzten aktuellen Position (erste Deklaration)
Zeile 28: Zeile 30:
 
</pre>
 
</pre>
  
War der Aufruf der Funktion MoveToEx erfolgreich, liefert die Funktion einen Wert <> 0 zurück. War der Aufruf der Funktion nicht erfolgreich, dann liefert die Funktion einen Wert = 0 zurück.
+
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]].
 
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]].

Version vom 26. Februar 2007, 21:01 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 MoveToEx Lib "gdi32.dll" ( _
                 ByVal hdc As Long, _
                 ByVal X As Long, _
                 ByVal Y As Long, _
                 ByVal lpPoint As Long) As Long

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.

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)
MoveToEx hdc, X, Y, 0

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.