ITfRange 인터페이스(msctf.h)

아티클
03/08/2023

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