org.vishia.commander

Class FcmdFileCard

java.lang.Object

org.vishia.gral.base.GralWidgetBase

org.vishia.gral.widget.GralFileSelector

org.vishia.commander.FcmdFileCard

All Implemented Interfaces:

GralWidgetBase_ifc

public class FcmdFileCard
extends GralFileSelector

This is one file table in the the.File.commander. Each main panel (left, middle, right) has maybe more as one tabs, each tab has exactly one instance of this. The file table is reused for the several tabs of the main panel, and they are reused too if the directory is changed.

This class is inherited from the GralFileSelector. This allows same handling for the files, but additional handling for favors:
The #wdgFavorCard is referenced here and contains names and FcmdFavorCard.FavorPath to fill different directories to this GralFileSelector base data.

For different opened favors the #wdgCardSelector is a quasi tab to select this different favors. The opened favors are well visible hence in this widget without focus the favor card itself. But the same functionality to select favors can also be done via the FcmdFavorCard

Synchronization of 2 file cards:
If the synchronization is switch on with FcmdFavorPathSelector.bSyncMidRight then syncWithSecondPanel(String) is called with the filename. Therewith the same file in the second panel (middle or right) will be selected if it exists. If an existing directory is selected, the other file card follows it if it exists. So the user can walk through two file trees which have the same structure, but maybe some different content. It is proper for comparison.

Nested Class Summary

Nested classes/interfaces inherited from class org.vishia.gral.widget.GralFileSelector

GralFileSelector.Callbacks, GralFileSelector.Constants, GralFileSelector.FavorPath, GralFileSelector.FileSelectList, GralFileSelector.Gui, GralFileSelector.InternalData, GralFileSelector.MenuTexts, GralFileSelector.WindowConfirmSearch

Nested classes/interfaces inherited from class org.vishia.gral.base.GralWidgetBase

GralWidgetBase.GralWidgComposite, GralWidgetBase.TimeOrderCreateImplWidget

Field Summary

Fields

Modifier and Type	Field and Description
(package private) GralUserAction	actionFocused This action is bound in the File selection table.
private GralUserAction	actionOnEnterFile This action is associated to the FcmdFileCard respectively its base class GralFileSelector.setActionOnEnterFile(GralUserAction) It calls FcmdExecuter.executeFileByExtension(File).
(package private) GralUserAction	actionOnFileSelection Action to show the file properties in the info line.
(package private) GralUserAction	actionSaveFavors
(package private) GralColor[]	colorSelectFocused123 Three colors for the current line in the file card.
(package private) FcmdFavorPathSelector.FavorFolder	favorFolder Aggregation to the appropriate entry of the favors.
(package private) Fcmd	main The component
(package private) FcmdLeftMidRightPanel	mainPanel The left, mid or right main panel where this tabbed file table is associated.
(package private) java.lang.String	nameFilePanel The search-name of the tabbed file panel where this Table is placed on.
(package private) FcmdFileCard	otherFileCardtoSync If not null, then should synchronize with this file card.
(package private) java.lang.String	sDirSync If not null, then it is the base dir for synchronization with the otherFileCardtoSync.
(package private) java.lang.String	sTabSelection It is build from the #label and the #favorPathInfo.
(package private) java.lang.String	syncPartnerTabSelection If not null then the name of the own favor card and the favor card from the other panel for sync.
(package private) java.lang.String	syncTabSelection If not null then the name of the own favor card and the favor card from the other panel for sync.
static int	version Version, history and license 2023-01-14 fixed: Now from begin the current tab is green and recognized as current.
(package private) int	zDirSync length of sDirSync or -1 It will be set in FcmdFilesCp.setDirs().

Fields inherited from class org.vishia.gral.widget.GralFileSelector

contextMenuTexts, fillinEv, gui, idata, sVersion, windSearch

Fields inherited from class org.vishia.gral.base.GralWidgetBase

_cdata, _wdgPos, bVisibleState, gralMng, name, pixSize

Constructor Summary

Constructors

Constructor and Description
FcmdFileCard(GralPos refPos, FcmdLeftMidRightPanel mainPanelP, FcmdFavorPathSelector.FavorFolder favorFolder) Creates the cards with tabs for the files and for the favorite paths.

Method Summary

Modifier and Type	Method and Description
protected void	actionOnFileSelection(FileRemote file, java.lang.String sFileName) This routine is invoked from actionOnFileSelection action listener whenever a file in any file card will be selected (key up, down, mouse click etc.).
protected void	setActFilePanel_setColorCurrLine() Sets the panel which contains this File card as actual, adjust the order of actual file panels and sets the color of the current line of table of all 3 current file panels to the 3-stage color to see which table has the focus.
void	setFocused(boolean bGained) This operation can be called from the implementation graphic if the focus is gained for an implementation widget.
(package private) void	syncWithSecondPanel(java.lang.String sFileName)

Methods inherited from class org.vishia.gral.widget.GralFileSelector

