Command.Bindings 屬性
設定或取得用來叫用 (Invoke) 命令的按鍵清單。
命名空間: EnvDTE
組件: EnvDTE (在 EnvDTE.dll 中)
語法
'宣告
Property Bindings As Object
Object Bindings { get; set; }
property Object^ Bindings {
Object^ get ();
void set (Object^ value);
}
abstract Bindings : Object with get, set
function get Bindings () : Object
function set Bindings (value : Object)
屬性值
型別:System.Object
物件的 SafeArray。
備註
Bindings 會設定或傳回包含描述所有指定命令金鑰繫結之字串的物件 SafeArray。 若要將繫結加入至命令中,請先將繫結加入至 SafeArray,然後再將它設定回來。 若要從命令中移除繫結,請從 SafeArray 中移除繫結,然後再將它設定回來。
每個字串採用下列任一種語法 ("modifiers+" 是選擇性項目):
"scopename::modifiers+key"
"scopename::modifiers+key, modifiers+key"
修飾詞是「ctrl+」, 「alt+」和「shift+」,以英文必須指定。 顯示順序不拘。 第一個修飾詞或按鍵規範,緊跟在雙冒號 ("::") 之後。 按鍵順序中任何的逗號分隔符號之後,都有一個空格。
任何項目都是以大小寫混合的方式報告,例如「Ctrl+Space」,但是在加入新繫結時,可以使用任何的大小寫組合。
繫結字串中的空格,是當做常值來處理。 空格和定位字元等都沒有逸出序列。 下面是繫結設定值的範例:
"Text Editor::ctrl+r, ctrl+r"
"Global::ctrl+o"
"Global::f2"
Bindings 會針對一些不具繫結的命令 (也就是不會出現在 [工具選項] 鍵盤繫結屬性頁的命令) 傳回 Nothing。 如果您試圖為此類命令設定這項屬性,則會傳回錯誤。
注意事項 |
---|
您不能用程式設計的方式來變更預設的鍵盤對應配置設定。若要變更這些設定值,請在 [選項] 對話方塊的 [鍵盤] 節點中,儲存預設鍵盤對應配置的複本。您可以在這個對應配置中,變更設定值。 |
範例
' Macro code.
Sub BindingsExample()
Dim cmds As Commands
Dim cmd As Command
Dim props As EnvDTE.Properties = DTE.Properties("Environment", _
"Keyboard")
Dim prop As EnvDTE.Property
' Set references to the Commands collection and the File.NewFile
' command.
cmds = DTE.Commands
cmd = cmds.Item("File.NewFile")
' Assigns the command (File.NewFile) globally to the F2 key.
' Because you cannot programmatically change the default keyboard
' mapping scheme settings, you must first make a copy of the
' Default Settings for the Keyboard Mapping Scheme.
prop = props.Item("Scheme")
' Sets the Scheme property value to a new keyboard scheme.
' This saves the old keyboard mapping scheme and allows you
' to add new key mappings.
MsgBox("PROP NAME: " & prop.Name & " VALUE: " & prop.Value)
prop.Value = "C:\Documents and Settings\johndoe\Application _
Data\Microsoft\VisualStudio\8.0\MyNewKbdScheme.vsk"
MsgBox("PROP NAME: " & prop.Name & " VALUE: " & prop.Value)
cmd.Bindings = "Global::f2"
End Sub
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。