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 |
|---|---|
|
텍스트는 쓰기로 보호됩니다. |
|
다른 이유로 인해 실패합니다. |
설명
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 |
추가 정보
개념
참조