FINDREPLACEW 구조체(commdlg.h)

아티클
11/20/2024

FindText 및 ReplaceText 함수가 찾기 초기화하고 바꾸기 대화 상자를 초기화하는 데 사용하는 정보가 포함되어 있습니다. FINDMSGSTRING 등록된 메시지는 이 구조를 사용하여 사용자의 검색 또는 대체 입력을 찾기 또는 바꾸기 대화 상자의 소유자 창에 전달합니다.

통사론

typedef struct tagFINDREPLACEW {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPWSTR       lpstrFindWhat;
  LPWSTR       lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCWSTR      lpTemplateName;
} FINDREPLACEW, *LPFINDREPLACEW;

회원

lStructSize

형식: DWORD

구조체의 길이(바이트)입니다.

hwndOwner

형식: HWND

대화 상자를 소유하는 창에 대한 핸들입니다. 지정한 창의 창 프로시저는 대화 상자에서 FINDMSGSTRING 메시지를 받습니다. 이 멤버는 유효한 창 핸들일 수 있지만 NULL안 됩니다.

hInstance

형식: HINSTANCE

FR_ENABLETEMPLATEHANDLE 플래그가 Flags설정된 경우 hInstance 대화 상자 템플릿을 포함하는 메모리 개체에 대한 핸들입니다. FR_ENABLETEMPLATE 플래그가 설정되면 hInstancelpTemplateName 멤버로 명명된 대화 상자 템플릿이 포함된 모듈에 대한 핸들입니다. 두 플래그가 모두 설정되지 않으면 이 멤버는 무시됩니다.

Flags

형식: DWORD

대화 상자를 초기화하는 데 사용할 수 있는 비트 플래그 집합입니다. 대화 상자는 사용자의 입력을 나타내기 위해 FINDMSGSTRING 등록된 메시지를 보낼 때 이러한 플래그를 설정합니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.

값	의미
FR_DIALOGTERM 0x00000040	FINDMSGSTRING 메시지에 설정된 경우 대화 상자가 닫히고 있음을 나타냅니다. 이 플래그가 설정된 메시지를 받으면 FindText 또는 ReplaceText 함수에서 반환된 대화 상자 핸들이 더 이상 유효하지 않습니다.
FR_DOWN 0x00000001	설정하면 현재 위치에서 문서 끝까지 검색해야 함을 나타내는 찾기 대화 상자에서 방향 라디오 단추의 아래쪽 단추가 선택됩니다. 설정하지 않으면 위로 단추가 선택되므로 문서의 시작 부분으로 검색해야 합니다. 이 플래그를 설정하여 대화 상자를 초기화할 수 있습니다. FINDMSGSTRING 메시지에 설정된 경우 사용자의 선택을 나타냅니다.
FR_ENABLEHOOK 0x00000100	lpfnHook 멤버에 지정된 후크 함수를 사용하도록 설정합니다. 이 플래그는 대화 상자를 초기화하는 데만 사용됩니다.
FR_ENABLETEMPLATE 0x00000200	hInstance 및 lpTemplateName 멤버가 기본 템플릿 대신 사용할 대화 상자 템플릿을 지정함을 나타냅니다. 이 플래그는 대화 상자를 초기화하는 데만 사용됩니다.
FR_ENABLETEMPLATEHANDLE 0x00002000	hInstance 멤버가 미리 로드된 대화 상자 템플릿을 포함하는 데이터 블록을 식별함을 나타냅니다. 이 플래그가 지정된 경우 시스템에서 lpTemplateName 멤버를 무시합니다.
FR_FINDNEXT 0x00000008	FINDMSGSTRING 메시지에 설정된 경우 사용자가 찾기 또는 바꾸기 대화 상자에서 다음 찾기 단추를 클릭했음을 나타냅니다. lpstrFindWhat 멤버는 검색할 문자열을 지정합니다.
FR_HIDEUPDOWN 0x00004000	찾기 대화 상자를 초기화할 때 설정된 경우 검색 방향 라디오 단추를 숨깁니다.
FR_HIDEMATCHCASE 0x00008000	찾기 또는 바꾸기 대화 상자를 초기화할 때 설정된 경우 대/소문자 확인란을 숨깁니다.
FR_HIDEWHOLEWORD 0x00010000	찾기 또는 바꾸기 대화 상자를 초기화할 때 설정된 경우 단어 전체만 일치 확인란을 숨깁니다.
FR_MATCHCASE 0x00000004	설정된 경우 대/소문자를 구분해야 함을 나타내는 대/소문자 확인란이 선택됩니다. 설정하지 않으면 확인란이 선택되지 않으므로 검색이 대/소문자를 구분하지 않아야 합니다. 이 플래그를 설정하여 대화 상자를 초기화할 수 있습니다. FINDMSGSTRING 메시지에 설정된 경우 사용자의 선택을 나타냅니다.
FR_NOMATCHCASE 0x00000800	찾기 또는 바꾸기 대화 상자를 초기화할 때 설정된 경우 대/소문자 확인란을 사용하지 않도록 설정합니다.
FR_NOUPDOWN 0x00000400	찾기 대화 상자를 초기화할 때 설정된 경우 검색 방향 라디오 단추를 사용하지 않도록 설정합니다.
FR_NOWHOLEWORD 0x00001000	찾기 또는 바꾸기 대화 상자를 초기화할 때 설정된 경우 Word 확인란을 사용하지 않도록 설정합니다.
FR_REPLACE 0x00000010	FINDMSGSTRING 메시지에 설정된 경우 사용자가 바꾸기 대화 상자에서 바꾸기 단추를 클릭했음을 나타냅니다. lpstrFindWhat 멤버는 바꿀 문자열을 지정하고 lpstrReplaceWith 멤버는 대체 문자열을 지정합니다.
FR_REPLACEALL 0x00000020	FINDMSGSTRING 메시지에 설정된 경우 사용자가 바꾸기 대화 상자에서 모든 바꾸기 단추를 클릭했음을 나타냅니다. lpstrFindWhat 멤버는 바꿀 문자열을 지정하고 lpstrReplaceWith 멤버는 대체 문자열을 지정합니다.
FR_SHOWHELP 0x00000080	대화 상자에 도움말 단추가 표시되도록 합니다. hwndOwner 멤버는 사용자가 도움말 단추를 클릭할 때 대화 상자에서 보내는 HELPMSGSTRING 등록된 메시지를 받을 창을 지정해야 합니다.
FR_WHOLEWORD 0x00000002	설정된 경우 단어 전체만 일치 확인란이 선택되어 검색 문자열과 일치하는 전체 단어만 검색해야 함을 나타냅니다. 설정하지 않으면 확인란이 선택되지 않으므로 검색 문자열과 일치하는 단어 조각도 검색해야 합니다. 이 플래그를 설정하여 대화 상자를 초기화할 수 있습니다. FINDMSGSTRING 메시지에 설정된 경우 사용자의 선택을 나타냅니다.

