Conteúdo
Índice 🔎︎

# Instrução ChDrive

Altera a unidade atual.

Some DOS-specific file and directory functions are no longer provided in LibreOffice, or their function is only limited. For example, support for the ChDir, ChDrive and CurDir functions is not provided. Some DOS-specific properties are no longer used in functions that expect file properties as parameters (for example, to differentiate from concealed files and system files). This ensures the greatest possible level of platform independence for LibreOffice. Therefore this feature is subject to removal in a future release.

The ScriptForge library in LibreOffice 7.1 introduces the FileSystem service with methods to handle files and folders in user scripts.

### Sintaxe:

      ChDrive Text As String

### Parâmetros:

Texto: qualquer expressão de cadeia que possui a letra da nova unidade. Se quiser, pode utilizar a notação URL.

Deverá ser atribuída uma letra maiúscula à unidade. No Windows, a letra que atribuir à unidade está restrita às definições em LASTDRV. Se o valor da unidade for uma cadeia de múltiplos caracteres, só a primeira letra é relevante. Se tentar aceder a uma unidade não existente, ocorre um erro ao qual pode dar seguimento com a instrução OnError.

### Códigos de erro

5 Chamada de procedimento inválido

68 Dispositivo não disponível

76 Caminho não encontrado

### Exemplo:

      Sub ExampleChDrive
          ChDrive "D" ' Apenas possível se existir uma unidade 'D'.
      End Sub

Tópicos relacionados

ScriptForge.FileSystem service

ScriptForge.TextStream service