EM_STREAMOUT 메시지

서식 있는 편집 컨트롤이 콘텐츠를 애플리케이션 정의 EditStreamCallback 콜백 함수에 전달하도록 합니다. 그러면 콜백 함수는 데이터 스트림을 파일이나 선택한 다른 위치에 쓸 수 있습니다.

매개 변수

wParam

데이터 서식 및 바꾸기 옵션을 지정합니다.

이 값은 다음 값 중 하나여야 합니다.

값	의미
SF_RTF	RTF.
SF_RTFNOOBJS	COM 개체 대신 공백이 있는 RTF.
SF_TEXT	COM 개체 대신 공백이 있는 텍스트입니다.
SF_TEXTIZED	COM 개체의 텍스트 표현이 포함된 텍스트입니다.

SF_RTFNOOBJS 옵션은 COM 개체의 RTF 표현이 그리 간단하지 않기 때문에 애플리케이션이 COM 개체 자체를 저장하는 경우에 유용합니다. 컨트롤 단어 \objattph 뒤에 공백이 있으면 개체 위치를 나타냅니다.

또한 다음 플래그를 지정할 수 있습니다.

값	의미
SFF_PLAINRTF	지정된 경우 서식 있는 편집 컨트롤은 언어별 키워드를 무시하고 모든 언어에 공통적인 키워드만 스트리밍합니다. 지정하지 않으면 서식 있는 편집 컨트롤이 모든 키워드를 스트리밍합니다. 이 플래그를 SF_RTF 또는 SF_RTFNOOBJS 플래그와 결합할 수 있습니다.
SFF_SELECTION	지정된 경우 서식 있는 편집 컨트롤은 현재 선택 항목의 콘텐츠만 스트리밍합니다. 지정하지 않으면 컨트롤이 전체 콘텐츠를 스트리밍합니다. 이 플래그를 모든 데이터 서식 값과 결합할 수 있습니다.
SF_UNICODE	Microsoft Rich Edit 2.0 이상: 유니코드 텍스트를 나타냅니다. 이 플래그를 SF_TEXT 플래그와 결합할 수 있습니다.
SF_USECODEPAGE	서식 있는 편집 3.0 이상: 다른 코드 페이지를 사용하여 UTF-8 RTF 및 텍스트를 생성합니다. 코드 페이지는 wParam의 상위 단어에 설정됩니다. 예를 들어, UTF-8 RTF의 경우 wParam을 (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF에 설정합니다.

lParam

EDITSTREAM 구조체에 대한 포인터입니다. 입력 시 이 구조체의 pfnCallback 멤버는 애플리케이션 정의 EditStreamCallback 함수를 가리켜야 합니다. 출력 시 dwError 멤버는 오류가 발생한 경우 0이 아닌 오류 코드를 포함할 수 있습니다.

반환 값

이 메시지는 데이터 스트림에 기록된 문자 수를 반환합니다.

설명

EM_STREAMOUT 메시지를 보낼 때 서식 있는 편집 컨트롤은 EDITSTREAM 구조체의 pfnCallback 멤버가 지정한 EditStreamCallback 함수를 반복적으로 호출합니다. 콜백 함수를 호출할 때마다 컨트롤은 컨트롤 콘텐츠의 일부를 포함하는 버퍼를 전달합니다. 이 프로세스는 컨트롤이 모든 콘텐츠를 콜백 함수에 전달하거나 오류가 발생할 때까지 계속됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Richedit.h

추가 정보

참조

EDITSTREAM

EditStreamCallback

EM_STREAMIN