포탄 Namespace 연장: 주문 사령선 품목 추가

개관

나에서 더 이른 포스트, 나는 과태 IShellView 실시 (일컬어 DefView)를 사용하여 포탄 Namespace 연장을 창조하는 방법을 보여주었다. 당신이 견본에서 주의할지도 모른 1개의 것은 사령선이의 공허 과태 품목과 같은 "편성한다"와 "전망"이다 이다.

당신이 당신의 자신의 Namespace를 개발하고 그리고 디폴트 버튼을 포함하고는 것을 그리고/또한 사령선에 당신의 자신 성분을 또한 추가하고 싶은 경우에, 당신은 어떻게 이것을 달성하는가? 응답: 당신은 실행해야 한다 IExplorerCommand, IExplorerCommandProvider 그리고 IEnumExplorerCommand 공용영역.

나는의 밑에 공용영역의 각각이 사용되고 무슨을 위해 제대로 당신의 부호에서 그들을 실행하기 위하여 당신이 필요가 있는 무슨을 기술한다 할.

IExplorerCommandProvider

당신의 Namespace가 적재된 후에, 포탄은 IExplorerCommandProvider의 경우를 당신의 Namespace를 요구할 것이다. 이 공용영역은 2개의 방법을 드러낸다: GetCommand와 GetCommands. 포탄은 GetCommand 공급한 GUID와 일치하는 IExplorerCommand 특정한 목표를 만회하기 위하여 방법을 부른다 (각 명령은 GUID에 의해 확인된다). GetCommands 방법은 IEnumExplorerCommand 경우를 만회하기 위하여 불린다. 이 목표는 namespace를 위한 IExplorerCommand 모든 경우를 열거한다.

당신은 그것의 IShellFolder의 CreateViewObject의 실시를 통해 IExplorerCommandProvider의 그것의 실시를 위해 Namespace 질문된다. CreateViewObject에 통과된 REFIID는 IID_IExplorerCommandProvider일 것이다. 포탄은 그 때 이 만회하기 위하여 공용영역을의 실시인 당신의 사령선 품목 이용할 것이다 IExplorerCommand 공용영역.

IExplorerCommand

IExplorerCommand 공용영역은 탐험가의 사령선에 품목의 외관 그리고 행동을 제공하기 위하여 이용된다. 방법의 대부분은 품목이 전망에서 현재 선정되는 무슨을 확인하는 IShellItemArray를 통과한다. 이 정보는 실시에 의해 아무 품목도 선정되지 않는 경우에 또는 다른 선택을 위한 행동을 주문을 받아서 만들기 위하여 이용될 수 있다. 예를 들면, 아무 품목도 선정되지 않는 경우에, 당신은, 각각 국가를 ECS_DISABLED 또는 ECS_HIDDEN에 회색 밖으로에 놓거나 사령선에서 품목을 완전하게 제거할 바랄 수도 있다.

이 공용영역에 의해 드러낸 방법은 아래에 기술한 바와 같다.

방법	묘사
EnumSubCommands	현재 명령의 이하 명령을 열거하는 이용된 IEnumExplorerCommand 경우를 돌려보낸다. 포탄은 단지 GetFlags 방법이 ECF_HASSUBCOMMANDS를 돌려보내는 경우에 이 방법만 부를 것이다. 이렇게 하는 것이 가능한 동안, 이하 명령 그들자신이 있는 이하 명령에는 격려되지 않는다는 것을 주에 여기에서 중요하다.
GetCanonicalName	이 명령과 관련되었던 세계적으로 유일한 인식기 (GUID)를 만회한다
GetFlags	이 명령과 관련되었던 깃발을 만회한다. 이 깃발은 사령선에 명령의 외관 그리고 행동을 지정한다.
GetIcon	아이콘 자원 끈을 만회한다. 이 끈은 "myfile.dll, I.D의 모양으로" 이다. 예를 들면: “shell32.dll,-101”
GetState	Retrieves the state of the command item. This is the first method of the interface that is called. The state that is returned affects the appearance and behavior of the command item. This method also passes a BOOL to let the command implementation know if the slow response rule is in effect.
GetTitle	Retrieves the string to display for the command item.
GetToolTip	Retrieves the string to use in the ToolTip associated with this command item.
Invoke	Called by the Shell when the user has activated a command on the Commands Module.

