IRowFocusListener.java
上传用户:hengxinggs
上传日期:2008-01-15
资源大小:212k
文件大小:2k
源码类别:

PlugIns编程

开发平台:

Java

  1. /*
  2.  * Copyright (C) 2005 David Orme <djo@coconut-palm-software.com>
  3.  * 
  4.  * All rights reserved. This program and the accompanying materials
  5.  * are made available under the terms of the Eclipse Public License v1.0
  6.  * which accompanies this distribution, and is available at
  7.  * http://www.eclipse.org/legal/epl-v10.html
  8.  *
  9.  * Contributors:
  10.  *     David Orme     - Initial API and implementation
  11.  */
  12. package org.eclipse.jface.examples.databinding.compositetable;
  13. import org.eclipse.swt.widgets.Control;
  14. /**
  15.  * Interface IRowFocusListener.  An interface for objects that want to listen to and have the
  16.  * possibility of vetoing row change events on a CompositeTable.
  17.  * 
  18.  * @author djo
  19.  */
  20. public interface IRowFocusListener {
  21. /**
  22.  * Method requestRowChange.  Requests permission to change rows.  This method is
  23.  * called immediately before a row change occurs.  Listeners must return true to
  24.  * grant permission for the row change to occur or return false to veto it.  If
  25.  * any listener returns false, the entire row change operation is aborted.<p>
  26.  *  
  27.  * @param sender The CompositeTable sending the event.
  28.  * @param currentObjectOffset The offset of the current object in the data structure.
  29.  * @param row The row control that is losing focus.
  30.  * @return true to permit the row change to occur; false otherwise.
  31.  */
  32. boolean requestRowChange(CompositeTable sender, int currentObjectOffset, Control row);
  33. /**
  34.  * Method depart.  Called after requstRowChange has been called to indicate that
  35.  * the focus is departing the specified row.
  36.  * 
  37.  * @param sender
  38.  * @param currentObjectOffset
  39.  * @param row
  40.  */
  41. void depart(CompositeTable sender, int currentObjectOffset, Control row);
  42. /**
  43.  * Method arrive.  Notifies receiver that the current row has just been changed.
  44.  * 
  45.  * @param sender The CompositeTable sending the event.
  46.  * @param currentObjectOffset The 0-based offset to the row that should be populated
  47.  * @param newRow The actual SWT row object that needs to be populated with data
  48.  */
  49. void arrive(CompositeTable sender, int currentObjectOffset, Control newRow);
  50. }