gnat-gps-doc 5.0-6 / usr / share / doc / gnat-gps / html / Adding-contextual-menus.html

This file is indexed.

/usr/share/doc/gnat-gps/html/Adding-contextual-menus.html is in gnat-gps-doc 5.0-6.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<html lang="en">
<head>
<title>Adding contextual menus - Using the GNAT Programming Studio</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNAT Programming Studio">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files" title="Customizing through XML and Python files">
<link rel="prev" href="Adding-new-menus.html#Adding-new-menus" title="Adding new menus">
<link rel="next" href="Adding-tool-bar-buttons.html#Adding-tool-bar-buttons" title="Adding tool bar buttons">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 2002-2010 AdaCore.

This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.

This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, see `http://www.gnu.org/licenses/'.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
pre.smallexample {background-color:rgb(240,240,240);
                     font-family: courier new,courier,fixed;
                     font-size: 14px;
                     margin: 0px 40px 0px 40px;
                     border-width: 1px 2px 2px 1px;
                     border-top-style: dotted;
                     border-left-style: dotted;
                     border-right-style: solid;
                     border-bottom-style: solid;
                     border-color: black;}
   code             {color:black;
                     font-family: courier new,courier,fixed;
                     font-size: 14px;}
   body             {font-family: arial,helvetica,sans-serif;
                     font-size: 16px;
                     max-width: 800px;
                     text-align: justify}
   samp             {font-family: courier new,courier,fixed;
                     font-size: 14px}
                    
--></style>
</head>
<body>
<div class="node">
<a name="Adding-contextual-menus"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Adding-tool-bar-buttons.html#Adding-tool-bar-buttons">Adding tool bar buttons</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Adding-new-menus.html#Adding-new-menus">Adding new menus</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files">Customizing through XML and Python files</a>
<hr>
</div>

<h4 class="subsection">16.5.6 Adding contextual menus</h4>

<p><a name="index-g_t_003ccontextual_003e-807"></a><!--  -->

<p class="noindent">The actions can also be used to contribute new entries in the contextual
menus everywhere in GPS. These menus are displayed when the user presses
the right mouse button, and should only show actions relevant to the current
context.

   <p>Such contributions are done through the <code>&lt;contextual&gt;</code> tag, which takes
the following attributes:

     <dl>
<dt><code>"action"  (mandatory)</code><dd>Name of the action to execute, and must be defined elsewhere in one of the
customization files.

     <p>If this attribute is set to an empty string, a separator will be inserted
in the contextual menu instead. If you specify a reference item with one of
the "before" or "after" attribute, the separator will be visible only when
the reference item is visible.

     <br><dt><code>"before" (optional, default="")</code><dd>If it is specified, this attribute should be the name of another contextual,
before which the new menu should appear. The name of predefined contextual
menus can be found by looking at the output of "Contextual.list" in the shell
console. The name of the contextual menus you define yourself is the value of
the <code>&lt;title&gt;</code> child.

     <p>There is no guarantee that the new menu will appear just before the referenced
menu. In particular, it won't be the case if the new menu is created before
the reference menu was created, or if another later contextual menu indicates
that it must be displayed before the same reference item.

     <br><dt><code>"after" (optional, default="")</code><dd>Same as "before", except it indicates the new menu should appear after the
reference item.

     <p>If both "after" and "before" are specified, only the latter is taken into
account.

   </dl>

   <p>It accepts one child tag, <code>&lt;Title&gt;</code> which specifies the name of the
menu entry. If this child is not specified, the menu entry will use the name
of the action itself. The title is in fact the full path to the new menu entry. 
Therefore, you can create submenus by using a title of the form
"Parent1/Parent2/Menu".

   <p>Special characters can be used in the title, and will be automatically
expended based on the current context. These are exactly the ones described
in the section for macros arguments, See <a href="Macro-arguments.html#Macro-arguments">Macro arguments</a>.

   <p>The new contextual menu will only be shown if the filters associated with the
action match the current context.

   <p>For instance, the following example inserts a new contextual menu which prints
the name of the current file in the GPS console. This contextual menu is only
displayed in source editors. This contextual menu entry is followed by a
separator line, visible when the menu is visible

<pre class="smallexample">     &lt;?xml version="1.0" ?&gt;
     &lt;print&gt;
       &lt;action name="print current file name" &gt;
         &lt;filter module="Source_Editor" /&gt;
         &lt;shell&gt;echo %f&lt;/shell&gt;
       &lt;/action&gt;
     
       &lt;contextual action="print current file name" &gt;
         &lt;Title&gt;Print Current File Name&lt;/Title&gt;
       &lt;/contextual&gt;
       &lt;contextual action="" after="Print Current File Name" /&gt;
     &lt;/print&gt;
</pre>
   <!--  -->
   </body></html>

APT Browse - Built by Thomas Orozco.