OPENFILENAMEA 구조체(commdlg.h)

아티클
08/22/2023

[Windows Vista부터 일반 항목 대화 상자로 열기 및 저장일반 대화 상자가 대체되었습니다. 공통 대화 상자 라이브러리에서 이러한 대화 상자 대신 공통 항목 대화 상자 API를 사용하는 것이 좋습니다.]

GetOpenFileName 및 GetSaveFileName 함수가 다른 이름으로 열기 또는 다른 이름으로 저장 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조에서 사용자의 선택에 대한 정보를 반환합니다.

구문

typedef struct tagOFNA {
  DWORD         lStructSize;
  HWND          hwndOwner;
  HINSTANCE     hInstance;
  LPCSTR        lpstrFilter;
  LPSTR         lpstrCustomFilter;
  DWORD         nMaxCustFilter;
  DWORD         nFilterIndex;
  LPSTR         lpstrFile;
  DWORD         nMaxFile;
  LPSTR         lpstrFileTitle;
  DWORD         nMaxFileTitle;
  LPCSTR        lpstrInitialDir;
  LPCSTR        lpstrTitle;
  DWORD         Flags;
  WORD          nFileOffset;
  WORD          nFileExtension;
  LPCSTR        lpstrDefExt;
  LPARAM        lCustData;
  LPOFNHOOKPROC lpfnHook;
  LPCSTR        lpTemplateName;
  LPEDITMENU    lpEditInfo;
  LPCSTR        lpstrPrompt;
  void          *pvReserved;
  DWORD         dwReserved;
  DWORD         FlagsEx;
} OPENFILENAMEA, *LPOPENFILENAMEA;

멤버

lStructSize

형식:DWORD

구조체의 길이(바이트)입니다. 이 매개 변수에 를 사용합니다 sizeof (OPENFILENAME) .

hwndOwner

형식: HWND

대화 상자를 소유하는 창에 대한 핸들입니다. 이 멤버는 유효한 창 핸들이거나 대화 상자에 소유자가 없는 경우 NULL 일 수 있습니다.

hInstance

형식: HINSTANCE

OFN_ENABLETEMPLATEHANDLE 플래그가 Flags 멤버에 설정된 경우 hInstance는 대화 상자 템플릿을 포함하는 메모리 개체에 대한 핸들입니다. OFN_ENABLETEMPLATE 플래그가 설정된 경우 hInstance는 lpTemplateName 멤버로 명명된 대화 상자 템플릿이 포함된 모듈에 대한 핸들입니다. 두 플래그가 모두 설정되지 않으면 이 멤버는 무시됩니다. OFN_EXPLORER 플래그가 설정된 경우 시스템은 지정된 템플릿을 사용하여 기본 Explorer 스타일 대화 상자의 자식인 대화 상자를 만듭니다. OFN_EXPLORER 플래그가 설정되지 않은 경우 시스템은 템플릿을 사용하여 기본 대화 상자를 대체하는 이전 스타일 대화 상자를 만듭니다.

lpstrFilter

형식: LPCTSTR

null로 끝나는 필터 문자열 쌍을 포함하는 버퍼입니다. 버퍼의 마지막 문자열은 두 개의 NULL 문자로 종료되어야 합니다.

각 쌍의 첫 번째 문자열은 필터를 설명하는 표시 문자열(예: "텍스트 파일")이며 두 번째 문자열은 필터 패턴(예 ".TXT": )을 지정합니다. 단일 표시 문자열에 여러 필터 패턴을 지정하려면 세미콜론을 사용하여 패턴을 구분합니다(예: ".TXT;.DOC;). BAK"). 패턴 문자열은 유효한 파일 이름 문자와 별표(*) 와일드카드 문자의 조합일 수 있습니다. 패턴 문자열에 공백을 포함하지 마세요.

시스템에서 필터의 순서를 변경하지 않습니다. lpstrFilter에 지정된 순서대로 파일 형식 콤보 상자에 표시됩니다.

lpstrFilter가 NULL이면 대화 상자에 필터가 표시되지 않습니다.

