ScreenList

Finds available fullscreen video modes

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction ScreenList ( KeyPgByvalByVal depth KeyPgAsAs KeyPgLongLong = 0 ) KeyPgAsAs KeyPgLongLong

Usage
	result = ScreenList( [ depth ] )

Parameters
	depth
		the color depth for which the list of modes is requested  (supported 
		depths are 8, 15, 16, 24 and 32)

Return Value
	returns 0, when there are no more resolutions to read.

Description
	It works like the KeyPgDirDir function: the first call to the function requires 
	the depth parameter to be specified, it  returns the lowest supported 
	resolution for the requested depth. Further calls to ScreenList without 
	arguments returns the next resolutions. When no more resolutions are 
	available, KeyPgScreenlistScreenList returns 0.

	The result of KeyPgScreenlistScreenList is encoded as a 32 bit value, with the screen 
	width as the KeyPgHiwordHigh Word and the height as the KeyPgLoWordLow Word.

	Resolutions are returned from lowest to highest supported ones. 

	It is safe to call this function before any graphics mode has been set.

Example
	Dim As Long mode
	Dim As UInteger w, h

	Print "Resolutions supported at 8 bits per pixel:"

	mode = ScreenList(8)
	While (mode <> 0)
	   w = HiWord(mode)
	   h = LoWord(mode)
	   Print w & "x" & h
	   mode = ScreenList()
	Wend

Dialect Differences
	* Not available in the CompilerOptlang-lang qb dialect unless referenced with the 
	  alias __Screenlist.

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgScreengraphicsScreen (Graphics)
	* KeyPgScreenresScreenRes

