Share via


ITextServices::OnTxPropertyBitsChange 메서드(textserv.h)

컨트롤에 대한 속성(비트로 표시)을 설정합니다.

구문

HRESULT OnTxPropertyBitsChange(
  [in] DWORD dwMask,
  [in] DWORD dwBits
);

매개 변수

[in] dwMask

형식: DWORD

변경할 속성을 나타내는 비트입니다. 가능한 비트 값은 dwBits의 TXTBIT_* 값 목록을 참조하세요.

[in] dwBits

형식: DWORD

비트 속성에 대한 새 값입니다. 다음의 조합일 수 있습니다.

의미
TXTBIT_ALLOWBEEP
TRUE이면 비프음이 사용됩니다.
TXTBIT_AUTOWORDSEL
TRUE이면 AutoWordSelect 기능이 활성화됩니다.
TXTBIT_BACKSTYLECHANGE
TRUE이면 백스타일이 변경되었습니다. TxGetBackStyle을 참조하세요.
TXTBIT_CHARFORMATCHANGE
TRUE이면 문자 형식이 변경되었습니다.
TXTBIT_CLIENTRECTCHANGE
TRUE이면 클라이언트 사각형이 변경되었습니다.
TXTBIT_DISABLEDRAG
TRUE이면 끌기를 사용할 수 없습니다.
TXTBIT_D2DDWRITE
GDI/Uniscribe가 아닌 이 instance Direct2D/DirectWrite 사용합니다.
TXTBIT_D2DPIXELSNAPPED
문자 모양을 가장 가까운 픽셀 위치에 렌더링합니다. D2DDWRITE 설정된 경우에만 유효합니다.
TXTBIT_D2DSUBPIXELLINES
하위 픽셀 정밀도로 선을 그립니다. 보조 텍스트 흐름 방향(일반적으로 세로)에서 텍스트 줄, 밑줄 및 취소선을 픽셀 맞춤하지 마세요. D2DDWRITE 설정되고 D2DPIXELSNAPPED 설정되지 않은 경우에만 유효합니다.
TXTBIT_D2DSIMPLETYPOGRAPHY
간단한 입력 체계(문자 모양 렌더링 없음)를 사용하여 텍스트를 렌더링합니다. 이 값은 TXTBIT_D2DDWRITE 지정한 경우에만 유효합니다.
TXTBIT_EXTENTCHANGE
TRUE이면 클라이언트 사각형의 크기가 변경되었습니다.
TXTBIT_HIDESELECTION
TRUE이면 텍스트 서비스 개체는 컨트롤이 비활성 상태일 때 선택 영역을 숨겨야 합니다. FALSE이면 컨트롤이 비활성 상태일 때 선택 항목이 표시됩니다.

이는 TXTBIT_SAVESELECTION TRUE임을 의미 합니다.

TXTBIT_MAXLENGTHCHANGE
TRUE이면 컨트롤의 텍스트에 대한 최대 길이가 변경되었습니다.
TXTBIT_MULTILINE
TRUE이면 text services 개체가 여러 줄 모드에서 작동해야 합니다. TXTBIT_WORDWRAP 값을 사용하여 선을 보기 사각형으로 래핑할지 또는 클립할 것인지를 결정합니다.

FALSE인 경우 text services 개체는 ENTER 키에서 캐리지 리턴/줄 바꿈을 처리하지 않아야 하며 첫 번째 줄 바꿈 직전에 줄 바꿈이 포함된 들어오는 텍스트를 잘라야 합니다. 여러 줄 필드에 바인딩될 때 한 줄 컨트롤을 사용하지 않는 것은 호스트의 책임이므로 ITextServices::TxSetText로 설정된 텍스트를 자르는 것도 허용됩니다.

TXTBIT_NOTHREADREFCOUNT
이 instance 대신하여 TLS 데이터를 참조하지 마세요.
TXTBIT_PARAFORMATCHANGE
TRUE이면 단락 형식이 변경되었습니다.
TXTBIT_READONLY
TRUE이면 text services 개체가 사용자 인터페이스를 통해 편집 변경을 수락해서는 안 됩니다. 그러나 EM_SETTEXTEX, EM_REPLACESEL 및 ITextServices::TxSetText를 통해 프로그래밍 방식으로 변경된 내용을 계속 허용해야 합니다. 또한 사용자는 여전히 삽입 지점을 이동하고, 텍스트를 선택하고, 복사와 같은 콘텐츠를 수정하지 않는 다른 작업을 수행할 수 있어야 합니다.
TXTBIT_RICHTEXT
TRUE이면 text services 개체가 서식 있는 텍스트 모드여야 합니다.

