Module org.autogui

Package org.autogui.swing

Class GuiSwingViewFilePathField.PropertyFilePathPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

org.autogui.swing.util.SearchTextField

org.autogui.swing.util.SearchTextFieldFilePath

org.autogui.swing.GuiSwingViewFilePathField.PropertyFilePathPane

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, GuiMappingContext.SourceUpdateListener, GuiSwingView.ValuePane<Object>

Direct Known Subclasses:

GuiSwingTableColumnFilePath.ColumnEditFilePathPane, LambdaProperty.LambdaFilePathPane

Enclosing class:

GuiSwingViewFilePathField

public static class GuiSwingViewFilePathField.PropertyFilePathPane
extends SearchTextFieldFilePath
implements GuiMappingContext.SourceUpdateListener, GuiSwingView.ValuePane<Object>

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.autogui.swing.util.SearchTextFieldFilePath

SearchTextFieldFilePath.DesktopOpenAction, SearchTextFieldFilePath.DesktopRevealAction, SearchTextFieldFilePath.FileClearAction, SearchTextFieldFilePath.FileCopyAllAction, SearchTextFieldFilePath.FileInfoItem, SearchTextFieldFilePath.FileItem, SearchTextFieldFilePath.FileItemWithKey, SearchTextFieldFilePath.FileListAction, SearchTextFieldFilePath.FileListEditAction, SearchTextFieldFilePath.FilePasteAction, SearchTextFieldFilePath.FileSelection, SearchTextFieldFilePath.FileTransferHandler, SearchTextFieldFilePath.IconWrapper, SearchTextFieldFilePath.OpenDialogAction, SearchTextFieldFilePath.SearchTextFieldModelFilePath

Nested classes/interfaces inherited from class org.autogui.swing.util.SearchTextField

SearchTextField.DynamicItemAction, SearchTextField.SearchBackgroundPainter, SearchTextField.SearchBackgroundPainterBordered, SearchTextField.SearchedItemsListener, SearchTextField.SearchTask, SearchTextField.SearchTextFieldModel, SearchTextField.SearchTextFieldModelEmpty, SearchTextField.SearchTextFieldPublisher, SearchTextField.SearchTextFieldPublisherEmpty

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
protected GuiMappingContext	context
protected boolean	currentValueSupported
protected List<Runnable>	editFinishHandlers
protected MenuBuilder.MenuLabel	infoLabel
protected List<PopupCategorized.CategorizedMenuItem>	menuItems
protected GuiSwingView.SpecifierManager	specifierManager
protected GuiTaskClock	viewClock

Fields inherited from class org.autogui.swing.util.SearchTextFieldFilePath

MENU_CATEGORY_FILE_CANDIDATE, MENU_CATEGORY_FILE_CHILD, MENU_CATEGORY_FILE_CURRENT, MENU_CATEGORY_FILE_DEFAULT, MENU_CATEGORY_FILE_PARENT, MENU_CATEGORY_FILE_SIBLING

Fields inherited from class org.autogui.swing.util.SearchTextField

backgroundPainter, buttonsPane, currentSearchedItems, currentTask, editingRunner, emptyIcon, field, icon, menuItemsSource, model, popup, popupButton, searchedItemsListeners, undoManager

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
PropertyFilePathPane(GuiMappingContext context, GuiSwingView.SpecifierManager specifierManager)
PropertyFilePathPane(GuiMappingContext context, GuiSwingView.SpecifierManager specifierManager, SearchTextFieldFilePath.SearchTextFieldModelFilePath model)

Method Summary

