_WClearRect( ), API-Bibliotheksroutine

Löscht den angegebenen rechteckigen Bereich des angegebenen Fensters durch Ändern des Bereichs auf die Standard-Hintergrundfarbe.

void _WClearRect(WHANDLE wh, Rect r)
WHANDLE wh;            /* Window handle. */
Rect r;                     /* Rectangle to clear. */

Hinweise

Die Ausgabeposition bleibt unverändert.

Der Bereich des Rechtecks erstreckt sich von der oberen linken Koordinate bis zur unteren rechten Koordinate, wobei diese nicht einbezogen wird. Das bedeutet, dass Sie die unteren und rechten Koordinaten um eins größer deklarieren sollten als die gewünschte Größe des Rechtecks.

Weitere Informationen zum Erstellen einer API-Bibliothek und ihrer Integration in Visual FoxPro finden Sie unter Zugreifen auf die Visual FoxPro-API.

Beispiel

Im folgenden Beispiel wird ein Fenster erstellt und mit dem Zeichen X aufgefüllt. Wenn Sie eine Taste als Reaktion auf einen WAIT-Befehl von Visual FoxPro drücken, löscht _WClearRect( ) einen rechteckigen Bereich des Fensters.

Visual FoxPro-Code

SET LIBRARY TO WCLRECT 

C-Code

#include <pro_ext.h>

FAR WClearEx(ParamBlk FAR *parm)
{
   WHANDLE wh;
   int row, col;
   Rect r;

   wh = _WOpen(2,2,20,70,WEVENT | CLOSE,WINDOW_SCHEME,(Scheme FAR *) 0,
      WO_SYSTEMBORDER);
   _WShow(wh);

   for (row = 0; row < _WHeight(wh); row++)
   {
      for (col = 0; col < _WWidth(wh); col++)
      {
         _WPutChr(wh, 'X');
      }
   }
   _Execute("WAIT WINDOW 'Press any key to clear window rectangle'");

   r.top    = 2;W
   r.left    = 2;
   r.bottom = 15;
   r.right  = 65;

   _WClearRect(wh, r);
}

FoxInfo myFoxInfo[] = {
   {"ONLOAD", (FPFI) WClearEx, CALLONLOAD, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Siehe auch

_WClear( ), API-Bibliotheksroutine | WAIT-Befehl | _WClearRectP( ), API-Bibliotheksroutine | Zugreifen auf die Visual FoxPro-API