lpstrFindWhat

형식: LPTSTR

사용자가 입력한 검색 문자열 찾기 편집 컨트롤입니다. 대화 상자가 닫히기 전에 범위를 벗어나지 않도록 버퍼를 동적으로 할당하거나 전역 또는 정적 배열을 사용해야 합니다. 버퍼의 길이는 80자 이상이어야 합니다. 대화 상자를 초기화할 때 버퍼에 문자열이 포함된 경우 찾기 편집 컨트롤에 문자열이 표시됩니다. FINDMSGSTRING 메시지가 FR_FINDNEXT 플래그를 지정하는 경우 lpstrFindWhat 검색할 문자열이 포함됩니다. FR_DOWN, FR_WHOLEWORD및 FR_MATCHCASE 플래그는 검색의 방향과 유형을 나타냅니다. FINDMSGSTRING 메시지가 FR_REPLACE 또는 FR_REPLACE 플래그를 지정하는 경우 lpstrFindWhat 바꿀 문자열이 포함됩니다.

lpstrReplaceWith

형식: LPTSTR

사용자가 입력한 대체 문자열로 바꾸기 편집 컨트롤입니다. 대화 상자가 닫히기 전에 범위를 벗어나지 않도록 버퍼를 동적으로 할당하거나 전역 또는 정적 배열을 사용해야 합니다. 대화 상자를 초기화할 때 버퍼에 문자열이 포함된 경우 대체 편집 컨트롤에 문자열이 표시됩니다.

FINDMSGSTRING 메시지가 FR_REPLACE 또는 FR_REPLACEALL 플래그를 지정하는 경우 lpstrReplaceWith 대체 문자열이 포함됩니다.

FindText 함수는 이 멤버를 무시합니다.

wFindWhatLen

형식: WORD

lpstrFindWhat 멤버가 가리키는 버퍼의 길이(바이트)입니다.

wReplaceWithLen

형식: WORD

lpstrReplaceWith 멤버가 가리키는 버퍼의 길이(바이트)입니다.

lCustData

형식: LPARAM

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

lpfnHook

형식: LPFRHOOKPROC

대화 상자에 대한 메시지를 처리할 수 있는 FRHookProc 후크 프로시저에 대한 포인터입니다. FR_ENABLEHOOK 플래그가 Flags 멤버에 설정되지 않으면 이 멤버는 무시됩니다. 후크 프로시저가 WM_INITDIALOG 메시지에 대한 응답으로 FALSE 반환하는 경우 후크 프로시저에 대화 상자가 표시되어야 합니다. 그렇지 않으면 대화 상자가 표시되지 않습니다. 이렇게 하려면 먼저 다른 페인트 작업을 수행한 다음 ShowWindow 호출하고 UpdateWindow 함수를 .

lpTemplateName

형식: LPCTSTR

hInstance 멤버로 식별되는 모듈의 대화 상자 템플릿 리소스 이름입니다. 이 템플릿은 표준 대화 상자 템플릿으로 대체됩니다. 번호가 매겨진 대화 상자 리소스의 경우 MAKEINTRESOURCE 매크로에서 반환된 값일 수 있습니다. FR_ENABLETEMPLATE 플래그가 Flags 멤버에 설정되지 않으면 이 멤버는 무시됩니다.

발언

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
헤더	commdlg.h(Windows.h 포함)

참고 항목

일반 대화 상자 라이브러리

개념

FRHookProc

FindText

메이킨트레소스

참조

ReplaceText

ShowWindow

WM_INITDIALOG

다음을 통해 공유

FINDREPLACEW 구조체(commdlg.h)

통사론

회원

발언

요구 사항

참고 항목

피드백

추가 리소스