바로 가기의 경우 필터가 설정되지 않은 경우 GetOpenFileName 및 GetSaveFileName 은 대상이 아닌 .lnk 파일의 이름을 검색합니다. 이 동작은 Flags 멤버에서 OFN_NODEREFERENCELINKS 플래그를 설정하는 것과 동일합니다. 필터링하지 않고 바로 가기의 대상을 검색하려면 문자열 "All Files\0*.*\0\0"을 사용합니다.

lpstrCustomFilter

형식: LPTSTR

사용자가 선택한 필터 패턴을 보존하기 위해 null로 끝나는 필터 문자열 쌍을 포함하는 정적 버퍼입니다. 첫 번째 문자열은 사용자 지정 필터를 설명하는 표시 문자열이고 두 번째 문자열은 사용자가 선택한 필터 패턴입니다. 애플리케이션이 대화 상자를 처음 만들 때 첫 번째 문자열을 지정합니다. 이 문자열은 아무 것도 없는 문자열일 수 있습니다. 사용자가 파일을 선택하면 대화 상자에서 현재 필터 패턴을 두 번째 문자열에 복사합니다. 보존된 필터 패턴은 lpstrFilter 버퍼에 지정된 패턴 중 하나이거나 사용자가 입력한 필터 패턴일 수 있습니다. 시스템은 문자열을 사용하여 다음에 대화 상자를 만들 때 사용자 정의 파일 필터를 초기화합니다. nFilterIndex 멤버가 0이면 대화 상자에서 사용자 지정 필터를 사용합니다.

이 멤버가 NULL인 경우 대화 상자는 사용자 정의 필터 패턴을 유지하지 않습니다.

이 멤버가 NULL이 아닌 경우 nMaxCustFilter 멤버의 값은 lpstrCustomFilter 버퍼의 크기를 문자 단위로 지정해야 합니다.

nMaxCustFilter

형식:DWORD

lpstrCustomFilter로 식별되는 버퍼의 크기(문자)입니다. 이 버퍼의 길이는 40자 이상이어야 합니다. lpstrCustomFilter가 NULL이거나 NULL 문자열을 가리키는 경우 이 멤버는 무시됩니다.

nFilterIndex

형식:DWORD

파일 형식 컨트롤에서 현재 선택한 필터의 인덱스입니다. lpstrFilter가 가리키는 버퍼에는 필터를 정의하는 문자열 쌍이 포함되어 있습니다. 문자열의 첫 번째 쌍에는 인덱스 값 1, 두 번째 쌍 2 등이 있습니다. 인덱스 0은 lpstrCustomFilter로 지정된 사용자 지정 필터를 나타냅니다. 입력에 인덱스 를 지정하여 대화 상자의 초기 필터 설명 및 필터 패턴을 나타낼 수 있습니다. 사용자가 파일을 선택하면 nFilterIndex 는 현재 표시된 필터의 인덱스를 반환합니다. nFilterIndex가 0이고 lpstrCustomFilter가 NULL인 경우 시스템은 lpstrFilter 버퍼의 첫 번째 필터를 사용합니다. 세 멤버가 모두 0 또는 NULL이면 시스템에서 필터를 사용하지 않으며 대화 상자의 파일 목록 컨트롤에 파일이 표시되지 않습니다.

lpstrFile

형식: LPTSTR

파일 이름 편집 컨트롤을 초기화하는 데 사용되는 파일 이름 입니다. 초기화가 필요하지 않은 경우 이 버퍼의 첫 번째 문자는 NULL 이어야 합니다. GetOpenFileName 또는 GetSaveFileName 함수가 성공적으로 반환되면 이 버퍼에는 선택한 파일의 드라이브 지정자, 경로, 파일 이름 및 확장자가 포함됩니다.

