IContextMenu::GetCommandString 메서드(shobjidl_core.h)

아티클
08/26/2023

명령의 도움말 문자열과 언어 독립적 또는 정식 이름을 포함하여 바로 가기 메뉴 명령에 대한 정보를 가져옵니다.

구문

HRESULT GetCommandString(
  UINT_PTR idCmd,
  UINT     uType,
  UINT     *pReserved,
  CHAR     *pszName,
  UINT     cchMax
);

매개 변수

idCmd

형식: UINT_PTR

메뉴 명령 식별자 오프셋입니다.

uType

형식: UINT

반환할 정보를 지정하는 플래그입니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

GCS_HELPTEXTA

pszName을 명령에 대한 도움말 텍스트가 포함된 ANSI 문자열로 설정합니다.

GCS_HELPTEXTW

pszName을 명령에 대한 도움말 텍스트가 포함된 유니코드 문자열로 설정합니다.

GCS_VALIDATEA

메뉴 항목이 있는 경우 S_OK 반환하거나, 그렇지 않으면 S_FALSE 반환합니다.

GCS_VALIDATEW

메뉴 항목이 있는 경우 S_OK 반환하거나, 그렇지 않으면 S_FALSE 반환합니다.

GCS_VERBA

pszName을 메뉴 항목에 대한 언어 독립적 명령 이름을 포함하는 ANSI 문자열로 설정합니다.

GCS_VERBW

pszName을 메뉴 항목의 언어 독립적 명령 이름을 포함하는 유니코드 문자열로 설정합니다.

pReserved

형식: UINT*

예약되어 있습니다. 애플리케이션은 이 메서드를 호출할 때 NULL 을 지정해야 하며 처리기는 호출 시 이 매개 변수를 무시해야 합니다.

pszName

형식: LPSTR

검색할 null로 종료된 문자열을 받을 버퍼의 주소입니다.

cchMax

형식: UINT

null로 끝나는 문자열을 받을 버퍼의 크기(문자)입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

언어 독립적 명령 이름 또는 동사는IContextMenu::InvokeCommand 메서드에 전달되어 애플리케이션에서 명령을 활성화할 수 있는 이름입니다. 도움말 텍스트는 Windows Explorer 상태 표시줄에 표시되는 명령에 대한 설명입니다. 상당히 짧아야 합니다(40자 미만).

몇 가지 일반적인 동사는 정식 이름으로 식별할 수 있으며, instance, 열기, 인쇄, 삭제 및 이름 바꾸기가 가능합니다. 클라이언트는 pszName이 가리키는 문자열을 이러한 정식 이름과 비교하여 바로 가기 메뉴의 현재 상태를 검사 수 있습니다.

pszName이 LPSTR로 선언되더라도 uFlags가 GCS_HELPTEXTW또는 GCS_VERBW 설정된 경우 UINT_PTR 캐스팅하고 유니코드 문자열을 반환해야 합니다. GCS_UNICODE 포함된 플래그의 'W' 및 'A' 버전에 대해 uFlags 를 테스트하는 비트 마스크로 사용할 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)

다음을 통해 공유