Return to readme CVS log

Up to [WindowsNT SDKs] / q_a / samples / regions

Microsoft Windows NT Build 297 06-28-1992

 Sample: Using Region-Related API Functions

Summary:

The REGIONS sample demonstrates various region-related API
functions, and allows a user to create rectangular,
elliptic, and multi-polygon regions. In addition, hit-
testing a region and combining regions using the different
region-combination modes is demonstrated.

More Information:

When the program has started, create a region by choosing
one of the items in the Create submenu. At this point, items
in the Options submenu will be enabled, and hit-testing,
inversion, and other actions can be performed on the region.

When a second region is created, items in the Combine
submenu will be enabled. Choosing one of these items causes
CombineRgn to be called with the specified combine mode, and
the two regions are merged into one.

It is possible to create up to three regions at a time.
Items in the Options submenu always apply to the most
recently created (or combined) region. The Erase item
deletes all existing regions. Items in the Combine submenu
always apply to the two most recently created (or combined)
regions.

The following is a list of the Win32 API functions used in
this sample:

   BeginPaint         GetCapture     PtInRegion     
   CheckMenuItem      GetClientRect  Rectangle      
   CombineRgn         GetDC          RectInRegion   
   CreateEllipticRgn  GetMenu        RegisterClass  
   CreateEllipticRgn  GetMessage     ReleaseCaptur  
   Indirect                          e
   CreatePen          GetRgnBox      SelectObject   
   CreatePolygonRgn   GetStockObjec  SetCapture     
                      t
   CreatePolyPolygon  GetSubMenu     SetDlgItemTex  
   Rgn                               t
   CreateRectRgn      InvalidateRec  SetRectRgn     
                      t
   CreateSolidBrush   InvertRgn      SetROP2        
   CreateWindow       LoadCursor     ShowWindow     
   DeleteObject       LoadIcon       TranslateMess  
                                     age
   ReleaseDC          LocalAlloc     UpdateWindow   
   DialogBox          LocalFree      wsprintf       
   DispatchMessage    LocalHandle                   
   EnableMenuItem     MessageBeep                   
   EndDialog          MessageBox                    
   EndPaint           OffsetRgn                     
   FillRgn            PolyPolygon                   
   FrameRgn           PostQuitMessa                 
                      ge

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.