OFN_ALLOWMULTISELECT 플래그가 설정되고 사용자가 여러 파일을 선택하는 경우 버퍼에는 현재 디렉터리와 선택한 파일의 파일 이름이 포함됩니다. Explorer 스타일 대화 상자의 경우 디렉터리 및 파일 이름 문자열은 NULL로 구분되고 마지막 파일 이름 뒤에 추가 NULL 문자가 있습니다. 이전 스타일 대화 상자의 경우 문자열은 공백으로 구분되고 함수는 공백이 있는 파일 이름에 짧은 파일 이름을 사용합니다. FindFirstFile 함수를 사용하여 long 파일 이름과 짧은 파일 이름 간에 변환할 수 있습니다. 사용자가 파일을 하나만 선택하면 lpstrFile 문자열에 경로와 파일 이름 사이에 구분 기호가 없습니다.

버퍼가 너무 작으면 함수는 FALSE 를 반환하고 CommDlgExtendedError 함수는FNERR_BUFFERTOOSMALL 반환합니다. 이 경우 lpstrFile 버퍼의 처음 두 바이트에는 필요한 크기(바이트 또는 문자)가 포함됩니다.

nMaxFile

형식:DWORD

lpstrFile이 가리키는 버퍼의 크기(문자)입니다. 버퍼는 종료 되는 NULL 문자를 포함하여 경로 및 파일 이름 문자열 또는 문자열을 저장할 수 있을 만큼 커야 합니다. 버퍼가 너무 작아서 파일 정보를 포함할 수 없는 경우 GetOpenFileName 및 GetSaveFileName 함수는 FALSE 를 반환합니다. 버퍼의 길이는 256자 이상이어야 합니다.

lpstrFileTitle

형식: LPTSTR

선택한 파일의 파일 이름 및 확장명(경로 정보 없음)입니다. 이 멤버는 NULL일 수 있습니다.

nMaxFileTitle

형식:DWORD

lpstrFileTitle이 가리키는 버퍼의 크기(문자)입니다. lpstrFileTitle이 NULL인 경우 이 멤버는 무시됩니다.

lpstrInitialDir

형식: LPCTSTR

초기 디렉터리입니다. 초기 디렉터리를 선택하는 알고리즘은 플랫폼마다 다릅니다.

Windows 7:

애플리케이션에서 열기 또는 다른 이름으로 저장 대화 상자를 처음 사용할 때 lpstrInitialDir의 값이 전달된 값과 동일한 경우 사용자가 가장 최근에 선택한 경로가 초기 디렉터리로 사용됩니다.
그렇지 않으면 lpstrFile 에 경로가 포함된 경우 해당 경로는 초기 디렉터리입니다.
그렇지 않으면 lpstrInitialDir 이 NULL이 아닌 경우 초기 디렉터리를 지정합니다.
lpstrInitialDir이 NULL이고 현재 디렉터리에 지정된 필터 형식의 파일이 포함된 경우 초기 디렉터리가 현재 디렉터리입니다.
그렇지 않으면 초기 디렉터리가 현재 사용자의 개인 파일 디렉터리입니다.
그렇지 않으면 초기 디렉터리가 Desktop 폴더입니다.

Windows 2000/XP/Vista:

lpstrFile에 경로가 포함된 경우 해당 경로는 초기 디렉터리입니다.
그렇지 않으면 lpstrInitialDir 에서 초기 디렉터리를 지정합니다.
그렇지 않으면 애플리케이션이 과거에 열기 또는 다른 이름으로 저장 대화 상자를 사용한 경우 가장 최근에 사용한 경로가 초기 디렉터리로 선택됩니다. 그러나 애플리케이션이 오랫동안 실행되지 않으면 저장된 선택한 경로가 삭제됩니다.
lpstrInitialDir이 NULL이고 현재 디렉터리에 지정된 필터 형식의 파일이 포함된 경우 초기 디렉터리가 현재 디렉터리입니다.
그렇지 않으면 초기 디렉터리가 현재 사용자의 개인 파일 디렉터리입니다.
그렇지 않으면 초기 디렉터리가 Desktop 폴더입니다.

lpstrTitle

형식: LPCTSTR

