org.vishia.gral.widget

Class GralFileProperties

java.lang.Object

org.vishia.gral.base.GralWidgetBase

org.vishia.gral.widget.GralFileProperties

All Implemented Interfaces:

GralWidgetBase_ifc

public class GralFileProperties
extends GralWidgetBase

This comprehensive widget contains all to show and change properties of a File given as FileRemote.

Nested Class Summary

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) FileRemote	actDir The file given on showFileInfos(FileRemote, GralFileSelector).
(package private) FileRemote	actFile The file given on showFileInfos(FileRemote, GralFileSelector).
(package private) GralUserAction	actionBtnCntLen Action for Key F2 for view command.
(package private) GralUserAction	actionButton Action for all buttons of 'file properties' window:
(package private) GralUserAction	actionInvisible
(package private) GralUserAction	actionRefresh This action is called after changing the file.
(package private) GralUserAction	actionsetNameToRenameCopy
(package private) boolean	bUnixSystem True if it is a unix system.
(package private) java.lang.String	buttonFilePropsAbort
(package private) java.lang.String	buttonFilePropsChanging
(package private) java.lang.String	buttonFilePropsChg
(package private) java.lang.String	buttonFilePropsChgRecurisve
(package private) java.lang.String	buttonFilePropsCntLen
(package private) java.lang.String	buttonFilePropsCopy
(package private) java.lang.String	buttonFilePropsCopying
(package private) java.lang.String	buttonFilePropsGetAll
(package private) java.lang.String	buttonFilePropsOk
(package private) java.lang.String	buttonFilePropsRetry
(package private) FileRemoteProgressEventConsumer	callbackChgProps
(package private) FileRemoteProgressEventConsumer	callbackCntLen
(package private) FileRemoteProgressEventConsumer	callbackCopyMove Callback this in the execution thread of the file system.
(package private) GralColor	colorChanged
(package private) GralColor	colorGrayed
(package private) GralColor	colorProgress
(package private) GralColor	colorUnchanged
(package private) GralColor	colorWrong
(package private) EventSource	evSrc
(package private) GralFileSelector	fileSelector The fileSelector given on showFileInfos(FileRemote, GralFileSelector).
(package private) java.text.DateFormat	formatDate
(package private) boolean	isVisible True then the window is opened.
(package private) int	nFlagsOriginal The flags how written on #showFileInfos(FileRemote) It is compared with maybe changed content in the widgRd etc..
(package private) GralPanelContent	panel
(package private) static java.lang.String	sCmdAbort
(package private) static java.lang.String	sCmdChg
(package private) static java.lang.String	sCmdChgRecurs
(package private) static java.lang.String	sCmdCopy
(package private) static java.lang.String	sCmdQuit
(package private) java.lang.String	sDateOriginal The time stamp string how written on #showFileInfos(FileRemote) It is compared with maybe changed content in the widgDate.
(package private) java.lang.String	sHidden
(package private) java.lang.String	sNameNew
(package private) java.lang.String	sNonHidden
(package private) java.lang.String	sNonSubdir
(package private) java.lang.String	sRdOnly
(package private) java.lang.String	sSubdir
(package private) java.lang.String	sWidgCallbackTextNok This text should be set after action to widgBtnCallback.
(package private) java.lang.String	sWidgCallbackTextOk This text should be set after action to widgBtnCallback.
(package private) java.lang.String	sWrAble
static java.lang.String	version Version, history and license.
(package private) GralButton	widgBtnCallback This button is changed on start of an file action.
(package private) GralButton	widgChgFile Action button.
(package private) GralButton	widgChgRecurs Action button.
(package private) GralButton	widgCopyFile Action button.
(package private) GralButton	widgCreateDirFile Action button.
(package private) GralTextField	widgDate
(package private) GralButton	widgDelFile Action button.
(package private) GralTextField	widgDir
(package private) GralButton	widgDirectory
(package private) GralButton	widGetAllProps Action button.
(package private) GralButton[]	widgEx
(package private) GralButton	widgGID
(package private) GralButton	widgHidden
(package private) GralTextField	widgLength
(package private) GralTextField	widgLink
(package private) GralTextField	widgName
(package private) GralTextField	widgNameNew
(package private) GralButton[]	widgRd
(package private) GralButton	widgRename Action button.
(package private) GralButton	widgSticky
(package private) GralButton	widgUID
(package private) GralButton[]	widgWr
(package private) GralWindow_ifc	windFileProps

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

