IUIFramework::InvalidateUICommand 메서드(uiribbon.h)
Windows 리본 프레임워크 Command 속성, 값 또는 상태를 무효화합니다.
구문
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
매개 변수
[in] commandId
형식: UINT32
태그 리소스 파일에 지정된 명령의 ID입니다.
[in] flags
형식: UI_INVALIDATIONS
무효화할 명령의 측면을 식별합니다.
참고UI_INVALIDATIONS_ALLPROPERTIES 전달하면 값 및 상태를 포함하여 명령에 바인딩된 모든 속성이 무효화됩니다.
[in] key
형식: const PROPERTYKEY*
명령 속성 또는 상태의 속성 키입니다. 이 매개 변수는 NULL일 수 있습니다.
반환 값
형식: HRESULT
성공하면 S_OK 반환합니다. 그렇지 않으면 다음 목록의 오류 값입니다.
| 값 | 설명 |
|---|---|
| E_INVALIDARG | 키에 대한 잘못된 값이 제공되었습니다. |
| E_FAIL | 작업이 실패했습니다. 모든 명령이 무효화되지 않거나 지정된 속성이 지원되지 않습니다. |
설명
리본 프레임워크 태그에 정의된 리소스는 태그 파일이 이진 형식으로 컴파일될 때 생성되는 리소스 테이블에 저장됩니다. 리소스가 무효화된 후에는 태그 리소스 테이블에서 리소스를 복원할 수 없습니다.
무효화 후 프레임워크는 호스트 애플리케이션에 리소스 세부 정보를 쿼리합니다.
명령 값이 무효화되면(플래그 에 UI_INVALIDATIONS_VALUE 포함) 키 값은 NULL입니다.
IUIFramework::InvalidateUICommand가 여러 번 호출되고 각 호출에 전달된 UI_INVALIDATIONS 값이 UI_INVALIDATIONS_STATE 및 UI_INVALIDATIONS_ALLPROPERTIES 같은 겹치는 속성을 지정하는 경우 호스트 애플리케이션에 대한 하나의 콜백만 생성됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiribbon.h |
| DLL | Mshtml.dll |