Modifier and Type	Method	Description
void	addSwingEditFinishHandler(Runnable eventHandler)	the method is used for table cell-editors, in order to observe the completion of editing.
SearchTextFieldFilePath.FileItem	getFileItemFromValue(Object value)
Supplier<List<PopupCategorized.CategorizedMenuItem>>	getMenuItems()
List<Object>	getMenuItemsSource()
GuiReprValue.ObjectSpecifier	getSpecifier()
PopupExtension.PopupMenuBuilder	getSwingMenuBuilder()	a typical implementation if there are no dynamic items becomes like the following code:
List<PopupCategorized.CategorizedMenuItem>	getSwingStaticMenuItems()	a typical implementation becomes like the following code:
GuiMappingContext	getSwingViewContext()
Object	getSwingViewValue()
void	init()
void	initContextUpdate()
void	initEditable()
void	initLazy()
void	initName()
void	initPopup()
void	initValue()
boolean	isSwingCurrentValueSupported()
void	prepareForRefresh()	for each component, the method is called before refreshing in order to clear the view-clock.
void	requestSwingViewFocus()
void	selectSearchedItemFromGui(PopupCategorized.CategorizedMenuItem item)	update property: the user selects the item from the menu, and then update the target property
void	selectSearchedItemFromModel(PopupCategorized.CategorizedMenuItem item)	update property: search done, and then the matched item will be set to the target property
void	selectSearchedItemWithoutUpdateContext(PopupCategorized.CategorizedMenuItem item)	no property update
void	setCurrentValueSupported(boolean currentValueSupported)
void	setKeyStrokeString(String keyStrokeString)	set the key-stroke info.
void	setSwingViewValue(Object value)	update GUI display, and it does NOT update the target model value.
void	setSwingViewValue(Object value, GuiTaskClock clock)	update if the clock is newer than the current view-clock of the pane.
void	setSwingViewValueWithUpdate(Object value)	update the GUI display and the model.
void	setSwingViewValueWithUpdate(Object value, GuiTaskClock clock)	update the GUI display and the model if the clock is newer than the current view-clock of the pane.
void	shutdownSwingView()	for each component, at the end of the process, this method will be called
void	update(GuiMappingContext cause, Object newValue, GuiTaskClock contextClock)
void	updateFieldInEvent(boolean modified, boolean immediate)	executed under event thread: start a new search task in background
void	updateFieldInEventWithoutEditFinish()
void	updateFromGui(Object value, GuiTaskClock viewClock)

Methods inherited from class org.autogui.swing.util.SearchTextFieldFilePath

formatFileSize, getFile, getFileItem, initTransferHandler, isUpdateFieldModifiedEvent, setFile, setTextFromSearchedItem, toFileNameString, toPathString

Methods inherited from class org.autogui.swing.util.SearchTextField

add, addSearchItemsListener, convertIcon, createSearchTask, doActionButtons, getButtonsPane, getCurrentTask, getDynamicItemAction, getEditingRunner, getEditingRunnerDelay, getEmptyIcon, getField, getFocusColor, getIcon, getModel, getPopup, getPopupButton, getPopupUpdateListener, getSearchedItems, getSearchedItemsListeners, initAfter, initBackgroundPainter, initField, initIcon, initLayout, initLayoutButtons, initLayoutButtonsPane, initPopupCategorized, isSwingEditable, isUpdateFieldImmediateEvent, isUpdateFieldImmediateEvent, isUpdateFieldModifiedEvents, paintComponent, removeSearchItemsListener, setBackground, setBackgroundWithoutInit, setCurrentSearchedItems, setCurrentSearchedItems, setIconFromSearchedItem, setTextWithoutUpdateField, setToolTipText, setTransferHandlerWithSettingExportingDragSource, setupCopyAndPaste, shutdown, updateField

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUI, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.autogui.swing.GuiSwingView.ValuePane

asSwingViewComponent, executeContextTask, getActionByContext, getActionByName, getChildByName, getDescendantActionByContext, getDescendantByContext, getDescendantByValue, getDescendantByValueIf, getPrefsJsonSupported, getSwingFocusKeyStroke, isSwingEditable, loadSwingPreferences, loadSwingPreferences, refreshByContext, saveSwingPreferences, setPrefsJsonSupported, setSwingViewHistoryValue, setSwingViewValueForTable, updateSwingViewSource, updateSwingViewSourceFromRoot, wrapSwingNamed, wrapSwingPane, wrapSwingProperty, wrapSwingScrollPane

Field Details

context

protected GuiMappingContext context

specifierManager

