ITextFont::SetProtected 메서드(tom.h)

아티클
08/26/2023

문자를 수정하려는 시도로부터 문자가 보호되는지 여부를 설정합니다.

구문

HRESULT SetProtected(
  [in] long Value
);

매개 변수

[in] Value

형식: long

다음 중 하나일 수 있는 tomBool 값입니다.

값	의미
tomTrue	문자가 보호됩니다.
tomFalse	문자는 보호되지 않습니다.
tomToggle	Protected 속성의 상태를 전환합니다.
tomUndefined	Protected 속성이 정의되지 않았습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 다음 COM 오류 코드 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
E_INVALIDARG	인수가 잘못되었습니다.
CO_E_RELEASED	글꼴 개체는 삭제된 범위에 연결됩니다.
E_ACCESSDENIED	쓰기 액세스가 거부되었습니다.
E_OUTOFMEMORY	메모리가 부족합니다.

설명

일반적으로 범위의 서식 또는 내용을 변경하려는 TOM(텍스트 개체 모델) 메서드는 해당 범위의 일부가 보호되거나 문서가 읽기 전용인 경우 E_ACCESSDENIED 실패합니다. 보호된 텍스트를 변경하려면 TOM 클라이언트가 수정할 텍스트의 보호를 해제하려고 시도해야 합니다. 문서의 소유자가 이를 허용할 수 있습니다. 예를 들어 서식 있는 편집 컨트롤에서 보호된 텍스트를 변경하려고 하면 EN_PROTECTED 알림 코드가 문서 작성자에 적용됩니다. 그러면 변경에 대한 권한을 거부하거나 부여할 수 있습니다. 작성자는 CreateWindow 함수 또는 CreateTextServices 함수를 호출하여 창 없는 서식 있는 편집 컨트롤을 만드는 ITextHost 개체를 통해 창이 있는 서식 있는 편집 컨트롤을 만든 클라이언트입니다.

요구 사항

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