| Purpose: | Browse directories and files. |
| Format: | XDIR [ranges] [options] [file...] |
| ranges | one or more ranges |
| options | one or more file selection or report format options |
| file | The file, directory, or list of files or directories to display. |
command dialog |
suppress header |
||
Trailing \ for directories |
Lower case |
||
Mark 32-bit modules |
suppress footer |
||
Attribute select |
/N[desfhjlmvz] |
New format or disable options |
|
show Compression |
Order |
||
Disable color coding |
Pause |
||
upper case |
show owner |
||
Full path |
show aTtributes |
||
/G[:n] |
allocated size |
time type |
|
Hide dots |
show summary information |
||
/I"text" |
description range |
show short names |
|
Justify names |
use FAT format |
Usage:
XDIR is a combination of DIR, CDD, and a mini file manager. It displays a formatted list of directories / files with the desired fields (i.e., date / time, size, attributes, etc.) in a listbox that you can scroll through and perform various actions, including changing directories, viewing files, creating, renaming, or deleting files / directories, etc.
The top of the XDIR window will start at the current cursor location or row 9, whichever is less. If the current location is > line 9, TCC will scroll the display to put the cursor at line 9 and then show the XDIR window.
The XDIR caption shows the current directory / filename on the left, and toolbar below the caption shows a search edit control with two buttons for searching down and searching up.
If you have enabled directory colorization, XDIR will display the listbox in the same colors as used in the TCC window. If directory colorization is off, XDIR will use the default foreground and background colors for your current theme (including light & dark modes).
XDIR supports most of the DIR options (except those that use multiple columns or multiple rows).
XDIR is not supported in TCC-RT.
You can redefine all of the XDIR keys using the OPTION / Keyboard dialog.
Directive |
Default |
Description |
|---|---|---|
XDirAppendClip |
Ctrl-Shift-C |
Append the selected filename to the clipboard. |
XDirCD |
Ctrl-Enter |
Change the TCC directory |
XDirCDExit |
Shift-Enter |
Change to the selected directory and exit XDIR. |
XDirCopyClip |
Ctrl-C |
Copy the selected filename to the clipboard. |
XDirDel |
Ctrl-D, Del |
Delete the selected directory or file. TCC will display a messagebox to confirm the delete. A directory deletion is equivalent to a RD /S, so pay attention to the prompt! |
XDirDown |
Down |
Scroll down one row. |
XDirEdit |
Ctrl-E |
Edit the file with TCEdit. |
XDirEnd |
End |
Move to the last line. |
XDirExit |
Esc |
If the focus is in the listbox, quits XDIR. If the focus is in one of the edit controls, changes the focus back to the listbox. |
XDirFind |
Ctrl-F |
Moves the focus to the search edit control. An Enter will then look for the first matching name (starting at the current location). The search supports all TCC wildcards as well as regular expressions (prefixed by two colons, i.e. ::expr .). Also available in the right-click context menu. |
XDirHelp |
F1 |
Display this help page. |
XDirInfo |
?, I |
Display a messagebox with file information (pathname, description, size, create / access / last write date & time). |
XDirHome |
Home |
Move to the first line. |
XDirNewFile |
Ctrl-N |
Create a new file. Also available in the right-click context menu. |
XDirNewFolder |
Ctrl-S |
Create a new subdirectory. Also available in the right-click context menu. |
XDirNext |
F3 |
Find next matching filename. |
XDirParent |
Backspace |
Display the parent directory. A Ctrl-Backspace will change the TCC default directory to the parent directory. |
XDirPgUp |
PgUp |
Scroll up one page. |
XDirPgDn |
PgDn |
Scroll down one page. |
XDirPreview |
Space |
Show file in VIEW. |
XDirPrevious |
F4 |
Find previous matching filename. |
XDirRefresh |
Ctrl-R |
Clear the XDIR window and get / display the directory again. |
XDirRename |
F2 |
Rename a subdirectory or file. An edit control will open over the current selection with the directory / file name to edit. An Enter will save the change; an Esc will discard any changes. |
XDirSelect |
Enter |
Enter (or Left-DblClk) - If the selection is a directory, XDIR will change the listbox to display the contents of that directory. A Ctrl-Enter will also change the TCC default directory to the selected directory. If the selection is a file, XDIR will execute the default Windows "Open" action for that file type |
XDirUp |
Up |
Scroll up one row. |
Options:
| /A[:] | Display only those files that have the specified attribute(s) set. See Attribute Switches for information on the attributes which can follow /A:. |
You can specify /A:= to display a dialog to help you set individual attributes.
| /F | Display each filename with its drive letter and path in a single column, without other information. If you use /F with /X, the "short" version of the entire path is displayed. |
| /I"text" | Select filenames by matching text in their descriptions. The text can include wildcards and extended wildcards. The search text must be enclosed in double quotes, and must follow the /I immediately, with no intervening spaces. You can select all filenames that have a description with /I"[?]*", or all filenames that do not have a description with /I"[]". |
The /I option may be used to select files even if descriptions are not displayed (for example, if /2 is used). However, /I will be ignored if /C or /O:c is used.
| /J | Justify (align) filename extensions and display them in the FAT format. If on an LFN drive, you must also specify the /X and /Z options. |
| /N | Use the long filename display format, even if the files are stored on a volume which does not support long filenames. See also /Z. |
A /N with one of the following arguments has an alternate meaning:
| e | Don't display an error message if no files match |
| l | Don't display the link name for symbolic links |
| m:n | Display a maximum of n directory entries |
| q | Don't display the confirmation messagebox when deleting files. (Deleting directories will always show the confirmation dialog.) |
| n | Sort by filename and extension, unless e is explicitly included. This is the default. |
| - | Reverse the sort order for the next sort key |
| a | Sort names and extensions in standard ASCII order, instead of numerically when numeric substrings are included in the name or extension. |
| c | Sort by compression ratio (the least compressed file in the list will be displayed first). For single-column directory displays in the short filename format, the compression ratios will be used as the basis of the sort and will also be displayed. For information on supported compression systems see /C above. |
| d | Sort by date and time (oldest first); also see /T:acw |
| e | Sort by extension |
| g | Group subdirectories first, then files |
| i | Sort by file description (ignored if /C or /O:c is also used) |
| o | Sort by owner |
| r | Reverse the sort order for all options |
| s | Sort by size |
| t | Same as d |
| u | Unsorted |
R |
Read-only |
A |
Archive |
H |
Hidden |
D |
Subdirectory |
S |
System |
C |
Compressed |
E |
Encrypted |
O |
Offline |
N |
Normal |
I |
Not content-indexed |
T |
Temporary |
L |
Junction or symbolic link |
P |
Sparse file |
Attributes which are set are represented by their letter, unset attributes by the _ (underscore) character.
If you wish to add another option after /T, you must start the next option with a forward slash. If you don't, TCC will interpret the /T as the /T:{acw} time display switch (see below) and the following character as a time selector. For example:
xdir /tz incorrect, will display an error
xdir /t /z correct
| /T:a|c|w[u] | Specify which of the date and time fields on a drive which supports long filenames should be displayed and used for sorting: |
| a | Last access date and time (on VFAT volumes access time is always midnight). |
| c | Creation date and time. |
| w | Last modification (write) date and time (default). |
If you append a u after the field, XDIR will display the file time in UTC.
| /Z | Display filenames on LFN drives in the old-style format, with the filename on the left and the description (when available) on the right. Long names will be truncated to 12 characters unless /X is also used. If the name is longer than 12 characters, it will be followed by a è "right arrow" symbol to show that one or more characters have been truncated. |