.\" This is a wxWidgets manpage page generated from the XML docs
.TH wxPanel 3wx 2005-02-15 "wxWidgets" "wxWidgets class documentation"
.SH NAME
wxPanel \- 
  A window whose colour changes according to current user settings
 
.SH DESCRIPTION

  


   A panel is a window on which controls are placed. It is usually placed within
   a frame. It contains minimal extra functionality over and above its parent
   class wxWindow; its main purpose is to be similar in appearance and
   functionality to a dialog, but with the flexibility of having any window as a
   parent.
  
  


   
    Note:
   
   if not all characters are being intercepted by your OnKeyDown or OnChar
   handler, it may be because you are using the wxTAB_TRAVERSAL style, which
   grabs some keypresses for use by child controls.
  
 
.SH REMARKS

  
   By default, a panel has the same colouring as a dialog.
  
 
.SH "PARENTS"

  wxWindow
   
  wxEvtHandler
   
  wxObject
 
.SH "INCLUDE FILES"
wx/panel.h
.SH MEMBERS

  
.SS  wxPanel ()

     


      Default constructor.
     
    
.SS  wxPanel (wxWindow* parentwxWindowID id = -1const wxPoint& pos = wxDefaultPositionconst wxSize& size = wxDefaultSizelong style = wxTAB_TRAVERSALconst wxString& name = ``panel")

     


      Constructor.
     
    
   
  
.SS  ~wxPanel ()

     


      Destructor. Deletes any child windows before deleting the physical window.
     
    
   
  
.SS bool Create (wxWindow* parentwxWindowID idconst wxPoint& pos = wxDefaultPositionconst wxSize& size = wxDefaultSizelong style = wxTAB_TRAVERSALconst wxString& name = ``panel")

     


      Used for two-step panel construction. See
      wxPanel::wxPanel
      for details.
     
    
   
  
.SS wxWindow* GetDefaultItem ()

     


      Returns a pointer to the button which is the default for this window, or
      NULL. The default button is the one activated by pressing the Enter key.
     
    
   
  
.SS void InitDialog ()

     


      Sends a
      wxInitDialogEvent
      , which in turn transfers data to the dialog via validators.
     
    
   
  
.SS void OnSysColourChanged (wxSysColourChangedEvent& event)

     


      The default handler for wxEVT_SYS_COLOUR_CHANGED.
     
    
   
  
.SS void SetDefaultItem (wxButton *btn)

     


      Changes the default button for the panel.
     
    
   
  
.SS virtual void SetFocus ()

     


      Overrides
      wxWindow::SetFocus
      . This method uses the (undocumented) mix-in class wxControlContainer
      which manages the focus and TAB logic for controls which usually have
      child controls. In practice, if you call this method and the control has
      at least one child window, the focus will be given to the child window.
     
    
   
  
.SS virtual void SetFocusIgnoringChildren ()

     


      In contrast to
      wxPanel::SetFocus
      (see above) this will set the focus to the panel even of there are child
      windows in the panel. This is only rarely needed.
     
    
 
.SH "WINDOW STYLES"

.SH "SEE ALSO"

  wxWindow
   
  wxEvtHandler
   
  wxObject
 
  wxDialog
 
.SH "AUTHORS"
Documentation content by Julian Smart, Robert Roebling, Vadim Zeitlin, Robin Dunn, et al

Conversion to manpage format by Arnout Engelen (http://bzzt.net), bugreports welcome.