精华内容
下载资源
问答
  • 下列标记中用于定义HTML文档所要显示内容的是( )。 答案:<body></body>
    千次阅读
    2021-06-11 04:36:44

    相关问题

    SPSS Statistics 的主要功能( ): SPSS Statistics 功能 p 以上 /p

    防范人质绑架的技巧包括(): 人质 技巧 睡觉 标记 斗智斗勇智

    接触化学危险品、剧毒以及致病微生物等的仪器设备和器皿,必须有明确醒目的标记。使用后及时清洁,特别是维修保养或移至到其他场地前,必须进行彻底的净化: 化学 危险品 剧毒 致病 微生物 仪器 设备 器皿 标记 后 维修 保养 场地 前 净化

    如果某菜单项的尾部有省略号标记,则表明( )。: 菜单项 尾部 省略号 标记 菜单 对话框

    HTML,文档,中,标记,文本,段落,中,浏览器,窗口,大小,

    标记,

    下面,标记,height,

    标记,选择,器,选择器,伪类,选择器,

    标记,中,之间,

    中,图像,标记,

    标记,快捷键,

    页面,标题,标记,tiltle,

    救灾,现场,伤员,颜色,标记,红色,

    网页,背景,图形,bg,以下,标记,中,

    标记,HTML,文档,开始,结束,HTML,结构,标记,HTML,/HTML,

    工薪,记录,中,有关,核准,标记,工薪,账项,内控,目标,控制,测试,程序,

    中国大学,MOOC,品牌,产品,生产者,服务,销售者,名称,术语,标记,符号,组合,

    智慧,职教,螺栓,长度,标记,螺栓,

    文恩,图,中,标记,命题,星号,

    林琳,时,学习,内容,要点,划线,方式,书上,标记,学习,策略,复述,策略,

    全称,基因组,分子,标记,设计,育种,技术,

    DNA,保留,方式,标记,双链,分子,放射,标记物,溶液,中,复制,分子,放射,活性,分子,放射性,

    文本,标记,语言,Web,编程,基础,网,超文本,基础,上,

    中,荧光,标记,方法,荧光,染料,标记,引物,

    HTML,中,网页,文字,段落,标记,标记,

    水平,线,标记,标记,错,

    网页,中,dt,标记,dd,标记,标记,列表,列表,定义,列表,中,错,

    超链接,标记,打开,目标,窗口,属性,

    标记,属性,

    标记,后,标记,方向,

    更多相关内容
  • java文档注释规范:javadoc标签(二)

    千次阅读 2018-09-23 18:14:32
    javadoc标签必须从一行的开头(在任何前导空格和可选的星号之后)开始,否则将被视为普通文本。 按照惯例,具有相同名称的标签被组合在一起(标签大小写敏感)。 例如,将所有@see标记放在一起。标签可以分为: 块...

    javadoc标签必须从一行的开头(在任何前导空格和可选的星号之后)开始,否则将被视为普通文本。 按照惯例,具有相同名称的标签被组合在一起(标签大小写敏感)。 例如,将所有@see标记放在一起。标签可以分为:

    • 块标签:只能放在主要描述部分后面的标签部分。 块标签的格式为:@tag。
    • 内联标记:可以放在主要描述中的任何位置或块标签的注释中。 内联标记用花括号标记:{@ tag}。

    现有的javadoc标签(截至jdk1.5):

    TagIntroduced in JDK/SDK
    @author1.0
    {@code}1.5
    {@docRoot}1.3
    @deprecated1.0
    @exception1.0
    {@inheritDoc}1.4
    {@link}1.2
    {@linkplain}1.4
    {@literal}1.5
    @param1.0
    @return1.0
    @see1.0
    @serial1.2
    @serialData1.2
    @serialField1.2
    @since1.1
    @throws1.2
    {@value}1.4
    @version1.0

    @author 名字(文本)
    当使用-author选项时,以指定的名字(文本)添加一个“Author”条目到生成的文档中。 文档注释可以包含多个@author标签。可以为每个@author标签指定一个名字,或为每个标签指定多个名字。 在前一种情况下,Javadoc工具在名字之间插入逗号(,)和空格。 在后一种情况下,只需将整个文本复制到生成的文档而不进行解析。 因此,如果想要使用除逗号之外的其他分隔符,则可以每行指定多个名字

    @deprecated 被弃用文本
    注意:从JDK 5.0开始,可以使用@Deprecated注解来标记弃用程序元素。
    添加一个标记此API不应再使用的注释(即使它可能仍然有效)。Javadoc工具把被弃用文本移动到主要描述之前,将其置为斜体字,并在其前面加上一个粗体警告:“Deprecated”。此标签在所有文档注释中都有效:概述,包,类,接口,构造函数,方法和字段。
    被弃用文本的第一句应该至少告诉用户API自何时被弃用以及使用什么作为替代。 Javadoc工具只将第一个句子复制到摘要部分和索引。后续句子也可以解释为什么它已被弃用。您应该包含指向替换的API的{@link}标记(对于Javadoc 1.2或更高版本)。

    • 对于Javadoc 1.2及更高版本,请使用{@link}标记。这会在您想要的位置创建内联链接。例如:
    /**
     * @deprecated自JDK 1.1起,替换为{@link #setBounds(int,int,int,int)}
     */
    • 对于Javadoc 1.1,标准格式是为每个@deprecated标签创建一个@see标签(但是不能“内联”)。

    {@code 文本}

    等同于<code> {@ literal} </ code>
    以代码字体显示文本而不将文本解释为HTML标签或嵌套的javadoc标签。这使您可以在文档注释中使用尖括号(<和>)而不是HTML实体(&lt;和&gt;),例如参数类型(<Object>),不等式(3 <4)或箭头( < - )。例如,doc注释文本:

     {@code A <B> C}
    在生成的HTML页面中的显示不变:
         A <B> C
    <B>不会被解释为粗体,并且以代码字体显示。
    如果您想要非代码字体的同样的功能,请使用{@literal}标签。

    {@docRoot}
    表示从任何生成的页面到生成的文档(目标)根目录的相对路径。当您想要包含一个要在所有生成的页面中都引用的文件(例如版权页面或公司徽标)时,它非常有用。在每页底部都链接到版权页面很常见。
    {@docRoot}标签可以在命令行和文档注释中使用,在所有文档注释中都有效:概述,包,类,接口,构造函数,方法和字段,包括任何标签的文本部分(例如@return@param@deprecated)。

    • 在命令行上,在定义页眉/页脚/底部的地方:

       javadoc -bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
    注意:在make文件中以这种方式使用{@docRoot}时,某些makefile程序需要对括号{}字符进行特殊的转义。例如,在Windows上运行的Inprise MAKE 5.2版需要双括号:{{@ docRoot}}。它还需要双引号(而不是单引号)将诸如-bottom之类的选项的参数括起来(同时省略了href参数周围的引号)。
    在文档注释中:

     /**
      * See the <a href="{@docRoot}/copyright.html">Copyright</a>.
      */

    需要此标签的原因是由于生成的文档位于分层的目录中,与子包的数量一样深。这个表达式:
      <a href="{@docRoot}/copyright.html">
    在java/lang/Object.java文件中会解析为:<a href="../../copyright.html">;在java/lang/ref/Reference.java文件中会解析为:<a href="../../../copyright.html">

    @exception 类名 描述
    @exception标签是@throws的同义词。

    {@inheritDoc}
    从“最近的”可继承类或可实现的接口继承(复制)注释文档到当前doc注释中(位于此标签所在位置)。这允许您在继承树的更高处编写更一般的注释,也使您可以在复制的文本周围编写注释。此标签仅在文档注释中的以下位置有效:

    • 在方法的主要描述块中。在这种情况下,主要描述从继承层次结构中的类或接口复制。
    • 在方法的@return@param@throws标签的文本参数中。在这种情况下,标签文本将从继承层次结构中的相应标签复制

    请注意,如果缺少此标记,则根据该部分中描述的规则决定是否自动继承注释。

    {@link package.class#member label}
    插入带有可见文本标签的内嵌链接(该链接指向引用类的指定包名,类名或成员名的文档)。此标签在所有文档注释中都有效:概述,包,类,接口,构造函数,方法和字段,包括任何标签的文本部分(例如@return@ param@deprecated)。
    此标签与@see非常相似:两者都需要相同的引用,并且对package.class #memberlabel接受完全相同的语法。主要区别在于{@link}生成了一个内联链接而不是将链接放在“See Also”部分。如果你需要用在label中使用“}”,请使用 HTML实体标记&#125;,}句子中允许的{@link}标签数量没有限制。例如,这是一个引用getComponentAt(int,int)方法的注释:

    Use the {@link #getComponentAt(int, int) getComponentAt} method.

    由此,标准doclet将生成以下HTML(假设它引用同一包中的另一个类):

    Use the <a href="Component.html#getComponentAt(int, int)">getComponentAt</a> method.

    它在网页上显示为:Use the getComponentAt method。您可以使用-link选项扩展{@link}以链接到没有被文档记录(documented)的类。

    {@linkplain package.class#member label}
    {@link}相同,但链接的label以纯文本显示,而不是代码字体。label是纯文本时很有用。例:
           Refer to {@linkplain add() the overridden method}.
    这将显示为:
    Refer to the overridden method.

    {@literal 文本}

    显示文本而不将文本解释为HTML标签或嵌套的javadoc标签。这使您可以在文档注释中使用尖括号(<和>)
    而不是HTML实体(&lt;和&gt;),比如参数类型(<Object>),不等式(3 <4)或箭头( < - )。例如,文档注释文本:
         {@literal A <B> C}
    在浏览器中生成的HTML页面中显示不变: A <B> C。如果您想要相同的功能但使用代码字体的文本,请使用{@code}。

    @param 参数名 描述
    添加一个有指定参数名的“参数”。参数名后紧跟对参数部分的具体描述。描述可以跨多行。此标记仅在方法,构造函数或类的文档注释中有效。
    参数名可以是方法或构造函数中的参数名,也可以是类,方法或构造函数的类型参数名。在此参数名周围使用尖括号指定使用类型参数。

    类的类型参数示例:

     /**
      * @param <E> Type of element stored in a list
      */
     public interface List<E> extends Collection<E> {
     }
    

    方法的类型参数实例:

    
    
         /**
          * @param string  the string to be converted
          * @param type    the type to convert the string to
          * @param <T>     the type of the element
          * @param <V>     the value of the element
          */
         <T, V extends T> V convert(String string, Class<T> type) {
         }

    @return 描述
    添加带有描述文本的“Returns”部分。该文本应描述返回类型和允许的值范围。此标记仅在方法的文档注释中有效。

    @see 引用
    添加“See Also”标题,其中包含指向引用的链接或文本条目。文档注释可以包含任意数量的@see标签,这些标签都被归入同一标题下。 @see标签有三种变体,下面的第三种形式是最常见的。此标记在任何文档注释中都有效:概述,包,类,接口,构造函数,方法或字段。要将句子中的内嵌链接插入包,类或成员,请参阅{@link}

    • @see "字符串"

    添加字符串的文本条目(不会生成链接)。该字符串是书籍或其他(URL不可用的)信息的引用。 Javadoc工具通过查找双引号(")作为第一个字符来区分此情况。例如:
         @see "Java编程语言"
    这会生成以下文本:

    See Also:
    "The Java Programming Language"

    • @see <a href="URL#value">标签</a>

    添加URL#value定义的链接。 URL#值是相对或绝对URL。 Javadoc工具通过查找小于号(<)作为第一个字符来区别于其他情况。例如:
         @see <a href="spec.html#section"> Java Spec </a>
    这会生成一个链接:
    See Also:
    Java Spec

    • @see package.class#member label

    添加带有可见文本标签的链接,该链接指向所引用的Java Language中指定的name的文档。label是可选的。如果省略,则name(package.class#member 部分)作为可见文本显示,并将适当的缩短 ( 请参阅下面:名字如何显示)。使用-noqualifier将全局地从可见文本中删除包名。如果希望可见文本与自动生成的可见文本不同,请使用label
    仅在版本1.2中,只有名字而不是label会自动出现在<code> HTML标签中;从1.2.2开始,<code>始终包含在可见文本周围,无论是否使用labelpackage.class #member是被引用的任何有效程序元素名:包,类,接口,构造函数,方法或字段名,成员名前面的字符应该是哈希字符(#)。该class 表示任何顶级或嵌套类或接口。该member表示任何构造函数,方法或字段(包括嵌套类或接口)。如果此名位于被文档记录(documented)的类中,则Javadoc工具将自动创建指向它的链接。要创建指向外部引用类的链接,请使用-link选项。使用其他两个@see的变体中来引用不属于引用类name的文档。(下面的“定制名字”中下更详尽地描述了该参数。)

    label是可选文本,作为链接的标签显示。label可以包含空格。空格是package.class #memberlabel之间的分隔符(不包括括号内的空格,因此可以在方法中的参数之间使用空格)。示例:

    /**
     * @see String#equals(Object) equals
     */

    标准doclet将生成这样的HTML:

    <dl>
    <dt><b>See Also:</b>
    <dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals<code></a>
    </dl>

    在浏览器中看起来像这样,label是可见的链接文本:
    See Also:
    equals

    定制名字

    这里的package.class#member (名字)可以是完全限定的,例如 java.lang.String#toUpperCase() ,也可以不是,例如String#toUpperCase()#toUpperCase()。如果没有完全限定,Javadoc工具使用普通的Java编译器搜索顺序来查找它,下面在@see的搜索顺序中将详尽描述。名字可以在括号内包含空格(例如方法参数之间)。

    当然,提供更短的“部分限定”名字的优点是它们的类型更短,使得源代码中的杂乱程度更低。下表显示了名称的不同形式,其中Class可以是类或接口,Type可以是类,接口,数组或基本类型,方法可以是方法或构造函数。

    Typical forms for @see package.class#member
    Referencing a member of the current class
    @see  #field
    @see  #method(Type, Type,...)
    @see  #method(Type argname, Type argname,...)
    @see  #constructor(Type, Type,...)
    @see  #constructor(Type argname, Type argname,...)

    Referencing another class in the current or imported packages
    @see  Class#field
    @see  Class#method(Type, Type,...)
    @see  Class#method(Type argname, Type argname,...)
    @see  Class#constructor(Type, Type,...)
    @see  Class#constructor(Type argname, Type argname,...)
    @see  Class.NestedClass
    @see  Class

    Referencing an element in another package (fully qualified)
    @see  package.Class#field
    @see  package.Class#method(Type, Type,...)
    @see  package.Class#method(Type argname, Type argname,...)
    @see  package.Class#constructor(Type, Type,...)
    @see  package.Class#constructor(Type argname, Type argname,...)
    @see  package.Class.NestedClass
    @see  package.Class
    @see  package

    上表中的注意事项:
    第一种形式(没有类或包)将导致Javadoc工具仅搜索当前类的层次结构。它将找到当前类或接口或者其超类或超接口之一,或其封闭的类或接口之一的一个成员(搜索步骤1-3)。它不会搜索当前包或其他包的其余部分(搜索步骤4-5)。

    如果输入没有括号形式的任何方法或构造函数,例如getValue,并且如果没有相同名字的字段,则Javadoc工具将正确创建指向它的链接,不过会打印一条警告消息,提醒您添加括号和参数。如果此方法被重载,Javadoc工具将链接到其搜索遇到的第一个方法,该方法将是不确定的。

    不管应用哪种形式,嵌套类必须指定为outer.inner,而不仅仅是inner。
    如上所述,散列字符(#)而不是点(.)将成员与其类分开。这使得Javadoc工具能够解决歧义,因为点还分隔了类,嵌套类,包和子包。但是,Javadoc工具是宽松的,如果你确定不存在歧义,它会正确地解析一个(.),不过它会打印一个警告。

    @see的搜索顺序

    Javadoc工具将处理出现在源文件(.java),包文件(package.htmlpackage-info.java)或概述文件(overview.html)中的@see标记。在后两个文件中,必须为@see提供完全限定的名字。在源文件中,您可以指定完全限定或部分限定的名字。

    当Javadoc工具在.java文件中遇到非完全限定的@see标签时,它会按照与Java编译器相同的搜索顺序搜索指定的名字(不同的是,Javadoc工具不会检测某些命名空间歧义,因为它假设源代码没有这些错误)。Javadoc工具通过所有相关和导入的类和包搜索该名字。它按以下顺序搜索:

    1. 当前的类或接口
    2. 任何封闭(enclosing)的类和接口,优先搜索最近的
    3. 任何超类和超接口,优先搜索最近的
    4. 当前包
    5. 任何导入的包,类和接口,按import语句的顺序搜索

    Javadoc工具继续通过步骤1-3递归搜索它遇到的每个类,直到找到匹配的为止。也就是说,在搜索当前类及其封闭类E之后,它将在搜索E的封闭类之前搜索E的超类。在步骤4和5中,Javadoc工具不会以任何特定的顺序搜索包中的类或接口(该顺序取决于特定的编译器)。在第5步中,Javadoc工具会在java.lang中查找,因为它会被所有程序自动导入。

    Javadoc工具不一定在子类中查找,也不会在其他包中查找,即使它们的文档也在同一次运行中生成。例如,如果@see标签位于java.awt.event.KeyEvent类中并引用java.awt包中的名字,则javadoc不会查找该包,除非该类导入了它。

    名字如何显示

    如果省略label,则将显示package.class.member。 通常,它相对于当前的类和包适当地缩短。Javadoc工具只显示必要的最小名字。 例如,如果String.toUpperCase()方法包含对同一个类的成员和另一个类的成员的引用,则仅在后一种情况下显示类名,如下表所示。

    Use -noqualifier to globally remove the package names.

    Type of ReferenceExample in String.toUpperCase()Displays As
    @see tag refers to member of the same class, same package@see String#toLowerCase() toLowerCase() 
    (omits the package and class names)
    @see tag refers to member of a different class, same package@see Character#toLowerCase(char) Character.toLowerCase(char) 
    (omits the package name, includes the class name)
    @see tag refers to member of a different class, different package@see java.io.File#exists() java.io.File.exists() 
    (includes the package and class names)

    @see的例子
    右边的注释显示了如果@see标记位于另一个包中的类(如java.applet.Applet)中,将如何显示该名称。

                                               See also: 
    @see java.lang.String                   //  String                           
    @see java.lang.String The String class  //  The String class                 
    @see String                             //  String                           
    @see String#equals(Object)              //  String.equals(Object)            
    @see String#equals                      //  String.equals(java.lang.Object)   
    @see java.lang.Object#wait(long)        //  java.lang.Object.wait(long)      
    @see Character#MAX_RADIX                //  Character.MAX_RADIX              
    @see <a href="spec.html">Java Spec</a>  //  Java Spec            
    @see "The Java Programming Language"    //  "The Java Programming Language"  

    可以使用-link选项扩展@see以链接到未被文档记录的类。

    @serial 字段描述|include|exclude
    用于默认的可序列化字段的文档注释。
    可选的字段描述应解释字段的含义并列出可接受的值。字段描述可以跨多行。标准doclet将此信息添加到序列化表单页面。如果可序列化字段在类可序列化之后的某个时间被添加到类中,则应在其主要描述中添加一个语句以标识它的添加版本。includeexclude参数标识是否应在序列化表单页面中包含或排除类或包。他们以如下方式工作:

    除非该类(或其包)标记为@serial exclude,否则将包含实现Serializable的公共类或受保护类。
    除非该类(或其包)标记为@serial include,否则将排除实现Serializable的私有或包私有类。
    例如:javax.swing包标记为@serial exclude(在package.htmlpackage-info.java中)。公共类java.security.BasicPermission标记为@serial exclude。 package-private类java.util.PropertyPermissionCollection标记为@serial include

    类级别的@serial标签会在包级别覆盖@serial

    @serialField 字段名 字段类型 字段描述
    记录可序列化类的serialPersistentFields成员的ObjectStreamField组件。每个ObjectStreamField组件都应使用一个@serialField标签。

    @serialData 数据描述
    数据描述以序列化形式记录了数据类型和顺序。具体来说,此数据包括writeObject方法写入的可选数据以及Externalizable.writeExternal方法写入的所有数据(包括基本类)。
    @serialData标记可以在writeObject,readObject,writeExternal,readExternal,writeReplace和readResolve方法的文档注释中使用。

    @since 文本
    使用指定的文本向生成的文档添加“Since”标题。该文本没有特殊的内部结构。此标签在任何文档注释中都有效:概述,包,类,接口,构造函数,方法或字段。此标记表示自文本指定的软件版本以来,此更改或功能已存在。例如:
        @since 1.5
    在Java平台中的源代码里,此标签代表Java平台API规范的版本(不一定在将其添加到参考实现时)。允许使用多个@since标签,类似于多个@author标签。如果prgram元素被多个API使用,你可以使用多个标签。

    @throws 类名 描述
    @throws@exception标签是同义词。使用类名描述文本向生成的文档添加“throws”子标题。类名是方法可能抛出的异常的名字。此标签仅在方法或构造函数的文档注释中有效。如果未完全指定此类,则Javadoc工具使用搜索顺序查找此类。对于相同或不同的异常,可以在给定的文档注释中使用多个@throws标签。
    为确保记录所有已检查的异常,如果throws子句中的异常不存在@throws标签,则Javadoc工具会自动将该异常添加到HTML输出(没有描述),就像使用@throws标签记录了一样。只有在重写方法中显式声明了异常时,才会将@throws注释从被重写的方法复制到子类。从接口方法复制到实现方法也是如此。您可以使用{@inheritDoc}强制@throws继承文档。

    {@value package.class #field}
    当在静态字段的doc注释中使用{@value}(没有任何参数)时,它会显示该常量的值:

        /**
         * The value of this constant is {@value}.
         */
        public static final String SCRIPT_START =“<script>”


    当与任何文档注释中的参数package.class #field一起使用时,它会显示指定常量的值:
     

        /**
         * Evaluates the script starting with {@value #SCRIPT_START}.
         */
        public String evalScript(String script) {
        }

    参数package.class #field采用与@see的参数相同的形式,但该成员必须是静态字段。这些常量的值也显示在“常量字段值”页面上。

    @version 版本文本
    使用-version选项时,将指定版本文本的“Version”子标题添加到生成的文档中。 此标签用于保存此代码所属软件的当前版本号(与@since相反,后者保存引入此代码的版本号)。 版本文本没有特殊的内部结构。文档注释可能包含多个@version标记。 如果有意义,您可以为每个@version标签指定一个版本号,或为每个标签指定多个版本号。 在前一种情况下,Javadoc工具在名称之间插入逗号(,)和空格。 在后一种情况下,只需将整个文本复制到生成的文档而不进行解析。 因此,如果需要使用除逗号之外的其他分隔符,则可以每行使用多个版本号。

    标签可以在何处使用

    注意:@ see,@ since,@ deprecated,{@ link},{@ linkplain}和{@docroot}可用于所有文档注释。

    • 概述文档注释标签

    注意:{@link}标签在版本1.2中的概述文档中有bug - 文本正确显示但没有链接。 {@docRoot}标签目前不适用于概述文档。

    Overview Tags
    @see
    @since
    @author
    @version
    {@link}
    {@linkplain}
    {@docRoot}
    • 包文档注释标签

    @serial标签只能在此处使用必须includeexclude参数。

    Package Tags
    @see
    @since
    @serial
    @author
    @version
    {@link}
    {@linkplain}
    {@docRoot}
    • 类和接口文档注释标签

    @serial标签只能在此处使用必须includeexclude参数。

    Class/Interface Tags
    @see
    @since
    @deprecated
    @serial
    @author
    @version
    {@link}
    {@linkplain}
    {@docRoot}

    例如:

    /**
     * A class representing a window on the screen.
     * For example:
     * <pre>
     *    Window win = new Window(parent);
     *    win.show();
     * </pre>
     *
     * @author  Sami Shaio
     * @version %I%, %G%
     * @see     java.awt.BaseWindow
     * @see     java.awt.Button
     */
    class Window extends BaseWindow {
       ...
    }
    • 字段文档注释标签
    Field Tags
    @see
    @since
    @deprecated
    @serial
    @serialField
    {@link}
    {@linkplain}
    {@docRoot}
    {@value}

    例如:

     /**
      * The X-coordinate of the component.
      *
      * @see #getLocation()
      */
     int x = 1263732;
    • 构造函数和方法文档注释标签

    例外:@return不能出现在构造函数中;{@inheritDoc}存在特定的限制(certain restrictions);@serialData标签只能用于特定的序列化方法上(certain serialization methods)。

    Method/Constructor Tags
    @see
    @since
    @deprecated
    @param
    @return
    @throws and @exception
    @serialData
    {@link}
    {@linkplain}
    {@inheritDoc}
    {@docRoot}

    例如:

     /**
      * Returns the character at the specified index. An index 
      * ranges from <code>0</code> to <code>length() - 1</code>.
      *
      * @param     index  the index of the desired character.
      * @return    the desired character.
      * @exception StringIndexOutOfRangeException 
      *              if the index is not in the range <code>0</code> 
      *              to <code>length()-1</code>.
      * @see       java.lang.Character#charValue()
      */
     public char charAt(int index) {
        ...
     }

    References


    1. Javadoc 1.5

    2. Javadoc Tool Reference Page (Microsoft Windows)

    3. How to Write Doc Comments for Javadoc

    4. Cay S. Horstmann,Gary Cornell,  Core Java volume I,Ninth Edition

    展开全文
  • js打开word文档,而不是下载

    万次阅读 2017-12-12 16:20:48
    打开word文档,而不是下载 a > body > html > 第二种方法 <!DOCTYPE html> < html lang = "en" > < head > < meta charset = "UTF-8" > < title > Title title > < script ...
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <script>
            function openmydoc(path) {
                var doc = new ActiveXObject("Word.Application");
                doc.visible = true;
                doc.Documents.Open(path);
            }
        </script>
    </head>
    <body>
    
    <a onclick="openmydoc('D:\\word\\go.doc');" type="activxobject(word.application)">
        点击我!!!打开word文档,而不是下载
    </a>
    </body>
    </html>

    第二种方法

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <script language="Javascript">
            function doword() {
                var WordApp = new ActiveXObject("Word.Application");
                WordApp.Application.Visible = true;
                var Doc = WordApp.Documents.Add("D:\\word\\go.doc",true);
                //下面是以只读方式打开
                var openDocObj = new ActiveXObject("SharePoint.OpenDocuments.1");
                openDocObj.EditDocument("http://localhost/cmt/go.doc");
            }
        </script>
    </head>
    <body>
    <button onclick="doword()">打开Word模板</button>
    </body>
    </html>
    展开全文
  • Qt帮助文档使用方法

    千次阅读 2019-10-22 20:22:18
    Qt 帮助文档非常细致而全面,应有尽有,是非常不错的自学教材。因为 Qt 帮助文档太多,所以难以都翻译成中文,即使翻译了一部分,翻译花的时间太多,翻译更新的时效性也难以保证,所以还是得看英文帮助为主。本节...

    Qt 帮助文档非常细致而全面,应有尽有,是非常不错的自学教材。因为 Qt 帮助文档太多,所以难以都翻译成中文,即使翻译了一部分,翻译花的时间太多,翻译更新的时效性也难以保证,所以还是得看英文帮助为主。本节介绍 Qt 助手和 Qt 帮助文档的使用,学会基本的文档运用方式。

    Qt Assistant(Qt 助手)

    在开始菜单中找到“Qt 5.9.0-->5.9-->MinGW 5.3.0 (32-bit)-->Assistant”,或者在 Qt 命令行工具中运行 assistant 命令,都可以打开独立的 Qt 助手程序,这就是帮助文档的浏览查阅软件,并且可以添加新的 Qt 相关文档。

    首先介绍一下 Qt 助手的界面:

    Qt Assistant(Qt 助手)界面


    Qt 助手是典型的 Qt 主窗口(MainWindow)程序,上方是菜单栏和工具栏(默认显示的叫导航工具栏),最下面的是状态栏。

    Qt 助手界面与常见的网页浏览器功能非常类似,概略介绍一下几个菜单:

    菜单说明
    文件可以新建多个标签页,同时打开多个文档页面,还可设置文档页面属性,打印帮助页面。
    编辑在当前打开页面复制文本或查找文本,以及 Qt 助手自身的首选项编辑。
    查看文档页面显示的放大缩小,显示各个功能窗口(内容、索引、书签、搜索、打开页列表)或工具栏(过滤器工具栏、地址工具栏、书签工具栏)。
    前往类似网页浏览器的前进、后退、主页,有区别的是同步目录菜单项,如果通过索引或搜索查找打开的帮助页,不知道该页面位于哪个目录树里和目录路 径,可以点击同步目录,定位该帮助页在目录树里的路径。
    书签添加打开的页面到书签菜单栏或书签工具栏,管理书签等。
    帮助关于 Qt 助手版本信息。


    默认显示的工具栏是导航工具栏,在菜单“查看-->工具栏”里可以找到其他三个工具栏,或者右击工具栏或菜单栏空白处,邮件菜单也可以设置显示哪些工具栏。

    导航工具栏里按钮功能在菜单栏里都有对应菜单项,“同步目录”按钮就是菜单“前往-->同步目录”菜单项一样的功能。“Find in Text”按钮就是“编辑”菜单里的对应项,快捷键 Ctrl+F,注意查找当前页文本的查找栏不是弹窗的,而是位居底部状态栏上面。 在本页检索到的关键词会用黄色背景高亮显示出来,查找栏可以通过点击左边红叉按钮关闭,可以按快捷键 Ctrl+F 再次显示。导航工具栏的其他按钮意义都很简单直白,如前进、后退、主页、复制、打印、放大、缩小、正常大小等,就不多作说明了。

    介绍完边边角角,我们来看看左边的导航窗口,左边导航窗口分两部分,上方的是四个选项卡式的子窗口:内容、索引、书签和搜索。下方的是当前打开的文档页面。

    导航窗口下方的打开文档列表窗口一目了然,对于上面四个子窗口需要解释一下:

    子窗口说明
    内容显示 Qt 帮助文档的目录树,每一个文档树的根对应一个 qch 文件(Qt Compressed Help file),对于本教程安装的 Qt 开发环境,这些 qch 文件位于“Qt安装目录\Docs\Qt-5.9”文件夹里,这个文件夹不仅有一堆 *.qch 文件,还有一堆子文件夹,子文件夹名字与 qch 文件名字是对应的,子文件夹保存 qch 文件的快速索引数据。
    索引qch 文件里每篇帮助页都有快速索引,索引的内容一般有帮助页标题、Qt 模块名、类名/名字空间、成员变量/属性、成员函数、枚举类型、宏定义等等,通过输入索引关键词,就可以快速找到相关的文档页面。这些快速索引数据保存位置就是刚才讲的“Qt安装目录\Docs\Qt-5.9”的子文件里。
    书签可以按快捷键 Ctrl+D,保存当前页为书签,书签保存位置分两类,一类是在书签菜单栏的菜单项显示,另一类是在书签工具栏里显示。可以右击菜单栏或工具栏空白处,在右 键菜单选择显示书签工具栏。
    搜索这个是对所有 Qt 文档页面进行全文搜索,对于快速索引找不到的关键词,可以在全文检索子窗口里查找。


    在本小节第一张图可以看到帮助页内部的结构,主要有帮助页的标题、目录树路径、前一篇和后一篇链接、帮助页内部目录、页面分节小标题、正文内容等,图上标注的 比较清楚,就不再赘述了。

    Qt Creator 集成的帮助系统

    Qt Creator 作为集成开发环境,打开这一个工具等于打开所有的工具,Qt Creator 除了自带设计师插件,还带有助手插件,可以随时查看帮助文档。Qt Creator 的助手插件有两种工作方式,第一种是以 Qt Creator 的帮助模式出现,打开 QtCreator,点击左边“帮助”,如下图所示:

    Qt Creator 集成的帮助系统


    界面与独立的 Qt 助手程序差不多,主要是工具栏的区别。Qt Creator 左边是分栏窗口,上面分栏子窗口的默认是“目录”视图,对应助手独立程序左侧的“内容”窗口,在该子窗口标题栏位置(其实是工具栏)可以选择当前视图,总共有四个:

    • 书签:对应 Qt 助手独立程序的“书签”,保存的文档书签页面。
    • 目录:对应 Qt 助手独立程序的“内容”,即帮助文档目录树。
    • 索引:对应 Qt 助手独立程序的“索引”,对帮助文档进行快速索引。
    • 查找:对应 Qt 助手独立程序的“搜索”,对帮助文档进行全文搜索。


    分栏窗口的工具栏还有两个分别是“添加分栏”和“关闭分栏”按钮,可以添加分栏显示上面列举的多个视图。如果要关闭全部边栏,可以点击 QtCreator 菜单“控件”-->“Hide SideBar”隐藏边栏;如果边栏被全部关闭了,那么可以点击 QtCreator 菜单“控件”-->“Show SideBar”重新显示边栏。

    左侧分栏下方的子窗口是打开页面列表(Open Pages),也可以切换显示的视图,与左边上面子窗口的功能差不多,只是默认显示的视图不一样。

    右边区域都是当前打开的帮助页面,页面上方的区域是其工具栏,有一排按钮,功能分别是:

    • 主页:回到帮助文档主页,这里默认是 QtCreator 文档主页。
    • 后退:回到上一个显示的页面。
    • 前进:与后退相反,进入下一个页面。
    • 添加书签:保存当前显示的帮助页面到书签视图(Bookmarks)里。
    • 打开页面列表:与左侧打开的页面列表(Open Pages)是对应的关系,可以选择显示已打开的页面。
    • 过滤文档根:在帮助文档目录树里,筛选一个文档根,查看其内容,默认“未过滤”是显示所有文档根。


    Qt Creator 的帮助文档内容和 Qt 助手独立程序的帮助文档内容是一样的,这两个程序都可以查阅帮助文档,页面内容也是一样的。

    选中代码进入帮助页面

    现在来看看 QtCreator 助手插件的第二种工作方式,先进入“欢迎”模式,打开上一节的 testbug 项目,然后自动进入“编辑”模式。

    在“编辑”模式,边栏上半部分项目视图里打开 widget.cpp ,在构造函数里选中 qSleep 函数名,然后按快捷键 F1,看到在“编辑”模式里集成的智能感知帮助页面:

    选中代码进入Qt帮助页面


    如上图所示,在 QtCreator 的“编辑”模式里,可以根据选中的函数名、变量名、类名等,按 F1 键之后自动打开智能感知帮助页面,会自动根据编辑器里的名称查询帮助文档,如果找到对应的文档,就跳转进去。这是非常好用的功能,如果不知道类或对象有什么函数,选择名称,按 F1 键会直接进入该类的帮助文档,查找文档特别方便。

    智能感知页面上方是它的工具栏:工具栏第一个按钮“Open in Help Mode”表明当前处于 QtCreator 的帮助模式,工具栏剩下的按钮分别是主页、后退、前进、添加书签、打开模式和关闭。

    关于 QtCreator 和 Qt 助手独立程序的界面就介绍这么多,这些工具用多了就熟悉了。下面介绍怎么查询和运用帮助文档,因为帮助文档都是英文的,所以学好英文还是有必要的。

    帮助文档运用

    在使用帮助文档之前,首先是要知道自己想达到什么目的、实现什么功能,然后先可以用谷歌百度搜索一下关键词,得到可能的模块名、类名、函数名,再用 Qt 助手的索引或搜索功能找到具体的文档和示例代码。

    就拿前面提到的睡眠函数举例,通常猜都猜得到跟 sleep 单词有关系,然后去 Qt 助手索引里查找:


    如上图所示,在索引栏输入 sleep 之后出来好几个函数以及常量,双击鼠标即可进入相关页面。

    打断一下思路,我们先来讲讲 Qt 一般的命名规则:

    • 类名、枚举类型/常量、名字空间等名称都是首字母大写,名字里单词首字母都大写,比如 Qt::Key_Sleep ,这里的 Qt 是名字空间,Key_Sleep 是 Qt 名字空间里的常量。
    • 类的属性/成员变量、成员函数、静态函数等名称一般以小写字母单词打头,名称里第二个单词开始用大写首字母,如 setText 函数。
    • 全局函数以及名字空间里的全局函数通常以 q 打头,后面接首字母大写的英文单词,比如 qSleep 函数,qAbs 函数(求绝对值),另外在 <QtGlobal> 头文件包含了一堆全局的类型、函数、宏等。
    • 全局的宏定义是单词字母全部大写,单词之间用下划线分隔,如 QT_VERSION(版本号 0xMMNNPP,MM = major,NN = minor,PP = patch,比如 0x050400)、Q_OS_WIN32(仅在 Windows 操作系统里定义)。


    对于上图里的函数名、常量名可以对比上面规则,基本是一致的,msleep、sleep、usleep 都是成员函数,它们的名称很短,只能算一个单词,所以都是小写字母。

    对于右侧void QTest::​qSleep(int ms)一行,怎么知道 QTest 是类名还是函数名呢?

    可以直接滚动页面到顶端,或者点击示例代码里的绿色 QTest 字样(注意示例代码明确用了QTest::前缀),打开链接,看到类似下面的帮助内容:


    查看 QTest 帮助页面开头的描述和该页面的标题,可以知道它是一个名字空间,根据上边的页内目录,可以看到它里面定义了一堆类、类型、函数、宏,另外还有 QTest 名字空间的详细描述,可以点击上边的“Detailed Description”或者帮助页第一段的“More ...”查看详细描述。

    在 QTest 帮助页顶头的简要描述之后,紧接着的就是该名字空间的头文件以及使用时需要的 Qt 模块,到这里就可以弄清楚我们使用 qSleep 函数时需要的一切依赖和步骤:

    • 包含头文件:#include <QTest>
    • pro文件里添加需要的模块:QT += testlib
    • 代码里调用函数:QTest::qSleep(250);


    其他 Qt 名字空间或类里面的函数用法都是类似的,一般都是上面示范的三个步骤,熟悉之后用起来就很方便。

    对于上图里的 Qt::Key_Sleep,这是个键盘按键定义,有些多媒体键盘带有休眠按键,该按键对应这个常量定义。 QStyle::SH_ToolTip_FallAsleepDelay 这个定义不管它,是工具提示风格里的。

    剩下三个函数的声明如下图所示:

    • msleep:毫秒级睡眠,是 QThread 类的公开静态成员函数。
    • sleep:秒级睡眠,也是 QThread 类的公开静态成员函数。
    • usleep:微秒级睡眠,也是 QThread 类的公开静态成员函数。

     


    这三个是静态成员函数,说明与具体对象无关,可以直接在代码里使用,如 QThread::sleep(1) 。QThread 类位于核心模块 core 里面,所以不需要额外添加 Qt 模块,包含它的头文件 <QThread> 就行了。使用 QThread 类里的睡眠函数要比 QTest 名字空间里的函数方便一些,而且功能也丰富一些。

    展开全文
  •  直接以txt通过串口打印条码标签。包括Code39和DATAMATRIX。...我发现下面代码应该也不是用这个语言写的。下面这些打印机打标签命令模板是 之前供应商给的。具体我也看不懂。内容也只是替换一下变量test和test1
  • 本文记录了如何使用HTML中a标签的target属性在指定的框架中打开被链接文档。 使用<frame>标签,做一个有框架的网页,框架思路如下图所示: 该网页由Frame A和Frame B两部分组成,其中给Frame A设置属性值...
  • 一:HTML中的 head 标签都可以放哪些标签 。 二:title 标签,meta标签,link标签,stye标签,script标签,base标签
  • 使用GitBook编写文档书籍

    千次阅读 2017-12-01 11:34:44
    GitBook支持输出以下几种文档格式: 静态站点:GitBook默认输出该种格式 PDF:需要安装gitbook-pdf依赖 eBook:需要安装ebook-convert GitBook可以用来写书、API文档、公共文档,企业手册,论文,研究报告等。一、...
  • 前段时间在项目中遇到文件需要下载,直接拿出了之前封装的下载指令,在用的时候发现在下载jpg、txt文件时,并不会直接下载,而是会在浏览器中打开文件,即使给a标签添加了download 属性,也无济于事。 我先把之前...
  • 《RabbitMQ开发库的完整API文档》翻译

    万次阅读 2017-12-28 21:28:38
    我的Android端需要实时的接收RabbitMQ推送过来的消息,故找了对应的文档查看用法。这里特地翻译出来方便自己和诸位博友日后学习分享。 译文链接 Java Client API Guide 我的译文 Java...
  • 下面关于HTML语言说法不正确的是(分).ppt (9页) 本资源提供全文预览,点击全文预览即可全文预览,如果喜欢文档就下载吧,查找使用更方便哦!15.90 积分1、下面关于HTML语言说法不正确的是 (1分) A.HTML语言是描述性...
  • Java文档标签

    千次阅读 2008-08-03 10:21:00
    Javadoc注释由Javadoc标签和描述性文本组成,你可以为类、接口添加注释,也可为构造函数、值域、方法等类中的元素添加注释。我们来看一个带Javadoc注释的程序,其代码如下所示: 代码清单 1 Person.java1. package ...
  • 如何写好一篇技术型文档

    万次阅读 多人点赞 2022-01-26 13:14:32
    如何写好一篇技术型文档 周智 2022/1/20 参加工作时间久一点的工程师应该有这样一个体会:自己平时代码写得再多再好,可一旦要用文档去描述或者表达某一个事情或者问题时,都感觉非常困难,无从下手,不知道自己该...
  • 用户标签体系的意义及设计方法

    万次阅读 2019-07-02 14:19:17
    我们这次重点谈一下用户标签。 对于市场层面,用户标签能帮助我们什么? 1.完善数据仓 之前我们讲过,企业或市场要有自己的数据仓来进行线索的存储与培育,用户标签就是存在于此,我们希望用户的标签尽可能完整,...
  • Doxygen文档生成工具

    千次阅读 2022-02-16 14:45:23
    Doxygen代码文档生成工具 文章目录Doxygen代码文档生成工具DoxygenDoxygen的注释vscode插件Doxygen实际使用 Doxygen 根据百度百科说法,Doxygen是一种开源的,跨平台的文档系统,支持C、C++、Java、Objective-C语言...
  • HTML学习3:常用标签之文本标签

    万次阅读 2015-10-18 16:04:50
    前面说到HTML是一种标记语言,在HTML中就是用一个个标签来标记网页的,下面就来进行常用标签的学习。我们说到网页,首先关注到的就是网页中显示的文本内容,而这些文本内容就是用文本标签来标记的。  在说常用的...
  • 个人整理 HTML全部标签总集,及用法

    千次阅读 多人点赞 2019-08-07 09:53:01
    注释标签用于在源代码中插入注释。注释不会显示在浏览器中。 您可使用注释对您的代码进行解释,这样做有助于您在以后的时间对代码的编辑。当您编写了大量代码时尤其有用。 使用注释标签来隐藏浏览器不支持的脚本也...
  • 在打包的时候,出了下面的问题,查了一下,说是xml文件中的标签不对应。。 怎么处理呢,找到报错的文件,然后拿出来,看看他的html标签是不是一一对应的。 可以看到,果然是这个标签乱了。 ...
  • 几款制作帮助文档的工具汇总

    千次阅读 2020-11-04 17:09:07
    几款制作帮助文档的工具汇总 文章目录几款制作帮助文档的工具汇总为什么需要发布产品帮助文档支持在线用 MarkDown格式的编辑器1、[GitBook](https://www.gitbook.com/)2、[Docsify](https://docsify.js.org/)3、...
  • 下面就是使用Python爬虫库BeautifulSoup对文档树进行遍历并对标签进行操作的实例,都是最基础的内容 html_doc = """ <html><head><title>The Dormouse's story</title></...
  • HTML学习6:常用标签之超链接标签

    千次阅读 2015-10-24 14:45:16
     超链接可以是一个字,一个词,或者一组词,也可以是一幅图像,您可以点击这些内容来跳转到新的文档或者当前文档中的某个部分。当您把鼠标指针移动到网页中的某个链接上时,箭头会变为一只小手。  我们通过使用 ...
  • html中为什么用i标签<i></i>作小图标

    千次阅读 2021-07-13 02:32:40
    51:12来源:亿速云阅读:75作者:清风这篇文章主要为大家展示了html中为什么用i标签作小图标,内容简而易懂,条理清晰,希望能够帮助大家解决疑惑,下面让小编带大家一起来研究并学习一下“html中为什么用i标签作小...
  • Web前端 HTML 基本结构标签

    千次阅读 多人点赞 2022-03-22 18:55:03
    每个网页都会有一个基本的结构标签(也称为骨架标签),页面内容也是在这些基本标签上书写。 标签名 定义 说明 <html> </html> HTML标签 页面中最大的标签,我们称为 根标签 <head&...
  • layuiAdmin 框架iframe文档

    万次阅读 2019-08-29 01:00:43
    layuiAdmin.std(iframe 版) 是完全基于 layui 架构而成的通用型后台管理模板...该文档适用于 layuiAdmin.std 常规版(iframe),阅读之前请务必确认是否与你使用的版本对应。 熟练掌握 layuiAdmin 的前提是熟练...
  • 下面通过浏览器来查看这个页面的源代码,如图所示,这些源代码就是浏览器可以理解并展示的一种计算机标签语言—HTML HTML 是 Hyper Text Markup Language 的缩写,中文翻译为超文本标记语言,是制作网页最基本的...
  • 如何复制百度文档中的内容

    万次阅读 2019-05-16 11:19:18
    如何复制百度文档中的内容使用打印...1.使用浏览器打印预览功能,复制文档内容,这里使用谷歌浏览器进行演示,以下面这个文档为例,鼠标右击后发现没有复制选项,而且复制的快捷键也没有用,那首先我们按下“Ctrl+...
  • HTML里面的head标签中可以放入什么

    千次阅读 2019-01-17 09:32:00
    amp;amp;amp;amp;amp;amp;lt;head&amp;...标签里可以放入什么 ... 标签用于定义文档的头部,它是所有头部元素的容器。 2、&amp;amp;amp;amp;amp;amp;lt;head&amp;amp;amp;amp;amp;amp;gt; 标签中的元
  • Python爬虫获取某个网页所有的a标签中的超链接网址安装BeautifulSoup管理员身份运行命令行,然后命令行中输入以下命令:pip install beautifulsoup4爬虫核心代码如下:# -*- coding:utf-8 -*-# python 3.7#引入系统...
  • 有时我们的系统中有这样的需求:用户将文件上传到服务器,然后需要我们将其中一篇文档当做段落插入到另一篇文档中。 要完成这种需求,如果从头到尾由我们自己来实现的话,首先要会集成ActiveX控件,其次还要懂一些...
  • 这篇文章主要以图文结合的方式详细介绍了Word文档插入SmartArt图形的方法,具体...很多用户都知道怎么操作,其实win7系统下Word文档插入SmartArt图形的方法比较简单,只要简单几个步骤即可,下面小编和大家讲解详...

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 339,613
精华内容 135,845
关键字:

下面哪个不是文档标签