ITextRange::D elete 메서드(tom.h)

CTRL 키를 누른 상태로 두지 않고 DELETE 및 BACKSPACE 키를 모방합니다.

구문

HRESULT Delete(
  long Unit,
  long Count,
  long *pDelta
);

매개 변수

Unit

형식: long

사용할 단위입니다. 단위 는 tomCharacter (기본값) 또는 tomWord일 수 있습니다.

Count

형식: long

삭제할 단위수입니다. Count= 0이면 범위의 텍스트만 삭제됩니다. Count가 0보다 크면 ITextRange::D 삭제는 DELETE 키가 Count 시간을 누른 것처럼 작동합니다. Count가 0보다 작으면 백스페이스 키를 눌렀던 것처럼 작동합니다. 기본값은 1입니다. 자세한 내용은 주의 섹션을 참조하십시오.

pDelta

형식: long*

삭제된 단위 수입니다. null일 수 있습니다. pDelta 매개 변수는 삭제된 단위수와 동일하게 설정됩니다. 퇴화되지 않은 범위의 텍스트를 삭제하면 하나의 단위로 계산됩니다.

반환 값

형식: HRESULT

이 메서드는 HRESULT 값을 반환합니다. 성공하면 S_OK 반환합니다. 그렇지 않으면 다음 값 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	Description
E_ACCESSDENIED	텍스트는 쓰기로 보호됩니다.
S_FALSE	다른 이유로 인해 실패합니다.

설명

Count = 0이면 이 메서드는 범위의 텍스트를 삭제합니다. 즉, 범위가 삽입 지점일 경우 아무 것도 삭제하지 않습니다.

Count가 0이 아니고 범위가 삽입 지점(즉, 퇴화)인 경우 | Count| (절대값 개수) 단위s는 Count 기호에 의해 지정된 논리적 방향으로 삭제됩니다. 여기서 양수 값은 스토리의 끝 방향이고 음수 값은 스토리의 시작 부분에 있습니다.

Count가 0이 아니고 범위가 퇴화되지 않은 경우(텍스트 포함) 범위의 텍스트는 단위 및 개수 값에 관계없이 삭제되어 삽입 지점을 만듭니다. 그런 다음, | Count| - 1 단위는 Count 기호에 의해 지정된 논리적 방향으로 삭제 됩니다.

범위에 null 문자열을 할당하여 범위의 텍스트를 삭제할 수도 있습니다(r = 여기서 은 범위임). 그러나 ITextRange::D 삭제 는 BSTR을 할당할 필요가 없습니다.

CR(단락 끝 표시)을 삭제하면 Microsoft Word UI의 특수 동작이 발생합니다. 4개의 경우는 특히 관심이 있습니다.

• CR만 삭제하지만 단락에 텍스트가 포함된 경우 CR이 삭제되고 다음 단락은 현재 단락과 동일한 단락 서식을 가져옵니다.
• 다음 단락의 일부 문자뿐만 아니라 일부 문자도 삭제하면 현재 단락에서 남은 문자는 다음 단락의 단락 서식을 가져옵니다.
• 단락의 끝까지 선택하지만 전체 단락은 선택하지 않으면 CR이 삭제되지 않습니다.
• 전체 단락을 삭제하는 경우(처음부터 CR까지) 파일의 마지막 CR이 아닌 한 CR도 삭제합니다.

요구 사항

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

추가 정보

개념

ITextRange

참조

텍스트 개체 모델