Polygon: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K
 
(11 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Zeichnet ein geschlossenes Polygon. Die Polygonpunkte werden in einem Feld vom Typ [[PointApi]] oder in einem Feld von 32-Bit-Integern (Long) übergeben.  
+
__NOTOC__
 +
== ==
 +
Die API-Funktion '''Polygon''' zeichnet ein geschlossenes Polygon. Die Polygonpunkte werden in einem Feld vom Typ [[PointApi]] oder in einem Feld von 32-Bit-Integern (Long) übergeben.
  
'''Deklarationen'''
 
 
<pre>
 
<pre>
 
Declare Function Polygon Lib "gdi32" ( _
 
Declare Function Polygon Lib "gdi32" ( _
                 ByVal hdc As Long, _
+
                 ByVal hDC As Long, _
                 lpPoint As POINTAPI, _
+
                 ByRef lpPoint As PointApi, _
 
                 ByVal nCount As Long) As Long
 
                 ByVal nCount As Long) As Long
  
 +
Declare Function Polygon Lib "gdi32" ( _
 +
                ByVal hDC As Long, _
 +
                ByRef lpPoint As Long, _
 +
                ByVal nCount As Long) As Long</pre>
 +
 +
==Parameter:==
 +
''hDC''
 +
:Handle eines Device Contextes
 +
''lpPoint''
 +
:Zeiger auf ein Feld vom Typ [[PointApi]]
 +
''nCount''
 +
:Anzahl der zu verwendenden Linienpunkte
 +
 +
==Rückgabe(n):==
 +
War die Funktion erfolgreich, so erfolgt eine Übergabe eines Wertes ungleich 0. Sollte die Funktion fehlschlagen, so kann die Fehlerursache mittels [[GetLastError]] festgestellt werden.
 +
 +
==Beispiel:==
 +
<PRE>
 +
Dim lngReturn As Long
 +
Dim tPointApi(0 To 3) As PointApi
  
Declare Function Polygon Lib "gdi32" ( _
+
tPointApi(0).X = 10: tPointApi(0).Y = 10
                ByVal hdc As Long, _
+
tPointApi(1).X = 10: tPointApi(1).Y = 100
                lpPoint As Long, _
+
tPointApi(2).X = 50: tPointApi(2).Y = 100
                ByVal nCount As Long) As Long
+
tPointApi(3).X = 50: tPointApi(3).Y = 50
</pre>
 
  
Anmerkungen:
+
lngReturn = Polygon(Picture1.hDC, tPointApi(0), 4)
 +
</PRE>
  
 +
==Hinweise:==
 
Die Ausgabe beginnt beim angegebenen Punkt. Dies kann, muß aber nicht notwendigerweise, der erste Punkt im Feld ([[Array]]) sein. nCount ist die Zahl der zu verwendenden Polygonpunkte. Diese Zahl ist üblicherweise die Anzahl der Punkte im Feld, kann aber auch geringer sein.
 
Die Ausgabe beginnt beim angegebenen Punkt. Dies kann, muß aber nicht notwendigerweise, der erste Punkt im Feld ([[Array]]) sein. nCount ist die Zahl der zu verwendenden Polygonpunkte. Diese Zahl ist üblicherweise die Anzahl der Punkte im Feld, kann aber auch geringer sein.
  
Es werden die aktuellen Stift-Einstellungen und Füllstile, bzw. Füllmuster verwendet. Erfolgt die Ausgabe in einer Vb-Picturebox oder Form, so können die VB-Funktionen verwendet werden, um Einstellungen zu setzen. Andernfalls müssen API-Befehle (CreatePen, CreateBrush) verwendet werden.
+
Es werden die aktuellen Stift-Einstellungen und Füllstile, bzw. Füllmuster verwendet. Erfolgt die Ausgabe in einer VB-Picturebox oder Form, so können die VB-Funktionen verwendet werden, um Einstellungen zu setzen. Andernfalls müssen API-Befehle (CreatePen, CreateBrush) verwendet werden.
  
Beispiel:
+
==Betriebssystem:==
 +
Die API-Funktion '''Polygon''' ist unter folgenden Betriebssystemen funktionsfähig:
  
<pre>
+
*Windows 95 und später. Bei Windows 9x ist die Zahl der Polygonpunkte auf ca 16000 beschränkt.
Polygon Picture1.Hdc, pt(1), 10
+
*Windows NT 3.1 und später
</pre>
 
  
Ein DC wird durch Anwendung der GDI-befehle nicht automatisch aktualisieret. Die Ausgabe wird in VB erst nach aufruf des Refresh-Befehls sichtbar.
 
  
<pre>
 
Picture1.Refresh
 
</pre>
 
  
Besondere Anmerkungen zu Windows 95, 98 und ME:
+
[[Kategorie:Vektorgrafik]]
Die Anzahl der Polygonpunkte ist auf ca. 16000 beschränkt.
+
[[Kategorie:GDI]]
 +
[[Kategorie:Funktionen]]
 +
[[Kategorie:Grafik]]

Aktuelle Version vom 10. September 2008, 14:59 Uhr

Die API-Funktion Polygon zeichnet ein geschlossenes Polygon. Die Polygonpunkte werden in einem Feld vom Typ PointApi oder in einem Feld von 32-Bit-Integern (Long) übergeben.

Declare Function Polygon Lib "gdi32" ( _
                 ByVal hDC As Long, _
                 ByRef lpPoint As PointApi, _
                 ByVal nCount As Long) As Long

Declare Function Polygon Lib "gdi32" ( _
                 ByVal hDC As Long, _
                 ByRef lpPoint As Long, _
                 ByVal nCount As Long) As Long

Parameter:

hDC

Handle eines Device Contextes

lpPoint

Zeiger auf ein Feld vom Typ PointApi

nCount

Anzahl der zu verwendenden Linienpunkte

Rückgabe(n):

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

Beispiel:

Dim lngReturn As Long
Dim tPointApi(0 To 3) As PointApi

tPointApi(0).X = 10: tPointApi(0).Y = 10
tPointApi(1).X = 10: tPointApi(1).Y = 100
tPointApi(2).X = 50: tPointApi(2).Y = 100
tPointApi(3).X = 50: tPointApi(3).Y = 50

lngReturn = Polygon(Picture1.hDC, tPointApi(0), 4)

Hinweise:

Die Ausgabe beginnt beim angegebenen Punkt. Dies kann, muß aber nicht notwendigerweise, der erste Punkt im Feld (Array) sein. nCount ist die Zahl der zu verwendenden Polygonpunkte. Diese Zahl ist üblicherweise die Anzahl der Punkte im Feld, kann aber auch geringer sein.

Es werden die aktuellen Stift-Einstellungen und Füllstile, bzw. Füllmuster verwendet. Erfolgt die Ausgabe in einer VB-Picturebox oder Form, so können die VB-Funktionen verwendet werden, um Einstellungen zu setzen. Andernfalls müssen API-Befehle (CreatePen, CreateBrush) verwendet werden.

Betriebssystem:

Die API-Funktion Polygon ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows 95 und später. Bei Windows 9x ist die Zahl der Polygonpunkte auf ca 16000 beschränkt.
  • Windows NT 3.1 und später