vscode-extension-samples/basic-multi-root-sample/README.md

# Basic multi root API samples

This extension adds an entry to the status bar that shows the name of the currently active file. To exercise multi root APIs it:
- only enables itself when more than one `WorkspaceFolder` is opened using `workspace.workspaceFolders` API
- shows the name of the `WorkspaceFolder` the file is from (if any) using `workspace.getWorkspaceFolder()` API
- updates when there are changes to the number of `WorkspaceFolder` via the `workspace.onDidChangeWorkspaceFolders()` API
- registers a setting `multiRootSample.statusColor` with a scope of `resource` to configure a color per `WorkspaceFolder` to use for the status bar item

![Show the folder of the active file](https://raw.githubusercontent.com/Microsoft/vscode-extension-samples/main/basic-multi-root-sample/preview.gif)

## Running the example

- Open this example in VS Code
- `npm install`
- `npm run compile`
- `F5` to start debugging
first cut simple extension for basic multi root APIs 2017-09-05 15:23:45 +02:00			`# Basic multi root API samples`

Fixed typo 2018-11-30 08:12:11 +01:00			`This extension adds an entry to the status bar that shows the name of the currently active file. To exercise multi root APIs it:`
first cut simple extension for basic multi root APIs 2017-09-05 15:23:45 +02:00			- only enables itself when more than one `WorkspaceFolder` is opened using `workspace.workspaceFolders` API
			- shows the name of the `WorkspaceFolder` the file is from (if any) using `workspace.getWorkspaceFolder()` API
			- updates when there are changes to the number of `WorkspaceFolder` via the `workspace.onDidChangeWorkspaceFolders()` API
			- registers a setting `multiRootSample.statusColor` with a scope of `resource` to configure a color per `WorkspaceFolder` to use for the status bar item

rename to main 2021-02-22 09:58:22 -08:00			`![Show the folder of the active file](https://raw.githubusercontent.com/Microsoft/vscode-extension-samples/main/basic-multi-root-sample/preview.gif)`
more work 2017-09-05 15:29:36 +02:00
first cut simple extension for basic multi root APIs 2017-09-05 15:23:45 +02:00			`## Running the example`

			`- Open this example in VS Code`
			- `npm install`
			- `npm run compile`
			- `F5` to start debugging