대화 상자의 제목 표시줄에 배치할 문자열입니다. 이 멤버가 NULL인 경우 시스템은 기본 제목(즉, 다른 이름으로 저장 또는 열기)을 사용합니다.

Flags

형식:DWORD

대화 상자를 초기화하는 데 사용할 수 있는 비트 플래그 집합입니다. 대화 상자가 반환되면 이러한 플래그를 설정하여 사용자의 입력을 나타냅니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.

값	의미
OFN_ALLOWMULTISELECT 0x00000200	파일 이름 목록 상자에서 여러 항목을 선택할 수 있습니다. 또한 OFN_EXPLORER 플래그를 설정하는 경우 대화 상자는 Explorer 스타일 사용자 인터페이스를 사용합니다. 그렇지 않으면 이전 스타일의 사용자 인터페이스를 사용합니다. 사용자가 둘 이상의 파일을 선택하는 경우 lpstrFile 버퍼는 현재 디렉터리에 대한 경로와 선택한 파일의 파일 이름을 반환합니다. nFileOffset 멤버는 첫 번째 파일 이름에 대한 오프셋(바이트 또는 문자)이며 nFileExtension 멤버는 사용되지 않습니다. Explorer 스타일 대화 상자의 경우 디렉터리 및 파일 이름 문자열은 NULL로 구분되고 마지막 파일 이름 뒤에 추가 NULL 문자가 있습니다. 이 형식을 사용하면 Explorer 스타일 대화 상자에서 공백이 포함된 긴 파일 이름을 반환할 수 있습니다. 이전 스타일 대화 상자의 경우 디렉터리 및 파일 이름 문자열은 공백으로 구분되고 함수는 공백이 있는 파일 이름에 짧은 파일 이름을 사용합니다. FindFirstFile 함수를 사용하여 long 파일 이름과 짧은 파일 이름 간에 변환할 수 있습니다. 이전 스타일 대화 상자에 대한 사용자 지정 템플릿을 지정하는 경우 파일 이름 목록 상자의 정의에는 LBS_EXTENDEDSEL 값이 포함되어야 합니다.
OFN_CREATEPROMPT 0x00002000	사용자가 존재하지 않는 파일을 지정하는 경우 이 플래그를 사용하면 대화 상자에서 사용자에게 파일 만들기 권한을 묻는 메시지가 표시됩니다. 사용자가 파일을 만들도록 선택하면 대화 상자가 닫히고 함수가 지정된 이름을 반환합니다. 그렇지 않으면 대화 상자가 열린 상태로 유지됩니다. 이 플래그를 OFN_ALLOWMULTISELECT 플래그와 함께 사용하면 대화 상자에서 사용자가 존재하지 않는 파일을 하나만 지정할 수 있습니다.
OFN_DONTADDTORECENT 0x02000000	시스템에서 사용자의 가장 최근에 사용한 문서가 포함된 파일 시스템 디렉터리에서 선택한 파일에 대한 링크를 추가하지 못하도록 합니다. 이 디렉터리의 위치를 검색하려면 CSIDL_RECENT 플래그를 사용하여 SHGetSpecialFolderLocation 함수를 호출합니다.
OFN_ENABLEHOOK 0x00000020	lpfnHook 멤버에 지정된 후크 함수를 사용하도록 설정합니다.
OFN_ENABLEINCLUDENOTIFY 0x00400000	사용자가 폴더를 열 때 대화 상자가 CDN_INCLUDEITEM 알림 메시지를 OFNHookProc 후크 프로시저로 보내도록 합니다. 대화 상자는 새로 열린 폴더의 각 항목에 대한 알림을 보냅니다. 이러한 메시지를 사용하면 대화 상자가 폴더의 항목 목록에 표시되는 항목을 제어할 수 있습니다.
OFN_ENABLESIZING 0x00800000	마우스 또는 키보드를 사용하여 Explorer 스타일 대화 상자의 크기를 조정할 수 있습니다. 기본적으로 Explorer 스타일 열기 및 다른 이름으로 저장 대화 상자를 사용하면 이 플래그가 설정되었는지 여부에 관계없이 대화 상자의 크기를 조정할 수 있습니다. 이 플래그는 후크 프로시저 또는 사용자 지정 템플릿을 제공하는 경우에만 필요합니다. 이전 스타일 대화 상자는 크기 조정을 허용하지 않습니다.
OFN_ENABLETEMPLATE 0x00000040	lpTemplateName 멤버는 hInstance 멤버로 식별된 모듈의 대화 템플릿 리소스 이름에 대한 포인터입니다. OFN_EXPLORER 플래그가 설정된 경우 시스템은 지정된 템플릿을 사용하여 기본 Explorer 스타일 대화 상자의 자식인 대화 상자를 만듭니다. OFN_EXPLORER 플래그가 설정되지 않은 경우 시스템은 템플릿을 사용하여 기본 대화 상자를 대체하는 이전 스타일 대화 상자를 만듭니다.
OFN_ENABLETEMPLATEHANDLE 0x00000080	hInstance 멤버는 미리 로드된 대화 상자 템플릿이 포함된 데이터 블록을 식별합니다. 이 플래그가 지정된 경우 시스템은 lpTemplateName 을 무시합니다. OFN_EXPLORER 플래그가 설정된 경우 시스템은 지정된 템플릿을 사용하여 기본 Explorer 스타일 대화 상자의 자식인 대화 상자를 만듭니다. OFN_EXPLORER 플래그가 설정되지 않은 경우 시스템은 템플릿을 사용하여 기본 대화 상자를 대체하는 이전 스타일 대화 상자를 만듭니다.
OFN_EXPLORER 0x00080000	다른 이름으로 열기 또는 다른 이름으로 저장 대화 상자에 대한 사용자 지정이 Explorer 스타일 사용자 지정 방법을 사용함을 나타냅니다. 자세한 내용은 Explorer 스타일 후크 프로시저 및 Explorer 스타일 사용자 지정 템플릿을 참조하세요. 기본적으로 다른 이름으로 열기 및 저장 대화 상자는 이 플래그가 설정되었는지 여부에 관계없이 Explorer 스타일 사용자 인터페이스를 사용합니다. 이 플래그는 후크 프로시저 또는 사용자 지정 템플릿을 제공하거나 OFN_ALLOWMULTISELECT 플래그를 설정하는 경우에만 필요합니다. 이전 스타일 사용자 인터페이스를 원하는 경우 OFN_EXPLORER 플래그를 생략하고 대체 이전 스타일 템플릿 또는 후크 프로시저를 제공합니다. 이전 스타일을 원하지만 사용자 지정 템플릿 또는 후크 프로시저가 필요하지 않은 경우 항상 FALSE를 반환하는 후크 프로시저를 제공하기만 하면 됩니다.
OFN_EXTENSIONDIFFERENT 0x00000400	사용자가 lpstrDefExt에 지정된 확장명과 다른 파일 이름 확장명을 입력했습니다. lpstrDefExt가 NULL인 경우 함수는 이 플래그를 사용하지 않습니다.
OFN_FILEMUSTEXIST 0x00001000	사용자는 파일 이름 입력 필드에 기존 파일의 이름만 입력할 수 있습니다. 이 플래그를 지정하고 사용자가 잘못된 이름을 입력하면 대화 상자 프로시저에 메시지 상자에 경고가 표시됩니다. 이 플래그를 지정하면 OFN_PATHMUSTEXIST 플래그도 사용됩니다. 이 플래그는 열기 대화 상자에서 사용할 수 있습니다. 다른 이름으로 저장 대화 상자와 함께 사용할 수 없습니다.
OFN_FORCESHOWHIDDEN 0x10000000	시스템 및 숨겨진 파일을 강제로 표시하여 숨겨진 파일을 표시하거나 표시하지 않도록 사용자 설정을 재정의합니다. 그러나 시스템 및 숨김으로 표시된 파일은 표시되지 않습니다.
OFN_HIDEREADONLY 0x00000004	읽기 전용 검사 상자를 숨깁니다.
OFN_LONGNAMES 0x00200000	이전 스타일 대화 상자의 경우 이 플래그를 사용하면 대화 상자에서 긴 파일 이름을 사용합니다. 이 플래그를 지정하지 않거나 OFN_ALLOWMULTISELECT 플래그도 설정된 경우 이전 스타일 대화 상자는 공백이 있는 파일 이름에 짧은 파일 이름(8.3 형식)을 사용합니다. Explorer 스타일 대화 상자는 이 플래그를 무시하고 항상 긴 파일 이름을 표시합니다.
OFN_NOCHANGEDIR 0x00000008	사용자가 파일을 검색하는 동안 디렉터리를 변경한 경우 현재 디렉터리를 원래 값으로 복원합니다. 이 플래그는 GetOpenFileName에 비효율적입니다.
OFN_NODEREFERENCELINKS 0x00100000	선택한 바로 가기의 경로와 파일 이름()을 반환하도록 대화 상자를 지시합니다. LNK) 파일. 이 값을 지정하지 않으면 대화 상자는 바로 가기에서 참조하는 파일의 경로와 파일 이름을 반환합니다.
OFN_NOLONGNAMES 0x00040000	이전 스타일 대화 상자의 경우 이 플래그를 사용하면 대화 상자에서 짧은 파일 이름(8.3 형식)을 사용합니다. Explorer 스타일 대화 상자는 이 플래그를 무시하고 항상 긴 파일 이름을 표시합니다.
OFN_NONETWORKBUTTON 0x00020000	네트워크 단추를 숨기고 사용하지 않도록 설정합니다.
OFN_NOREADONLYRETURN 0x00008000	반환된 파일에는 읽기 전용 검사 상자가 선택되어 있지 않으며 쓰기로 보호된 디렉터리에 없습니다.
OFN_NOTESTFILECREATE 0x00010000	대화 상자를 닫기 전에 파일이 만들어지지 않습니다. 애플리케이션이 가상화되지 않은 네트워크 공유에 파일을 저장하는 경우 이 플래그를 지정해야 합니다. 애플리케이션이 이 플래그를 지정하는 경우 라이브러리는 쓰기 보호, 전체 디스크, 오픈 드라이브 도어 또는 네트워크 보호를 위해 검사 않습니다. 이 플래그를 사용하는 애플리케이션은 파일을 닫은 후 다시 열 수 없으므로 파일 작업을 신중하게 수행해야 합니다.
OFN_NOVALIDATE 0x00000100	일반 대화 상자는 반환된 파일 이름에 잘못된 문자를 허용합니다. 일반적으로 호출 애플리케이션은 FILEOKSTRING 메시지를 사용하여 파일 이름을 확인하는 후크 프로시저를 사용합니다. 편집 컨트롤의 텍스트 상자가 비어 있거나 공백만 포함된 경우 파일 및 디렉터리 목록이 업데이트됩니다. 편집 컨트롤의 텍스트 상자에 다른 내용이 포함된 경우 nFileOffset 및 nFileExtension 은 텍스트를 구문 분석하여 생성된 값으로 설정됩니다. 텍스트에 기본 확장이 추가되지 않으며 lpstrFileTitle에서 지정한 버퍼에 텍스트가 복사되지 않습니다. nFileOffset에 지정된 값이 0보다 작으면 파일 이름이 잘못되었습니다. 그렇지 않으면 파일 이름이 유효하고 nFileExtension 및 nFileOffset 을 OFN_NOVALIDATE 플래그가 지정되지 않은 것처럼 사용할 수 있습니다.
OFN_OVERWRITEPROMPT 0x00000002	선택한 파일이 이미 있는 경우 다른 이름으로 저장 대화 상자가 메시지 상자를 생성하도록 합니다. 사용자는 파일을 덮어쓸지 여부를 확인해야 합니다.
OFN_PATHMUSTEXIST 0x00000800	사용자는 유효한 경로 및 파일 이름만 입력할 수 있습니다. 이 플래그를 사용하고 사용자가 파일 이름 입력 필드에 잘못된 경로와 파일 이름을 입력하는 경우 대화 상자 함수는 메시지 상자에 경고를 표시합니다.
OFN_READONLY 0x00000001	대화 상자를 만들 때 읽기 전용 검사 상자가 처음에 선택되도록 합니다. 이 플래그는 대화 상자가 닫혀 있을 때 읽기 전용 검사 상자의 상태를 나타냅니다.
OFN_SHAREAWARE 0x00004000	네트워크 공유 위반으로 인해 OpenFile 함수 호출이 실패하면 오류가 무시되고 대화 상자에서 선택한 파일 이름을 반환하도록 지정합니다. 이 플래그를 설정하지 않으면 사용자가 지정한 파일 이름에 대해 네트워크 공유 위반이 발생할 때 대화 상자가 후크 프로시저에 알깁니다. OFN_EXPLORER 플래그를 설정하면 대화 상자에서 CDN_SHAREVIOLATION 메시지를 후크 프로시저로 보냅니다. OFN_EXPLORER 설정하지 않으면 대화 상자에서 SHAREVISTRING 등록된 메시지를 후크 프로시저로 보냅니다.
OFN_SHOWHELP 0x00000010	대화 상자에 도움말 단추가 표시되도록 합니다. hwndOwner 멤버는 사용자가 도움말 단추를 클릭할 때 대화 상자에서 보내는 HELPMSGSTRING 등록 메시지를 받을 창을 지정해야 합니다. Explorer 스타일 대화 상자는 사용자가 도움말 단추를 클릭할 때 후크 프로시저에 CDN_HELP 알림 메시지를 보냅니다.

