MINIGUI-API-REF-MANUAL-V1.3-E

MiniGUIAPIReferenceManualForMiniGUIVersion1.3.xBeijingFeynmanSoftwareTechnologyCo.,Ltd.Oct.2003MiniGUIAPIReferenceManualiIntroductionMiniGUIisaGPL’dfreesoftwareproject,ledbyBeijingFeynmanSoftwareTechnologyCo.,Ltd.andsupportedbymanyfreesoftwaredevelopers.Itaimstoprovideafast,stable,andlightweightGraphicsUserInterfacesupportsystem,whichisespeciallyfitforreal-timeembeddedsystemsbasedonLinux.MiniGUIdefinesasetoflightwindowingandGDI(GraphicsDeviceInterface)APIsforapplications.Byusingthem,anapplicationcancreatemultiplewindowsand/orcontrols,andcandrawinthesewindows/controlswithoutinterferingtheothers.MiniGUIiscomposedoffourlibraries:libminigui,libmgext,andlibvcongui.Libminiguiisthecorelibrary,whichprovideswindowingandgraphicsinterfacesaswellasthestandardcontrols.Libmgextisanextensionlibraryoflibminigui.Itprovidessomeprettyandusefulcontrols,andsomeconvenientuserinterfacefunctions,suchas`OpenFileDialogBox'..Libvconguiprovidesavirtualconsolewindowinwhichyoucanrunprogramsincharactermode.YoucanconfigureandcompileMiniGUIas`MiniGUI-Threads'oras`MiniGUI-Lite'.AprogramrunningonMiniGUI-Threadscancreatemultiplewindowsindifferentthreads,andallthewindowsbelongtoasingleprocess;onthecontrary,aprogramrunningonMiniGUI-Liteisanindependentprocess,whichcanalsocreatemultiplewindows.Theformerisfitforsomereal-timesystemswithsimplefunctionality,andthelatterisfitforsomecomplexembeddedsystems,suchasPDAs,Thin-ClientsorSTBs.Currently,thelateststableversionofMiniGUIisversion1.3.1.Youcandownloadthesourcefrom://(C)2003,BeijingFeynmanSoftwareTechnologyCo.,Ltd.Allrightsreserved.Youcannotdistributeorcopythewholeoranypartofthisdocumentationinanyforms,includingpublication,electronicpapers,orwebpages.MiniGUIAPIReferenceManualiiiContentsModuleIndex..............................................................................................................................................viiiDataStructureIndex......................................................................................................................................xiFileIndex.....................................................................................................................................................xiiiPageIndex...................................................................................................................................................xiiiModuleDocumentation..................................................................................................................................1Macrosanddatatypescommonlyused..................................................................................................1Versioninformation...............................................................................................................................1Basicdatatypes......................................................................................................................................2Endiannessinformation..........................................................................................................................4Simpleandcommontypesandmacros..................................................................................................5MiniGUIhandles....................................................................................................................................6Win32-likedatatypesandmacros.........................................................................................................8DatatypesforGDI...............................................................................................................................15Macrosforkeycodesandshiftstatus..................................................................................................18Errorcodes...........................................................................................................................................25Miscellaneousmacros..........................................................................................................................25Functions..............................................................................................................................................26Global/generalfunctions......................................................................................................................27Miscellaneousfunctions.......................................................................................................................27Standardcontrols..........................................................................................