ITfRange 인터페이스(msctf.h)
ITfRange 인터페이스는 텍스트 서비스 및 애플리케이션에서 지정된 컨텍스트 내에서 텍스트를 참조하고 조작하는 데 사용됩니다. 인터페이스 ID가 IID_ITfRange.
상속
ITfRange 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ITfRange 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
ITfRange 인터페이스에는 이러한 메서드가 있습니다.
| ITfRange::AdjustForInsert ITfRange::AdjustForInsert 메서드는 텍스트 삽입을 위해 조정할 텍스트 범위를 확장하거나 축소합니다. |
| ITfRange::Clone ITfRange::Clone 메서드는 이 텍스트 범위를 복제합니다. |
| ITfRange::Collapse ITfRange::Collapse 메서드는 시작 앵커와 끝 앵커를 동일한 위치로 이동하여 텍스트 범위를 지웁니다. |
| ITfRange::CompareEnd ITfRange::CompareEnd 메서드는 이 텍스트 범위의 끝 앵커 위치를 다른 범위의 앵커와 비교합니다. |
| ITfRange::CompareStart ITfRange::CompareStart 메서드는 이 텍스트 범위의 시작 앵커 위치를 다른 범위의 앵커와 비교합니다. |
| ITfRange::GetContext ITfRange::GetContext 메서드 |
| ITfRange::GetEmbedded ITfRange::GetEmbedded 메서드는 텍스트 스트림의 TS_CHAR_EMBEDDED 문자에 해당하는 콘텐츠를 가져옵니다. 텍스트 범위의 시작 앵커는 관심 있는 문자 바로 앞에 배치됩니다. |
| ITfRange::GetFormattedText ITfRange::GetFormattedText 메서드는 텍스트 범위 내에 포함된 형식이 지정된 콘텐츠를 가져옵니다. 콘텐츠는 IDataObject 인터페이스를 지원하는 개체에 패키지됩니다. |
| ITfRange::GetGravity ITfRange::GetGravity 메서드 |
| ITfRange::GetText ITfRange::GetText 메서드는 이 텍스트 범위에서 다루는 콘텐츠를 가져옵니다. |
| ITfRange::InsertEmbedded ITfRange::InsertEmbedded 메서드는 텍스트 범위의 시작 앵커 위치에 개체를 삽입합니다. |
| ITfRange::IsEmpty ITfRange::IsEmpty 메서드는 시작 및 끝 앵커가 동일한 위치를 차지하기 때문에 텍스트 범위가 비어 있는지 확인합니다. |
| ITfRange::IsEqualEnd ITfRange::IsEqualStart 메서드는 이 텍스트 범위의 끝 앵커가 지정된 다른 범위의 앵커와 일치하는지 확인합니다. |
| ITfRange::IsEqualStart ITfRange::IsEqualStart 메서드는 이 텍스트 범위의 시작 앵커가 지정된 다른 범위의 앵커와 일치하는지 확인합니다. |
| ITfRange::SetGravity ITfRange::SetGravity 메서드 |
| ITfRange::SetText ITfRange::SetText 메서드는 텍스트 범위에서 다루는 콘텐츠를 대체합니다. |
| ITfRange::ShiftEnd ITfRange::ShiftEnd 메서드 |
| ITfRange::ShiftEndRegion ITfRange::ShiftEndRegion 메서드 |
| ITfRange::ShiftEndToRange ITfRange::ShiftEndToRange 메서드 |
| ITfRange::ShiftStart ITfRange::ShiftStart 메서드 |
| ITfRange::ShiftStartRegion ITfRange::ShiftStartRegion 메서드 |
| ITfRange::ShiftStartToRange ITfRange::ShiftStartToRange 메서드 |
설명
TSF 관리자는 이 인터페이스를 구현합니다. 범위, 앵커, 포함된 개체 및 TSF에서 사용하는 기타 텍스트 속성에 대한 자세한 내용은 Text Services 프레임워크 사용 내의 범위, 포함된 개체 및 기타 topics 참조하세요.
예제
ITfComposition 컴퍼지션 개체가 인스턴스화되면 다음 코드 예제와 같이 ITfComposition::GetRange 메서드를 호출하여 ITfRange 인터페이스 포인터에 대한 포인터를 가져올 수 있습니다.
HRESULT hr;
ITfComposition *pComposition;
ITfRange *pRange;
WCHAR *achBuffer[64]; // Buffer to receive text.
ULONG cch;
hr = pComposition->GetRange(&pRange);
if(SUCCEEDED(hr))
{
// Loop to scan text:
do
{
cch = ARRAYSIZE(achBuffer);
hr = pRange->GetText(ec, TF_TF_MOVESTART | TF_TF_IGNOREEND, achBuffer, cch, &cch);
if(SUCCEEDED(hr))
{
// Do something with the text.
pRange->Release();
}
}
while (cch == ARRAYSIZE(achBuffer));
pComposition->Release();
}
현재 ITfRange 개체에 대한 포인터는 TF_SELECTION 구조체의 범위> 요소에서 <가져올 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |