コマンド フラグ要素
親要素を変更します。
構文
<CommandFlag>DynamicVisibility</CommandFlag>
属性と要素
次のセクションでは、有効な要素値について説明します。
属性
なし。
子要素
| Value | 説明 |
|---|---|
| AllowParams | ユーザーがコマンドの正規名を入力するときに、[コマンド] ウィンドウにコマンド パラメーターを入力できることを示します。 有効な対象: Button |
| AlwaysCreate | グループとボタンのどちらもない場合でもメニューが作成されます。 有効な対象: Menu |
| CaseSensitive | ユーザーの入力では、大文字と小文字が区別されます。 有効な対象: Combo |
| CommandWellOnly | コマンドが最上位レベルのメニューに表示されず、追加のシェル カスタマイズ (キーボード ショートカットへのバインディングなど) できるようにする場合は、このフラグを適用します。 VSPackage のインストール後に、[オプション] ダイアログ ボックスを開き、[キーボード環境] カテゴリの下にあるコマンドの配置を編集することで、これらのコマンドをカスタマイズできます。 このフラグは、ショートカット メニュー、ツール バー、メニュー コントローラー、またはサブメニューの配置には影響しません。 有効な対象: Button、Combo |
| DefaultDisabled | 既定では、コマンドを実装する VSPackage が読み込まれていない場合、または QueryStatus メソッドが呼び出されていない場合は、コマンドが無効になります。有効な対象: Button、Combo |
| DefaultDocked | 既定ではドッキングされます。 この設定は、常にドッキングされているため、ツール バーには適用されなくなりました。 |
| DefaultInvisible | 既定では、コマンドを実装する VSPackage が読み込まれていない場合、または QueryStatus メソッドが呼び出されていない場合は、コマンドが表示されません。これは、 DynamicVisibility フラグと組み合わせて使用することをお勧めします。有効な対象: Button、Combo、Menu |
| DontCache | 開発環境で、このコマンドの QueryStatus メソッドの結果がキャッシュされません。メニューに対しては、メニュー項目のテキストをキャッシュしないようにメニュー コントローラーに指示します。 このフラグは、動的な項目がメニューに含まれるか、動的なテキストが項目に含まれるときに使用します。 有効な対象: Button、Menu |
| DynamicAutomationName | QueryStatus ハンドラーがOLECMDTEXTFEXT_AUTOMATIONNAMEに応答し、コントロールのオートメーション名として使用される文字列を返すことを指定します。 OleMenuCommand を使用している場合は、このフラグが設定されている場合は、BeforeQueryStatus ハンドラーで AutomationName プロパティを設定できます。 Menu 要素で使用すると、このフラグは MenuController または MenuControllerLatched 型のメニューにのみ適用されます。 有効な対象: Button、Combo、Menu |
| DynamicItemStart | 動的リストの先頭を示します。 これにより、OLECMDERR_E_UNSUPPORTED フラグが返されるまで、リスト項目に対して QueryStatus メソッドを連続して呼び出すことで、環境を構築できます。 これは、最近使用した (MRU) リストやウィンドウ リストなどの項目に適しています。有効な対象: Button |
| DynamicVisibility | コマンドの可視性は、QueryStatus メソッドを使用して、または VisibilityConstraints セクションに含まれるコンテキスト GUID を使用して変更できます。メニューおよびツール ウィンドウのツール バーに表示されるコマンドに適用されますが、メイン ウィンドウに表示される最上位レベルのツール バーには適用されません。 QueryStatus メソッドから OLECMDF_INVISIBLE フラグが返されると、最上位レベルのツール バー項目を無効にすることはできますが、非表示にすることはできません。 ツール ウィンドウのツール バーに表示されるツール バー コマンドは非表示にすることができます。メニューについては、このフラグが、すべてのメンバーが非表示のときに自動的にメニューを非表示にする必要があることも示します。 最上位レベルのメニューには既にこの動作があるため、通常、このフラグはサブメニューに割り当てられます。 このフラグは、 DefaultInvisible フラグと組み合わせる必要があります。有効な対象: Button、Combo、Menu |
| FilterKeys | 「Combo 要素」のフィルター処理キーのトピックを参照してください。 有効な対象: Combo |
| FixMenuController | このコマンドがメニュー コントローラーに配置されている場合は、このコマンドが常に既定になります。つまり、メニュー コントローラー ボタン自体が選択されると常に、このコマンドが選択されます。 メニュー コントローラーに TextIsAnchorCommand フラグが設定されている場合、メニューコントローラーは、FixMenuController フラグが設定されたコマンドからテキストも受け取ります。FixMenuController フラグは、メニュー コントローラーの 1 つのコマンドにのみ設定する必要があります。 複数のコマンドにフラグが設定されている場合は、メニューの最後のコマンドが、既定のコマンドになります。有効な対象: Button |
| IconAndText | メニューとツール バーにアイコンとテキストを表示します。 有効な対象: Button、Combo、Menu |
| NoAutoComplete | オートコンプリート機能が無効になります。 有効な対象: Combo |
| NoButtonCustomize | ユーザーがこのボタンをカスタマイズできないようにします。 有効な対象: Button、Combo |
| NoKeyCustomize | キーボードのカスタマイズを有効にしません。 有効な対象: Button、Combo |
| NoShowOnMenuController | このコマンドがメニュー コントローラーに配置されている場合は、そのコマンドがドロップダウン リストに表示されません。 有効な対象: Button |
| NotInTBList | 使用可能なツール バーのリストに表示されません。 これは、Toolbar 型のメニューに対してのみ有効です。 有効な対象: Menu |
| NoToolbarClose | ユーザーはツール バーを閉じることができません。 これは、Toolbar 型のメニューに対してのみ有効です。 有効な対象: Menu |
| Pict | ツール バーにアイコンのみを表示し、メニューにはテキストのみを表示します。 アイコンが指定されていない場合は、クリック可能な空白領域をツール バーに表示します。 有効な対象: Button |
| PostExec | コマンドを非ブロッキングにします。 開発環境により、すべての前処理クエリが完了するまで実行が延期されます。 有効な対象: Button |
| RouteToDocs | コマンドが、アクティブなドキュメントにルーティングされます。 有効な対象: Button |
| StretchHorizontally | このフラグが設定されていると、幅が、コンボ ボックスの最小幅になります。そして、ツール バーに空き領域がある場合は、使用可能なスペースを埋めるようにコンボ ボックスが拡大されます。 これは、ツール バーが水平方向にドッキングされており、ツール バー上の 1 つのコンボ ボックスのみがフラグを使用できる場合にのみ発生します (フラグは、最初のコンボ ボックスを除くすべてで無視されます)。 有効な対象: Combo |
| TextChanges | コマンドまたはメニュー テキストは実行時に、通常は QueryStatus メソッドを使用して変更できます。有効な対象: Button、Menu |
| TextChangesButton | 有効な対象: Button |
| TextIsAnchorCommand | メニュー コントローラーの場合は、メニューのテキストが既定の (アンカー) コマンドから取得されます。 アンカー コマンドとは、最後に選択またはラッチされたコマンドです。 このフラグが設定されていない場合、メニュー コントローラーは、それ自体の MenuText フィールドを使用します。 ただし、メニュー コントローラーのクリックによっても、そのコントローラーから最後に選択されたコマンドが有効になります。このフラグは、 TextChanges フラグと組み合わせて使用することをお勧めします。このフラグは、MenuController 型または MenucontrollerLatched 型のメニューにのみ適用されます。 有効な対象: Menu |
| TextMenuCtrlUseMenu | メニュー コントローラー上の MenuText フィールドを使用します。 既定のフィールドは ButtonText です。有効な対象: Button |
| TextMenuUseButton | メニューの ButtonText フィールドを使用します。 既定のフィールドは MenuText です (指定されている場合)。有効な対象: Button |
| TextOnly | ツール バーまたはメニューにテキストのみを表示します。アイコンが指定されている場合でもアイコンは表示しません。 有効な対象: Button |
| TogglePatternAvailable | ボタンがチェック/ラッチされることをサポートしていることを示します (つまり、OLEMCDF_LATCHEDを返すか、OleMenuCommand の Checked プロパティを設定できます)。 これにより、オートメーション レイヤーはトグル パターンを公開できるため、スクリーン リーダーはボタンテキストと共にチェック/未チェック状態を読み取ることができます。 有効な対象: Button |
親要素
| 要素 | 説明 |
|---|---|
| Buttons 要素 | Button 要素の要素のグループを提供します。 |
| Menus 要素 | VSPackage で実装するすべてのメニューを定義します。 |