SHAutoComplete 함수(shlwapi.h)

아티클
03/15/2023

자동 완성을 사용하여 URL 또는 파일 시스템 경로를 완료하도록 시스템 편집 컨트롤에 지시합니다.

구문

LWSTDAPI SHAutoComplete(
  [in] HWND  hwndEdit,
       DWORD dwFlags
);

매개 변수

[in] hwndEdit

형식: HWND

시스템 편집 컨트롤의 창 핸들입니다. 일반적으로 이 매개 변수는 편집 컨트롤의 핸들 또는 ComboBoxEx 컨트롤에 포함된 편집 컨트롤입니다.

dwFlags

형식:DWORD

SHAutoComplete 작업을 제어하는 플래그입니다. 처음 네 개의 플래그는 인터넷 Explorer 레지스트리 설정을 재정의하는 데 사용됩니다. 사용자는 도구 메뉴에서 인터넷 옵션 속성 시트를 시작하고 고급 탭을 클릭하여 이러한 설정을 수동으로 변경할 수 있습니다.

SHACF_AUTOAPPEND_FORCE_OFF(0x80000000)

레지스트리 기본값을 무시하고 AutoAppend 기능을 강제로 해제합니다. 이 플래그는 하나 이상의 SHACF_FILESYS* 또는 SHACF_URL* 플래그와 함께 사용해야 합니다.

SHACF_AUTOAPPEND_FORCE_ON(0x40000000)

레지스트리 값을 무시하고 AutoAppend 기능을 강제로 설정합니다. 완성된 문자열은 추가된 문자가 강조 표시된 편집 상자에 표시됩니다. 이 플래그는 하나 이상의 SHACF_FILESYS* 또는 SHACF_URL* 플래그와 함께 사용해야 합니다.

SHACF_AUTOSUGGEST_FORCE_OFF(0x20000000)

레지스트리 기본값을 무시하고 AutoSuggest 기능을 강제로 해제합니다. 이 플래그는 하나 이상의 SHACF_FILESYS* 또는 SHACF_URL* 플래그와 함께 사용해야 합니다.

SHACF_AUTOSUGGEST_FORCE_ON(0x10000000)

레지스트리 값을 무시하고 AutoSuggest 기능을 강제로 설정합니다. 가능한 완료된 문자열의 선택 항목이 편집 상자 아래에 드롭다운 목록으로 표시됩니다. 이 플래그는 하나 이상의 SHACF_FILESYS* 또는 SHACF_URL* 플래그와 함께 사용해야 합니다.

SHACF_DEFAULT(0x00000000)

SHACF_FILESYSTEM SHACF_URLALL | 해당하는 기본 설정입니다. SHACF_DEFAULT 다른 플래그와 결합할 수 없습니다.

SHACF_FILESYS_ONLY(0x00000010)

파일 시스템만 포함합니다.

SHACF_FILESYS_DIRS(0x00000020)

파일 시스템 및 디렉터리, UNC 서버 및 UNC 서버 공유를 포함합니다.

SHACF_FILESYSTEM(0x00000001)

파일 시스템 및 셸의 나머지 부분(예: 데스크톱, 컴퓨터 및 제어판)을 포함합니다.

SHACF_URLALL(SHACF_URLHISTORY | SHACF_URLMRU)

사용자 기록 및 최근에 사용한 목록에 URL을 포함합니다. SHACF_URLHISTORY SHACF_URLMRU | 동일합니다.

SHACF_URLHISTORY(0x00000002)

사용자의 기록 목록에 URL을 포함합니다.

SHACF_URLMRU(0x00000004)

사용자의 최근에 사용한 목록에 URL을 포함합니다.

SHACF_USETAB(0x00000008)

TAB 키를 눌러 사용자가 자동 제안 목록에서 선택할 수 있도록 허용합니다. 이 플래그가 설정되지 않은 경우 TAB 키를 누르면 포커스가 다음 컨트롤로 이동하고 자동 제안 목록을 닫습니다. SHACF_USETAB 설정되면 TAB 키를 누르면 목록의 첫 번째 항목이 선택됩니다. TAB 키를 다시 누르면 목록에서 다음 항목이 선택됩니다. 사용자가 목록의 끝에 도달하면 다음 TAB 키를 누르면 포커스가 편집 컨트롤로 다시 순환됩니다. 이 플래그는 이 페이지에 나열된 하나 이상의 SHACF_FILESYS* 또는 SHACF_URL* 플래그와 함께 사용해야 합니다.

SHACF_VIRTUAL_NAMESPACE(0x00000040)

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

SHAutoComplete 는 편집 컨트롤과 ComboBoxEx 컨트롤과 같은 편집 컨트롤이 포함된 컨트롤을 비롯한 모든 시스템 편집 컨트롤에서 작동합니다. ComboBoxEx 컨트롤에 포함된 편집 컨트롤에 대한 핸들을 검색하려면 ComboBoxEx 컨트롤에 CBEM_GETEDITCONTROL 메시지를 보냅니다.

이 함수를 호출하기 전에 애플리케이션이 CoInitialize 또는 OleInitialize 를 호출해야 합니다. 편집 상자가 hwndEdit에 대한 WM_DESTROY 메시지 처리를 완료할 때까지 CoUninitialize 또는 OleUninitialize를 호출할 수 없습니다.

자동 제안 드롭다운 목록 상자에 표시할 수 있는 최대 항목 수는 1000개입니다.

Windows Vista 이전의 Windows 버전 및 Windows Server 2008 이전의 서버 버전에서 SHAutoComplete 는 동일한 HWND를 사용하여 두 번 이상 호출해서는 안 됩니다. 이렇게 하면 메모리 누수가 발생합니다. AutoComplete 개체의 이전 instance, 이전 AutoComplete 개체가 참조한 열거자 개체 및 Windows GDI(그래픽 디바이스 인터페이스) 리소스를 포함하여 원래 리소스가 해제되지 않도록 합니다. 자동 완성 목록을 변경하기 위해 다른 플래그 집합으로 SHAutoComplete 를 다시 호출하는 대신 CLSID_AutoComplete CoCreateInstance 를 호출하여 AutoComplete 개체를 가져옵니다. 그런 다음 HWND 를 개체에 전달하여 초기화하고 고유한 사용자 지정 열거자를 제공합니다. 자동 완성에서 여러 목록을 사용하려면 CLSID_ACLMulti 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 5.0 이상)

추가 정보

자동 완성 사용

Share via