The above methods GetState and GetFlags return values that determine the appearance and behavior of the item in the Command Module. In the table below are screenshots of the command resulting from the combinations of the flags/states values.

	ECS_ENABLED	ECS_DISABLED	ECS_HIDDEN
NONE
ECF_HASSUBCOMMANDS
ECF_HASSPLITBUTTON
ECF_HIDELABEL
ECF_ISSEPARATOR		N/A
ECF_HASLUASHIELD

	ECS_CHECKBOX	ECS_CHECKBOX| ECS_CHECKED
NONE
ECF_HASSUBCOMMANDS
ECF_HASSPLITBUTTON
ECF_HIDELABEL
ECF_ISSEPARATOR	N/A	N/A
ECF_HASLUASHIELD

*ECS_CHECKBOX and ECS_CHECKED only apply to sub items

** ECF_ISSEPARATOR can only be added as a sub item

Slow Response Rule

The second parameter of the GetState method is a BOOL (fOkToBeSlow) that lets the implementation of IExplorerCommand know if the “slow response rule” is in effect. If this value is FALSE, and your implementation performs slow operations (such as I/O, network calls or calls to out of thread COM objects) then your command should return E_PENDING. This will cause the Commands Module to call the command’s GetState (and other methods) on a background thread with fOkToBeSlow set to TRUE. This prevents slow operations in your implementation from running on the UI thread, thus preventing performance issues.

Command Item Ordering

It is important to note here that the developer of the Namespace Extension has no control over the ordering of command items. For example, you cannot force your command items before the default View and Organize command items or have the View or Organize command items renamed/removed. Items are simply appended to the end of the Commands Module in the order returned from the IEnumExplorerCommand instance.

IEnumExplorerCommand

The IEnumExplorerCommand is returned to the Shell by the GetCommands method of the IExplorerCommandProvider interface. As the name suggests, it permits enumeration of the IExplorerCommand instances by the Shell.

FolderViewImpl Sample Code

The above interfaces have been implemented in the attached Shell Namespace Extension sample code derived from the FolderViewImpl SDK sample. The structure of the command items (as well as sub items) is data-driven from an array of structures that define the command items (see the array of FVCOMMANDITEMs in fvcommands.cpp). This approach was used to make it easy to experiment with the hierarchy of command items as well as their behavior/appearance. The way you implement commands in your Namespace Extension may differ.

The above is a screenshot of the modified SDK sample. Notice we now have the default command items (Organize and Views) as well as our custom items. The Display command item performs the same function as right-clicking items in the view and selecting “Display” from the context menu. The Settings button is used to demonstrate a command item with sub items. All it does is display a message box with the name of the sub item when the user invokes the specified sub item.

It should also be noted that if you are using a custom view in your Namespace by implementing your own IShellView (instead of using DefView) you will need to include an implementation of IFolderView::GetFolder. In your GetFolder implementation you will need to include the ability to QueryService for SID_SFolderView.

Building the FolderView SDK Sample

1. To build the FolderViewImpl sample, be sure to download and install the Windows SDK.
2. Download the modified FolderView SDK sample
3. Launch FolderViewImpl.sln in Visual Studio
4. Open the properties for the project
5. Add a path to the SDK includes to the C/C++ - General page
6. Add a path to the SDK libs to the Linker – General page
7. Build

Installing the FolderView SDK Sample

1. Once you have built the sample, copy the FolderViewImpl.dll and FolderViewImpl.propdesc to the same directory
2. From an elevated cmd window, regsvr32 FolderViewImpl.dll
3. Restart explorer
4. Open explorer to Computer
5. There should be a list item named “FolderView SDK Sample”

Popularity: 2%

Written by chrdavis. Read more great feeds at is source WEBSITE
no comments.
Read more articles on shell and namespace and Coding and API and Programming and vista and Windows Vista.

• [+] Digg: Feature this article
• [+] Del.icio.us: Bookmark this article
• [+] Furl: Bookmark this article

Related articles

• Shell Namespace Extension: Enabling Deep Search (March 3rd, 2008)