Overview
Examples
Screenshots
Comparisons
Applications
Download
Documentation
Tutorials
Bazaar
Status & Roadmap
FAQ
Authors & License
Forums
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: 939
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?

i.e.

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

EDIT:

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

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


Current Time: Thu Mar 28 17:27:40 CET 2024

Total time taken to generate the page: 0.01898 seconds