Interface IPersistFileFormat

Artigo
08/10/2016

Publicado: junho de 2016

Obtém informações de formato de arquivo sobre itens que exigem salvando e permite o carregamento através de programação ou salvar um objeto em um formato especificado pelo usuário.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

[GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")]
[InterfaceTypeAttribute(1)]
public interface IPersistFileFormat : IPersist

[GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")]
[InterfaceTypeAttribute(1)]
public interface class IPersistFileFormat : IPersist

[<GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")>]
[<InterfaceTypeAttribute(1)>]
type IPersistFileFormat = 
    interface
        interface IPersist
    end

<GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")>
<InterfaceTypeAttribute(1)>
Public Interface IPersistFileFormat
    Inherits IPersist

Métodos

	Nome	Descrição
	GetClassID(Guid)
	GetCurFile(String, UInt32)	Retorna o caminho para o arquivo de trabalho atual de um objeto, ou, se não houver um arquivo de trabalho atual, prompt de nome de arquivo do objeto padrão.
	GetFormatList(String)	Fornece o chamador com as informações necessárias para abrir o padrão comum Salvar como caixa de diálogo (usando o GetSaveFileNameViaDlg função) em nome do objeto.
	InitNew(UInt32)	Instrui o objeto para se inicializar no estado sem título.
	IsDirty(Int32)	Determina se um objeto foi alterado desde que estão sendo salvos em seu arquivo atual.
	Load(String, UInt32, Int32)	Abre um arquivo especificado e inicializa um objeto de conteúdo do arquivo.
	Save(String, Int32, UInt32)	Salva uma cópia do objeto no arquivo especificado.
	SaveCompleted(String)	Notifica o objeto que ele concluiu a transação de gravação e que o objeto pode gravar em seu arquivo.

Comentários

O IPersistFileFormat interface é baseada no padrão IPersistFile interface e amplia o das seguintes maneiras:

Mostra como especificar um novo arquivo sem título para corretamente o InitNew método.
Mostra se o arquivo deve ser aberto como um arquivo somente leitura.
Elimina o desnecessários Salvar como solicitar a cadeia de caracteres de GetCurFile.
Retorna um erro de código quando Save(null) é chamado em um objeto sem título.

IPersistFileFormat Fornece informações suficientes para que o cliente de um objeto para implementar o Salvar como caixa de diálogo — ou seja, preencha o Salvar como tipo suspensa listar e gerenciar a extensão de arquivo inicial, mas ainda oferecer flexibilidade completa para o objeto. Portanto, o objeto possui todos os aspectos do seu arquivo e formato, incluindo o nome do seu formato.

Observações para implementadores:

Ao salvar documentos ou editores de documento que usam o padrão de Salvar como implementação de caixa de diálogo do ambiente.

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via