IUICommandHandler::UpdateProperty 메서드(uiribbon.h)

Windows 리본 프레임워크의 속성 업데이트 요청에 응답합니다.

구문

HRESULT UpdateProperty(
  [in]           UINT32            commandId,
  [in]           REFPROPERTYKEY    key,
  [in, optional] const PROPVARIANT *currentValue,
  [out]          PROPVARIANT       *newValue
);

매개 변수

[in] commandId

형식: UINT32

태그 리소스 파일에 지정된 명령의 ID입니다.

[in] key

형식: REFPROPERTYKEY

업데이트할 속성 키 입니다.

[in, optional] currentValue

형식: const PROPVARIANT*

키의 현재 값에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[out] newValue

형식: PROPVARIANT*

이 메서드가 반환되면 키에 대한 새 값에 대한 포인터가 포함됩니다.

반환 값

형식: HRESULT

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

설명

리본 프레임워크에 대한 후속 호출이 수행되기 전에 이 메서드를 반환할 수 있어야 합니다.

UI_PKEY_Enabled 또는 UI_PKEY_Label 같은 Command 속성 값은 SetUICommandProperty 또는 InvalidateUICommand에 대한 호출을 통해 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiribbon.h
DLL	Mshtml.dll

추가 정보

IUICommandHandler

Windows 리본 프레임워크 샘플