Compartilhar via

OPENFILENAME

  • Artigo

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa estrutura contém informações de sistema operacional usa para inicializar a system-defined Abrir Ou Salvar como caixa diálogo. Depois que o usuário fecha a caixa diálogo, o sistema retorna informações sobre como seleção do usuário a essa estrutura.

Syntax

typedef struct tagOFN { /* ofn */
  DWORD lStructSize;
  HWND hwndOwner;
  HINSTANCE hInstance;
  LPCSTR lpstrFilter;
  LPSTR lpstrCustomFilter;
  DWORD nMaxCustFilter;
  DWORD nFilterIndex;
  LPSTR lpstrFile;
  DWORD nMaxFile;
  LPSTR lpstrFileTitle;
  DWORD nMaxFileTitle;
  LPSTR lpstrInitialDir;
  LPCSTR lpstrTitle;
  DWORD Flags;
  WORD nFileOffset;
  WORD nFileExtension;
  LPCSTR lpstrDefExt;
  DWORD lCustData;
  LPOFNHOOKPROC lpfnHook;
  LPCSTR lpTemplateName;
} OPENFILENAME;

Os membros

  • lStructSize
    Especifica o comprimento, em bytes, da estrutura.
  • hwndOwner
    Identificador para a janela proprietária caixa de diálogo. Esse membro pode ser qualquer válido identificador janela, ou ele pode ser NULL se a caixa diálogo não possui nenhum proprietário.
  • hInstance
    Não suportado.

  • lpstrFilter
    Ponteiro longo para uma reserva que contém pares de seqüências de caracteres filtro NULL-Terminated. A última seqüência de caracteres na reserva devem ser terminadas por dois NULL caracteres.

    A primeira seqüência de caracteres em cada par é um seqüência de caracteres exibir que descrevem o filtro (por exemplo, Text Files) e o segundo seqüência de caracteres Especifica o padrão filtro (por exemplo, *.txt). Para especificar múltiplo filtro padrões para uma seqüência de caracteres exibir único, use um ponto-e-vírgula para separar os padrões (de exemplo, *.txt; *.DOC; *.BAK). Um seqüência de caracteres padrão podem ser uma combinação de válido caracteres nome arquivo e o caractere curinga asterisco (*). Não inclua espaços nas seqüência de caracteres padrão.

    O sistema não alteração a ordem dos filtros. Ele exibe-los a Arquivo Tipos caixa de combinação na ordem especificada na lpstrFilter.

    Se lpstrFilter é NULL, caixa de diálogo não exibir todos os filtros.

  • lpstrCustomFilter
    Não suportado.
  • nMaxCustFilter
    Não suportado.

  • nFilterIndex
    Especifica o índice do filtro selecionado no momento no controle de File Types. A reserva apontada pelo lpstrFilter contém pares de seqüências de caracteres que definem os filtros. O primeiro par de seqüências de caracteres tiver um valor índice de 1, o segundo par 2, e assim por diante. Você pode especificar um índice na entrada para indicar o filtro inicial descrição e filtro padrão para caixa de diálogo. Quando o usuário seleciona um arquivo, nFilterIndex Retorna o índice do filtro atualmente exibido.

    Se nFilterIndex for zero, o sistema usa o primeiro filtro in a lpstrFilter reserva.

  • lpstrFile
    Ponteiro longo para uma reserva que contém um nome arquivo usado para inicializar o controle de edição File Name. O primeiro caractere desta reserva deve ser NULL se inicialização não for necessária. Quando o GetOpenFileName Ou GetSaveFileName função retorna com êxito, que esta reserva contém o designador unidade, caminho, nome arquivo e extensão do arquivo selecionado.

    Se a reserva for muito pequena, a função retornará FALSE. Neste maiúsculas e minúsculas, a primeira Two bytes das lpstrFile reserva contêm o exigido tamanho, em bytes ou caracteres.

  • nMaxFile
    Especifica o tamanho, em bytes (versão ANSI) ou 16-bit caracteres (versão Unicode), a reserva apontado pelo lpstrFile. O GetOpenFileName e GetSaveFileName funções retornar FALSE se a reserva é muito pequena para conter a informações do arquivo. A reserva deve ter pelo menos 256 caracteres.
  • lpstrFileTitle
    Ponteiro longo para uma reserva que recebe o nome arquivo e extensão (sem informações caminho) do arquivo selecionado. Esse membro pode ser NULL.
  • nMaxFileTitle
    Especifica o tamanho, em bytes (versão ANSI) ou 16-bit caracteres (versão Unicode), a reserva apontado pelo lpstrFileTitle. Este membro será ignorado se lpstrFileTitle é NULL.
  • lpstrInitialDir
    Ponteiro longo para um seqüência de caracteres que especifica o Diretório arquivo inicial. Se esse membro é NULL, o sistema usa o Diretório raiz.
  • lpstrTitle
    Ponteiro longo para um seqüência de caracteres ser colocados na barra de título de caixa de diálogo. Se esse membro é NULL, usa a sistema de usar como padrão título (ou seja, Salvar como Ou Abrir).

  • Sinalizadores
    Um máscara de bits dos sinalizadores usados para inicializar a caixa diálogo. Quando a caixa diálogo retorna, ele define esses sinalizadores para indicar entrada do usuário. Esse membro pode ser uma combinação do seguinte sinalizadores.

    Valor Descrição

    OFN_ALLOWMULTISELECT

    Não suportado.

    OFN_CREATEPROMPT

    Se o usuário especifica um arquivo que não existe, este sinalizador fará com que a caixa diálogo para prompt o usuário de permissão para criar o arquivo. Se o usuário escolher criar o arquivo, a fecha caixa de diálogo e a função retorna o nome especificado; caso contrário, o diálogo caixa permanecerá aberto.

    OFN_ENABLEHOOK

    Não suportado.

    OFN_ENABLESIZING

    Não suportado.

    OFN_ENABLETEMPLATE

    Não suportado.

    OFN_ENABLETEMPLATEHANDLE

    Não suportado.

    OFN_EXPLORER

    Ignorado. Interface de usuário Explorer sempre é usado.

    OFN_EXTENSIONDIFFERENT

    Especifica que o usuário digitado um extensão de nome de arquivo que difere a extensão especificada por lpstrDefExt. A função não usa esse sinalizador se lpstrDefExt é NULL.

    OFN_FILEMUSTEXIST

    Especifica que o usuário pode tipo apenas nomes dos arquivos existentes na Arquivo Nome campo entrada. Se este sinalizador for especificado e o usuário insere um inválido nome, o procedimento caixa diálogo exibe um aviso em uma caixa mensagem. Se esse sinalizador for especificado, o sinalizador OFN_PATHMUSTEXIST também é usado.

    OFN_HIDEREADONLY

    Oculta o Somente leitura caixa de seleção.

    OFN_LONGNAMES

    Ignorado. Interface de usuário Explorer sempre é usado.

    OFN_NOCHANGEDIR

    Não suportado.

    OFN_NODEREFERENCELINKS

    Direciona a caixa diálogo para retornar o caminho e arquivo Nome de arquivo de atalho selecionado (.LNK). Se esse valor não for especificado, a caixa diálogo retorna o nome caminho e arquivo do arquivo relacionado pelo atalho

    OFN_NOLONGNAMES

    Não suportado.

    OFN_NONETWORKBUTTON

    Não suportado.

    OFN_NOREADONLYRETURN

    Não suportado.

    OFN_NOTESTFILECREATE

    Não suportado.

    OFN_NOVALIDATE

    Ignorado. Um nome arquivo sempre é validado.

    OFN_PROJECT

    Para versão 2.0, faz com que o GetOpenFileName função para a caixa diálogo projeto aberto.

    OFN_PROPERTY

    Para versão 2.0, faz com que o GetSaveFileName função para caixa de diálogo propriedade aberto.

    OFN_OVERWRITEPROMPT

    Faz com que o Salvar Como caixa diálogo gerar uma caixa mensagem se o arquivo selecionado já existe. O usuário deverá confirmar se deseja substituir o arquivo.

    OFN_PATHMUSTEXIST

    Especifica que o usuário pode válido apenas tipo caminhos e nomes arquivo. Se este sinalizador é usado e o usuário digita um inválido nome no caminho e arquivo de Arquivo Nome campo entrada, a função caixa de diálogo exibe um aviso em um caixa de mensagem.

    OFN_READONLY

    Não suportado.

    OFN_SHAREAWARE

    Não suportado.

    OFN_SHOW_ALL

    Especifica que se OFN_PROJECT for definida, apresentação o < All Folders > item.

    Observação

    Esse sinalizador se aplica somente a dispositivos Windows Mobile powered .

    OFN_SHOWHELP

    Não suportado.
  • nFileOffset
    Especifica o deslocamento baseada em zero, em bytes (versão ANSI) ou 16-bit caracteres (versão Unicode), a partir do início do caminho ao nome do arquivo na seqüência de caracteres apontado pelo lpstrFile. Por exemplo, se lpstrFile aponta para o seguinte seqüência de caracteres, c:\dir1\dir2\file.ext, esse membro contém o valor 13 para indicar o deslocamento de seqüência de caracteres de File.ext.
  • nFileExtension
    Especifica o deslocamento baseada em zero, em bytes (versão ANSI) ou 16-bit caracteres (versão Unicode), a partir do início do caminho para o extensão de nome de arquivo na seqüência de caracteres apontado pelo lpstrFile. Por exemplo, se lpstrFile aponta para o seguinte seqüência de caracteres, c:\dir1\dir2\file.ext, esse membro contém o valor 18. Se o usuário não especificou tipo uma extensão e lpstrDefExt é NULL, esse membro especifica um deslocamento para a caractere nulo de terminação. Se o usuário digitou ". " Como o último caractere no nome do arquivo, esse membro especifica zero.
  • lpstrDefExt
    Ponteiro longo para uma reserva que contém a extensão usar como padrão. GetOpenFileName e GetSaveFileName anexar esta extensão para o arquivo nome se o usuário falhar ao tipo de extensão. Esta seqüência de caracteres podem ser qualquer comprimento, mas somente os três primeiros caracteres serão acrescentados. O seqüência de caracteres não devem conter um período (.). Se esse membro é NULL e o usuário falha para tipo uma extensão, nenhuma extensão é acrescentado.
  • lCustData
    Não suportado.
  • lpfnHook
    Não suportado.
  • lpTemplateName
    Não suportado.

Requirements

Header commdlg.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetOpenFileName
GetSaveFileName