ITfContext::GetSelection 메서드(msctf.h)

문서 내에서 선택 항목을 가져옵니다.

구문

HRESULT GetSelection(
  [in]  TfEditCookie ec,
  [in]  ULONG        ulIndex,
  [in]  ULONG        ulCount,
  [out] TF_SELECTION *pSelection,
  [out] ULONG        *pcFetched
);

매개 변수

[in] ec

편집 세션을 식별하는 편집 쿠키를 포함합니다. ITfEditSession::D oEditSession에 전달된 값입니다.

[in] ulIndex

가져올 첫 번째 선택 영역의 인덱스(0부터 시작)를 지정합니다. TF_DEFAULT_SELECTION 사용하여 기본 선택을 가져옵니다. TF_DEFAULT_SELECTION 사용하는 경우 하나의 선택 항목만 가져옵니다.

[in] ulCount

가져올 최대 선택 횟수를 지정합니다.

[out] pSelection

각 선택 영역에 대한 데이터를 수신하는 TF_SELECTION 구조체의 배열입니다. 배열은 적어도 ulCount 요소를 보유할 수 있어야 합니다.

[out] pcFetched

가져온 선택 횟수를 수신하는 ULONG 값에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_E_NOSELECTION	문서에 선택 항목이 없습니다.
TF_E_NOLOCK	ec의 쿠키가 잘못되었습니다.
TF_E_DISCONNECTED	컨텍스트가 문서 스택에 없습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	메모리 할당 오류가 발생했습니다.

설명

선택 영역은 강조 표시된 텍스트 범위이거나, 범위가 비어 있으면 문서 내의 사용자 포커스 영역을 식별하는 삽입 지점입니다.

이 메서드가 성공하면 호출자는 가져온 모든 TF_SELECTION 구조체의 범위 멤버를 해제해야 합니다.

일반적으로 컨텍스트는 단일 선택만 지원합니다. 그러나 컨텍스트가 여러 동시 선택을 지원할 수 있습니다. 이 메서드는 여러 선택 항목을 가져오는 데 사용할 수 있습니다.

예제

HRESULT         hr;
TF_SELECTION    tfSel;
ULONG           uFetched;

//Obtain the default selection. 
hr = pContext->GetSelection(ec, TF_DEFAULT_SELECTION, 1, &tfSel, &uFetched);
if(SUCCEEDED(hr) && (uFetched > 0))
{
    //Work with the selection. 
    
    //Release the selection range object. 
    tfSel.range->Release();
}

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0

참고 항목

ITfContext 인터페이스, ITfEditSession::D oEditSession, TF_SELECTION structure, ITfContext::SetSelection