Class FileFieldEditor


public class FileFieldEditor extends StringButtonFieldEditor
A field editor for a file path type preference. A standard file dialog appears when the user presses the change button.
  • Constructor Details

    • FileFieldEditor

      protected FileFieldEditor()
      Creates a new file field editor
    • FileFieldEditor

      public FileFieldEditor(String name, String labelText, Composite parent)
      Creates a file field editor.
      Parameters:
      name - the name of the preference this field editor works on
      labelText - the label text of the field editor
      parent - the parent of the field editor's control
    • FileFieldEditor

      public FileFieldEditor(String name, String labelText, boolean enforceAbsolute, Composite parent)
      Creates a file field editor.
      Parameters:
      name - the name of the preference this field editor works on
      labelText - the label text of the field editor
      enforceAbsolute - true if the file path must be absolute, and false otherwise
      parent - the parent of the field editor's control
    • FileFieldEditor

      public FileFieldEditor(String name, String labelText, boolean enforceAbsolute, int validationStrategy, Composite parent)
      Creates a file field editor.
      Parameters:
      name - the name of the preference this field editor works on
      labelText - the label text of the field editor
      enforceAbsolute - true if the file path must be absolute, and false otherwise
      validationStrategy - either StringFieldEditor.VALIDATE_ON_KEY_STROKE to perform on the fly checking, or StringFieldEditor.VALIDATE_ON_FOCUS_LOST (the default) to perform validation only after the text has been typed in
      parent - the parent of the field editor's control.
      Since:
      3.4
      See Also:
  • Method Details

    • changePressed

      protected String changePressed()
      Description copied from class: StringButtonFieldEditor
      Notifies that this field editor's change button has been pressed.

      Subclasses must implement this method to provide a corresponding new string for the text field. If the returned value is null, the currently displayed value remains.

      Specified by:
      changePressed in class StringButtonFieldEditor
      Returns:
      the new string to display, or null to leave the old string showing
    • checkState

      protected boolean checkState()
      Description copied from class: StringFieldEditor
      Checks whether the text input field contains a valid value or not.
      Overrides:
      checkState in class StringFieldEditor
      Returns:
      true if the field value is valid, and false if invalid
    • setFileExtensions

      public void setFileExtensions(String[] extensions)
      Sets this file field editor's file extension filter.
      Parameters:
      extensions - a list of file extension, or null to set the filter to the system's default value
    • setFilterPath

      public void setFilterPath(File path)
      Sets the initial path for the Browse dialog.
      Parameters:
      path - initial path for the Browse dialog
      Since:
      3.6