nFileOffset

형식: WORD

lpstrFile이 가리키는 문자열의 파일 이름에 대한 경로의 시작 부분부터 문자 단위의 0부터 시작하는 오프셋입니다. ANSI 버전의 경우 바이트 수입니다. 유니코드 버전의 경우 문자 수입니다. 예를 들어 lpstrFile 이 다음 문자열 "c:\dir1\dir2\file.ext"를 가리키는 경우 이 멤버는 "file.ext" 문자열의 오프셋을 나타내는 값 13을 포함합니다. 사용자가 둘 이상의 파일을 선택하는 경우 nFileOffset 은 첫 번째 파일 이름에 대한 오프셋입니다.

nFileExtension

형식: WORD

경로의 시작 부분에서 lpstrFile이 가리키는 문자열의 파일 이름 확장명까지의 0부터 시작하는 오프셋(문자)입니다. ANSI 버전의 경우 바이트 수입니다. 유니코드 버전의 경우 문자 수입니다. 일반적으로 파일 이름 확장명은 점(".") 문자가 마지막으로 나타나는 부분 문자열입니다. 예를 들어 txt는 파일 이름 readme.txt 확장명이며, readme.txt.html 확장명은 html입니다. 따라서 lpstrFile이 "c:\dir1\dir2\readme.txt" 문자열을 가리키는 경우 이 멤버에는 값 20이 포함됩니다. lpstrFile이 문자열 "c:\dir1\dir2\readme.txt.html"을 가리키는 경우 이 멤버에는 값 24가 포함됩니다. lpstrFile이 문자열 "c:\dir1\dir2\readme.txt.html."을 가리키는 경우 이 멤버에는 값 29가 포함됩니다. lpstrFile이 "c:\dir1\dir2\readme"와 같은 "." 문자를 포함하지 않는 문자열을 가리키는 경우 이 멤버에는 0이 포함됩니다.

