Share via

FINDREPLACEA 구조체(commdlg.h)

  • 아티클

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

구문

typedef struct tagFINDREPLACEA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPSTR        lpstrFindWhat;
  LPSTR        lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;

멤버

lStructSize

형식:DWORD

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

hwndOwner

형식: HWND

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

hInstance

형식: HINSTANCE

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

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
 찾기 또는 바꾸기 대화 상자를 초기화할 때 설정된 경우 전체 Word 일치 검사 상자를 숨깁니다.
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
 설정하면 전체 Word 일치 검사 상자가 선택되어 검색 문자열과 일치하는 전체 단어만 검색해야 함을 나타냅니다. 설정하지 않으면 검사 상자가 선택되지 않으므로 검색 문자열과 일치하는 단어 조각도 검색해야 합니다. 이 플래그를 설정하여 대화 상자를 초기화할 수 있습니다. FINDMSGSTRING 메시지에서 설정된 경우 는 사용자의 선택을 나타냅니다.

lpstrFindWhat

형식: LPTSTR

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

lpstrReplaceWith

형식: LPTSTR

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

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

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

wFindWhatLen

형식: WORD

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

wReplaceWithLen

형식: WORD

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

lCustData

형식: LPARAM

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

lpfnHook

형식: LPFRHOOKPROC

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

lpTemplateName

형식: LPCTSTR

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

설명

참고

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

요구 사항

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

추가 정보

일반 대화 상자 라이브러리

개념

FRHookProc

Findtext

MAKEINTRESOURCE

참조

ReplaceText

Showwindow

WM_INITDIALOG