_cdata, _wdgPos, bVisibleState, gralMng, name, pixSize, sVersion

Constructor Summary

Constructors

Constructor and Description
GralFileProperties(GralPos refPos, java.lang.String sPosName, GralWindow wind) Ctor either with a given new window or to create a Panel

Method Summary

Modifier and Type	Method and Description
boolean	createImplWidget_Gthread() This operation is called to create the implementation widget appearance.
static GralFileProperties	createWindow(GralPos refPosP, java.lang.String sPosName, java.lang.String sTitle) Builds the content of the file property window.
(package private) boolean	doActionButtons(GralWidget btn)
GralWidgetBase_ifc	getFocusedWidget() Returns the widget which is in focus of a panel or comprehensive widget.
boolean	isInFocus() Returns true if this widget is the focused one.
boolean	isVisible() Returns whether the widget is visible or not.
(package private) void	openDialog(FileRemote src, GralFileSelector fileSelector) Opens the view window and fills its content.
void	removeImplWidget_Gthread() Removes the implementation widget, maybe to re-create with changed properties or also if the GralWidget itself should be removed.
void	setActionRefresh(GralUserAction actionRefresh)
void	setFocus() Sets the focus to the widget. .
void	setFocus(int delay, int latest)
void	setFocusedWidget(GralWidgetBase_ifc widg) If this widget is a comprehensive widget or a panel, it sets one of the content as focused.
(package private) void	setRename()
boolean	setVisible(boolean visible) Sets this widget visible on graphic or invisible.
void	showFileInfos(FileRemote src, GralFileSelector fileSelector) This can be called from outside to show the properties of the given file.

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

checkImplWidgetCreation, createImplWidget, getImplAccess, getName, gralMng, hasFocus, pos, remove, resizePostPreparation, setFocused, 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 java.lang.String version

Version, history and license.

• 2023-01-30 some enhancements, in progress
• 2023-01-15 Now it is an independent common usable class especially for GralFileSelector
• 2011 Hartmut created with The.file.Commander

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 is 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 doesn'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 intent to use this source without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

colorChanged

GralColor colorChanged

colorProgress

GralColor colorProgress

colorUnchanged

GralColor colorUnchanged

colorWrong

GralColor colorWrong

colorGrayed

GralColor colorGrayed

buttonFilePropsChg

final java.lang.String buttonFilePropsChg

See Also:

Constant Field Values

buttonFilePropsChanging

final java.lang.String buttonFilePropsChanging

See Also:

Constant Field Values

buttonFilePropsCopying

final java.lang.String buttonFilePropsCopying

See Also:

Constant Field Values

buttonFilePropsRetry

final java.lang.String buttonFilePropsRetry

See Also:

Constant Field Values

buttonFilePropsAbort

final java.lang.String buttonFilePropsAbort

See Also:

Constant Field Values

buttonFilePropsOk

final java.lang.String buttonFilePropsOk

See Also:

Constant Field Values

buttonFilePropsCopy

final java.lang.String buttonFilePropsCopy

See Also:

Constant Field Values

buttonFilePropsChgRecurisve

final java.lang.String buttonFilePropsChgRecurisve

See Also:

Constant Field Values

buttonFilePropsGetAll

final java.lang.String buttonFilePropsGetAll

See Also:

Constant Field Values

buttonFilePropsCntLen

final java.lang.String buttonFilePropsCntLen

See Also:

Constant Field Values

windFileProps

final GralWindow_ifc windFileProps

panel

final GralPanelContent panel

widgName

final GralTextField widgName

widgNameNew

final GralTextField widgNameNew

widgDir

final GralTextField widgDir

widgLink

final GralTextField widgLink

widgDate

final GralTextField widgDate

widgLength

final GralTextField widgLength

widgRd

final GralButton[] widgRd

widgWr

final GralButton[] widgWr

widgEx

final GralButton[] widgEx

widgUID

final GralButton widgUID

widgGID

final GralButton widgGID