protected GuiSwingView.SpecifierManager specifierManager

menuItems

protected List<PopupCategorized.CategorizedMenuItem> menuItems

infoLabel

protected MenuBuilder.MenuLabel infoLabel

viewClock

protected GuiTaskClock viewClock

currentValueSupported

protected boolean currentValueSupported

editFinishHandlers

protected List<Runnable> editFinishHandlers

Constructor Details

PropertyFilePathPane

public PropertyFilePathPane(GuiMappingContext context,
 GuiSwingView.SpecifierManager specifierManager)

PropertyFilePathPane

public PropertyFilePathPane(GuiMappingContext context,
 GuiSwingView.SpecifierManager specifierManager,
 SearchTextFieldFilePath.SearchTextFieldModelFilePath model)

Method Details

init

public void init()

Overrides:

init in class SearchTextFieldFilePath

initLazy

public void initLazy()

initPopup

public void initPopup()

Overrides:

initPopup in class SearchTextFieldFilePath

initName

public void initName()

initEditable

public void initEditable()

initContextUpdate

public void initContextUpdate()

initValue

public void initValue()

isSwingCurrentValueSupported

public boolean isSwingCurrentValueSupported()

Specified by:

isSwingCurrentValueSupported in interface GuiSwingView.ValuePane<Object>

setCurrentValueSupported

public void setCurrentValueSupported(boolean currentValueSupported)

getMenuItems

public Supplier<List<PopupCategorized.CategorizedMenuItem>> getMenuItems()

Overrides:

getMenuItems in class SearchTextField

getSwingStaticMenuItems

public List<PopupCategorized.CategorizedMenuItem> getSwingStaticMenuItems()

Description copied from interface: GuiSwingView.ValuePane

a typical implementation becomes like the following code:

      if (menuItems == null) { menuItems = PopupCategorized.getMenuItems(actions, menus); }
      return menuItems;
  

the method returns original menu items for the pane. so, if a wrapper pane has a wrapped sub-pane added as a child component, it should not include items of the wrapped sub-pane.

Specified by:

getSwingStaticMenuItems in interface GuiSwingView.ValuePane<Object>

Returns:

a list of actions (or menu-components) statically determined, that should be always same instances

getSwingMenuBuilder

public PopupExtension.PopupMenuBuilder getSwingMenuBuilder()

Description copied from interface: GuiSwingView.ValuePane

a typical implementation if there are no dynamic items becomes like the following code:

     if (popup == null) { popup = new PopupExtension(this,
                                    new PopupCategorized(this::getSwingStaticMenuItems)); }
     return popup.getMenuBuilder();
 

Specified by:

getSwingMenuBuilder in interface GuiSwingView.ValuePane<Object>

Returns:

a menu builder

getMenuItemsSource

public List<Object> getMenuItemsSource()

Overrides:

getMenuItemsSource in class SearchTextFieldFilePath

Returns:

list of menu items including Action or JComponent

selectSearchedItemFromGui

public void selectSearchedItemFromGui(PopupCategorized.CategorizedMenuItem item)

update property: the user selects the item from the menu, and then update the target property

Overrides:

selectSearchedItemFromGui in class SearchTextField

Parameters:

item - the selected item

selectSearchedItemFromModel

public void selectSearchedItemFromModel(PopupCategorized.CategorizedMenuItem item)

update property: search done, and then the matched item will be set to the target property

Overrides:

selectSearchedItemFromModel in class SearchTextField

Parameters:

item - the selected item by the model

updateFromGui

public void updateFromGui(Object value,
 GuiTaskClock viewClock)

selectSearchedItemWithoutUpdateContext

public void selectSearchedItemWithoutUpdateContext(PopupCategorized.CategorizedMenuItem item)

no property update

Parameters:

item - the selected item

update

public void update(GuiMappingContext cause,
 Object newValue,
 GuiTaskClock contextClock)

Specified by:

update in interface GuiMappingContext.SourceUpdateListener

updateFieldInEvent

public void updateFieldInEvent(boolean modified,
 boolean immediate)

Description copied from class: SearchTextField