lpstrDefExt

형식: LPCTSTR

기본 확장입니다. GetOpenFileName 및 GetSaveFileName 은 사용자가 확장명을 입력하지 못하는 경우 이 확장명을 파일 이름에 추가합니다. 이 문자열은 모든 길이일 수 있지만 처음 세 문자만 추가됩니다. 문자열에 마침표(.)가 포함되어서는 안 됩니다. 이 멤버가 NULL 이고 사용자가 확장을 입력하지 못하면 확장이 추가되지 않습니다.

lCustData

형식: LPARAM

시스템이 lpfnHook 멤버로 식별된 후크 프로시저에 전달하는 애플리케이션 정의 데이터입니다. 시스템에서 WM_INITDIALOG 메시지를 후크 프로시저로 보낼 때 메시지의 lParam 매개 변수는 대화 상자를 만들 때 지정된 OPENFILENAME 구조체에 대한 포인터입니다. 후크 프로시저는 이 포인터를 사용하여 lCustData 값을 가져올 수 있습니다.

lpfnHook

형식: LPOFNHOOKPROC

후크 프로시저에 대한 포인터입니다. Flags 멤버에 OFN_ENABLEHOOK플래그가 포함되어 있지 않으면 이 멤버는 무시됩니다.

OFN_EXPLORER 플래그가 Flags 멤버에 설정되지 않은 경우 lpfnHook는 대화 상자용 메시지를 수신하는 OFNHookProcOldStyle 후크 프로시저에 대한 포인터입니다. 후크 프로시저는 기본 대화 상자 프로시저에 메시지를 전달하려면 FALSE 를 반환하고 메시지를 삭제하려면 TRUE 를 반환합니다.

