## Документация

Введение
Вид
Закладки
Операции с файлами
Поиск
Установки
Разное
Известные ограничения

### Введение

Программа должна выполнять только одну задачу, но выполнять ее хорошо.
Программы должны уметь взаимодействовать друг с другом.

Основные принципы на которых основывается разработка - это предоставление визуально удобного и простого в использовании интерфейса к файлам. Реализовано много оригинальных идей для облегчения выполнения наиболее часто возникающих задач. Используются возможности среды Windows и ее расширений, что позволяет самой программе оставаться максимально простой.

### Вид

Наиболее часто используемый способ работы в SurF - это режим Просмотр файлов:

По умолчанию файлы сгруппированы по своим расширениям, а в пределах каждой группы сортировка идет по имени файла. Для изменения правил сортировки по умолчанию, вы можете использовать диалог настройки Группировка файлов. Кроме стандартных иконок для файлов, SurF создает иконки для графических файлов. Цвет файла показывает такие атрибуты как Скрытый, Сжатый и Зашифрованный. Только что созданные и измененные файлы подсвечиваются соответствующим цветом на 1 секунду.

Текущая папка представляется как " . ", родительская - " . . ". Это дает возможность скопировать текущий/родительский путь в буфер обмена, просмотреть свойства этих папок, перетащить на них файлы.

Для поиска файла в текущей папке, быстро наберите на клавиатуре несколько первых букв его имени.

В режиме Просмотр размера файлы и папки по умолчанию отсортированы по размеру на диске, который учитывает NTFS сжатие, NTFS разреженность файлов и величину минимального блока на диске выделяемого под файлы. Символ ~ показывает, что вычисление размера папки еще не завершено:

В режиме Просмотр времени файлы и папки по умолчанию отсортированы по времени последнего изменения. Даты текущей недели отображаются в краткой форме:

В режиме Просмотр изображений удобно просматривать коллекции изображений. Изображения автоматически поворачиваются, если доступны EXIF данные об ориентации камеры. При Размере иконок более 48, отображается содержимое некоторых документов (например, видео файлов) и папок:

Каждый вид можно независимо настраивать: в диалоге Настройки вида для выбора доступны столбцы, порядок сортировки, размер иконок и отображение скрытых файлов; в диалоге Управление видами можно изменить имя и иконку для вида, создавать и удалять виды, установить вид по умолчанию.

Контекстное меню для текущей папки можно вызвать правым кликом на фоне списка файлов. При наличии нескольких столбцов, контекстное меню можно также вызвать правым кликом по области с названиями столбцов. Третий способ вызвать контекстное меню – это нажать Shift + F10 или клавишу Контекста, когда не выбрано ни одного файла. |

### Закладки

Можно держать открытыми одновременно несколько папок. Каждая папка представлена закладкой и входит в Дерево закладок. Для лучшей организации SurF может добавлять виртуальные закладки к дереву (как например "Common Files" на картинке справа). Двойной клик на виртуальной закладке превращает ее в настоящую. Закладки для папок открываемых при загрузке имеют жирный шрифт и при переходе по директориям на таких папках создаются новые закладки. |

Кроме иконки вида, каждая закладка может отображать еще три иконки: - текущая операция для списка файлов выполнятся в фоновом режиме, - отслеживание изменений списка файлов отключено, - проверка изменений списка файлов в дочерних папках включена.

Чтобы выбрать папку для новой закладки при помощи клавиатуры нажмите Ctrl + N ("Создать - БыстрыйПоиск..."). В поле Искать можно ввести, например, csys32 для выбора папки c:\windows\system32. Первой буквой должна быть буква диска, на котором ведется поиск. Для поиска в подкаталогах текущей папки введите первым символом .(точку). Например, если закладка открыта на c:\1 и ввести .45, то будет найдена папка 2\3\4\5. Поиск выполняется в фоновом режиме. Когда находится более подходящий путь, он заменяет собой текущий. Когда поиск заканчивается, шрифт найденного пути становится жирным. Если ни один путь не найден и поиск закончен, то отображается знак вопроса. |

Чтобы выбрать папку для новой закладки при помощи мыши вызовите стандартный диалог "Обзор папок" при помощи кнопки на панели инструментов или пункта меню "Создать - Обзор...". Если папка/файл открыты в другой программе или путь к папке/файлу представлен строкой текста - скопируйте это в буфер обмена и создайте новую закладку при помощи кнопки или пункта меню "Создать - из Буфера Обмена".

