Abra um documento somente leitura

Às vezes, você pode ter um documento que precisa de revisão, mas não deseja que os revisores modifiquem aleatoriamente seu conteúdo. Aspose.Words permite que você torne a permissão do seu documento somente leitura para que o conteúdo possa ser copiado ou lido, mas não modificado. Isso impedirá que o conteúdo seja removido ou adicionado ao seu documento.

Aplicar a opção somente leitura ao seu documento não impede que alguém crie uma nova cópia dele e salve-o com outro nome.

Este artigo explica como tornar um documento somente leitura.

Tornar um documento somente leitura

Aspose.Words possui a classe pública WriteProtection que especifica as configurações de proteção contra gravação para um documento. Você não cria instâncias desta classe diretamente.

A proteção contra gravação mostra se o autor recomendou a abertura de um documento como somente leitura e/ou exigiu uma senha para modificar o documento.

Aspose.Words permite tornar um documento somente leitura para restringir a edição usando a propriedade read_only_recommended e o método set_password.

No Microsoft Word, você pode criar um documento somente leitura de maneira semelhante usando ambos:

• “Sempre abrir somente leitura” (Arquivo → Informações → Proteger documento)
• “Senha para modificar” (Salvar como → Ferramentas → Opções gerais → Senha)

Os usuários também podem restringir a edição de documentos selecionando ProtectionType como READ_ONLY, mas este é outro recurso que oferece recursos de proteção mais avançados. Existe tal função em Microsoft Word, respectivamente, ela é implementada em Aspose.Words.

ProtectionType será descrito em detalhes em um dos seguintes artigos – “Restringir Edição de Documentos”.

A propriedade read_only_recommended é protegida por senha, portanto, se você não definir uma senha antes de aplicar a propriedade read_only_recommended, outros usuários poderão simplesmente abrir o documento como se ele estivesse desprotegido. Você acessa as configurações de proteção de documentos e define uma senha de proteção contra gravação através do método set_password.

Observe que a senha definida é apenas uma propriedade em um documento que pode ser removida se as propriedades do documento forem acessadas. Conseqüentemente, tal senha não é garantia da segurança do documento.

Se precisar verificar se um documento possui uma senha de proteção contra gravação que restringe sua edição, você pode usar a propriedade is_write_protected.

O exemplo de código a seguir mostra como tornar um documento somente leitura:

import aspose.words as aw

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.write("Open document as read-only")

# Enter a password that's up to 15 characters long.
doc.write_protection.set_password("MyPassword")

# Make the document as read-only.
doc.write_protection.read_only_recommended = True

# Apply write protection as read-only.
doc.protect(aw.ProtectionType.READ_ONLY)
doc.save(docs_base.artifacts_dir + "DocumentProtection.ReadOnlyProtection.docx")

Remover restrição somente leitura

Se não quiser que um usuário abra seu documento como somente leitura, você pode simplesmente definir a propriedade read_only_recommended como False ou selecionar ProtectionType como NO_PROTECTION.

O exemplo de código a seguir mostra como remover o acesso somente leitura de um documento:

import aspose.words as aw

doc = aw.Document()
            
# Enter a password that's up to 15 characters long.
doc.write_protection.set_password("MyPassword")

# Remove the read-only option.
doc.write_protection.read_only_recommended = False

# Apply write protection without any protection.
doc.protect(aw.ProtectionType.NO_PROTECTION)
doc.save(docs_base.artifacts_dir + "DocumentProtection.RemoveReadOnlyRestriction.docx")