Interface ClientAnchor

  • All Known Implementing Classes:
    HSSFClientAnchor

    public interface ClientAnchor
    A client anchor is attached to an excel worksheet. It anchors against absolute coordinates, a top-left cell and fixed height and width, or a top-left and bottom-right cell, depending on the ClientAnchor.AnchorType:
    1. ClientAnchor.AnchorType.DONT_MOVE_AND_RESIZE == absolute top-left coordinates and width/height, no cell references
    2. ClientAnchor.AnchorType.MOVE_DONT_RESIZE == fixed top-left cell reference, absolute width/height
    3. ClientAnchor.AnchorType.MOVE_AND_RESIZE == fixed top-left and bottom-right cell references, dynamic width/height
    Note this class only reports the current values for possibly calculated positions and sizes. If the sheet row/column sizes or positions shift, this needs updating via external calculations.
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Interface Description
      static class  ClientAnchor.AnchorType  
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      ClientAnchor.AnchorType getAnchorType()
      Gets the anchor type Changed from returning an int to an enum in POI 3.14 beta 1.
      short getCol1()
      Returns the column (0 based) of the first cell, or -1 if there is no top-left anchor cell.
      short getCol2()
      Returns the column (0 based) of the second cell, or -1 if there is no bottom-right anchor cell.
      int getDx1()
      Returns the x coordinate within the first cell.
      int getDx2()
      Returns the x coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      int getDy1()
      Returns the y coordinate within the first cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      int getDy2()
      Sets the y coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      int getRow1()
      Returns the row (0 based) of the first cell, or -1 if there is no bottom-right anchor cell.
      int getRow2()
      Returns the row (0 based) of the second cell, or -1 if there is no bottom-right anchor cell.
      void setAnchorType​(ClientAnchor.AnchorType anchorType)
      Sets the anchor type
      void setCol1​(int col1)
      Sets the column (0 based) of the first cell.
      void setCol2​(int col2)
      Returns the column (0 based) of the second cell.
      void setDx1​(int dx1)
      Sets the x coordinate within the first cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      void setDx2​(int dx2)
      Sets the x coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      void setDy1​(int dy1)
      Sets the y coordinate within the first cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      void setDy2​(int dy2)
      Sets the y coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
      void setRow1​(int row1)
      Returns the row (0 based) of the first cell.
      void setRow2​(int row2)
      Returns the row (0 based) of the first cell.
    • Method Detail

      • getCol1

        short getCol1()
        Returns the column (0 based) of the first cell, or -1 if there is no top-left anchor cell. This is the case for absolute positioning ClientAnchor.AnchorType.MOVE_AND_RESIZE
        Returns:
        0-based column of the first cell or -1 if none.
      • setCol1

        void setCol1​(int col1)
        Sets the column (0 based) of the first cell.
        Parameters:
        col1 - 0-based column of the first cell.
      • setCol2

        void setCol2​(int col2)
        Returns the column (0 based) of the second cell.
        Parameters:
        col2 - 0-based column of the second cell.
      • getRow1

        int getRow1()
        Returns the row (0 based) of the first cell, or -1 if there is no bottom-right anchor cell. This is the case for absolute positioning (ClientAnchor.AnchorType.DONT_MOVE_AND_RESIZE).
        Returns:
        0-based row of the first cell or -1 if none.
      • setRow1

        void setRow1​(int row1)
        Returns the row (0 based) of the first cell.
        Parameters:
        row1 - 0-based row of the first cell.
      • setRow2

        void setRow2​(int row2)
        Returns the row (0 based) of the first cell.
        Parameters:
        row2 - 0-based row of the first cell.
      • getDx1

        int getDx1()
        Returns the x coordinate within the first cell. Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Returns:
        the x coordinate within the first cell
      • setDx1

        void setDx1​(int dx1)
        Sets the x coordinate within the first cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Parameters:
        dx1 - the x coordinate within the first cell
      • getDy1

        int getDy1()
        Returns the y coordinate within the first cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Returns:
        the y coordinate within the first cell
      • setDy1

        void setDy1​(int dy1)
        Sets the y coordinate within the first cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Parameters:
        dy1 - the y coordinate within the first cell
      • getDy2

        int getDy2()
        Sets the y coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Returns:
        the y coordinate within the second cell
      • setDy2

        void setDy2​(int dy2)
        Sets the y coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Parameters:
        dy2 - the y coordinate within the second cell
      • getDx2

        int getDx2()
        Returns the x coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Returns:
        the x coordinate within the second cell
      • setDx2

        void setDx2​(int dx2)
        Sets the x coordinate within the second cell Note - XSSF and HSSF have a slightly different coordinate system, values in XSSF are larger by a factor of Units.EMU_PER_PIXEL
        Parameters:
        dx2 - the x coordinate within the second cell
      • setAnchorType

        void setAnchorType​(ClientAnchor.AnchorType anchorType)
        Sets the anchor type
        Parameters:
        anchorType - the anchor type to set
        Since:
        POI 3.14
      • getAnchorType

        ClientAnchor.AnchorType getAnchorType()
        Gets the anchor type Changed from returning an int to an enum in POI 3.14 beta 1.
        Returns:
        the anchor type