| Просмотр файлов можно открыть в отдельном окне используя пункт меню Закладка – Отсоединить. Отдельное окно можно вернуть в закладку используя пункт меню Закладка – Подсоединить.

### Операции с файлами

Для выполнения базовых операций с файлами, такими как копирование и перемещение, доступны следующие возможности:

- Буфер обмена Windows: Скопируйте/Вырежьте выбранные файлы в буфер обмена, перейдите в папку назначения, Вставьте/Вставьте копию файлов из буфера обмена (Вставить копию добавляет префикс "Копия" к новому файлу, если файл с оригинальным именем уже существует в папке назначения). Вставив из буфера обмена эти файлы в другой программе, например "Проводник Windows" Скопирует/Вырежет их, а Вставив их в "Блокноте" или "cmd.exe" скопирует пути файлов как текст.
- Перетаскивание мышью: выбранные файлы можно перетаскивать на закладки и на папки в списке файлов (для того чтобы выбранная закладка или папка открылась после перетаскивания держите нажатой клавишу Shift). Перетаскиваемые файлы по умолчанию перемещаются, для копирования держите нажатой клавишу Control. Для создания ярлыков держите нажатыми клавиши Control + Shift. Для создания копии держите нажатой клавишу Alt. Если перетащить файлы в другую программу, то например в "Проводнике Windows" они Скопируется/Вырежутся, а в "Блокноте" или "cmd.exe" пути файлов скопируются как текст. Список файлов автоматически прокручивается во время перетаскивания когда курсор мыши оказывается у края.
- Диалоги Копировать/Переместить в папку: откройте диалог Копировать/Переместить в папку, определите папку назначения используя поле быстрого поиска и выбранные файлы будут перенесены в нужное место на диске.

#### NTFS ссылки на папки

Эта возможность для опытных пользователей позволяет, например, создать ссылку на букву CD устройства U:\ из папки C:\CD - вы сможете просматривать содержимое CD дисков открыв папку C:\CD. Или создать ссылку на папку D:\Games из папки C:\Program Files\Games - вы сможете устанавливать игры в папку C:\Program Files\Games, а дисковое пространство будет использоваться на диске D:\. Создание ссылок на папки расположенные на сетевых дисках не поддерживается NTFS.

Чтобы создать NTFS ссылку на папку в SurF: Скопируйте исходную папку в буфер обмена (например, D:\Games), перейдите в родительской каталог папки где вы хотите создать ссылку (например, C:\Program Files) и выберите команду меню Файл - Вставить NTFS ссылку. При создании или удалении файлов в папке C:\Program Files\Games они будут также созданы или удалены в папке D:\Games и наоборот.

Используя диалог Файл - NTFS свойства можно проверить наличие ссылки и удалить ее (обратите также внимание на наложение изображения ссылки в списке файлов). При удалении ссылки через диалог NTFS свойства гарантируется, что файлы в исходной папке (D:\Games) не будут изменены. Если вы попробуете удалить папку со ссылкой как обычную папку, то файлы из исходной папки тоже могут удалиться вместе с ней. |

| Windows 7 и Vista используют несколько специальных ссылок на папки для обратной совместимости. Например, C:\Documents and Settings ссылается на C:\Users и установленные права доступа запрещают чтение содержимого папки C:\Documents and Settings. SurF определяет такие специальные папки и при попытке перейти в C:\Documents and Settings создается новая закладка для C:\Users.

#### NTFS ссылки на файлы

Эта возможность для опытных пользователей позволяет создавать ссылки на один файл из разных папок. Например, для существующего файла C:\Docs\readme.txt можно создать ссылки C:\Favorites\readme.txt и C:\Public\please read.txt. При изменении одного из файлов будут изменены все три. При удалении одного из файлов два других продолжат свое существование. NTFS позволяет создавать ссылки на файл только в пределах того же диска.

Для создания NTFS ссылки на файл в SurF: Скопируйте исходный файл в буфер обмена (например, C:\Docs\readme.txt), перейдите в папку где вы хотите создать ссылку (например, C:\Favorites) и выберите команду меню Файл - Вставить NTFS ссылку. Для проверки наличия ссылки на файл можно воспользоваться диалогом Файл - NTFS свойства (строка Количество ссылок на файл). Обратите также внимание на наложение изображения ссылки в списке файлов.

#### Символические ссылки

