SHAutoComplete 함수(shlwapi.h)
자동 완성을 사용하여 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 이상) |