Difference between revisions of "How to use smart docking"
Line 4: | Line 4: | ||
https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/examples/docking | https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/examples/docking | ||
− | If you have checked out SVN codes, it's in your SVN_ROOT/examples/docking folder. | + | If you have checked out SVN codes, it's in your SVN_ROOT/examples/docking folder. It should looks like figure 1. |
[[Image:How_to_use_smart_docking_figure_1.png]] | [[Image:How_to_use_smart_docking_figure_1.png]] | ||
Line 32: | Line 32: | ||
content.set_long_title ("A long title") | content.set_long_title ("A long title") | ||
manager.contents.extend (content) | manager.contents.extend (content) | ||
− | -- You should call the following feature | + | -- You should call the following feature to make the content visible. |
content.set_top ({SD_ENUMERATION}.top) | content.set_top ({SD_ENUMERATION}.top) | ||
</Eiffel> | </Eiffel> | ||
Line 41: | Line 41: | ||
*SD_ICONS_SINGLETON (deferred) | *SD_ICONS_SINGLETON (deferred) | ||
This is the class which provide docking library pixmaps for icons or dragging feedback. | This is the class which provide docking library pixmaps for icons or dragging feedback. | ||
− | By default, Smart Docking library provide embedded icons which can be used directly without any changes. But if you want to customize your icons, you should inherit this class | + | By default, Smart Docking library provide embedded icons which can be used directly without any changes. But if you want to customize your icons, you should inherit this class and implement several once features which provide EV_PIXMAPs |
like this: | like this: | ||
<Eiffel> | <Eiffel> | ||
Line 64: | Line 64: | ||
---- | ---- | ||
* SD_ENUMERATION | * SD_ENUMERATION | ||
− | This class only contain enumerations of Smart Docking library, such as | + | This class only contain enumerations of Smart Docking library, such as direction enumeration, SD_CONTENT type enumeration. |
− | For more | + | For more information about SD_ENUMERATION, see [[How to use smart docking sd enumeration]] |
Revision as of 04:07, 6 May 2009
- There is a simple docking project example, is in the SVN:
https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/examples/docking
If you have checked out SVN codes, it's in your SVN_ROOT/examples/docking folder. It should looks like figure 1.
As a client programmer you only need to care about four classes in the DOCKING LIBRARY cluster.
- SD_DOCKING_MANAGER
This is the class which controls the whole SMART DOCKING library. Use it like this:
manager: SD_DOCKING_MANAGER create manager.make (a_container, a_window)
SD_CONTENT
This is the class which has the information to be put in a docking component. Client programmer should use it like this:
content: SD_CONTENT create content.make (create {USER_CONTENT}, "A_unique_title") content.set_short_title ("A short title") content.set_long_title ("A long title") manager.contents.extend (content) -- You should call the following feature to make the content visible. content.set_top ({SD_ENUMERATION}.top)
For more information about SD_CONTENT, see How to use smart docking sd content
- SD_ICONS_SINGLETON (deferred)
This is the class which provide docking library pixmaps for icons or dragging feedback. By default, Smart Docking library provide embedded icons which can be used directly without any changes. But if you want to customize your icons, you should inherit this class and implement several once features which provide EV_PIXMAPs like this:
arrow_indicator_up: EV_PIXMAP is once create Result.default_create Result.set_with_named_file (".\arrow.png") end arrow_indicator_left: EV_PIXMAP is once create Result.default_create Result.set_with_named_file (".\arrow_left.png") end arrow_indicator_center: EV_PIXMAP is once create Result.default_create Result.set_with_named_file (".\arrow_center.png") end ....
And you should call 'init' feature in SD_ICONS_SINGLETON, normally you can call it in the creation method of the SD_ICONS_SINGLETON implementation class.
- SD_ENUMERATION
This class only contain enumerations of Smart Docking library, such as direction enumeration, SD_CONTENT type enumeration.
For more information about SD_ENUMERATION, see How to use smart docking sd enumeration