Эта возможность для опытных пользователей позволяет создавать ссылки на файл или папку из различных мест. Символическая ссылка на папку ведет себя в точности как NTFS ссылка на папку плюс позволяет создавать ссылку на папку в сети. Символическая ссылка на файл ведет себя скорее как NTFS ссылка на папку, чем как NTFS ссылка на файл - при удалении исходного файла все ссылающиеся на него файлы становятся недействительными. Если NTFS ссылка на файл работает только в пределах одного диска, то символическая ссылка позволяет создавать ссылку на файл на другом диске или в сети.

| Для создания символической ссылки используйте команду меню Файл - Вставить символическую ссылку. Требуется Windows 7 или Vista плюс SurF должен быть запущен от имени администратора или под учетной записью обычного пользователя с привилегией Создание символических ссылок. Используя диалог Файл - NTFS свойства можно проверить наличие ссылки и удалить ее.

#### Альтернативные потоки данных NTFS Возможно хранение нескольких "внутренних" файлов в одном "обычном". Например, файл silverbullet-003.mp3 содержит как основное содержимое аудио запись и как "дополнительную" информацию сведения о том, что файл был загружен из Internet. Можно легко создать тестовый файл с альтернативным потоком данных самостоятельно: наберите "echo my_data > test_file_name.txt:stream.txt" в командной строке. Будет создан внешне пустой файл "test_file_name.txt", но если затем набрать "notepad test_file_name.txt:stream.txt" вы увидите "дополнительные" данные my_data. Диалог NTFS свойства отображает существующие альтернативные потоки данных в файлах и папках. Колонка Предварительный просмотр данных показывает первые 50 символов для текстовых потоков. Для просмотра текстовых потоков целиком и для просмотра двоичных потоков Скопируйте имя файла потока в буфер обмена и запустите свой обычный редактор файлов передав ему имя файла потока как параметр командной строки. |

### Поиск

Файл - Искать диалог предлагает несколько вариантов поиска файлов, можно произвольно менять размер диалога или развернуть его на весь экран. Диалог не блокирует основное окно работы с файлами и можно одновременно открыть несколько диалогов Поиск.

Области поиска дают возможность задать несколько обычных (например, C:\ | D:\) или специальных (например, Мой компьютер | Сетевое окружение\Вся сеть) папок для поиска. Маски для имени файла принимают: маски типа *.txt, часть имени файла (например, win), регулярные выражение Perl (например, win.*[\d] найдет winhlp32.exe и winnt256.bmp). Маски можно комбинировать используя символы | и & представляющие операции ИЛИ и И (например, *.exe | *.bmp & win найдет Prairie Wind.bmp и winhelp.exe). Чтобы исключить определенные файлы можно использовать символ ! (например, !*.dll & !*.exe). В масках запрещается использовать символы ! и пробел. Фильтры для файлов можно комбинировать символами () | и &. Например, ((Изменен > 21.7.2007 & Изменен < 23.10.2007) | (Создан > 21.7.2007 & Создан < 23.10.2007)) & Атрибуты = Скрытый отыщет скрытые файлы измененные или созданные за период с 21.7.2007 до 23.10.2007. Строка времени допускает не указывать секунды, минуты и вообще не указывать время. Можно использовать как дату строки Сегодня и Вчера. Доступны модификаторы размера Кб, Мб, Гб и Тб, а также их однобуквенные аналоги (К, М, Г и Т). |

Полнотекстовый поиск доступен при установке COM сервера Настольной поисковой системы (см. Установка). Образец содержащегося текста допускает ввод одного или нескольких слов, конкретной фразы и регулярного выражения Perl. При поиске по одному или нескольким словам учитываются морфология и синтаксис.

Список найденных файлов поддерживает клавишные комбинации для операций копирования, перемещения, удаления, вызова свойств, выполнения, а также комбинацию клавиш Ctrl+D Создать - на основе выбранного. Список автоматически прокручивается во время поиска, если в нем не выбрано ни одного файла. Можно менять порядок колонок перетаскивая их.

В процессе поиска жирные точки представляют найденные и еще не обработанные папки (более светлые точки соответствуют недавно найденным папкам). Окружности представляют найденные и еще не обработанные файлы и отображаются только при поиске текста. |

### Установки

SurF определяет глобальную горячую клавишу Win+S для быстрого вызова программы из фонового режима. Если нажать горячую клавишу когда окно SurF уже активно, то это приведет к минимизации программы. Выбрать горячую клавишу можно в диалоге Общих настроек.