actionUserKey, add, addFavor, addFavor, buildKey, checkRefresh, clear, closeDialog, createGralFileSelectorWindow, currentDir, currentFile, doActionExec, doActionGetFileName, doActionSelectFileTableFromFavor, doActivateFavor, fillFavorPaths, fillIn, fillIn, fillInCurrentDir, fillInOriginDir, forcefillIn, getCurrentDir, getCurrentDirPath, getFocusedWidget, getLabelCurrFavor, getSelectedFiles, isInFocus, isVisible, openDialog, refresh, remove, selectFile, selectFileTable, selectFileTableFromFavor, setActionOnEnterDirectory, setActionOnEnterFile, setActionOnEnterPathNewFile, setActionOnFileSelected, setActionOnFocusedFileTable, setActionOnSaveButton, setActionSaveFavors, setActionSetFileLineAttrib, setDateFormat, setFocus, setFocus, setFocusedWidget, setOriginDir, setSortOrder, setVisible, showFileInfo, updateFavorWithCurrentDir, XXXgetSelectedFile

Methods inherited from class org.vishia.gral.base.GralWidgetBase

checkImplWidgetCreation, createImplWidget_Gthread, createImplWidget, getImplAccess, getName, gralMng, hasFocus, pos, removeImplWidget_Gthread, resizePostPreparation, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

version

public static final int version

Version, history and license

• 2023-01-14 fixed: Now from begin the current tab is green and recognized as current.
• 2022-12 Most of content is now in GralFileSelector, refactoring.
• 2012-03-09 Hartmut new: Now the synchronization between 2 panels works independent of the comparison with a improved algorithm.
• 2012-02-04 Hartmut new: #searchCompareResult(File) supports working with comparison result, used to set equal if a file was copied.

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL ist not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

main

final Fcmd main

The component

mainPanel

final FcmdLeftMidRightPanel mainPanel

The left, mid or right main panel where this tabbed file table is associated.

favorFolder

final FcmdFavorPathSelector.FavorFolder favorFolder

Aggregation to the appropriate entry of the favors.

colorSelectFocused123

GralColor[] colorSelectFocused123

Three colors for the current line in the file card.

nameFilePanel

final java.lang.String nameFilePanel

The search-name of the tabbed file panel where this Table is placed on. It is the visible label of the tab, following by ".1" till ".3" for the three panels.

sTabSelection

java.lang.String sTabSelection

It is build from the #label and the #favorPathInfo. FavorPath#selectName due to the selected favor which is shown in this file table. It is used to detect the correct other sync table, see syncTabSelection

syncTabSelection

java.lang.String syncTabSelection

If not null then the name of the own favor card and the favor card from the other panel for sync.

syncPartnerTabSelection

java.lang.String syncPartnerTabSelection

If not null then the name of the own favor card and the favor card from the other panel for sync.

otherFileCardtoSync

FcmdFileCard otherFileCardtoSync

If not null, then should synchronize with this file card. Used in

sDirSync

java.lang.String sDirSync

If not null, then it is the base dir for synchronization with the otherFileCardtoSync. It will be set in FcmdFilesCp.setDirs().

zDirSync

int zDirSync

length of sDirSync or -1 It will be set in FcmdFilesCp.setDirs().

actionOnFileSelection

GralUserAction actionOnFileSelection

Action to show the file properties in the info line. This action is called anytime if a line was changed in the file view table.

actionFocused

GralUserAction actionFocused

This action is bound in the File selection table. If it is focused, the current file tables of the other file panels will gotten the #colorSelectNonFocused to show that are not the first one. The file table of this is set with the #colorSelectFocused. Twice the Fcmd.lastFilePanels list is ordered with this panel as first one.

actionOnEnterFile

private GralUserAction actionOnEnterFile

This action is associated to the FcmdFileCard respectively its base class GralFileSelector.setActionOnEnterFile(GralUserAction) It calls FcmdExecuter.executeFileByExtension(File).

actionSaveFavors

GralUserAction actionSaveFavors

Constructor Detail

FcmdFileCard

FcmdFileCard(GralPos refPos,
             FcmdLeftMidRightPanel mainPanelP,
             FcmdFavorPathSelector.FavorFolder favorFolder)

Creates the cards with tabs for the files and for the favorite paths. This ctor will be called in the graphic thread. Therefore it can initialize the graphic for the fileCard and for the associated favor card in this code.

Parameters:

mainPanelP - The left, mid or right panel where this cards are assigned to

label - The label of the tab, it builds the name of all widgets.

Method Detail

actionOnFileSelection

protected void actionOnFileSelection(FileRemote file,
                                     java.lang.String sFileName)

This routine is invoked from actionOnFileSelection action listener whenever a file in any file card will be selected (key up, down, mouse click etc.). The routine writes infos about the file and may synchronize with another file card.

Parameters:

file - The currently selected file.

sFileName - Text in the cell, especially ".." for the parent dir entry.

syncWithSecondPanel

void syncWithSecondPanel(java.lang.String sFileName)

setFocused

public void setFocused(boolean bGained)

This operation can be called from the implementation graphic if the focus is gained for an implementation widget. It is also called for all parents of a widget if a child gets the focus. The specific widget implementation can override this operation to do specifics. It should call super.focused(bGained) to forward the focus to parents.

Specified by:

setFocused in interface GralWidgetBase_ifc

Overrides:

setFocused in class GralWidgetBase

Parameters:

bGained -

setActFilePanel_setColorCurrLine

protected void setActFilePanel_setColorCurrLine()

Sets the panel which contains this File card as actual, adjust the order of actual file panels and sets the color of the current line of table of all 3 current file panels to the 3-stage color to see which table has the focus. Sets Fcmd#lastFavorCard, FcmdLeftMidRightPanel.actFileCard, Fcmd.lastFilePanels.