Status & Roadmap
Authors & License
Funding Ultimate++
Search on this site
Search in forums

SourceForge.net Logo
Home » U++ Library support » U++ Library : Other (not classified elsewhere) » Missing Docs for some virtual Ctrl:: functions
Missing Docs for some virtual Ctrl:: functions [message #37595] Tue, 23 October 2012 11:35
kohait00 is currently offline  kohait00
Messages: 936
Registered: July 2009
Location: Germany
Experienced Contributor
hi all..

here is an excerpt of Ctrl:: functions that need any doc comment. some are very selfexplanatory but some, like Update() or PostInput() aren't. extenders will apreciate that grain of info..

	virtual void   PostInput();
	virtual void   ChildFrameMouseEvent(Ctrl *child, int event, Point p, int zdelta, dword keyflags);
	virtual Size   GetMaxSize() const;
	virtual void   Updated();
	virtual String GetDesc() const;

	Callback       WhenAction;
	bool             IsForeground() const;
	void        RefreshLayoutDeep()                      { SyncLayout(2); }
	void        UpdateLayout()                           { SyncLayout(); }
	void        UpdateParentLayout()                     { if(parent) parent->UpdateLayout(); }
	Rect        GetWorkArea() const;
	bool    IsIgnoreMouse() const                        { return ignoremouse; }
	Point   GetMouseViewPos() const;


i'd add some but don't understand some of them myself.
Can anyone shed some info on it?


Update(): Should be called whenever internal state of a Ctrl was changed, will invoke SetModified() and Updated(), so derive classes can adjust their additional state / computation info to it.

Updated(): see Update(). override it to add custom behaviour on internal state change of underlying base class (Ctrl or derived) before calling base class Updated(). Can serve to write back to data bases or update any back end representation..

is that true? how is the proper use case for that one, and what about PostInput() and GetMaxSize()?

cheers and thanks


BTW: why not make Ctrl::Action() virtual as well? that would enable us to easy extend action function without connecting to WhenAction callback, which would remain reserved for the user space??

[Updated on: Wed, 24 October 2012 08:15]

Report message to a moderator

Read Message
Previous Topic: umk got changed....
Next Topic: [FIXED] Full screen bug on additional screens. (GNU/Linux)
Goto Forum:

Current Time: Tue Apr 07 19:11:27 CEST 2020

Total time taken to generate the page: 0.00840 seconds