Редактируя избранное и открываемые при загрузке папки можно перетаскивать строки при помощи мыши. Для удаления строки - выберите ее нажав Shift + Space на клавиатуре или кликнув на заголовке строки мышкой, затем нажмите клавишу Delete. Для входа в режим редактирования ячейки можно использовать клавишу F2.

Формирование иконок для изображений является длительной операцией и поэтому введены некоторые ограничения, зависящие от размеров графического файла. Для изменения ограничений по умолчанию, вы можете использовать диалог настройки Иконок для изображений - для показа иконок к большему количеству картинок следует увеличить максимальный размер, для более быстрой работы следует уменьшить максимальный размер. Эти ограничения действуют только для видов с Размером иконок 16, 32 и 48.

Первоначальные установки считываются из xml файлов в папке "settings" или из файла "settings\settings.srfs", который можно создать используя пункт меню Сохранить настройки. При изменении установок через меню "Настройки" - эти пользовательские настройки сохраняются в личной папке пользователя и переопределяют первоначальные установки из папки "settings". Точный путь папки с пользовательскими настройками зависит от имени пользователя и пути установки программы. Обычно этот путь соответствует шаблону "c:\Documents and Settings\ИМЯ_ПОЛЬЗОВАТЕЛЯ\Local Settings\Application Data\IsolatedStorage\...\AssemFiles".

Можно переопределить общие настройки параметрами командной строки (имена параметров перечислены в файле settings.xml), например:

    SurF.exe UseCustomColor=True CustomColor=Chartreuse

Для резервного копирования/восстановления всех настроек или для переноса всех настроек с одного компьютера на другой используйте пункты меню Сохранить/Загрузить настройки.

### Разное

#### Параметры командной строки

Можно открыть дополнительные закладки при старте, если указать путь к папке или файлу в параметрах командной строки. Например,

    SurF.exe "C:\Program Files\SurF" C:\WINDOWS\Greenstone.bmp

откроет одну закладку для C:\Program Files\SurF и одну закладку для C:\WINDOWS с выбранным файлом Greenstone.bmp.

#### Многоязыковой интерфейс

Если у вас в Windows выбран русский интерфейс, то и в SurF будет русский интерфейс. В остальных случаях, интерфейс в SurF будет на английском.

#### Дополнительные комбинации клавиш

Копировать | Ctrl+Ins
Вставить | Shift+Ins
Следующая закладка | Ctrl+Tab
Переход в родительскую папку | Backspace
Контекстное меню | Shift + F10 Клавиша Контекст

#### Доступ к сетевым ресурсам После ввода имени сервера или IP адреса в окне Сервер в сети (например, comp1, или 192.168.1.1, или ::1) появляется диалог Выбор ресурса. Ресурсы которые невозможно открыть показаны серым цветом. Можно выбрать несколько ресурсов и открыть их все разом. Кнопка Подключиться как позволяет выбрать отличную от текущей учетную запись для удаленного доступа. Вводимый пароль для учетной записи никогда не сохраняется на диск и удаляется из памяти сразу после установления удаленного соединения. При подключении к компьютеру с Windows 9x и ресурсу защищенному паролем, выберите этот ресурс и отметьте "Подключаться к выбранному ресурсу" перед тем как нажимать Подключиться как. |

### Известные ограничения

#### 1. Предупреждение "Адресат не может обработать такой тип документа" при использовании контекстного меню Отправить.

"При получении предупреждения, просто нажмите OK. Файл успешно сохранен в Моих Документах или на съемном диске." KB328856

#### 2. Если после переименования файла его имя стало заметно длиннее всех остальных в папке, то такое имя может отобразиться с многоточием на конце.

Решение: Откройте эту закладку заново.

#### 3. Не поддерживается перетаскивание отложенных файлов в SurF (например, файлов из zip архива или писем из Outlook).

Решение: Скопируйте отложенные файлы в буфер обмена Windows и затем вставьте в SurF.

#### 4. Не поддерживается перетаскивание и копирование файлов из ftp папок Проводника Windows.

#### 5. Не поддерживается перетаскивание файлов ярлыками из разных папок из списка найденных файлов в Проводник Windows.

#### 6. Невозможно использовать некоторые символы (например, "(&<") для поиска текста.

#### 7. Невозможно отображение более 1200 отличающихся друг от друга иконок для изображений при максимальном Размере иконок.

Решение: Уменьшите Размер иконок.