Método IPersistFileFormat.GetCurFile (String, UInt32)

Artigo
08/10/2016

Publicado: junho de 2016

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.

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

Sintaxe

int GetCurFile(
    out string ppszFilename,
    out uint pnFormatIndex
)

int GetCurFile(
    [OutAttribute] String^% ppszFilename,
    [OutAttribute] unsigned int% pnFormatIndex
)

abstract GetCurFile : 
        ppszFilename:string byref *
        pnFormatIndex:uint32 byref -> int

Function GetCurFile (
    <OutAttribute> ByRef ppszFilename As String,
    <OutAttribute> ByRef pnFormatIndex As UInteger
) As Integer

Parâmetros

ppszFilename
Type: System.String

[out] Ponteiro para o nome do arquivo. Se o objeto tem um nome de arquivo válido, o nome do arquivo é retornado como o ppszFilename parâmetro out. Se o objeto estiver no estado sem título, null é retornado como o ppszFilename parâmetro out.

Observação esse resultado é diferente do padrão GetCurFile método, que retorna S_FALSE e "Salvar como" cadeia de caracteres de prompt.

pnFormatIndex
Type: System.UInt32

[out] Valor que indica o formato atual do arquivo. Esse valor é interpretado como um índice baseado em zero na lista de formatos, como retornado por uma chamada para GetFormatList. Um valor de índice de zero indica o primeiro formato, 1 segundo formato, e assim por diante. Se o objeto oferecer suporte a apenas um único formato, ele retornará zero. Em seguida, ele retorna um único elemento em sua lista de formato por meio de uma chamada para GetFormatList.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retornará S_OK. Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De fpstfmt.idl:

HRESULT IPersistFileFormat::GetCurFile(
   [out] LPOLESTR *ppszFilename,
   [out] DWORD *pnFormatIndex
);

Esse método é semelhante ao GetCurFile. Para salvar o arquivo atual no formato atual, chame GetCurFile para recuperar o valor de índice do formato atual para passá-la corretamente para o Save método.

Consulte também

Interface IPersistFileFormat
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via