EDITWORDBREAKPROCW 콜백 함수(winuser.h)

아티클
03/04/2024

EM_SETWORDBREAKPROC 메시지와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 여러 줄 편집 컨트롤 또는 서식 있는 편집 컨트롤은 EditWordBreakProc 함수를 호출하여 텍스트 줄을 끊습니다.

EDITWORDBREAKPROC 형식은 이 콜백 함수에 대한 포인터를 정의합니다. EditWordBreakProc는 애플리케이션 정의 함수 이름에 대한 자리 표시자입니다.

구문

EDITWORDBREAKPROCW Editwordbreakprocw;

int Editwordbreakprocw(
  [in] LPWSTR lpch,
  [in] int ichCurrent,
  [in] int cch,
  [in] int code
)
{...}

매개 변수

[in] lpch

형식: LPTSTR

편집 컨트롤의 텍스트에 대한 포인터입니다.

[in] ichCurrent

형식: int

함수가 단어 분리 확인을 시작해야 하는 지점을 식별하는 텍스트 버퍼의 문자 위치에 대한 인덱스입니다.

[in] cch

형식: int

편집 컨트롤 텍스트의 TCHAR 수입니다. ANSI 텍스트의 경우 바이트 수입니다. 유니코드 텍스트의 경우 WCHAR의 수입니다.

[in] code

형식: int

콜백 함수에서 수행할 작업입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
WB_CLASSIFY	지정된 위치에 있는 문자의 문자 클래스 및 단어 나누기 플래그를 검색합니다. 이 값은 서식 있는 편집 컨트롤과 함께 사용하기 위한 것입니다.
WB_ISDELIMITER	지정된 위치에 있는 문자가 구분 기호인지 여부를 확인합니다.
WB_LEFT	지정된 위치의 왼쪽에 있는 단어의 시작을 찾습니다.
WB_LEFTBREAK	지정된 위치의 왼쪽에 있는 단어 끝 구분 기호를 찾습니다. 이 값은 서식 있는 편집 컨트롤과 함께 사용하기 위한 것입니다.
WB_MOVEWORDLEFT	지정된 위치의 왼쪽에 있는 단어의 시작을 찾습니다. 이 값은 Ctrl+LEFT 키를 처리하는 동안 사용됩니다. 이 값은 서식 있는 편집 컨트롤과 함께 사용하기 위한 것입니다.
WB_MOVEWORDRIGHT	지정된 위치의 오른쪽에 있는 단어의 시작을 찾습니다. 이 값은 Ctrl+RIGHT 키를 처리하는 동안 사용됩니다. 이 값은 서식 있는 편집 컨트롤과 함께 사용하기 위한 것입니다.
WB_RIGHT	지정된 위치의 오른쪽에 있는 단어의 시작을 찾습니다. 오른쪽 맞춤 편집 컨트롤에 유용합니다.
WB_RIGHTBREAK	지정된 위치의 오른쪽에 있는 단어 끝 구분 기호를 찾습니다. 오른쪽 맞춤 편집 컨트롤에 유용합니다. 이 값은 서식 있는 편집 컨트롤과 함께 사용하기 위한 것입니다.

반환 값

형식: int

코드 매개 변수가 WB_ISDELIMITER 지정하는 경우 지정한 위치에 있는 문자가 구분 기호이면 반환 값이 0이 아니고 TRUE가 아니면 0이 됩니다. 코드 매개 변수가 WB_CLASSIFY 지정하는 경우 반환 값은 지정된 위치에 있는 문자의 문자 클래스 및 단어 나누기 플래그입니다. 그렇지 않으면 반환 값은 텍스트 버퍼에서 단어의 시작 부분에 대한 인덱스입니다.

설명

캐리지 리턴과 줄 바꿈은 콜백 함수에 의해 단일 단어로 처리되어야 합니다. 두 개의 캐리지 리턴과 줄 바꿈도 한 단어로 처리해야 합니다.

애플리케이션은 EM_SETWORDBREAKPROC 메시지에서 콜백 함수의 주소를 지정하여 콜백 함수를 설치해야 합니다.

서식 있는 편집 1.0:Microsoft Rich Edit 1.0은 ANSI 문자만 EditWordBreakProc에 전달합니다. 서식 있는 편집 컨트롤의 경우 EM_SETWORDBREAKPROCEX 메시지를 번갈아 사용하여 기본 확장 단어 분리 프로시저를 EditWordBreakProcEx 콜백 함수로 바꿀 수 있습니다. 이 함수는 문자 집합과 같은 텍스트에 대한 추가 정보를 제공합니다.

서식 있는 편집 2.0 이상:Microsoft Rich Edit 2.0 이상에서는 유니코드 문자만 EditWordBreakProc에 전달합니다. 따라서 ANSI 애플리케이션은 WideCharToMultiByte를 사용하여 리치 편집 제공 유니코드 문자열을 변환한 다음 인덱스를 적절하게 변환합니다.

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)