VCB and Shortcut Keys
-
-
@thomthom said:
It's only a simple property to enable or disable the VCB.
The docs only says:The enableVCB? method is used to tell SketchUp whether to allow the user to enter text into the VCB (value control box, aka the "measurements" panel). If you do not implement this method, then the vcb is disabled by default.So it doesn't affect what types of characters you can input - it just enables/disables the control as a whole.
I don't think it is the onUserText that is enabling the VCB. I think the default is true, not false. Try this script:
class MyTool def enableVCB? UI.beep end end; Sketchup.active_model.select_tool( MyTool.new )Depress and release the left mouse button slowly. You will see that enableVCB? is called on both the down and up of the left mouse button. That's why I think it is intended to sample each key stroke, to see if a shortcut key was preceded by a number, in which case it would be interpreted as a parameter of the number and not a shortcut key. But it doesn't get called at all with a key stroke, including the Enter key, which I think is the bug. Why is it called with a mouse action? That's what's curious to me.
-
I asked the SketchUp team, and they confirmed that onUserText enables the VCB - and enableVCB? is there to let you disable the VCB when you do not want user input. (For instance - if your tool uses the VCB to adjust values then you don't want the VCB to be enabled until you have performed an action.)
And enableVCB? is queried on certain event which one can assume the tool changes state - such as on mouse clicks.
-
I looked further at the behaviour of the Tool class - using variations of this snippet to inspect the behaviour:
<span class="syntaxdefault"><br />class ToolTest6<br /><br /> </span><span class="syntaxkeyword">%</span><span class="syntaxdefault">w</span><span class="syntaxkeyword">{<br /></span><span class="syntaxdefault"> activate<br /> deactivate<br /> Xdraw<br /> enableVCB</span><span class="syntaxkeyword">?<br /></span><span class="syntaxdefault"> getExtents<br /> getInstructorContentDirectory<br /> getMenu<br /> onCancel<br /> onKeyDown<br /> onKeyUp<br /> onLButtonDoubleClick<br /> onLButtonDown<br /> onLButtonUp<br /> onMButtonDoubleClick<br /> onMButtonDown<br /> onMButtonUp<br /> onMouseEnter<br /> onMouseLeave<br /> XonMouseMove<br /> onRButtonDoubleClick<br /> onRButtonDown<br /> onRButtonUp<br /> onReturn<br /> XonSetCursor<br /> onUserText<br /> resume<br /> suspend<br /> </span><span class="syntaxkeyword">}.</span><span class="syntaxdefault">each </span><span class="syntaxkeyword">{</span><span class="syntaxdefault"> </span><span class="syntaxkeyword">|</span><span class="syntaxdefault">event_name</span><span class="syntaxkeyword">|<br /></span><span class="syntaxdefault"> define_method</span><span class="syntaxkeyword">(</span><span class="syntaxdefault"> event_name </span><span class="syntaxkeyword">)</span><span class="syntaxdefault"> </span><span class="syntaxkeyword">{</span><span class="syntaxdefault"> </span><span class="syntaxkeyword">|*</span><span class="syntaxdefault">args</span><span class="syntaxkeyword">|<br /></span><span class="syntaxdefault"> puts event_name<br /> true<br /> </span><span class="syntaxkeyword">}<br /></span><span class="syntaxdefault"> </span><span class="syntaxkeyword">}<br /><br /></span><span class="syntaxdefault"> </span><span class="syntaxkeyword">%</span><span class="syntaxdefault">w</span><span class="syntaxkeyword">{<br /></span><span class="syntaxdefault"> onKeyDown<br /> onKeyUp<br /> </span><span class="syntaxkeyword">}.</span><span class="syntaxdefault">each </span><span class="syntaxkeyword">{</span><span class="syntaxdefault"> </span><span class="syntaxkeyword">|</span><span class="syntaxdefault">event_name</span><span class="syntaxkeyword">|<br /></span><span class="syntaxdefault"> define_method</span><span class="syntaxkeyword">(</span><span class="syntaxdefault"> event_name </span><span class="syntaxkeyword">)</span><span class="syntaxdefault"> </span><span class="syntaxkeyword">{</span><span class="syntaxdefault"> </span><span class="syntaxkeyword">|*</span><span class="syntaxdefault">args</span><span class="syntaxkeyword">|<br /></span><span class="syntaxdefault"> puts event_name<br /> false<br /> </span><span class="syntaxkeyword">}<br /></span><span class="syntaxdefault"> </span><span class="syntaxkeyword">}<br /><br /></span><span class="syntaxdefault">end </span><span class="syntaxcomment"># class<br /><br /></span><span class="syntaxdefault">Sketchup</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">active_model</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">select_tool</span><span class="syntaxkeyword">(</span><span class="syntaxdefault"> ToolTest6</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">new </span><span class="syntaxkeyword">)<br /></span><span class="syntaxdefault"> </span>Not the X in front of some names - I used that to quickly prevent some events from flooding the console.
Here's a quick summary of which event triggered which was followed by enableVCB?:
` activate
enableVCB?onMouseEnter
onMouseLeave
onLButtonDown
enableVCB?onLButtonUp
enableVCB?onLButtonDoubleClick
enableVCB?onMButtonDown
onMButtonUp
onRButtonDown
enableVCB?onRButtonUp
onRButtonDoubleClick
onKeyDown
onKeyUp
onUserText
onReturn
enableVCB?`The event's that responded with enableVCB? query:
activate onLButtonDown onLButtonUp onLButtonDoubleClick onRButtonDown onReturnOther observations:
IfonKeyDownoronKeyUpreturntruethen no text is entered into the VCB. It appear to block it.When the VCB is enabled: Space, S, M, K etc didn't trigger it's shortcuts - but only if I had typed a number first.
If the VCB is enabled, and you enter some input to the VCB then first
onUserTextwill trigger the first time you hit Return - then on the second you hit ReturnonReturnwill trigger.If the VCB is disabled then
onReturnwill trigger every time you hit Return. -
@thomthom said:
I asked the SketchUp team, and they confirmed that onUserText enables the VCB - and enableVCB? is there to let you disable the VCB when you do not want user input. (For instance - if your tool uses the VCB to adjust values then you don't want the VCB to be enabled until you have performed an action.)
And enableVCB? is queried on certain event which one can assume the tool changes state - such as on mouse clicks.
thomthom,
Thanks very much for the help on this and clearing things up. The documentation on this is really poor and misleading. I still wish we had a way to disable shortcut keys like the native tools have.
Thanks again.
-
@thomthom said:
I looked further at the behaviour of the Tool class - using variations of this snippet to inspect the behaviour:
thomthom,
Your help is well above and beyond anything I could ask for. Thanks again. I am loading the snippet to complete the "etc" and see if there are keys I can use.
-
Hi Joe,
your script partially works on mac withto_fadded @ line 4.
a lot of Capitals work as well, e.g LBWH all work, as a block or on their own...value = text.to_f.to_l #<<ADDED TO FLOATjohn
-
@driven said:
Hi Joe,
your script partially works on mac withto_fadded @ line 4.Interesting John. On my Windows PC I modified the script as follows:
<span class="syntaxdefault">def onUserText</span><span class="syntaxkeyword">(</span><span class="syntaxdefault">text</span><span class="syntaxkeyword">,</span><span class="syntaxdefault"> view</span><span class="syntaxkeyword">)<br /></span><span class="syntaxdefault"> puts</span><span class="syntaxkeyword">(</span><span class="syntaxstring">"Text is a #{text.class} class."</span><span class="syntaxkeyword">)<br /></span><span class="syntaxdefault"> begin<br /> value </span><span class="syntaxkeyword">=</span><span class="syntaxdefault"> text</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">to_l<br /> puts</span><span class="syntaxkeyword">(</span><span class="syntaxstring">"Value is a #{value.class} class."</span><span class="syntaxkeyword">)<br /></span><span class="syntaxdefault"> rescue<br /> </span><span class="syntaxcomment"># Error parsing the text<br /></span><span class="syntaxdefault"> UI</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">beep<br /> puts </span><span class="syntaxstring">"Cannot convert #{text} to a Length"<br /></span><span class="syntaxdefault"> value </span><span class="syntaxkeyword">=</span><span class="syntaxdefault"> nil<br /> Sketchup</span><span class="syntaxkeyword">;;</span><span class="syntaxdefault">set_status_text </span><span class="syntaxstring">""</span><span class="syntaxkeyword">,</span><span class="syntaxdefault"> SB_VCB_VALUE<br /> end<br /> return if </span><span class="syntaxkeyword">!</span><span class="syntaxdefault">value<br /> if </span><span class="syntaxkeyword">@</span><span class="syntaxdefault">state </span><span class="syntaxkeyword">==</span><span class="syntaxdefault"> 1 and </span><span class="syntaxkeyword">@</span><span class="syntaxdefault">stick_pt2</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">valid</span><span class="syntaxkeyword">?<br /></span><span class="syntaxdefault"> build_story_stick</span><span class="syntaxkeyword">(</span><span class="syntaxdefault">true</span><span class="syntaxkeyword">,</span><span class="syntaxdefault"> value</span><span class="syntaxkeyword">)<br /></span><span class="syntaxdefault"> new_stick<br /> end<br /> end</span>and get the following puts to the console. No complaints of coercing String to Length.
Text is a String class.
Value is a Length class.But your code is clearly more correct and you may have saved me a Mac bug. Very interesting that it works on the PC but not the Mac.
-
@chiefwoodworker said:
But your code is clearly more correct and you may have saved me a Mac bug. Very interesting that it works on the PC but not the Mac.
Whoops! Let me correct myself. SketchUp has a String def called to_l so the you don't need the to_f. Are you sure it doesn't work without the to_f?
-
with your original code, I get
Cannot convert 1w to a Length
if I change only this linevalue = text.to_f.to_l #just to do somethingI get 1w in the message box...
with your last code I get an empty message box, with or without the
.to_fjohn
-
Ya gotta love it! The following works just fine on the Mac, even though h is the shortcut for the pan tool, but fails on Windows by switching to pan.
<span class="syntaxdefault"></span><span class="syntaxkeyword">class </span><span class="syntaxdefault">MyTool<br /> def onUserText</span><span class="syntaxkeyword">(</span><span class="syntaxdefault">rawtext</span><span class="syntaxkeyword">, </span><span class="syntaxdefault">view</span><span class="syntaxkeyword">)<br /> </span><span class="syntaxdefault">begin<br /> UI</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">messagebox</span><span class="syntaxkeyword">(</span><span class="syntaxstring">"VCB held #{rawtext}"</span><span class="syntaxkeyword">) </span><span class="syntaxcomment"># show the raw input<br /> </span><span class="syntaxkeyword">if(</span><span class="syntaxdefault">rawtext</span><span class="syntaxkeyword">[-</span><span class="syntaxdefault">1</span><span class="syntaxkeyword">].</span><span class="syntaxdefault">chr </span><span class="syntaxkeyword">=~ /[</span><span class="syntaxdefault">wh</span><span class="syntaxkeyword">]/) </span><span class="syntaxcomment">#trap and strip key characters if present<br /> </span><span class="syntaxdefault">key </span><span class="syntaxkeyword">= </span><span class="syntaxdefault">rawtext</span><span class="syntaxkeyword">[-</span><span class="syntaxdefault">1</span><span class="syntaxkeyword">].</span><span class="syntaxdefault">chr<br /> text </span><span class="syntaxkeyword">= </span><span class="syntaxdefault">rawtext</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">chop</span><span class="syntaxkeyword">!<br /> else<br /> </span><span class="syntaxdefault">text </span><span class="syntaxkeyword">= </span><span class="syntaxdefault">rawtext<br /> end<br /> value </span><span class="syntaxkeyword">= </span><span class="syntaxdefault">text</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">to_l </span><span class="syntaxcomment">#see if text is convertible to a length<br /> </span><span class="syntaxdefault">rescue<br /> </span><span class="syntaxcomment"># can't process the VCB input. This could be because the trailing character<br /> # isn't one of the key characters or because the text isn't a number<br /> </span><span class="syntaxdefault">UI</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">beep<br /> puts </span><span class="syntaxstring">"Cannot convert #{rawtext} to Length with optional key"<br /> </span><span class="syntaxdefault">value </span><span class="syntaxkeyword">= </span><span class="syntaxdefault">nil<br /> Sketchup</span><span class="syntaxkeyword">;;</span><span class="syntaxdefault">set_status_text </span><span class="syntaxstring">""</span><span class="syntaxkeyword">, </span><span class="syntaxdefault">SB_VCB_VALUE<br /> end<br /> </span><span class="syntaxkeyword">return if !</span><span class="syntaxdefault">value<br /> UI</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">messagebox</span><span class="syntaxkeyword">(</span><span class="syntaxstring">"Got value = #{value}, key = #{key}"</span><span class="syntaxkeyword">)<br /> </span><span class="syntaxdefault">end<br />end<br />Sketchup</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">active_model</span><span class="syntaxkeyword">.</span><span class="syntaxdefault">select_tool</span><span class="syntaxkeyword">( </span><span class="syntaxdefault">MyTool</span><span class="syntaxkeyword">.new ) </span><span class="syntaxdefault"></span>Steve
-
Why not take your normal 'numbers' text as your lengths, and then use key-down checks for toggling what it means ?
Like Cmd/Ctrl, Shift etc *** - so on one press of that key it expects one type of value [shown in status-bar] on the next press it's something else = i.e. it's a 'toggle'.***You can use TAB key action as a toggle BUT it must be key-up as the MAC doesn't recognize tab-down - only tab-up !
-
@tig said:
Why not take your normal 'numbers' text as your lengths, and then use key-down checks for toggling what it means ?
Like Cmd/Ctrl, Shift etc *** - so on one press of that key it expects one type of value [shown in status-bar] on the next press it's something else = i.e. it's a 'toggle'.***You can use TAB key action as a toggle BUT it must be key-up as the MAC doesn't recognize tab-down - only tab-up !
Hi TIG,
That is exactly what I will end up doing in my tool. So as far as I am concerned I have a solution to the problem I raised, thanks to the folks like you who responded to my original question.
However, I think the bigger issue here is that there are scripts in this thread that work on the Mac and not the PC, and scripts that work on the PC and not the Mac. Apparently the Mac is not aware of the String class to_l method and the PC doesn't handle the h shortcut key correctly. Although I would argue that the PC is handling the h shortcut key the way I would like it to and the PC and Mac are handling shortcut keys when they shouldn't be if the VCB is active for user input.
I for one just wish that release 2013 spent more time on bug fixes, platform inconsistencies and Ruby API maintenance than it did on icon changes which are driving me nuts and causing me a lot of work.
But again, thank you and the others who helped me on this issue.
-
@driven said:
with your original code, I get
Cannot convert 1w to a Length
if I change only this linevalue = text.to_f.to_l #just to do somethingI get 1w in the message box...
with your last code I get an empty message box, with or without the
.to_fjohn
What should "1w" represent?
-
-
-
additional observation:
If onKeyDown or onKeyUp returns true then onCancel is not triggered. It is blocked by onKeyDown/onKeyUp as well.
Advertisement