getbkcolor

Syntax

#include <graphics.h>
int getbkcolor(void);

Description

getbkcolor returns the current background color. (See the table in setbkcolor for details.)

Return Value

getbkcolor returns the current background color.

Windows Notes

In the winbgim version, the user might set the background color to an RGB color. Therefore, the return value from getbkcolor might be an ordinary BGI color (integer from 0 to 15) or an RGB color.

See also

getcolor

getmaxcolor

getpalette

setbkcolor

Example

/* getbkcolor example */ 

#include <graphics.h>
#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include <conio.h>

int main(void)
{
   /* request autodetection */
   int gdriver = DETECT, gmode, errorcode;
   int bkcolor, midx, midy;
   char bkname[35];

   /* initialize graphics and local variables */
   initgraph(&gdriver, &gmode, "");

   /* read result of initialization */
   errorcode = graphresult();
   if (errorcode != grOk) {  /* an error occurred */
      printf("Graphics error: %s\n", grapherrormsg(errorcode));

      printf("Press any key to halt:");
      getch();
      exit(1);               /* terminate with an error code */
   }

   midx = getmaxx() / 2;
   midy = getmaxy() / 2;
   setcolor(getmaxcolor());

   /* for centering text on the display */
   settextjustify(CENTER_TEXT, CENTER_TEXT);

   /* get the current background color */
   bkcolor = getbkcolor();

   /* convert color value into a string */
   itoa(bkcolor, bkname, 10);
   strcat(bkname, " is the current background color.");



   /* display a message */
   outtextxy(midx, midy, bkname);

   /* clean up */
   getch();
   closegraph();
   return 0;
}