Eclipse Plug-in Developer Guide (Galileo) - ViewerCell (Eclipse Platform API Specification)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Eclipse Platform
Release 3.5

PREV CLASS NEXT CLASS

NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.eclipse.jface.viewers
Class ViewerCell


java.lang.Object
  
org.eclipse.jface.viewers.ViewerCell

public class ViewerCell
extends Object
extends Object

The ViewerCell is the JFace representation of a cell entry in a ViewerRow.

Since:: 3.3

Field Summary

static int ABOVE
          Constant denoting the cell above current one (value is 1).

static int BELOW
          Constant denoting the cell below current one (value is 2).

static int LEFT
          Constant denoting the cell to the left of the current one (value is 4).

static int RIGHT
          Constant denoting the cell to the right of the current one (value is 8).

Method Summary

boolean equals ( Object obj)


Color getBackground ()
          Gets the background color of the cell.

Rectangle getBounds ()
          Get the bounds of the cell.

int getColumnIndex ()
          Get the index of the cell.

Control getControl ()
          Get the control for this cell.

Object getElement ()
          Get the element this row represents.

Font getFont ()
          Gets the font of the cell.

Color getForeground ()
          Gets the foreground color of the cell.

Image getImage ()
          Return the Image for the cell.

Rectangle getImageBounds ()
          Returns the location and bounds of the area where the image is drawn

Widget getItem ()
          Return the item for the receiver.

ViewerCell getNeighbor (int directionMask, boolean sameLevel)
          Returns the specified neighbor of this cell, or null if no neighbor exists in the given direction.

StyleRange[] getStyleRanges ()
          Returns the style ranges to be applied on the text label or null if no style ranges have been set.

String getText ()
          Return the text for the cell.

Rectangle getTextBounds ()
          The location and bounds of the area where the text is drawn depends on various things (image displayed, control with SWT.CHECK)

ViewerRow getViewerRow ()


int getVisualIndex ()
          Get the current index.

int hashCode ()


boolean scrollIntoView ()
          Scroll the cell into view

void setBackground ( Color background)
          Set the background color of the cell.

void setFont ( Font font)
          Set the font of the cell.

void setForeground ( Color foreground)
          Set the foreground color of the cell.

void setImage ( Image image)
          Set the Image for the cell.

void setStyleRanges ( StyleRange[] styleRanges)
          Set the style ranges to be applied on the text label Note: Requires StyledCellLabelProvider with owner draw enabled.

void setText ( String text)
          Set the text for the cell.

Methods inherited from class java.lang. Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

ABOVE

public static int ABOVE

Constant denoting the cell above current one (value is 1).

BELOW

public static int BELOW

Constant denoting the cell below current one (value is 2).

LEFT

public static int LEFT

Constant denoting the cell to the left of the current one (value is 4).

RIGHT

public static int RIGHT

Constant denoting the cell to the right of the current one (value is 8).

Method Detail

getColumnIndex

public int getColumnIndex()

Get the index of the cell.

Returns:: the index

getBounds

public 
Rectangle getBounds()

Get the bounds of the cell.

Returns:: Rectangle

getElement

public 
Object getElement()

Get the element this row represents.

Returns:: Object

getText

public 
String getText()

Return the text for the cell.

Returns:: String

getImage

public 
Image getImage()

Return the Image for the cell.

Returns:: Image or null

setBackground

public void setBackground(
Color background)

Set the background color of the cell.

Parameters:: background -

setForeground

public void setForeground(
Color foreground)

Set the foreground color of the cell.

Parameters:: foreground -

setFont

public void setFont(
Font font)

Set the font of the cell.

Parameters:: font -

setText

public void setText(
String text)

Set the text for the cell.

Parameters:: text -

setImage

public void setImage(
Image image)

Set the Image for the cell.

Parameters:: image -

setStyleRanges

public void setStyleRanges(
StyleRange[] styleRanges)

Set the style ranges to be applied on the text label Note: Requires StyledCellLabelProvider with owner draw enabled.

Parameters:: styleRanges - the styled ranges
Since:: 3.4

getStyleRanges

public 
StyleRange[] getStyleRanges()

Returns the style ranges to be applied on the text label or null if no style ranges have been set.

Returns:: styleRanges the styled ranges
Since:: 3.4

getItem

public 
Widget getItem()

Return the item for the receiver.

Returns:: Item

getControl

public 
Control getControl()

Get the control for this cell.

Returns:: Control

getVisualIndex

public int getVisualIndex()

Get the current index. This can be different from the original index when columns are reordered

Returns:: the current index (as shown in the UI)
Since:: 3.4

getNeighbor

public 
ViewerCell getNeighbor(int directionMask,
                              boolean sameLevel)

Returns the specified neighbor of this cell, or null if no neighbor exists in the given direction. Direction constants can be combined by bitwise OR; for example, this method will return the cell to the upper-left of the current cell by passing ABOVE | LEFT. If sameLevel is true, only cells in sibling rows (under the same parent) will be considered.

Parameters:: directionMask - the direction mask used to identify the requested neighbor cell; sameLevel - if true, only consider cells from sibling rows
Returns:: the requested neighbor cell, or null if not found

getViewerRow

public 
ViewerRow getViewerRow()

Returns:: the row

getTextBounds

public 
Rectangle getTextBounds()

The location and bounds of the area where the text is drawn depends on various things (image displayed, control with SWT.CHECK)

Returns:: The bounds of the of the text area. May return null if the underlying widget implementation doesn't provide this information
Since:: 3.4

getImageBounds

public 
Rectangle getImageBounds()

Returns the location and bounds of the area where the image is drawn

Returns:: The bounds of the of the image area. May return null if the underlying widget implementation doesn't provide this information
Since:: 3.4

getForeground

public 
Color getForeground()

Gets the foreground color of the cell.

Returns:: the foreground of the cell or null for the default foreground
Since:: 3.4

getBackground

public 
Color getBackground()

Gets the background color of the cell.

Returns:: the background of the cell or null for the default background
Since:: 3.4

getFont

public 
Font getFont()

Gets the font of the cell.

Returns:: the font of the cell or null for the default font
Since:: 3.4

hashCode

public int hashCode()

Overrides:: hashCode in class Object

equals

public boolean equals(
Object obj)

Overrides:: equals in class Object

scrollIntoView

public boolean scrollIntoView()

Scroll the cell into view

Returns:: true if the cell was scrolled into view
Since:: 3.5