/* Copyright (C) 2015-2020, Dirk Krause SPDX-License-Identifier: BSD-3-Clause */ /* WARNING: This file was generated by the dkct program (see http://dktools.sourceforge.net/ for details). Changes you make here will be lost if dkct is run again! You should modify the original source and run dkct on it. Original source: Dk4WxControl.cpt */ #ifndef DK4WXCONTROL_H_INCLUDED /** Avoid multiple inclusions. */ #define DK4WXCONTROL_H_INCLUDED 1 #line 10 "Dk4WxControl.cpt" /** @file Dk4WxControl.h Triple-buffered control. */ #ifndef DK4CONF_H_INCLUDED #if DK4_BUILDING_DKTOOLS4 #include "dk4conf.h" #else #include #endif #endif #ifndef DK4TYPES_H_INCLUDED #if DK4_BUILDING_DKTOOLS4 #include "dk4types.h" #else #include #endif #endif #ifndef WX_WXPREC_H_INCLUDED #include #define WX_WXPREC_H_INCLUDED 1 #endif #ifdef __BORLANDC__ #pragma hdrstop #endif #ifndef WX_PRECOMP #ifndef WX_WX_H_INCLUDED #include #define WX_WX_H_INCLUDED 1 #endif #endif /** Base class for user-defined controls. Like double-buffering we write the windows contents to an image and finally transfer the entire image to the device context. Additionally we keep the image between the paint events and rebuild the image only if necessary (data to show has changed). When the frame containing your view becomes invisible (frame iconized or hidden) you should use the ReleaseBuffer() method to decrease the memory footprint of the program. In your derived class, call the Dk4WxControl constructors from the constructors. From Create() call Dk4WxControl::Create(). You should also use wxDECLARE_DYNAMIC_CLASS() and; wxIMPLEMENT_DYNAMIC_CLASS(). */ class Dk4WxControl : public wxControl { private: /** For RTTI. */ #if wxCHECK_VERSION(3,0,0) wxDECLARE_DYNAMIC_CLASS(Dk4WxControl); #else DECLARE_DYNAMIC_CLASS(Dk4WxControl) #endif /** Event table. */ #if wxCHECK_VERSION(3,0,0) wxDECLARE_EVENT_TABLE(); #else DECLARE_EVENT_TABLE() #endif protected: /** Class name. */ static const wxChar Dk4WxControlName[]; /** Protection against simultaneous access. */ wxCriticalSection csProtect; /** Bitmap to cache contents. */ wxBitmap *pBitmap; /** Bitmap width. */ int iBmWidth; /** Bitmap height. */ int iBmHeight; /** Flag: Must update contents. */ bool bUpdate; protected: /** Overwrite this method to do the real drawing. @param pdc Device context to draw to. @param event Paint event to draw for. @param buffered Flag: Operating on memory DC. @param clWidth Client area width. @param clHeight Client area height. */ virtual void PaintOperation( wxDC & pdc, wxPaintEvent & event, bool buffered, int clWidth, int clHeight ); /** Internal paint operation. @param pdc Device context to draw to. @param event Paint event to draw for. @param buffered Flag: Operating on memory DC. @param clWidth Client area width. @param clHeight Client area height. */ void InternalPaint( wxDC & pdc, wxPaintEvent & event, bool buffered, int clWidth, int clHeight ); public: /** Default constructor. */ Dk4WxControl(); /** Useful constructor. @param parent Parent window. @param wid Window ID. @param pos Position. @param size Size. @param style Style. @param validator Validator. @param name Type name. */ Dk4WxControl( wxWindow *parent, wxWindowID wid = wxID_ANY, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0L, const wxValidator & validator = wxDefaultValidator, const wxChar *name = Dk4WxControlName ); /** Create window after using default constructor. @param parent Parent window. @param wid Window ID. @param pos Position. @param size Size. @param style Style. @param validator Validator. @param name Type name. */ bool Create( wxWindow *parent, wxWindowID wid = wxID_ANY, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0L, const wxValidator & validator = wxDefaultValidator, const wxChar *name = Dk4WxControlName ); /** Destructor. */ ~Dk4WxControl(); /** Mark update necessarity. */ void SetUpdate(bool flag = true); /** Handler for erase background event. @param event Event to process. */ void OnErase(wxEraseEvent & event); /** Handler for paint event. @param event Event to process. */ void OnPaint(wxPaintEvent & event); /** Release buffer when frame is iconized or hidden. */ void ReleaseBuffer(void); }; #endif