|
xtd
0.2.0
|
◆ special_folder
|
strong |
Specifies enumerated constants used to retrieve directory paths to system special folders.
- Remarks
- The system special folders are folders such as Program Files, Programs, System, or Startup, which contain common information. Special folders are set by default by the system, or explicitly by the user, when installing a version of Windows.
- The xtd::environment::get_folder_path method returns the locations associated with this enumeration. The locations of these folders can have different values on different operating systems, the user can change some of the locations, and the locations are localized.
- For more information about special folders, see the KNOWNFOLDERID constants in the Windows documentation.
-
The list below typically represents special folders by OS :
Name android iOS Linux macOS Windows desktop /home/${User}/Desktop /Users/${User}/Desktop /home/${User}/Desktop /Users/${User}/Desktop C:\Users\${User}\Desktop programs C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Start Menu\Programs my_documents /home/${User} /Users/${User} /home/${User} /Users/${User} C:\Users\${User}\Documents personal /home/${User} /Users/${User} /home/${User} /Users/${User} C:\Users\${User}\Documents favorites /Users/${User}/Library/Favorites /Users/${User}/Library/Favorites C:\Users\${User}\Favorites startup C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup recent C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Recent send_to C:\Users\${User}\AppData\Roaming\Microsoft\Windows\SendTo start_menu C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Start Menu my_music /home/${User}/Music /Users/${User}/Music /home/${User}/Music /Users/${User}/Music C:\Users\${User}\Music my_videos /home/${User}/Movies /Users/${User}/Movies /home/${User}/Movies /Users/${User}/Movies C:\Users\${User}\Movies desktop_directory /home/${User}/Desktop /Users/${User}/Desktop /home/${User}/Desktop /Users/${User}/Desktop C:\Users\${User}\Desktop my_computer network_shortcuts C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Network Shortcuts fonts /home/${User}/.fonts /Users/${User}/Library/Fonts /home/${User}/.fonts /Users/${User}/Library/Fonts C:\Windows\Fonts templates /home/${User}/Templates /Users/${User}/Templates /home/${User}/Templates /Users/${User}/Templates C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Templates common_start_menu C:\ProgramData\Microsoft\Windows\Start Menu common_programs C:\ProgramData\Microsoft\Windows\Start Menu\Programs common_startup C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup common_desktop_directory C:\Users\Public\Desktop application_data /home/${User}/.config /Users/${User}/.config /home/${User}/.config /Users/${User}//Library/Preferences C:\Users\${User}\AppData\Roaming printer_shortcuts C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Printer Shortcuts local_application_data /home/${User}/.local/share /Users/${User}/.local/share /home/${User}/.local/share /Users/${User}/.local/share C:\Users\${User}\AppData\Local internet_cache /Users/${User}/Library/Caches /Users/${User}/Library/Caches C:\Users\${User}\AppData\Local\Microsoft\Windows\Temporary Internet Files cookies C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Cookies history C:\Users\${User}\AppData\Local\Microsoft\Windows\History common_application_data /usr/share /usr/share /usr/share /usr/share C:\ProgramData windows C:\Windows system /System /System C:\Windows\system32 program_files /Applications /Applications C:\Program Files (x86) my_pictures /home/${User}/Pictures /Users/${User}/Pictures /home/${User}/Pictures /Users/${User}/Pictures C:\Users\${User}\Pictures user_profile /home/${User} /Users/${User} /home/${User} /Users/${User} C:\Users\${User} system_x86 C:\Windows\SysWOW64 program_files_x86 C:\Program Files (x86) common_program_files C:\Program Files (x86)\Common Files common_program_files_x86 C:\Program Files (x86)\Common Files common_templates /usr/share/templates /usr/share/templates C:\ProgramData\Microsoft\Windows\Templates common_documents C:\Users\Public\Documents common_admin_tools C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Administrative Tools admin_tools C:\Users\${User}\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Administrative Tools common_music C:\Users\Public\Music common_pictures C:\Users\Public\Pictures common_videos C:\Users\Public\Videos resources C:\Windows\resources localized_resources common_oem_links cd_burning C:\Users\${User}\AppData\Local\Microsoft\Windows\Burn\Burn xtd_install ** /usr/local /usr/local /usr/local /usr/local C:\Program Files\xtd xtd_locale ** /usr/local/share/xtd/locale /usr/local/share/xtd/locale /usr/local/share/xtd/locale /usr/local/share/xtd/locale C:\Program Files\xtd\locale xtd_reference_guide ** /usr/local/share/xtd/reference_guide /usr/local/share/xtd/reference_guide /usr/local/share/xtd/reference_guide /usr/local/share/xtd/reference_guide C:\Program Files\xtd\reference_guide xtd_themes ** /usr/local/share/xtd/themes /usr/local/share/xtd/themes /usr/local/share/xtd/themes /usr/local/share/xtd/themes C:\Program Files\xtd\themes xtd_include ** /usr/local/include /usr/local/include /usr/local/include /usr/local/include C:\Program Files\xtd xtd_libraries ** /usr/local/lib /usr/local/lib /usr/local/lib /usr/local/lib C:\Program Files\xtd\lib xtd_resources ** /usr/local/share/xtd/resources /usr/local/share/xtd/resources /usr/local/share/xtd/resources /usr/local/share/xtd/resources C:\Program Files\xtd\resources xtd_console_include ** /usr/local/include /usr/local/include /usr/local/include /usr/local/include C:\Program Files\xtd xtd_console_libraries ** /usr/local/lib /usr/local/lib /usr/local/lib /usr/local/lib C:\Program Files\xtd\lib xtd_drawing_include ** /usr/local/include /usr/local/include /usr/local/include /usr/local/include C:\Program Files\xtd xtd_drawing_libraries ** /usr/local/lib /usr/local/lib /usr/local/lib /usr/local/lib C:\Program Files\xtd\lib xtd_drawing_resources ** /usr/local/share/xtd/resources /usr/local/share/xtd/resources /usr/local/share/xtd/resources /usr/local/share/xtd/resources C:\Program Files\xtd\resources xtd_forms_include ** /usr/local/include /usr/local/include /usr/local/include /usr/local/include C:\Program Files\xtd xtd_forms_libraries ** /usr/local/lib /usr/local/lib /usr/local/lib /usr/local/lib C:\Program Files\xtd\lib xtd_forms_resources ** /usr/local/share/xtd/resources /usr/local/share/xtd/resources /usr/local/share/xtd/resources /usr/local/share/xtd/resources C:\Program Files\xtd\resources xtd_tunit_include ** /usr/local/include /usr/local/include /usr/local/include /usr/local/include C:\Program Files\xtd xtd_tunit_libraries ** /usr/local/lib /usr/local/lib /usr/local/lib /usr/local/lib C:\Program Files\xtd\lib - ${User} represent the login user name. ** xtd::environment::special_folder_option has no effect with these values.
- See also
- environment
| Enumerator | |
|---|---|
| desktop | The logical Desktop rather than the physical file system location. |
| programs | The directory that contains the user's program groups. |
| my_documents | The My Documents folder. This member is equivalent to Personal. |
| personal | The directory that serves as a common repository for documents. This member is equivalent to MyDocuments. |
| favorites | The directory that serves as a common repository for the user's favorite items. |
| startup | The directory that corresponds to the user's Startup program group. The system starts these programs whenever a user logs on or starts Windows NT or later, or starts Windows 98. |
| recent | The directory that contains the user's most recently used documents. |
| send_to | The directory that contains the Send To menu items. |
| start_menu | The directory that contains the Start menu items. |
| my_music | The My Music folder. |
| my_videos | The file system directory that serves as a repository for videos that belong to a user. |
| desktop_directory | The directory used to physically store file objects on the desktop. Do not confuse this directory with the desktop folder itself, which is a virtual folder. |
| my_computer | The My Computer folder. The MyComputer constant always yields the empty string ("") because no path is defined for the My Computer folder. |
| network_shortcuts | A file system directory that contains the link objects that may exist in the My Network Places virtual folder. |
| fonts | A virtual folder that contains fonts. |
| templates | The directory that serves as a common repository for document templates. |
| common_start_menu | The file system directory that contains the programs and folders that appear on the Start menu for all users. This special folder is valid only for Windows NT systems. |
| common_programs | A folder for components that are shared across applications. This special folder is valid only for Windows NT, Windows 2000, and Windows XP systems. |
| common_startup | The file system directory that contains the programs that appear in the Startup folder for all users. This special folder is valid only for Windows NT systems. |
| common_desktop_directory | The file system directory that contains files and folders that appear on the desktop for all users. This special folder is valid only for Windows NT systems. |
| application_data | The directory that serves as a common repository for application-specific data for the current roaming user. A roaming user works on more than one computer on a network. A roaming user's profile is kept on a server on the network and is loaded onto a system when the user logs on. |
| printer_shortcuts | The file system directory that contains the link objects that can exist in the Printers virtual folder. |
| local_application_data | The directory that serves as a common repository for application-specific data that is used by the current, non-roaming user. |
| internet_cache | The directory that serves as a common repository for temporary Internet files. |
| cookies | The directory that serves as a common repository for Internet cookies. |
| history | The directory that serves as a common repository for Internet history items. |
| common_application_data | The directory that serves as a common repository for application-specific data that is used by all users. |
| windows | The Windows directory or SYSROOT. This corresponds to the windir% or SYSTEMROOT% environment variables. |
| system | The System directory. |
| program_files | The program files directory.On a non-x86 system, passing ProgramFiles to the GetFolderPath method returns the path for non-x86 programs. To get the x86 program files directory on a non-x86 system, use the ProgramFilesX86 member. |
| my_pictures | The My Pictures folder. |
| user_profile | The user's profile folder. Applications should not create files or folders at this level; they should put their data under the locations referred to by ApplicationData. |
| system_x86 | The Windows System folder. |
| program_files_x86 | The Program Files folder On an x86 system, passing the ProgramFilesX86 member to the Environment.GetFolderPath method returns string.Empty; use the ProgramFiles member instead. You can determine whether Windows is a 32-bit operating system by calling the Environment.Is64BitOperatingSystem property. |
| common_program_files | The directory for components that are shared across applications.To get the x86 common program files directory on a non-x86 system, use the ProgramFilesX86 member. |
| common_program_files_x86 | The Program Files folder. |
| common_templates | The file system directory that contains the templates that are available to all users. This special folder is valid only for Windows NT systems. |
| common_documents | The file system directory that contains documents that are common to all users. This special folder is valid for Windows NT systems, Windows 95, and Windows 98 systems with Shfolder.dll installed. |
| common_admin_tools | The file system directory that contains administrative tools for all users of the computer. |
| admin_tools | The file system directory that is used to store administrative tools for an individual user. The Microsoft Management Console (MMC) will save customized consoles to this directory, and it will roam with the user. |
| common_music | The file system directory that serves as a repository for music files common to all users. |
| common_pictures | The file system directory that serves as a repository for image files common to all users. |
| common_videos | The file system directory that serves as a repository for video files common to all users. |
| resources | The file system directory that contains resource data. |
| localized_resources | The file system directory that contains localized resource data. |
| common_oem_links | This value is recognized in Windows Vista for backward compatibility, but the special folder itself is no longer used. |
| cd_burning | The file system directory that acts as a staging area for files waiting to be written to a CD. |
| home | The file system directory that contains home folder. |
| application_resources | The application resources folder. |
| xtd_install | The installation folder of xtd. |
| xtd_locale | The xtd locale folder. |
| xtd_reference_guide | The xtd reference guide folder. |
| xtd_themes | The xtd themes folder. |
| xtd_include | The xtd inlude folder. |
| xtd_libraries | The xtd libraries folder. |
| xtd_resources | The xtd resources folder. |
| xtd_console_include | The xtd::console include folder. |
| xtd_console_libraries | The xtd::console libraries folder. |
| xtd_drawing_include | The xtd::drawing include folder. |
| xtd_drawing_libraries | The xtd::drawing libraries folder. |
| xtd_drawing_resources | The xtd::drawing resources folder. |
| xtd_forms_include | The xtd::forms include folder. |
| xtd_forms_libraries | The xtd::forms libraries folder. |
| xtd_forms_resources | The xtd::forms resources folder. |
| xtd_tunit_include | The xtd::tunit include folder. |
| xtd_tunit_libraries | The xtd::tunit libraries folder. |