Difference between revisions of "VS:VM MoveToLayer"
m |
m |
||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:VS:VM_MoveToLayer}} | {{DISPLAYTITLE:VS:VM_MoveToLayer}} | ||
− | + | {{LocationMain|category=LocationVS|specific=}} | |
+ | __TOC__ | ||
+ | <vwDoc> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <desc> | ||
+ | Displays an alert dialog which alerts the user to a condition or situation that requires the user's decision and input before preceding; such as an impending action with potentially destructive or irreversible consequences. The message can be in the form of a question. | ||
+ | </desc> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <def> | ||
+ | <funcDef lang="vs"> | ||
+ | FUNCTION AlertQuestion(question:STRING; advice:STRING; defaultButton:INTEGER; OKOverrideText:STRING; CancelOverrideText:STRING; customButtonAText:STRING; customButtonBText:STRING) : INTEGER; | ||
+ | </funcDef> | ||
+ | <funcDef lang="py"> | ||
+ | def vs.AlertQuestion(question, advice, defaultButton, OKOverrideText, CancelOverrideText, customButtonAText, customButtonBText): | ||
+ | return INTEGER | ||
+ | </funcDef> | ||
+ | </def> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <params> | ||
+ | <lineList ident=1> | ||
+ | <line> | ||
+ | question | ||
+ | STRING | ||
+ | The question to display | ||
+ | </line> | ||
+ | <line> | ||
+ | advice | ||
+ | STRING | ||
+ | The text to be added in a smaller font under the main information/message | ||
+ | </line> | ||
+ | <line> | ||
+ | defaultButton | ||
+ | INTEGER | ||
+ | Specifies which button is to be made the default | ||
+ | 0: the negative(Cancel) button is the default | ||
+ | 1: the positive(Ok) button is the default | ||
+ | 2: custom button A is the default | ||
+ | 3: custom button B is the default | ||
+ | </line> | ||
+ | <line> | ||
+ | OKOverrideText | ||
+ | STRING | ||
+ | Specifies a string to use in overriding the 'OK' string | ||
+ | </line> | ||
+ | <line> | ||
+ | CancelOverrideText | ||
+ | STRING | ||
+ | Specifies a string to use in overriding the 'Cancel' string | ||
+ | </line> | ||
+ | <line> | ||
+ | customButtonAText | ||
+ | STRING | ||
+ | Specifies a string to use for an optional custom button A | ||
+ | </line> | ||
+ | <line> | ||
+ | customButtonBText | ||
+ | STRING | ||
+ | Specifies a string to use for a second optional custom button B | ||
+ | </line> | ||
+ | </lineList> | ||
+ | </params> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <return> | ||
+ | Return Values | ||
+ | 0: the negative(Cancel) button was hit | ||
+ | 1: the positive(Ok) button was hit | ||
+ | 2: custom button A was hit | ||
+ | 3: custom button B was hit</return> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <remark> | ||
+ | Examples of all of the messaging techniques:<pre> | ||
+ | AlertQuestion uses the exclamation icon, when really it should use the question icon. | ||
+ | </remark> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <sample> | ||
+ | {{AlertDialogsAndMessages}} | ||
+ | </sample> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <seeAlso> | ||
+ | VS Functions: | ||
+ | [[VS:AlertInform]] | ||
+ | | [[VS:AlertCritical]] | ||
+ | </seeAlso> | ||
+ | |||
+ | ----------------------------------------------------------------------------------------------------------- | ||
+ | <version> | ||
+ | Availability: from VectorWorks12.0 | ||
+ | |||
+ | </version> | ||
+ | |||
+ | </vwDoc> | ||
+ | |||
[[Category:VS Function Reference:Object Editing]] | [[Category:VS Function Reference:Object Editing]] |
Revision as of 06:59, 16 November 2020
<vwDoc>
<desc> Displays an alert dialog which alerts the user to a condition or situation that requires the user's decision and input before preceding; such as an impending action with potentially destructive or irreversible consequences. The message can be in the form of a question. </desc>
<def> <funcDef lang="vs"> FUNCTION AlertQuestion(question:STRING; advice:STRING; defaultButton:INTEGER; OKOverrideText:STRING; CancelOverrideText:STRING; customButtonAText:STRING; customButtonBText:STRING) : INTEGER; </funcDef> <funcDef lang="py"> def vs.AlertQuestion(question, advice, defaultButton, OKOverrideText, CancelOverrideText, customButtonAText, customButtonBText):
return INTEGER
</funcDef> </def>
<params> <lineList ident=1> <line> question STRING The question to display </line> <line> advice STRING The text to be added in a smaller font under the main information/message </line> <line> defaultButton INTEGER Specifies which button is to be made the default 0: the negative(Cancel) button is the default 1: the positive(Ok) button is the default 2: custom button A is the default 3: custom button B is the default </line> <line> OKOverrideText STRING Specifies a string to use in overriding the 'OK' string </line> <line> CancelOverrideText STRING Specifies a string to use in overriding the 'Cancel' string </line> <line> customButtonAText STRING Specifies a string to use for an optional custom button A </line> <line> customButtonBText STRING Specifies a string to use for a second optional custom button B </line> </lineList> </params>
<return> Return Values 0: the negative(Cancel) button was hit 1: the positive(Ok) button was hit 2: custom button A was hit 3: custom button B was hit</return>
<remark> Examples of all of the messaging techniques:<pre> AlertQuestion uses the exclamation icon, when really it should use the question icon. </remark>
<sample> Template:AlertDialogsAndMessages </sample>
<seeAlso> VS Functions: VS:AlertInform | VS:AlertCritical </seeAlso>
<version> Availability: from VectorWorks12.0
</version>
</vwDoc>