executed under event thread: start a new search task in background

Overrides:

updateFieldInEvent in class SearchTextField

Parameters:

modified - true if the field is actually edited

immediate - if true, a background task will not be created even if the model supports it

updateFieldInEventWithoutEditFinish

public void updateFieldInEventWithoutEditFinish()

getSwingViewValue

public Object getSwingViewValue()

Specified by:

getSwingViewValue in interface GuiSwingView.ValuePane<Object>

Returns:

basically, the source value of the context, held by the component without touching the context.

setSwingViewValue

public void setSwingViewValue(Object value)

Description copied from interface: GuiSwingView.ValuePane

update GUI display, and it does NOT update the target model value. processed under the event thread. also increment the view-clock.

Specified by:

setSwingViewValue in interface GuiSwingView.ValuePane<Object>

Parameters:

value - the new value

getFileItemFromValue

public SearchTextFieldFilePath.FileItem getFileItemFromValue(Object value)

setSwingViewValueWithUpdate

public void setSwingViewValueWithUpdate(Object value)

Description copied from interface: GuiSwingView.ValuePane

update the GUI display and the model. processed under the event thread. also increment the view-clock

Specified by:

setSwingViewValueWithUpdate in interface GuiSwingView.ValuePane<Object>

Parameters:

value - the new value

setSwingViewValue

public void setSwingViewValue(Object value,
 GuiTaskClock clock)

Description copied from interface: GuiSwingView.ValuePane

update if the clock is newer than the current view-clock of the pane. the view-clock becomes the given clock. Note: instead, GuiSwingView.ValuePane.setSwingViewValue(Object) increments the current clock

Specified by:

setSwingViewValue in interface GuiSwingView.ValuePane<Object>

Parameters:

value - the new value

clock - the clock of the value: if the clock is newer than the current view-clock of the pane, it can update

setSwingViewValueWithUpdate

public void setSwingViewValueWithUpdate(Object value,
 GuiTaskClock clock)

Description copied from interface: GuiSwingView.ValuePane

update the GUI display and the model if the clock is newer than the current view-clock of the pane. the view-clock becomes the given clock.

Specified by:

setSwingViewValueWithUpdate in interface GuiSwingView.ValuePane<Object>

Parameters:

value - the new value

clock - the clock of the value

addSwingEditFinishHandler

public void addSwingEditFinishHandler(Runnable eventHandler)

Description copied from interface: GuiSwingView.ValuePane

the method is used for table cell-editors, in order to observe the completion of editing. the default impl. is empty.

Specified by:

addSwingEditFinishHandler in interface GuiSwingView.ValuePane<Object>

Parameters:

eventHandler - the handler called when the editing is finished

getSwingViewContext

public GuiMappingContext getSwingViewContext()

Specified by:

getSwingViewContext in interface GuiSwingView.ValuePane<Object>

shutdownSwingView

public void shutdownSwingView()

Description copied from interface: GuiSwingView.ValuePane

for each component, at the end of the process, this method will be called

Specified by:

shutdownSwingView in interface GuiSwingView.ValuePane<Object>

getSpecifier

public GuiReprValue.ObjectSpecifier getSpecifier()

Specified by:

getSpecifier in interface GuiSwingView.ValuePane<Object>

Returns:

the specifier for the context value, typically obtained from GuiSwingView.SpecifierManager

requestSwingViewFocus

public void requestSwingViewFocus()

Specified by:

requestSwingViewFocus in interface GuiSwingView.ValuePane<Object>

setKeyStrokeString

public void setKeyStrokeString(String keyStrokeString)

Description copied from interface: GuiSwingView.ValuePane

set the key-stroke info. to the pane as a guide

Specified by:

setKeyStrokeString in interface GuiSwingView.ValuePane<Object>

Parameters:

keyStrokeString - the key stroke info to be set.

prepareForRefresh

public void prepareForRefresh()

Description copied from interface: GuiSwingView.ValuePane

for each component, the method is called before refreshing in order to clear the view-clock.

Specified by:

prepareForRefresh in interface GuiSwingView.ValuePane<Object>