Package org.apache.poi.xssf.usermodel

Class XSSFHyperlink

  • All Implemented Interfaces:
    org.apache.poi.common.Duplicatable, Hyperlink, Hyperlink
    public class XSSFHyperlink
extends java.lang.Object
implements Hyperlink, org.apache.poi.common.Duplicatable
    XSSF Implementation of a Hyperlink. Note - unlike with HSSF, many kinds of hyperlink are largely stored as relations of the sheet

    • Constructor Summary

      Constructors 
      Constructor Description
      XSSFHyperlink​(Hyperlink other)
      Create a new XSSFHyperlink.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      org.apache.poi.common.Duplicatable copy()  
      java.lang.String getAddress()
      Hyperlink address.
      java.lang.String getCellRef()
      Get the address of the cell this hyperlink applies to, e.g.
      CTHyperlink getCTHyperlink()  
      int getFirstColumn()
      Return the column of the first cell that contains the hyperlink
      int getFirstRow()
      Return the row of the first cell that contains the hyperlink
      java.lang.String getLabel()
      Return text label for this hyperlink
      int getLastColumn()
      Return the column of the last cell that contains the hyperlink
      int getLastRow()
      Return the row of the last cell that contains the hyperlink
      java.lang.String getLocation()
      Location within target.
      java.lang.String getTooltip()  
      HyperlinkType getType()
      Return the type of this hyperlink
      boolean needsRelationToo()
      Do we need to a relation too, to represent this hyperlink?
      void setAddress​(java.lang.String address)
      Hyperlink address.
      void setCellReference​(java.lang.String ref)
      Assigns this hyperlink to the given cell reference
      void setCellReference​(CellReference ref)  
      void setFirstColumn​(int col)
      Set the column of the first cell that contains the hyperlink
      void setFirstRow​(int row)
      Set the row of the first cell that contains the hyperlink
      void setLabel​(java.lang.String label)
      Sets text label for this hyperlink
      void setLastColumn​(int col)
      Set the column of the last cell that contains the hyperlink.
      void setLastRow​(int row)
      Set the row of the last cell that contains the hyperlink.
      void setLocation​(java.lang.String location)
      Location within target.
      void setTooltip​(java.lang.String text)  

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • getCTHyperlink

        @Internal
public CTHyperlink getCTHyperlink()
        Returns:
        the underlying CTHyperlink object

      • needsRelationToo

        public boolean needsRelationToo()
        Do we need to a relation too, to represent this hyperlink?

      • getType

        public HyperlinkType getType()
        Return the type of this hyperlink
        Specified by:
        getType in interface Hyperlink
        Returns:
        the type of this hyperlink

      • getCellRef

        public java.lang.String getCellRef()
        Get the address of the cell this hyperlink applies to, e.g. A55

      • getAddress

        public java.lang.String getAddress()
        Hyperlink address. Depending on the hyperlink type it can be URL, e-mail, path to a file. The is the hyperlink target.
        Specified by:
        getAddress in interface Hyperlink
        Returns:
        the address of this hyperlink

      • getLabel

        public java.lang.String getLabel()
        Return text label for this hyperlink
        Specified by:
        getLabel in interface Hyperlink
        Returns:
        text to display

      • getLocation

        public java.lang.String getLocation()
        Location within target. If target is a workbook (or this workbook) this shall refer to a sheet and cell or a defined name. Can also be an HTML anchor if target is HTML file.
        Returns:
        location

      • setLabel

        public void setLabel​(java.lang.String label)
        Sets text label for this hyperlink
        Specified by:
        setLabel in interface Hyperlink
        Parameters:
        label - text label for this hyperlink

      • setLocation

        public void setLocation​(java.lang.String location)
        Location within target. If target is a workbook (or this workbook) this shall refer to a sheet and cell or a defined name. Can also be an HTML anchor if target is HTML file.
        Parameters:
        location - - string representing a location of this hyperlink

      • setAddress

        public void setAddress​(java.lang.String address)
        Hyperlink address. Depending on the hyperlink type it can be URL, e-mail, path to a file This is the hyperlink target.
        Specified by:
        setAddress in interface Hyperlink
        Parameters:
        address - - the address of this hyperlink

      • setCellReference

        @Internal
public void setCellReference​(java.lang.String ref)
        Assigns this hyperlink to the given cell reference

      • getFirstColumn

        public int getFirstColumn()
        Return the column of the first cell that contains the hyperlink
        Specified by:
        getFirstColumn in interface Hyperlink
        Returns:
        the 0-based column of the first cell that contains the hyperlink

      • getLastColumn

        public int getLastColumn()
        Return the column of the last cell that contains the hyperlink
        Specified by:
        getLastColumn in interface Hyperlink
        Returns:
        the 0-based column of the last cell that contains the hyperlink

      • getFirstRow

        public int getFirstRow()
        Return the row of the first cell that contains the hyperlink
        Specified by:
        getFirstRow in interface Hyperlink
        Returns:
        the 0-based row of the cell that contains the hyperlink

      • getLastRow

        public int getLastRow()
        Return the row of the last cell that contains the hyperlink
        Specified by:
        getLastRow in interface Hyperlink
        Returns:
        the 0-based row of the last cell that contains the hyperlink

      • setFirstColumn

        public void setFirstColumn​(int col)
        Set the column of the first cell that contains the hyperlink
        Specified by:
        setFirstColumn in interface Hyperlink
        Parameters:
        col - the 0-based column of the first cell that contains the hyperlink

      • setLastColumn

        public void setLastColumn​(int col)
        Set the column of the last cell that contains the hyperlink.
        Specified by:
        setLastColumn in interface Hyperlink
        Parameters:
        col - the 0-based column of the last cell that contains the hyperlink

      • setFirstRow

        public void setFirstRow​(int row)
        Set the row of the first cell that contains the hyperlink
        Specified by:
        setFirstRow in interface Hyperlink
        Parameters:
        row - the 0-based row of the first cell that contains the hyperlink

      • setLastRow

        public void setLastRow​(int row)
        Set the row of the last cell that contains the hyperlink.
        Specified by:
        setLastRow in interface Hyperlink
        Parameters:
        row - the 0-based row of the last cell that contains the hyperlink

      • getTooltip

        public java.lang.String getTooltip()
        Returns:
        additional text to help the user understand more about the hyperlink

      • setTooltip

        public void setTooltip​(java.lang.String text)
        Parameters:
        text - additional text to help the user understand more about the hyperlink

      • copy

        public org.apache.poi.common.Duplicatable copy()
        Specified by:
        copy in interface org.apache.poi.common.Duplicatable
        Returns:
        a new XSSFHyperlink based on this
        Since:
        POI 5.1.0