[flexcoders] Re: AsDoc and libraries problem
Hi again ! I am going on my investigations, and found out another partial solution : ASDOC only generated documentation for public methods... As my MXML classes declare most of the time private methods, nothing appears in the documentation. Is there a way to force ASDOC documenting private methods as well ? Last question, but not least : how do I include the general description of my MXML classes in the documentation ? Thanks for your help Ben --- In flexcoders@yahoogroups.com, Benoit Thiebault [EMAIL PROTECTED] wrote: Hi again ! I finally found how to (partially) solve my problem ! In ASDocAntTask, there are two files the user has to fill in : the build.xml file and a properties file. In the properties file, you define, for example, the name that you want to appear in the browser window... And as my project is French, I used a French special character é... which messed everything up... So finally, I got rid of this problem... But don't leave now : I have another one for you : I have now a great documentation, but nothing about mxml files ! The class is in the list of files, but ASDOC somehow misses all my ASDOC comments in the mx:Script tag... How can I solve this problem ? --- In flexcoders@yahoogroups.com, Benoit Thiebault neopium@ wrote: Hi everyone, I'm also trying to use ASDOC and encounters problems as well. I'm not using command line, but Eric Feminella's ASDocAntTask http://www.ericfeminella.com/blog/2007/06/07/asdocanttask-project-for-e\ clipse/ . I have a strange error message : Impossible to open the document, Invalid byte 2 of 3-byte UTF-8 sequence. It happens for a whole bunch of files in the asdoc/templates directory, including the asdoc-util.xsl file. Do you have any idea what to do in that case ? Thanks Ben --- In flexcoders@yahoogroups.com, Christophe Herreman lists@ wrote: have you tried using -doc-sources path/to/project instead of -source-path? AFAIK you don't need to specify the libs you're using then. regards, Christophe --- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org 2007/12/7, Rico Leuthold rleuthold@: I already have the swc in the source-path. I'm running asdoc from the root of the project folder like this: asdoc -source-path . -doc-sources. thanks_rico On 06.12.2007, at 16:14, Muzak wrote: Add the location of the flexlib swc to the -source-path parameter list asdoc -source-path path/to/project path/to/flexlib ... - Original Message - From: rleuthold rleuthold@ rleuthold%40access.ch To: flexcoders@yahoogroups.com flexcoders%40yahoogroups.com Sent: Thursday, December 06, 2007 12:02 PM Subject: [flexcoders] AsDoc and libraries problem Hi, I want to run asdoc (from command line) for my project, but always getting an error cause of the flexlib components I'm using (Error: Could not resolve flexlib:SuperTabNavigator to a component implementation). Does somebody have an idea how to exclude the flexlib components when running asdoc ? thanx_rico -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%http://www.mail-archive.com/flex\ coders%25 40yahoogroups.com Yahoo! Groups Links ... Rico Leuthold rleuthold@ rleuthold%40access.ch +41(0)76 512 05 50 ... -- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org
[flexcoders] Re: AsDoc and libraries problem
Hi, I finally have an answer to my problems : - ASDOC for Flex 2 doesn't support documenting private elements. A feature request has been transmitted to Adobe about this and may be implemented in Flex 3 - ASDOC for Flex 2 doesn't support class level comments in MXML files Too bad... --- In flexcoders@yahoogroups.com, Benoit Thiebault [EMAIL PROTECTED] wrote: Hi again ! I am going on my investigations, and found out another partial solution : ASDOC only generated documentation for public methods... As my MXML classes declare most of the time private methods, nothing appears in the documentation. Is there a way to force ASDOC documenting private methods as well ? Last question, but not least : how do I include the general description of my MXML classes in the documentation ? Thanks for your help Ben --- In flexcoders@yahoogroups.com, Benoit Thiebault neopium@ wrote: Hi again ! I finally found how to (partially) solve my problem ! In ASDocAntTask, there are two files the user has to fill in : the build.xml file and a properties file. In the properties file, you define, for example, the name that you want to appear in the browser window... And as my project is French, I used a French special character é... which messed everything up... So finally, I got rid of this problem... But don't leave now : I have another one for you : I have now a great documentation, but nothing about mxml files ! The class is in the list of files, but ASDOC somehow misses all my ASDOC comments in the mx:Script tag... How can I solve this problem ? --- In flexcoders@yahoogroups.com, Benoit Thiebault neopium@ wrote: Hi everyone, I'm also trying to use ASDOC and encounters problems as well. I'm not using command line, but Eric Feminella's ASDocAntTask http://www.ericfeminella.com/blog/2007/06/07/asdocanttask-project-for-e\ clipse/ . I have a strange error message : Impossible to open the document, Invalid byte 2 of 3-byte UTF-8 sequence. It happens for a whole bunch of files in the asdoc/templates directory, including the asdoc-util.xsl file. Do you have any idea what to do in that case ? Thanks Ben --- In flexcoders@yahoogroups.com, Christophe Herreman lists@ wrote: have you tried using -doc-sources path/to/project instead of -source-path? AFAIK you don't need to specify the libs you're using then. regards, Christophe --- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org 2007/12/7, Rico Leuthold rleuthold@: I already have the swc in the source-path. I'm running asdoc from the root of the project folder like this: asdoc -source-path . -doc-sources. thanks_rico On 06.12.2007, at 16:14, Muzak wrote: Add the location of the flexlib swc to the -source-path parameter list asdoc -source-path path/to/project path/to/flexlib ... - Original Message - From: rleuthold rleuthold@ rleuthold%40access.ch To: flexcoders@yahoogroups.com flexcoders%40yahoogroups.com Sent: Thursday, December 06, 2007 12:02 PM Subject: [flexcoders] AsDoc and libraries problem Hi, I want to run asdoc (from command line) for my project, but always getting an error cause of the flexlib components I'm using (Error: Could not resolve flexlib:SuperTabNavigator to a component implementation). Does somebody have an idea how to exclude the flexlib components when running asdoc ? thanx_rico -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%http://www.mail-archive.com/flex\ coders%25 40yahoogroups.com Yahoo! Groups Links ... Rico Leuthold rleuthold@ rleuthold%40access.ch +41(0)76 512 05 50 ... -- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org
[flexcoders] Re: AsDoc and libraries problem
Hi again ! I finally found how to (partially) solve my problem ! In ASDocAntTask, there are two files the user has to fill in : the build.xml file and a properties file. In the properties file, you define, for example, the name that you want to appear in the browser window... And as my project is French, I used a French special character é... which messed everything up... So finally, I got rid of this problem... But don't leave now : I have another one for you : I have now a great documentation, but nothing about mxml files ! The class is in the list of files, but ASDOC somehow misses all my ASDOC comments in the mx:Script tag... How can I solve this problem ? --- In flexcoders@yahoogroups.com, Benoit Thiebault [EMAIL PROTECTED] wrote: Hi everyone, I'm also trying to use ASDOC and encounters problems as well. I'm not using command line, but Eric Feminella's ASDocAntTask http://www.ericfeminella.com/blog/2007/06/07/asdocanttask-project-for-e\ clipse/ . I have a strange error message : Impossible to open the document, Invalid byte 2 of 3-byte UTF-8 sequence. It happens for a whole bunch of files in the asdoc/templates directory, including the asdoc-util.xsl file. Do you have any idea what to do in that case ? Thanks Ben --- In flexcoders@yahoogroups.com, Christophe Herreman lists@ wrote: have you tried using -doc-sources path/to/project instead of -source-path? AFAIK you don't need to specify the libs you're using then. regards, Christophe --- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org 2007/12/7, Rico Leuthold rleuthold@: I already have the swc in the source-path. I'm running asdoc from the root of the project folder like this: asdoc -source-path . -doc-sources. thanks_rico On 06.12.2007, at 16:14, Muzak wrote: Add the location of the flexlib swc to the -source-path parameter list asdoc -source-path path/to/project path/to/flexlib ... - Original Message - From: rleuthold rleuthold@ rleuthold%40access.ch To: flexcoders@yahoogroups.com flexcoders%40yahoogroups.com Sent: Thursday, December 06, 2007 12:02 PM Subject: [flexcoders] AsDoc and libraries problem Hi, I want to run asdoc (from command line) for my project, but always getting an error cause of the flexlib components I'm using (Error: Could not resolve flexlib:SuperTabNavigator to a component implementation). Does somebody have an idea how to exclude the flexlib components when running asdoc ? thanx_rico -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%http://www.mail-archive.com/flex\ coders%25 40yahoogroups.com Yahoo! Groups Links ... Rico Leuthold rleuthold@ rleuthold%40access.ch +41(0)76 512 05 50 ... -- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org
[flexcoders] Re: AsDoc and libraries problem
Hi everyone, I'm also trying to use ASDOC and encounters problems as well. I'm not using command line, but Eric Feminella's ASDocAntTask http://www.ericfeminella.com/blog/2007/06/07/asdocanttask-project-for-e\ clipse/ . I have a strange error message : Impossible to open the document, Invalid byte 2 of 3-byte UTF-8 sequence. It happens for a whole bunch of files in the asdoc/templates directory, including the asdoc-util.xsl file. Do you have any idea what to do in that case ? Thanks Ben --- In flexcoders@yahoogroups.com, Christophe Herreman [EMAIL PROTECTED] wrote: have you tried using -doc-sources path/to/project instead of -source-path? AFAIK you don't need to specify the libs you're using then. regards, Christophe --- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org 2007/12/7, Rico Leuthold [EMAIL PROTECTED]: I already have the swc in the source-path. I'm running asdoc from the root of the project folder like this: asdoc -source-path . -doc-sources. thanks_rico On 06.12.2007, at 16:14, Muzak wrote: Add the location of the flexlib swc to the -source-path parameter list asdoc -source-path path/to/project path/to/flexlib ... - Original Message - From: rleuthold [EMAIL PROTECTED] rleuthold%40access.ch To: flexcoders@yahoogroups.com flexcoders%40yahoogroups.com Sent: Thursday, December 06, 2007 12:02 PM Subject: [flexcoders] AsDoc and libraries problem Hi, I want to run asdoc (from command line) for my project, but always getting an error cause of the flexlib components I'm using (Error: Could not resolve flexlib:SuperTabNavigator to a component implementation). Does somebody have an idea how to exclude the flexlib components when running asdoc ? thanx_rico -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%http://www.mail-archive.com/flex\ coders%25 40yahoogroups.com Yahoo! Groups Links ... Rico Leuthold [EMAIL PROTECTED] rleuthold%40access.ch +41(0)76 512 05 50 ... -- Christophe Herreman http://www.herrodius.com http://www.pranaframework.org
Re : [flexcoders] Re: Problem extending TabNavigator class
I followed your advice and managed to position my button.
First of all, I extended the tabBar class instead of the tabNavigator class. I
added (via a rawChildren.addChild() method) my button to the tabBar and overrid
the updateDisplayList() method to place the button.
The position of the button is relative to its parent (the TabBar). The trick is
that the TabBar width is null when you call the createChildren() method, so you
can't set the position of the button in this method (which is what I did in the
first place). But the parent width is not null anymore when the
updateDisplayList() method is called.
I just have one problem left : my TabNavigator is placed in a Panel, contained
in an HDividedBox. The positionning of the button is perfect at loading, but
when I resize the HDividedBox, the positionning is not updated... Is there
another method I forgot to override ?
- Message d'origine
De : Benoit Thiebault [EMAIL PROTECTED]
À : flexcoders@yahoogroups.com
Envoyé le : Vendredi, 24 Août 2007, 17h57mn 54s
Objet : [flexcoders] Re: Problem extending TabNavigator class
Hi Ben, and thank you for your answer :-)
You can see what I want to do on this picture
http://picasaweb. google.fr/ benoit.thiebault /AlbumSansTitre/ photo#5102289531
346166354
The button I want to add should not act like it's part of the existing
tabBar.
When the user clicks the button, it hides/shows the content of my
tabNavigator. In fact, it just toggles the height of the component to
make it appear or disappear (in that case, you can only see the
tabBar, not the viewstack underneath).
I tried to create just the button (without anything else than the
button: no HBox, no spacer, no tabs), but it didn't display anything...
--- In [EMAIL PROTECTED] ups.com, ben.clinkinbeard
ben.clinkinbeard@ ... wrote:
Do you need your button to act like its part of the existing tabBar in
that it would deselect any active tab and vice versa? If not (and
maybe even if you do with a workaround) you can avoid creating the
HBox and Spacer and just create a button. super.createChildre n() is
also usually the first line of your overridden function unless there
is a specific reason not to do it that way.
I would also do your positioning in an overridden updateDisplayList as
that is the proper place for positioning child components. I guess
that may fall apart if you really need all the tabs to belong to a
single tabBar, but I'm not sure. Sorry, these are all kind of just
guesses as I've not worked with TabBar or Spacer at all. Is it
possible your button is there but being pushed off of the screen?
HTH,
Ben
--- In [EMAIL PROTECTED] ups.com, Benoit Thiebault neopium@ wrote:
Hi everyone ! [:)]
I need to extend the TabNavigator class in order to display a tab bar
containing :
- tabs on the left (as usual)
- a button the user can click on the right
Of course, my button should stay on the right of the tab bar whatever
the size of the TabBarNavigator
I didn't want to start from scratch, so I had a look at FlexLib
and its
great SuperTabNavigator. However, my tabNavigator is much more simpler
than the SuperTabNavigator and I just wanted to extend one class :
TabNavigator. I tried this :
package extensions
{
import mx.containers. TabNavigator;
import mx.controls. TabBar;
import mx.controls. tabBarClasses. Tab;
import mx.core.mx_internal ;
import mx.core.IFlexDispla yObject;
import flash.display. DisplayObject;
import mx.controls. Button;
import mx.containers. HBox;
import mx.containers. Canvas;
import mx.controls. Spacer;
use namespace mx_internal;
public class extended_TabNavigat or extends TabNavigator
{
protected var holder:HBox;
protected var spacer:Spacer;
protected var myButton:Button;
public function extended_TabNavigat or()
{
super();
}
override protected function createChildren( ):void{
// Tab bar creation
tabBar = new TabBar();
super.createChildre n();
// Holder that will contain my tab bar, a spacer and the button
holder = new HBox();
// Adds the container to the TabNavigator
rawChildren. addChild( holder);
// Adds the TabBar to the holder container
holder.addChild( tabBar);
// Spacer that will fill the space between the tabs and the button
spacer = new Spacer();
spacer.percentWidth = 100;
// Adds the spacer to the container
holder.addChild( spacer);
// My button
myButton = new Button();
myButton.label = Hello world !;
// Adds the button to the container
holder.addChild( myButton) ;
}
}
}
So I created an HBox containing:
- the tab bar
- a spacer filling all available space
- and my button
Unfortunately, it doesn't work... The TabNavigator has no tab bar nor
button
Re : Re : [flexcoders] Re: Problem extending TabNavigator class
Yes, the code is the following :
override protected function updateDisplayList(w:Number, h:Number):void{
super.updateDisplayList(w,h);
updateButtonPosition();
}
public function updateButtonPosition():void
{
myButton.move(parent.width-40, 0);
}
- Message d'origine
De : ben.clinkinbeard [EMAIL PROTECTED]
À : flexcoders@yahoogroups.com
Envoyé le : Lundi, 27 Août 2007, 15h29mn 28s
Objet : Re : [flexcoders] Re: Problem extending TabNavigator class
You should be setting its position every time updateDisplayList( )
is
called. Are you doing that?
Ben
--- In [EMAIL PROTECTED] ups.com, Benoit Thiebault [EMAIL PROTECTED] wrote:
I followed your advice and managed to position my button.
First of all, I extended the tabBar class instead of the
tabNavigator class. I added (via a rawChildren. addChild( ) method) my
button to the tabBar and overrid the updateDisplayList( ) method to
place the button.
The position of the button is relative to its parent (the TabBar).
The trick is that the TabBar width is null when you call the
createChildren( ) method, so you can't set the position of the button
in this method (which is what I did in the first place). But the
parent width is not null anymore when the updateDisplayList( ) method
is called.
I just have one problem left : my TabNavigator is placed in a Panel,
contained in an HDividedBox. The positionning of the button is perfect
at loading, but when I resize the HDividedBox, the positionning is not
updated... Is there another method I forgot to override ?
- Message d'origine
De : Benoit Thiebault [EMAIL PROTECTED]
À : [EMAIL PROTECTED] ups.com
Envoyé le : Vendredi, 24 Août 2007, 17h57mn 54s
Objet : [flexcoders] Re: Problem extending TabNavigator class
Hi Ben, and thank you for your answer :-)
You can see what I want to do on this picture
http://picasaweb. google.fr/ benoit.thiebault /AlbumSansTitre/
photo#5102289531 346166354
The button I want to add should not act like it's part of the existing
tabBar.
When the user clicks the button, it hides/shows the content of my
tabNavigator. In fact, it just toggles the height of the component to
make it appear or disappear (in that case, you can only see the
tabBar, not the viewstack underneath).
I tried to create just the button (without anything else than the
button: no HBox, no spacer, no tabs), but it didn't display anything...
--- In [EMAIL PROTECTED] ups.com, ben.clinkinbeard
ben.clinkinbeard@ ... wrote:
Do you need your button to act like its part of the existing tabBar in
that it would deselect any active tab and vice versa? If not (and
maybe even if you do with a workaround) you can avoid creating the
HBox and Spacer and just create a button. super.createChildre n() is
also usually the first line of your overridden function unless there
is a specific reason not to do it that way.
I would also do your positioning in an overridden updateDisplayList as
that is the proper place for positioning child components. I guess
that may fall apart if you really need all the tabs to belong to a
single tabBar, but I'm not sure. Sorry, these are all kind of just
guesses as I've not worked with TabBar or Spacer at all. Is it
possible your button is there but being pushed off of the screen?
HTH,
Ben
--- In [EMAIL PROTECTED] ups.com, Benoit Thiebault neopium@
wrote:
Hi everyone ! [:)]
I need to extend the TabNavigator class in order to display a
tab bar
containing :
- tabs on the left (as usual)
- a button the user can click on the right
Of course, my button should stay on the right of the tab bar
whatever
the size of the TabBarNavigator
I didn't want to start from scratch, so I had a look at FlexLib
and its
great SuperTabNavigator. However, my tabNavigator is much more
simpler
than the SuperTabNavigator and I just wanted to extend one class :
TabNavigator. I tried this :
package extensions
{
import mx.containers. TabNavigator;
import mx.controls. TabBar;
import mx.controls. tabBarClasses. Tab;
import mx.core.mx_internal ;
import mx.core.IFlexDispla yObject;
import flash.display. DisplayObject;
import mx.controls. Button;
import mx.containers. HBox;
import mx.containers. Canvas;
import mx.controls. Spacer;
use namespace mx_internal;
public class extended_TabNavigat or extends TabNavigator
{
protected var holder:HBox;
protected var spacer:Spacer
