Whole Tomato Software Forums
Whole Tomato Software Forums
Main Site | Profile | Register | Active Topics | Members | Search | FAQ
 All Forums
 Visual Assist
 Feature Requests
 MSDN tooltips

You must be registered to post a reply.
Click here to register.

Screensize:
UserName:
Password:
Format: BoldItalicizeUnderlineStrikethrough Align leftCenterAlign right Insert horizontal ruleUpload and insert imageInsert hyperlinkInsert email addressInsert codeInsert quoted textInsert listInsert Emoji
   
Message:

Forum code is on.
Html is off.

 
Check to subscribe to this topic.
   

T O P I C    R E V I E W
drac Posted - May 14 2009 : 03:54:05 AM
Hi,

Using APIs like WIN32 API can be a bit tedious. Take for example
CreateFile function, it has lots of parameters and those parameters
are integers which take #define values or-ed together. In order
to find out about those parameters I usually google "msdn CreateFile"
(I don't know why MSDN is dog slow on my machine, when I press F1
it takes like one minute to start up)

I would be really glad if Visual Assist would find out those parameters for me (from MSDN locally, online, some kind of webservice)

CreateFile resides in "ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.en/fileio/fs/createfile.htm", it would be a matter of parsing the html file
and sending the <dd> paragraph after dwShareMode:


<dt><em>dwShareMode</em> [in]  </dt>

<dd>
<p>The requested sharing mode of the file or device, which can be read, write, both, delete, all of these, or none (refer to the following table).  Access requests to attributes or extended attributes are not affected by this flag.</p>
<p>If this parameter is zero and <strong>CreateFile</strong> succeeds, 
       the file or device cannot be shared and cannot be opened again until the handle to the file or device is closed. For more information, see 
       the Remarks section.</p>
<p>You cannot request a sharing mode that conflicts with the access mode that is specified in an existing request 
       that has an open handle. <strong>CreateFile</strong> would fail and the <a id="ctl00_mainContentContainer_ctl09" onclick="javascript:Track('ctl00_mainContentContainer_ctl00|ctl00_mainContentContainer_ctl09',this);" href="http://msdn.microsoft.com/en-us/library/ms679360(VS.85).aspx"><strong>GetLastError</strong></a> function would return ERROR_SHARING_VIOLATION.</p>
<p>To enable a process to share a  file or device while another process has the file or device open, use a compatible combination of one or 
       more of the following values. For more information about valid combinations of this parameter with the <em>dwDesiredAccess</em> parameter, see 
       <a id="ctl00_mainContentContainer_ctl10" onclick="javascript:Track('ctl00_mainContentContainer_ctl00|ctl00_mainContentContainer_ctl10',this);" href="http://msdn.microsoft.com/en-us/library/aa363874(VS.85).aspx">Creating and Opening Files</a>.</p>

<p class="note"><strong>Note</strong>  The sharing options for each open handle remain in effect until that handle is closed, regardless of process context.</p>
<table>
<tr><th>Value</th><th>Meaning</th></tr>
<tr><td>
<dl><dt>0</dt><dt>0x00000000</dt></dl>
</td><td><p>Prevents other processes from opening a file or device if they request delete, read, or write access.</p>
</td></tr>
<tr><td>
<dl><dt>FILE_SHARE_DELETE</dt><dt>0x00000004</dt></dl>

</td><td><p>Enables subsequent open operations on a file or device to request delete access.</p>
<p>Otherwise, other processes cannot open the file or device if they request delete access.</p>
<p>If this flag is not specified, but the file or device has been opened for delete access, the function fails.</p>
<p class="note"><strong>Note</strong>  Delete access allows both delete and rename operations.</p>
</td></tr>
<tr><td>
<dl><dt>FILE_SHARE_READ</dt><dt>0x00000001</dt></dl>
</td><td><p>Enables subsequent open operations on a file or device to request read access.</p>
<p>Otherwise, other processes cannot open the file or device if they request read access.</p>

<p>If this flag is not specified, but the file or device has been opened for read access, the function fails.</p>
</td></tr>
<tr><td>
<dl><dt>FILE_SHARE_WRITE</dt><dt>0x00000002</dt></dl>
</td><td><p>Enables subsequent open operations on a file or device to request write access.</p>
<p>Otherwise, other processes cannot open the file or device if they request write access.</p>
<p>If this flag is not specified, but the file or device has been opened for write access or has a file mapping with 
         write access, the function fails.</p>
</td></tr>
</table>
<p> </p>

</dd>

Here is what I had in mind:




3   L A T E S T    R E P L I E S    (Newest First)
kevinsikes Posted - May 15 2009 : 09:37:37 AM
I have entered a feature request for this:

case=27027

Thanks for the suggestion!
drac Posted - May 14 2009 : 12:04:08 PM
quote:
Originally posted by kevinsikes

drac,

Thank you for taking the time to flesh this out so thoroughly. I'm not sure a tooltip is the best vehicle to display such a large volume of information. Would a dockable Dynamic Help tool window deliver the same results for you, or perhaps even just getting an existing MSDN window to display the pertinent information as the user iterates through the parameters?



A dockable Dynamic Help tool window would be excellent. 3rd party libraries can also be added to MSDN (Qt comes to mind, I don't know if they use the description (<dd>) tag though)

This would be a killer feature!

Please, pretty please implement this!
kevinsikes Posted - May 14 2009 : 11:52:07 AM
drac,

Thank you for taking the time to flesh this out so thoroughly. I'm not sure a tooltip is the best vehicle to display such a large volume of information. Would a dockable Dynamic Help tool window deliver the same results for you, or perhaps even just getting an existing MSDN window to display the pertinent information as the user iterates through the parameters?

© 2023 Whole Tomato Software, LLC Go To Top Of Page
Snitz Forums 2000