FALSE이면 일반 텍스트 모드입니다.

편집 명령이 적용되는 방식에 영향을 줍니다. 예를 들어 일반 편집 컨트롤에서 텍스트의 일부에 굵게 적용하면 전체 텍스트가 굵게 표시됩니다. 그러나 서식 있는 편집 컨트롤의 경우 선택한 텍스트만 굵게 만듭니다.

TXTBIT_SAVESELECTION
TRUE이면 컨트롤이 비활성 상태일 때 선택 영역의 경계를 저장해야 합니다.

FALSE이면 컨트롤이 다시 활성화되면 선택 경계를 다시 설정하여 = 0, 길이 = 0을 시작할 수 있습니다.

TXTBIT_SCROLLBARCHANGE
TRUE이면 스크롤 막대가 변경되었습니다.
TXTBIT_SELBARCHANGE
TRUE이면 선택 막대 너비가 변경되었습니다.
TXTBIT_SHOWACCELERATOR
설정된 경우 액셀러레이터 문자에 밑줄을 긋아야 합니다.

TxGetAcceleratorPos를 호출하려면 설정해야 합니다.

TXTBIT_SHOWPASSWORD
암호 문자열을 표시합니다.
TXTBIT_USECURRENTBKG
지원되지 않습니다.
TXTBIT_USEPASSWORD
TRUE이면 TxGetPasswordChar에서 가져온 암호 문자를 사용하여 텍스트를 표시합니다.

이 속성에 대한 알림은 암호 문자가 변경되었거나 암호 문자가 이전에 사용되지 않았지만 지금은 사용되었음을 의미할 수 있습니다(또는 그 반대의 경우도 마찬가지임).

TXTBIT_VERTICAL
지원되지 않습니다.
TXTBIT_VIEWINSETCHANGE
TRUE이면 inset이 변경되었습니다.
TXTBIT_WORDWRAP
TRUE 및 TXTBIT_MULTILINE TRUE이면 여러 줄 컨트롤이 선을 뷰 사각형으로 래핑해야 합니다. 이 속성이 FALSE 이고 TXTBIT_MULTILINETRUE이면 줄을 래핑하지 않고 잘려야 합니다. 보기 사각형의 오른쪽은 무시해야 합니다.

TXTBIT_MULTILINEFALSE이면 이 속성은 적용되지 않습니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 S_OK.

메서드가 실패하면 반환 값은 다음 HRESULT 코드입니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드 설명
E_NOTIMPL
구현되지 않았습니다.

설명

클라이언트 사각형은 text services 개체가 그리기 및 관리를 담당하는 사각형입니다. 호스트는 텍스트 서비스 개체를 사용하여 해당 영역을 그립니다. text services 개체는 해당 사각형 외부의 영역을 그리거나 무효화해서는 안 됩니다. 또한 호스트는 커서가 이 사각형 위에 있을 때 텍스트 서비스 개체에 마우스 메시지를 전달합니다. 이 사각형은 포함된 창의 클라이언트 좌표로 표현됩니다.

뷰 삽입은 클라이언트 사각형과 뷰 사각형 사이의 각 면에 있는 공간의 양입니다. 뷰 사각형(서식 사각형이라고도 함)은 텍스트의 서식을 지정해야 하는 사각형입니다. 자세한 내용은 TxGetViewInset을 참조하세요.

백스타일은 클라이언트 사각형의 배경 스타일입니다. TXTBACK_TRANSPARENT 또는 TXTBACK_SOLID 수 있습니다. TXTBACKSTYLE을 참조하세요.

스크롤 막대 속성은 스크롤 막대의 변경 내용을 나타냅니다. 스크롤 막대가 있는지, 스크롤할 때 스크롤 막대가 숨겨지거나 사용하지 않도록 설정되었는지 여부, 삽입 지점이 클라이언트 사각형에서 벗어날 때 자동 스크롤이 활성화된 경우입니다.

요구 사항

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

추가 정보

개념

ITextServices

기타 리소스

RECT

참조

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

창 없는 Rich Edit 컨트롤