widgSticky

final GralButton widgSticky

widgHidden

final GralButton widgHidden

widgDirectory

final GralButton widgDirectory

widGetAllProps

final GralButton widGetAllProps

Action button.

widgChgRecurs

final GralButton widgChgRecurs

Action button.

widgChgFile

final GralButton widgChgFile

Action button.

widgCopyFile

final GralButton widgCopyFile

Action button.

widgDelFile

final GralButton widgDelFile

Action button.

widgRename

final GralButton widgRename

Action button.

widgCreateDirFile

final GralButton widgCreateDirFile

Action button.

widgBtnCallback

GralButton widgBtnCallback

This button is changed on start of an file action. On callback set the callback info.

sWidgCallbackTextOk

java.lang.String sWidgCallbackTextOk

This text should be set after action to widgBtnCallback.

sWidgCallbackTextNok

java.lang.String sWidgCallbackTextNok

This text should be set after action to widgBtnCallback.

actionRefresh

GralUserAction actionRefresh

This action is called after changing the file. See setActionRefresh(GralUserAction).

formatDate

java.text.DateFormat formatDate

sWrAble

final java.lang.String sWrAble

See Also:

Constant Field Values

sRdOnly

final java.lang.String sRdOnly

See Also:

Constant Field Values

sHidden

final java.lang.String sHidden

See Also:

Constant Field Values

sNonHidden

final java.lang.String sNonHidden

See Also:

Constant Field Values

sSubdir

final java.lang.String sSubdir

See Also:

Constant Field Values

sNonSubdir

final java.lang.String sNonSubdir

See Also:

Constant Field Values

sCmdChg

static final java.lang.String sCmdChg

See Also:

Constant Field Values

sCmdCopy

static final java.lang.String sCmdCopy

See Also:

Constant Field Values

sCmdChgRecurs

static final java.lang.String sCmdChgRecurs

See Also:

Constant Field Values

sCmdQuit

static final java.lang.String sCmdQuit

See Also:

Constant Field Values

sCmdAbort

static final java.lang.String sCmdAbort

See Also:

Constant Field Values

bUnixSystem

boolean bUnixSystem

True if it is a unix system. It checks the "OS" environment variable.

isVisible

boolean isVisible

True then the window is opened. Write acutal file into.

sNameNew

java.lang.String sNameNew

sDateOriginal

java.lang.String sDateOriginal

The time stamp string how written on #showFileInfos(FileRemote) It is compared with maybe changed content in the widgDate. Only if the content is changed, a new time stamp will be set.

nFlagsOriginal

int nFlagsOriginal

The flags how written on #showFileInfos(FileRemote) It is compared with maybe changed content in the widgRd etc.. Only if the buttons are changed, a new time stamp will be set.

actFile

FileRemote actFile

The file given on showFileInfos(FileRemote, GralFileSelector).

actDir

FileRemote actDir

The file given on showFileInfos(FileRemote, GralFileSelector).

fileSelector

GralFileSelector fileSelector

The fileSelector given on showFileInfos(FileRemote, GralFileSelector). used for refresh.

evSrc

EventSource evSrc

actionButton

GralUserAction actionButton

Action for all buttons of 'file properties' window:

actionInvisible

GralUserAction actionInvisible

callbackChgProps

FileRemoteProgressEventConsumer callbackChgProps

actionBtnCntLen

GralUserAction actionBtnCntLen

Action for Key F2 for view command.

callbackCntLen

final FileRemoteProgressEventConsumer callbackCntLen

callbackCopyMove

final FileRemoteProgressEventConsumer callbackCopyMove

Callback this in the execution thread of the file system.

actionsetNameToRenameCopy

final GralUserAction actionsetNameToRenameCopy

Constructor Detail

GralFileProperties

public GralFileProperties(GralPos refPos,
                          java.lang.String sPosName,
                          GralWindow wind)

Ctor either with a given new window or to create a Panel

Parameters:

refPos - If wind is given, it is the refPos related to the wind.mainPanel, elsewhere a reference for given sPosName in a panel to create a sub panel.

sPosName - if wind is given, the name of its mainPanel, else maybe with position String

wind - null, then a new Panel for this content will be created.

Method Detail

createWindow

