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

문서 내에서 선택 영역을 설정합니다.

구문

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

매개 변수

[in] ec

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

[in] ulCount

pSelection 배열의 선택 횟수를 지정합니다.

[in] pSelection

각 선택 영역에 대한 정보를 포함하는 TF_SELECTION 구조체의 배열입니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_E_NOSELECTION	문서에 선택 항목이 없습니다.
TF_E_NOLOCK	ec의 쿠키가 잘못되었습니다.

설명

선택 영역은 강조 표시된 텍스트 범위이거나 범위가 비어 있는 경우 삽입 지점으로, 문서 내의 사용자 포커스 영역을 식별합니다. 일부 문서는 여러 항목을 선택할 수 있습니다. pSelection에는 문서 캐럿의 위치를 나타내기 때문에 길이가 0인 선택 항목이 하나만 있을 수 있습니다.

애플리케이션이 선택 영역으로 적용되는 텍스트를 조정해야 하는 경우 호출자가 잠금을 해제할 때까지 기다려야 합니다. 그러나 애플리케이션은 S_OK 반환하면서 TF_SELECTION 구조체의 스타일 멤버를 조정할 수 있습니다.

호출자는 하나의 선택 항목이 설정된 경우에만 fInterimChar 플래그를 설정할 수 있습니다. 이 경우 선택 영역은 정확히 한 문자에 걸쳐 있어야 하며 TF_SELECTION 구조체의 ase 멤버는 TFAE_NONE 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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::GetSelection