OFN_EXPLORER 설정된 경우 lpfnHook는 OFNHookProc 후크 프로시저에 대한 포인터입니다. 후크 프로시저는 대화 상자에서 보낸 알림 메시지를 받습니다. 후크 프로시저는 자식 대화 상자 템플릿을 지정하여 정의한 추가 컨트롤에 대한 메시지도 받습니다. 후크 프로시저는 기본 대화 상자의 표준 컨트롤에 대한 메시지를 수신하지 않습니다.

lpTemplateName

형식: LPCTSTR

hInstance 멤버로 식별된 모듈의 대화 상자 템플릿 리소스 이름입니다. 번호가 매겨진 대화 상자 리소스의 경우 MAKEINTRESOURCE 매크로에서 반환되는 값일 수 있습니다. flags 멤버에서 OFN_ENABLETEMPLATE 플래그를 설정하지 않으면 이 멤버는 무시됩니다. OFN_EXPLORER 플래그가 설정된 경우 시스템은 지정된 템플릿을 사용하여 기본 Explorer 스타일 대화 상자의 자식인 대화 상자를 만듭니다. OFN_EXPLORER 플래그가 설정되지 않은 경우 시스템은 템플릿을 사용하여 기본 대화 상자를 대체하는 이전 스타일 대화 상자를 만듭니다.

