Compartilhar via

OPENFILENAMEEX

  • Artigo

Windows Mobile SupportedWindows Embedded CE Not Supported

9/9/2008

Essa estrutura contém informações usadas para inicializar o GetOpenFileNameEx função.

Syntax

typedef struct tagOPENFILENAMEEX {
   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;
   OFN_EXFLAG ExFlags;
   OFN_SORTORDER dwSortOrder;
} OPENFILENAME, *LPOPENFILENAME;

Os membros

  • lStructSize
    O tamanho dessa estrutura, em bytes.
  • hwndOwner
    Um identificador para o janela proprietária.
  • hInstance
    Identificador para o módulo cujo arquivo executável contém a caixa diálogo.
  • lpstrFilter
    Quando ExFlags Tem o OFN_EXFLAG_THUMBNAILVIEW bit no e lpstrFilter é NULL, diálogo exibe todos os tipos arquivo de imagem com suporte, o sistema.
  • 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 GetOpenFileNameEx 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 GetOpenFileNameEx função 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
    Quando ExFlags Tem o OFN_EXFLAG_THUMBNAILVIEW bit no e lpstrInitialDir é NULL, padrões diálogo para "%MyDocuments%\My imagens", onde IMAGENS %MyDocuments%\My é a CSIDL_MYPICTURES pasta especial
  • lpstrTitle
    Quando initialView é FVM_THUMBNAIL e lpstrTitle é NULL, padrões de título diálogo para 'Selecione uma imagem'.
  • Sinalizadores
    Um máscara de bits dos sinalizadores usados para inicializar a caixa diálogo.
  • 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. GetOpenFileNameEx acrescentará essa extensão ao nome do arquivo 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.

  • ExFlags
    Um máscara de bits dos sinalizadores usados para inicializar o diálogo. A seguinte tabela mostra os valores, com uma descrição de cada valor.

    Valor Descrição

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEODEFAULT

    Iniciar a câmera no vídeo modo sem alterar o áudio configuração.

    Essa configuração é mutuamente com:

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEOONLY

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEOWITHAUDIO

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEOONLY

    Iniciar a câmera no vídeo modo e áudio desativar a gravação. O usuário pode habilitar o áudio no diálogo Opções.

    Desde áudio configurações são compartilhadas entre GetOpenFileNameEx e pimg.exe (o aplicativo visualizador de imagem), alterando o áudio configurações aqui afetará pimg.exe assim.

    Essa configuração é mutuamente com:

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEODEFAULT

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEOWITHAUDIO

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEOWITHAUDIO

    Iniciar a câmera no vídeo modo e áudio habilitar a gravação. O usuário pode desativar áudio no diálogo de opções.

    Desde áudio configurações são compartilhadas entre GetOpenFileNameEx e pimg.exe (o aplicativo visualizador de imagem), alterando o áudio configurações aqui afetará pimg.exe assim.

    Essa configuração é mutuamente com:

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEODEFAULT

    OFN_EXFLAG_CAMERACAPTURE_MODE_VIDEOONLY

    OFN_EXFLAG_DETAILSVIEW

    Exibe a ListView no formato detalhes.

    OFN_EXFLAG_EXPLORERVIEW

    Exibe a ListView no formato Explorer.

    OFN_EXFLAG_HIDEDRMFORWARDLOCKED

    Quando esse sinalizador é definida, indica que de conteúdo Forward Locked não é exibido no seletor a imagem.

    OFN_EXFLAG_HIDEDRMPROTECTED

    Se este sinalizador estiver definido, indica que arquivos protegido por DRM não estiverem exibidos no selecionador de imagens.

    OFN_EXFLAG_MESSAGING_FILE_CREATE

    Apenas as resoluções de imagem apresentação ou vídeo perfis que estão marcados como tipos de mensagens.

    OFN_EXFLAG_THUMBNAILVIEW

    Exibe a ListView no formato de miniaturas

  • dwSortOrder
    Especifica a ordem classificar inicial. dwSortOrder é com suporte atualmente somente quando ExFlags Tem o OFN_EXFLAG_THUMBNAILVIEW bit no. A seguinte tabela mostra os valores, com uma descrição de cada valor.

    Valor Descrição

    OFN_SORTORDER_AUTO

    Ordem de classificação é implementação-dependente.

    OFN_SORTORDER_DATE

    Ordem de classificação é Data decrescente. dwSortOrder Padrões para este valor quando ExFlags é OFN_EXFLAG_THUMBNAILVIEW

    OFN_SORTORDER_NAME

    Ordem de classificação é dependente no nome.

    OFN_SORTORDER_SIZE

    Ordem de classificação é dependente em tamanho.

Requirements

Header aygshell.h
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

Estruturas do shell
GetOpenFileNameEx