ASDoc tags 文档注释标签详解
转至Adobe:http://livedocs.adobe.com/flex/3/html/index.html?content=asdoc_9.html
ASDoc tag | Description | Example |
---|---|---|
@copy reference | Copies an ASDoc comment from the referenced location. The main description, @param, and @return content is copied; other tags are not copied. You typically use the @copy tag to copy information from a source class or interface not in the inheritance list of the destination class. If the source class or interface is in the inheritance list, use the @inheritDoc tag instead. You can add content to the ASDoc comment before the @copy tag. Specify the location by using the same syntax as you do for the @see tag. For more information, see Using the @see tag. | @copy #stop @copy MovieClip#stop |
@default value | Specifies the default value for a property, style, or effect. The ASDoc tool automatically creates a sentence in the following form when it encounters an @default tag: The default value is value. | @default 0xCCCCCC |
@eventType package.class.CONSTANT @eventType String | Use the first form in a comment for an [Event] metadata tag. It specifies the constant that defines the value of the Event.type property of the event object associated with the event. The ASDoc tool copies the description of the event constant to the referencing class. Use the second form in the comment for the constant definition. It specifies the name of the event associated with the constant. If the tag is omitted, ASDoc cannot copy the constant's comment to a referencing class. | See Documenting effects, events, and styles |
@example exampleText | Applies style properties, generates a heading, and puts the code example in the correct location. Enclose the code in <listing version="3.0"></listing> tags. Whitespace formatting is preserved and the code is displayed in a gray, horizontally scrolling box. | @example The following code sets the volume level for your sound: <listing version="3.0"> var mySound:Sound = new Sound(); mySound.setVolume(VOL_HIGH); </listing> |
@exampleText string | Use this tag in an ASDoc comment in an external example file that is referenced by the @example tag. The ASDoc comment must precede the first line of the example, or follow the last line of the example. External example files support one comment before and one comment after example code. | /** * This text does not appear * in the output. * @exampleText But this does. */ |
@inheritDoc | Use this tag in the comment of an overridden method or property. It copies the comment from the superclass into the subclass, or from an interface implemented by the subclass. The main ASDoc comment, @param, and @return content are copied; other tags are not. You can add content to the comment before the @inheritDoc tag. When you include this tag, ASdoc uses the following search order: 1. Interfaces implemented by the current class (in no particular order) and all of their base-interfaces. 2. Immediate superclass of current class. 3. Interfaces of immediate superclass and all of their base-interfaces. 4. Repeat steps 2 and 3 until the Object class is reached. You can also use the @copy tag, but the @copy tag is for copying information from a source class or interface that is not in the inheritance chain of the subclass. | @inheritDoc |
@internal text | Hides the text attached to the tag in the generated output. The hidden text can be used for internal comments. | @internal Please do not publicize the undocumented use of the third parameter in this method. |
@param paramName description | Adds a descriptive comment to a method parameter. The paramName argument must match a parameter definition in the method signature. | @param fileName The name of the file to load. |
@private | Exclude the element from the generated output. To omit an entire class, put the @private tag in the ASDoc comment for the class; to omit a single class element, put the @private tag in the ASDoc comment for the element. | @private |
@return description | Adds a Returns section to a method description with the specified text. ASDoc automatically determines the data type of the return value. | @return The translated message. |
@see reference [displayText] | Adds a See Also heading with a link to a class element. For more information, see Using the @see tag. Do not include HTML formatting characters in the arguments to the @see tag. | @see flash.display.MovieClip |
@throws package.class.className description | Documents an error that a method can throw. | @throws SecurityError Local untrusted SWFs may not communicate with the Internet. |