Conteúdo

# Instrução ChDrive

Altera a unidade atual.

Algumas funções específicas do DOS relacionadas com ficheiros e diretórios já não estão disponíveis no LibreOffice, ou a sua funcionalidade é limitada. Por exemplo, não é fornecido suporte para as funções ChDir, ChDrive e CurDir. Algumas propriedades específicas do DOS já não são utilizadas em funções que esperam propriedades de ficheiros como parâmetros (por exemplo, para diferenciar ficheiros ocultos e ficheiros de sistema). Isto garante o maior nível possível de independência de plataforma para o LibreOffice. Por conseguinte, esta funcionalidade está sujeita a remoção numa versão futura.

A biblioteca ScriptForge do LibreOffice 7.1 introduz o serviço FileSystem, com métodos para gerir ficheiros e pastas em scripts do utilizador.

### 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 serviço

ScriptForge.TextStream service

Necessitamos da sua ajuda!