OS4Depot.net 20130227_1013
  Home Search Mirrors Contact Info Credits

 Readme data for Root » Development » Example » dropicondock.lha

Description: Test program to show how to use AmiDock into a MUI
Install: dropicondock.lha
Size: 55kb 5
Version: 1
Date: 26 Jun 09
Author: Gianfranco "ShInKurO" Gignina
Submitter: Gianfranco "ShInKurO" Gignina
Homepage: http://shinkuro.amiga.it
Requirements: ppc-amigaos >= 4.0.0;
Category: development/example
License: Other
Distribute: yes
Min OS Version: 4.0
DropIconDock is a simple MUI test program which uses a subclass of
MUIC_Application to interact with application.library and so AmiDock. 
This class is called appDockClass and it's implemented into appDockClass.c 
and appDocClass.h sources files which you find into this archive.

The appDockClass.c and appDockClass.h files contain what you have to use
to give your program AmiDock support on OS4.x, a basic documentation about
several attributes of this subclass is into appDockClass.h header.

To have AmiDock support into your MUI program you have to include these
two files and then open/close properly the application.library and 
layers.library and of course the include files of these libraries 
like I show you into main.c and sys.h files.

Instead to use an istance of MUIC_Application into your program, you
have to use an istance of appDockClass (obviously after you have 
created a mui custom class using function declared into appDockClass.h, 
see main.c file).

If you will set to FALSE MUIA_AppDock_NoIcon and will pass a valid value
to MUIA_Application_DiskObject, appDockClass will use the icon value of
that attribute as icon for AmiDock.
Obviously you can have a different icon from MUIA_Application_DiskObject, 
seting MUIA_AppDock_DockIcon attribute instead, in this way
appDockClass will distinguish these two icons. You can use 
MUIA_AppDock_DockIcon to change icon on AmiDock whatever you want.

You can use several application.library/AmiDock features like
MUIA_AppDock_DockIcon simply setting attributes of appDockClass, you read 
appDockClass.h to know what attributes you could use.

A nice feature appDockClass will give to your program is to
iconify/uniconify it from AmiDock with only a doubleclick on its 
docky icon, just try :-) The behaviour is similar to other modern platforms 
and finally your user will have a more ordered Workbench with a doubleclick 
on AmiDock (if only all programs would use this class ;D). 
This feature uses a special layers.library function which was introduced
with AmigaOS3.9 and I have no seen to use by nobody yet... sad! :)

Test program itself only shows a window in which you can drop icon and
than that icon will become the new one visualized on AmiDock, and you can
iconify/uniconify test program with a click on its amidock docky. 

This class is not perfect and miss some of application.library fetures
like blanker managment (I don't use it, so...), even if it would be simple to
insert even this support.

This class is Public Domain, even if I appreace if you send me enanchement to 
this class.




Copyright (c) 2004-2013 Björn Hagström. All rights reserved.
OS4 and its logos are registered trademarks of Hyperion Entertainment