lpEditInfo

이 멤버는 조건부로 컴파일(사용 #ifdef _MAC)되므로 Windows 클라이언트 운영 체제가 아닌 Motorola 68K Macintosh 컴퓨터에만 적용됩니다.

lpstrPrompt

이 멤버는 조건부로 컴파일(사용 #ifdef _MAC)되므로 Windows 클라이언트 운영 체제가 아닌 Motorola 68K Macintosh 컴퓨터에만 적용됩니다.

pvReserved

형식: void*

이 멤버는 예약되어 있습니다.

dwReserved

형식:DWORD

이 멤버는 예약되어 있습니다.

FlagsEx

형식:DWORD

대화 상자를 초기화하는 데 사용할 수 있는 비트 플래그 집합입니다. 현재 이 멤버는 0 또는 다음 플래그일 수 있습니다.

값	의미
OFN_EX_NOPLACESBAR 0x00000001	이 플래그를 설정하면 위치 표시줄이 표시되지 않습니다. 이 플래그를 설정하지 않으면 Explorer 스타일 대화 상자에 즐겨찾기 및 데스크톱과 같이 일반적으로 사용되는 폴더에 대한 아이콘이 포함된 위치 표시줄이 포함됩니다.

설명

호환성을 위해 Flags가 OFN_ENABLEHOOK 설정되고 lStructSize가 OPENFILENAME_SIZE_VERSION_400 경우 Places Bar가 숨겨집니다.

참고

commdlg.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 OPENFILENAME을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	commdlg.h(Windows.h 포함)