BCX_FRAMEWND function

Purpose: BCX_FRAMEWND creates a MDI Frame Window along with an MDICLIENT Window. BCX_FRAMEWND returns the handle to the frame window and stores the MDICLIENT window handle in BCX_hwndMDIClient. The menu for the BCX_FRAMEWND must be loaded to an hMenu handle and included in the function parameters.


 Syntax: 

  hWnd = BCX_FRAMEWND(ClassName$, _
                    ProcedureName, _
                         Caption$  _
                         [, hmenu] _
                      [, hmenuPos] _                         
                         [, Xpos%] _
                         [, Ypos%] _
                        [, Width%] _ 
                       [, Height%] _ 
                     [, WinStyle%] _
                  [, ExWinStyle%]) _

 Parameters:

  • "ClassName" A unique string literal name for the program. Every Windows MDIGUI program requires a ClassName. Windows uses the ClassName to distinguish one running program from another.
  • ProcedureName specifies a WNDPROC name for this instance of a windows procedure. This name is used both for the WNDPROC structure of the window and for the BEGIN MDIEVENTS loop.
  • Caption$ [OPTIONAL] to be placed as title on the window.
  • hmenu [OPTIONAL] specifies the handle(HMENU) of the menu containing the item that activates the the MDICLIENT window. The default value of hMenu is NULL. if the window uses the class menu.
  • hmenuPos% [OPTIONAL] specifies the zero-based ordinal position in the menu of the item that activates the the MDICLIENT window. The default value of hMenuPos is 0.
  • Xpos% [OPTIONAL] specifies, in screen coordinates, the initial horizontal x-coordinate of the upper-left corner of the window being created. The default argument for this parameter is CW_USEDEFAULT. See the CreateWindowEx Function x parameter description in your Win32 SDK or PSDK Reference help for more information.
  • Ypos% [OPTIONAL] specifies, in screen coordinates, the initial vertical y-coordinate of the upper-left corner of the window being created. The default argument for this parameter is CW_USEDEFAULT. See the CreateWindowEx Function y parameter description in your Win32 SDK or PSDK Reference help for more information.
  • Width% [OPTIONAL] specifies, in PIXELS, the width of the window being created. The default argument for this parameter is CW_USEDEFAULT. See the CreateWindowEx Function nWidth parameter description in your Win32 SDK or PSDK Reference help for more information.
  • Height% [OPTIONAL] specifies, in PIXELS, the height of the window being created. The default argument for this parameter is CW_USEDEFAULT. See the CreateWindowEx Function nHeight parameter description in your Win32 SDK or PSDK Reference help for more information.
  • WinStyle% [OPTIONAL] If the WinStyle% parameter is used, the default Window Style for a BCX_FRAMEWND control, 0, is replaced with the value in WinStyle%. See the CreateWindowEx Function dwStyle parameter description in your Win32 SDK or PSDK Reference help for more information about valid Window Styles.
  • ExWinStyle% [OPTIONAL] The default Extended Window Style for a BCX_FRAMEWND is 0. See the CreateWindowEx Function dwExStyle parameter description in your Win32 SDK or PSDK Reference help for more information about valid Extended Window Styles.

 Return Value:

  • hWnd, the return value, is a handle to a new window if the function succeeds. If the function fails, the return value is NULL.