public static GralFileProperties createWindow(GralPos refPosP,
                                              java.lang.String sPosName,
                                              java.lang.String sTitle)

Builds the content of the file property window.

Parameters:

refPosP - a position related to the position of the window. It won't be changed.

sPosName - position of the window, maybe relative to given refPosP

sTitle - of the window

setActionRefresh

public void setActionRefresh(GralUserAction actionRefresh)

openDialog

void openDialog(FileRemote src,
                GralFileSelector fileSelector)

Opens the view window and fills its content.

Parameters:

src - The path which is selected as source. It may be a directory or a file.

showFileInfos

public void showFileInfos(FileRemote src,
                          GralFileSelector fileSelector)

This can be called from outside to show the properties of the given file. No access to the file system is done, all properties are gotten from the FileRemote instance.

Parameters:

src - the file

setRename

void setRename()

doActionButtons

boolean doActionButtons(GralWidget btn)

setFocus

public void setFocus()

Description copied from interface: GralWidgetBase_ifc

Sets the focus to the widget. . It can be called in any thread. If it is called in the graphic thread, the repaint action is executed immediately in the thread. Elsewhere the graphic thread will be woken up.

setFocus

public void setFocus(int delay,
                     int latest)

isInFocus

public boolean isInFocus()

Description copied from interface: GralWidgetBase_ifc

Returns true if this widget is the focused one.

isVisible

public boolean isVisible()

Description copied from interface: GralWidgetBase_ifc

Returns whether the widget is visible or not. This method can be invoked in any thread. It is an estimation because the state of the widget may be changed in the last time or a window can be covered by another one. The widget is not visible if it is a member of a card in a tabbed panel and that tab is not the selected one.

Specified by:

isVisible in interface GralWidgetBase_ifc

Overrides:

isVisible in class GralWidgetBase

Returns:

true if the widget seams to be visible.

setFocusedWidget

public void setFocusedWidget(GralWidgetBase_ifc widg)

Description copied from interface: GralWidgetBase_ifc

If this widget is a comprehensive widget or a panel, it sets one of the content as focused.

Parameters:

widg - The sub widget which should be focused. It influences for example the current tab of a tabbed panel, or influences which widget of a comprehensive widget is first focused. On a panel it determines which widget should get the focus if the panel gets the focus.

getFocusedWidget

public GralWidgetBase_ifc getFocusedWidget()

Description copied from interface: GralWidgetBase_ifc

Returns the widget which is in focus of a panel or comprehensive widget. This allows quests about the status of the widget, for example the opened tab on a tabbed panel of which is in use currently from a comprehensive widget.

setVisible

public boolean setVisible(boolean visible)

Description copied from interface: GralWidgetBase_ifc

Sets this widget visible on graphic or invisible. Any widget can be visible or not. More as one widgets can use the same position, only one of them may set visible. For a GralWindow, its the visibility of the whole window. Note that a window which is invisible is not shown in the task bar of the operation system. Note that an application can have more as one window. Note that a dialog window can be set to invisible if it is not need yet instead destroy and build newly.

Specified by:

setVisible in interface GralWidgetBase_ifc

Specified by:

setVisible in class GralWidgetBase

Returns:

createImplWidget_Gthread

public boolean createImplWidget_Gthread()
                                 throws java.lang.IllegalStateException

Description copied from class: GralWidgetBase

This operation is called to create the implementation widget appearance. If is either overridden in the specific widget implemented in the GralWidget by the default behavior. Or it should be overridden in instances which are not derived from GralWidget itself, on instances of comprehensive widgets. This implementation is only called in GralWidget.createImplWidget_Gthread() for composite widgets.

Overrides:

createImplWidget_Gthread in class GralWidgetBase

Returns:

true if created.

Throws:

java.lang.IllegalStateException - if called though the GralMng is not implemented.

removeImplWidget_Gthread

public void removeImplWidget_Gthread()

Description copied from class: GralWidgetBase

Removes the implementation widget, maybe to re-create with changed properties or also if the GralWidget itself should be removed. This is a internal operation not intent to use by an application. It is called from the GralMng.runGraphicThread() and hence package private.

Overrides:

removeImplWidget_Gthread in class GralWidgetBase