About the ShapeSheet spreadsheetMicrosoft Visio formulas are similar to typical spreadsheet formulas...

AbouttheShapeSheetspreadsheet

EverythinginMicrosoftVisio—everydocument,page,style,shape,group,shapeorobjectwithinagroup,master,objectfromanotherprogram,guide,andguidepoint—hasaShapeSheetspreadsheetwhereinformationaboutthatobjectisstored.Thisspreadsheetcontainsinformationsuchasheight,width,angle,color,andotherattributesthatdeterminetheshape'sappearanceandbehavior.

Asashapedeveloper,youneedprecisecontrolovertheappearanceandbehavioroftheshapesyoucreate.Youcanchangeashape'sdefaultbehaviorandenhancewhatitcandobyeditingitinitsShapeSheetspreadsheet,whichyoucanaccessthroughaShapeSheetwindoworprogrammatically.

ViewinganobjectinaShapeSheetwindow

StructureoftheShapeSheetwindow

EditinganobjectintheShapeSheetwindow

AdditionalShapeSheetspreadsheetreferences

Aboutformulas

Thekeytocontrollingshapeactionsistowriteformulasthatdefinethebehavioryouwant.Youcaneditacell'sformulatochangethevalueofthecelland,asaresult,changeaparticularshape'sbehavior.Forexample,theHeightcellintheShapeTransformsectioncontainsaformulathatyoucanchangetoaltertheshape'sheight.

MicrosoftVisioformulasaresimilartotypicalspreadsheetformulasinmanyways.Visioregardsanythinginacell—evenifitisanumericvalueorsimplecellreference—asaformula.

Aformulainacellcanbeinheritedfromtheequivalentcellofamasterorastyleordefinedlocally.Visioevaluatestheformula,andthenconvertstheresultstoanappropriatevalueandappropriateunitsforthecell.InaShapeSheetwindow,youcandisplaycellcontentsaseitherformulasorvalues.

Elementsofaformula

Defaultformulas

Inheritedformulas

Localformulas

Automaticupdatestoformulas

Aboutoperators

Youcanuseoperatorsinformulastoperformarithmeticoperations(addition,subtraction,multiplication,andsoon)orlogicalcomparisons(greaterthan,lessthan,equalto,andsoon).Youalsocancontroltheorderofevaluationinaformulabyenclosingexpressionsinparentheses.Usetheampersandoperatortocombine(concatenate)characterstrings.

MicrosoftVisioautomaticallyattemptstoconvertdatatypeswhenanoperationorfunctionrequiresaspecifictypeofdata.Forexample,themultiplicationoperatorrequiresnumericarguments,andtheampersand(stringconcatenation)operatorrequiresstringarguments.Iftheargumentcannotbeconvertedtotherequireddatatype,adefaultvalueisprovided.Thedefaultvalueisthetypedequivalentofnothing:zerofornumbers,FALSEforBooleanvalues,""forstrings,andsoon.

Thefollowingtableshowsexamplesofexpressionsandtheirresults.

Expression Result Description

2*5&"cents" "10cents" The&operator(stringconcatenation)requiresstringarguments,sothenumericresultof2*5isautomaticallyconvertedtothestring"10".

5*"2" 10 The*operator(multiplication)

requiresnumericarguments,sothestring"2"isautomaticallyconvertedtotheequivalentnumber2.

5*"sheep" 0 The*operator(multiplication)requiresnumericarguments,sobecausethestring"sheep"cannotbeconvertedtoanumber,zeroisusedasitsnumericequivalent.

Arithmeticoperators

Comparisonoperators

Orderofevaluation

Ampersandoperator

Aboutfunctions

Afunctionperformsasinglewell-definedtask.Mostfunctionstakeanumberofargumentsasinput.Althoughthetypeandnumberofargumentsdependonthefunction,allfunctionshavethesamegeneralsyntax:

FUNCTION(argument1,argument2,…argumentN[,argumentA|argumentB])

Syntaxelement Description() Ifafunctiontakesnoarguments,itmustbefollowedbyan

emptysetofparentheses()., Argumentsareseparatedbyacomma.… Usedfornotationonly;donotincludeinafunction.[] Optionalargument.Usedfornotationonly;donotincludein

afunction.| Achoice;youcanincludeargumentAorargumentB.Usedfor

notationonly;donotincludeinafunction.

Manyfunctionsthatyoucanuseinformulasresemblethoseyou'veseeninspreadsheetprograms:mathematical,suchasSUMorSQRT;trigonometric,suchasSINorCOS;orlogical,suchasIForNOT.ManyotherfunctionsareuniquetoMicrosoftVisio,suchasGUARD,GRAVITY,andRUNADDON.

Formoreinformationonspecificfunctions,seetheShapeSheetReferenceinthisDeveloperReference.

NoteCertainfunctionsappearinformulasgeneratedbyMicrosoftVisio,butarenotlistedintheInsertFunctiondialogboxordescribedinthisDeveloperReferencebecausetheyarereservedforinternaluseandshouldnotbeusedin

otherformulas.Hereareexamples:ELLIPSE_THETA,_ELLIPSE_ECC,_UCON_C1,and_SHAPEMIN.

Aboutstrings

Formulascancontainstrings.Toformatstringoutput,suchasinapromptcell,acustompropertyvalue,oratextfield,youspecifyaformatpicture.Outputcanbeformattedasanumber-unitpair,string,date-time,duration,orcurrency.Forexample,theformatpicture"0#/10uu"formatsthenumber-unitpair10.9cmas"109/10centimeters".

YoucanuseformatpicturesintheFormatcelloftheCustomPropertiessectionandasanargumenttotheFORMATorFORMATEXfunction.Whenyouinsertatextfield,formatpicturesappearinthelistofformatsintheFielddialogbox(ontheInsertmenu,clickField).

Usingfunctionstoformatstrings

Displayingformattedcustomproperties

Aboutcellreferences

YoucancreateinterdependenciesamongformulasbymeansofShapeSheetcellreferences.Cellreferencesgiveyouthepowertocalculateavalueforonecellbasedonanothercell'svalue.Forexample,ashape'sWidthcellmightcontainaformulathatcalculatestheshape'swidthbyreferringtothevalueofitsHeightcell,sothatwhenauserresizestheshapevertically,itswidthstaysinproportion.

Inacell'sformula,youcanrefertoacellofthesameshapeoranotherobject,suchasadocumentorpage,sothatMicrosoftVisiocalculatesavalueforonecellbasedonanothercell'svalue.

Whatcellreferencescaninclude

Cellreferencesyntaxandexamples

Aboutunitsofmeasure

Whenyouinsertfieldsintotextorbuildformulas,youoftenspecifyunitsofmeasureforthevaluesyoutype.

MicrosoftVisioevaluatestheresultofaformuladifferentlydependingonthecellinwhichyouentertheformula.Ingeneral,cellsthatrepresentshapeposition,adimension,orananglerequireanumber-unitpairthatconsistsofanumberandthequalifyingunitsneededtointerpretthenumber.Manyothercellsdon'trequireunitsandevaluatetoastring,toTRUEorFALSE,ortoanindex.Forexample,thesameformulathatintheFillForegndcellmeanscolor5fromthedrawing'scolorpalettemeansTRUE(andlockstheshape'swidth)intheLockWidthcell.

Alwaysspecifyaunitofmeasurewhenyouenteraformulainacellthatexpectsadimensionalvalue.Ifyoudon'tspecifyaunitofmeasure,Visiousesthedefaultunitforthatcell,whichcanbepageunits,drawingunits,typeunits,durationunits,orangularunits.

Unitsofmeasure

Compoundunitsofmeasure

Fractionalunitsofmeasure

Multidimensionalunitsofmeasure

Universalstrings

Implicitunitsofmeasure

Defaultunitsofmeasure

Aboutdate,time,anddurationvalues

Youcanperformoperationsinformulasusingdate,time,anddurationvalues.InMicrosoftVisio,adateandtimeexpressioncanbeevaluatedasasinglevalue.Adateandtimeexpressionisanyexpressioncommonlyrecognizedasadateand/ortimeorareferencetoacellcontainingadateand/ortime.Thisincludesstringsandnumbersthatlooklikeadateandtime,anddateandtimevaluesreturnedfromfunctions.

DateandtimevaluesinVisioarestoredinternallyasa64-bitfloatingpointnumber.ThevaluetotheleftofthedecimalrepresentsthenumberofdayssinceDecember30,1899.Thevaluetotherightofthedecimalrepresentsthefractionofadaysincemidnight.Noonisrepresentedby.5.

Tousedatesandtimeswithinanexpression(ratherthanasasingleconstant),youmustusetheappropriatefunctiontoidentifythemasdateandtimevalues.

Validdates

Validtimes

Dateandtimefunctions

Duration

Aboutformatpictures

Aformatpictureisusedtodeterminehowavaluewillbedisplayed.Forexample,youcancontrolthenumberofdigitsdisplayedtotherightorleftofadecimalpoint,orwhetheratextstringappearsasuppercaseorlowercase.

Thefollowingtablesshowsymbolsyoucanusetoformatdifferenttypesofvaluesfordisplay.

Stringandnumericvalues

Currencyvalues

Textvalues

Datevalues

Timevalues

Aboutcurrencyconstants

Toformatanumberascurrency,youcanusetheCYfunctionandpassanoptionalconstanttospecifywhichcountry/region'scurrencytouse.ThecurrencyconstantscanbespecifiedastheIDnumberthatcorrespondstoacountry/regionorasastring(enclosedinquotationmarks)thatcorrespondstoanISO4217three-characterabbreviation.

Ifyoushowcurrencysymbolsfornonlocalcurrencies,andthesystemdoesnotknowthesymbolforagivencurrency,thedollarsymbol($)isdisplayed.

IDsandabbreviations

Abouterrorvalues

Errorvaluesaredisplayedincellsthathaveincorrectformulasforthatcell.

Ifaformulareferencesacellthatcontainsanerrorvalue,thatformulaalsodisplaysanerrorvalue.YoucanusethefunctionISERR,ISERRNA,ISERROR,orISERRVALUEtolookforerrorvalues.

Errorvalues

Addanewrow

Selectacellintheexistingrow.

OntheInsertmenu,clickRowtoaddthenewrowbeforetheexistingrow,orclickRowAftertoinserttherowaftertheexistingrow.

Orright-clickthecell,andthenclickInsertRoworInsertRowAfterontheshortcutmenu.

Seealso

Addasection

ClickintheShapeSheetwindowtomakeitactive.

Dooneofthefollowing:

OntheInsertmenu,clickSection.

Orright-clickintheShapeSheetwindow,andthenclickInsertSectionontheshortcutmenu.

Selectthecheckboxforthesectionyouwanttoadd,andthenclickOK.

NoteIfyoudon’tseethenewsectionintheShapeSheetwindow,makesurethesectionissettoappear.OntheViewmenu,clickSections,andthenselectthecheckboxesforthesectionsyouwanttoappear.

Seealso

AddtheShowShapeSheetcommandtotheshortcutmenuOntheToolsmenu,clickOptions,andthenclicktheAdvancedtab.

UnderDeveloperSettings,selecttheRunindevelopermodecheckbox.

ClickOK.

Changearowtype

Selectarowbyclickingitslabel.

OntheEditmenu,clickChangeRowType.

Orright-clickarowlabelorcell,andthenclickChangeRowTypeontheshortcutmenu.

Seealso

ChangethenameandviewtheIDofashape

Selectashapeinadrawingwindow.

OntheFormatmenu,clickSpecial.

IntheSpecialdialogbox,enteraname.

TheIDoftheshapeislistedatthetopoftheSpecialdialogbox.

ClickOK.

Seealso

Collapseorexpandasection

Pointtothesectiontitle.

Ifthepointerchangestoaminussign ,youcancollapsethesection.

Ifthepointerchangestoaplussign ,youcanexpandthesection.

Clickthesectiontitle.

Thedisplaychangestoeitherhideorshowthesection'scells.

Seealso

Copyandpasteaformulafromonecellintoanothercell

Selectthecellthatcontainstheformulayouwant.

OntheEditmenu,clickCopy.

Toreplacetheentireformula,selectthecellwhoseformulayouwanttoreplace.

Topastetheformulaintoanexistingformula,double-clickthecell,andthenclickaninsertionpointwhereyouwanttopastetheformula.

OntheEditmenu,clickPaste.

PressENTERtoaccepttheformula.

Seealso

CustomizeShapeSheetmenusandtoolbars

OntheViewmenu,pointtoToolbars,andthenclickCustomize.

Orright-clickthetoolbar,andthenclickCustomizeontheshortcutmenu.

Seealso

Deletearow

Selectacellintherowyouwanttodelete.

OntheEditmenu,clickDeleteRow.

Orright-clickthecell,andthenclickDeleteRowontheshortcutmenu.

Followingrowsmoveuponerowinthesection.

Seealso

Deleteasection

Selectanycellinthesectionyouwanttodelete,andthenontheEditmenu,clickDeleteSection.

Orright-clickacell,andthenclickDeleteSectionontheshortcutmenu.

NoteCertainsectionscannotbedeleted.Forexample,youcannotdeletetheShapeTransformsectionbecauseitspecifiesashape'sposition.Ifyoucannotdeleteasection,DeleteSectionisdimmed.

Seealso

Displayformulasorvaluesincells

OntheViewmenu,clickFormulastoviewformulas,orclickValuestoviewvalues.

Youcanalsoright-clickintheShapeSheetwindow,andthenclickFormulasorValuesontheshortcutmenu.

Editapartofaformula

Double-clickthecell.OrselectthecellandpressF2.

Inthecellortheformulabar,edittheformulausingthetechniquesinthefollowingtable.

To DothisPlacetheinsertionpoint Clickwhereyouwanttheinsertionpointto

appear.Movetheinsertionpoint Presstheleftorrightarrowkey.Deletethecharactertotheleft PressBACKSPACE.Deletethecharactertotheright PressDELETE.Selecttext Dragthemouseoverthetext.Extendtheselectiontotheleft PressSHIFT+leftarrow.Extendtheselectiontotheright PressSHIFT+rightarrow.Selectaword PressCTRL+SHIFT+rightarrowor

double-click.Selecttotheend PressSHIFT+END.Selecttothebeginning PressSHIFT+HOME.Replaceselectedtext Typethenewtext.Deleteselectedtext PressDELETE.OrontheEditmenu,click

Enteranemptyformula

Selectthecellthatwillcontaintheformula.

PressDELETE,andthenpressENTER.

TipTrythisinaScratchcellafterinsertingalocalformula.ThecellrevertstoNoFormula,becausethereisnoformulatoinheritfromthemaster.

Seealso

MovearoundaShapeSheetwindow

TomovefromcelltocellinaShapeSheetwindow,usethearrowandTABkeys.ClickacelltoactivateitorscrollthroughtheShapeSheetcellswithoutchangingtheactivecell.

Youalsocanusethetechniquesinthefollowingtable.

To DothisActivateacell Clickthecellwiththepointer.Selectanumberedrowofcells Clicktherownumber.Moveleftonecell PresstheleftarrowkeyorSHIFT+TAB.Moverightonecell PresstherightarrowkeyorTAB.Moveuponecell Presstheuparrowkey.Movedownonecell Pressthedownarrowkey.Movetothelastcellinarow PressEND.Movetothefirstcellinarow PressHOME.Scrolldownonescreen PressPAGEDOWN.Scrolluponescreen PressPAGEUP.Scrollrightonescreen PressCTRL+PAGEDOWN.Scrollleftonescreen PressCTRL+PAGEUP.Scrolltothewindow'slower-rightcorner

PressCTRL+END.

Scrolltothewindow'supper-rightcorner

PressCTRL+HOME.

Seealso

Insertafunctionintoaformula

Double-clickthecell,andthenplacetheinsertionpointwhereyouwanttopastethefunction.

OntheInsertmenu,clickFunction.

IntheInsertFunctiondialogbox,clickthefunctionyouwantinthelist.

IfyouwantMicrosoftVisiotoincludethesyntaxforthefunction'sarguments,selecttheInsertargumentsintoformulabarcheckbox.

ClickOK.

Supplytheargumentsyouwantforthefunctionbytypingthem,byclickingShapeSheetcells,orbyusingtheNAMEfunctiontoselectShapeSheetcells.

Whentheformulaisfinished,pressENTERtoacceptchanges.OrpressESCtocancelthechanges.

NoteCertainfunctionsappearinformulasgeneratedbyVisio,butarenotlistedintheInsertFunctiondialogboxordescribedinthisDeveloperReference.Thesefunctionsbeginwithasingleunderscore(forexample,_ELLIPSE_THETA).Theyarereservedforinternaluseandshouldnotbeusedinotherformulas.

Seealso

Referenceacellinaformula

Double-clickthecellinwhichyouwanttoplacethereference,andthenplacetheinsertionpointatthelocationyouwantintheformula.

OntheInsertmenu,clickName.

IntheInsertNamedialogbox,clickthecellinthelistthatyouwanttoreference,andthenclickOK.

Toinsertmorethanonereferenceinyourformula,clickInsertaftereachselection.ClickOKwhenyouarefinished.

PressENTERtoaccepttheformula.OrpressESCtocancelthechanges.

TipYoucanquicklyreferenceacellinaformulabyplacingtheinsertionpointintheformulabar,clickingthecellyouwanttoreference,andthenpressingENTER.Thenameofthecellisinsertedattheinsertionpoint.

Seealso

ResizeacolumninaShapeSheetwindow

Placethepointeroverthecolumndivider,andthendragthedividertoincreaseordecreasethesizeofthecolumn.

Seealso

ShowanobjectintheShapeSheetwindowVisioobjectsarestoredinternallyasasetofformulas.YoucanviewaVisioobjectintheShapeSheetwindowtoseeandedittheunderlyingformulasthatdetermineitsappearanceandbehavior.

FordetailsonhowtoshowaspecificobjectintheShapeSheetwindow,clickanelementinthefollowinglist.

Showashape,group,guide,guidepoint,orforeignobject

Showamaster

Showapage

Showadocument

Showastyle

Showorhidesections

OntheViewmenu,clickSections.Orright-clickintheShapeSheetwindow,andthenclickViewSections.

Selectthecheckboxesforthesectionsyouwanttoshow,orclearthecheckboxesforthesectionsyouwanttohide.

ClickOK.

Seealso

ShoworhideShapeSheettoolbars

OntheViewmenu,clickToolbars.Orright-clickanytoolbar.

Selectthetoolbaryouwanttoshoworhide.

Acheckmarkspecifiesthatatoolbarisshown.

ShowtheDevelopertoolbar

OntheViewmenu,pointtoToolbars,andthenclickDeveloper.Orright-clickthetoolbar,andthenclickDeveloperontheshortcutmenu.

YouthencanselectanobjectandclicktheShowShapeSheetbutton forquickeraccesstotheShapeSheetwindow.

Typeanewformulaforacell

Selectthecell.

Thecell'sformulaappearsinthecellandintheformulabar.

Typethenewformula.

Theformulayoutypereplacesthecell'spreviousformula.

Ifyoutypeanumberbutdon'tsupplyunitsofmeasure,MicrosoftVisiousestheunitsfromthecell'spreviousvalueiftherewasone.Otherwise,ifthecellrequiresunits,Visiousesthedefaultunitsforthecell.

Toaccepttheformula,pressENTER.

Ifthenumberorformulacontainsanerror,Visiodisplaysamessageandthenhighlightstheerrorintheformulabarorcell.Correcttheerror,andpressENTERtoacceptthecorrection.

Acell(Geometrysection)

Representsdifferentinformationindifferentrows.ThistabledescribestheAcellbasedontherowinwhichit'slocated.

Row DescriptionArcTo Thedistancefromthearc'smidpointtothemidpointof

itschord.EllipticalArcTo Thex-coordinateofthearc'scontrolpoint—apointon

thearc.Thecontrolpointisbestlocatedabouthalfwaybetweenthebeginningandendingverticesofthearc.Otherwise,thearcmaygrowtoanextremesizeinordertopassthroughthecontrolpoint,withunpredictableresults.

PolylineTo Thepolylineformula.NURBSTo Thesecondtothelastknotofthenonuniformrational

B-spline(NURBS).SplineStart Thesecondknotofthespline.SplineKnot Oneofthespline'sknots(otherthanthelastoneorthe

firsttwo).InfiniteLine Anx-coordinateofapointontheinfiniteline;paired

Seealso

withy-coordinaterepresentedbytheBcell.Ellipse Anx-coordinateofapointontheellipse;pairedwithy-

coordinaterepresentedbytheBcell.

Remarks

ToreferencetheAcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.Ajwhereiandj=<1>,2,3…

Geometryi.A1(InfiniteLineandEllipserows)wherei=<1>,2,3…

ToreferencetheAcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionFirstComponent+iwherei=0,1,2…

Rowindex: visRowVertex+jwherej=0,1,2…

visRowVertex(InfiniteLineandEllipserows)Cellindex: visBow(ArcTorow) visControl(EllipticalArcTorow) visPolylineData(Polylinerow) visNURBSKnot(NURBSTorow) visSplineKnot(SplineStartandSplineKnotrows) visInfiniteLineX2(InfiniteLinerow) visEllipseMajorX(Ellipserow)

Actioncell(Actionssection)

ContainstheformulatobeexecutedwhenauserchoosesthecommandnamedefinedinthecorrespondingMenucell.

Remarks

AnActioncellisevaluatedonlywhentheactionoccurs,notwhentheformulaisentered.

ToreferencetheActioncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Actions.Action[i]wherei=<1>,2,3…

ToreferencetheActioncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionActionRowindex: visRowAction+i

wherei=0,1,2…Cellindex: visActionAction

Seealso Rows

Activecell(Layerssection)

Specifieswhetherthelayerisactive.Shapeswithoutpre-assignedlayersareassignedtotheactivelayer(s)whendroppedonthedrawingpage.

Value DescriptionTRUE Layerisactive.FALSE Layerisnotactive.

Remarks

ThevalueinthiscellcorrespondstotheActiveoptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

ToreferencetheActivecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Active[i]wherei=<1>,2,3…

ToreferencetheActivecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionLayerRowindex: visRowLayer+i

wherei=0,1,2…Cellindex: visLayerActive

Seealso Rows

Addresscell(Hyperlinkssection)

SpecifiesaURLaddress,DOSfilename,orUNCpathtowhichtojump.

YoucanspecifyAddressasarelativepathbasedonthebasepathdefinedforthedocumentintheHyperlinkBasefieldontheSummarytabofthePropertiesdialogbox(clickPropertiesontheFilemenu).Ifthedocumenthasnobasepath,theapplicationnavigatesbasedonthedocumentpath.Ifthedocumenthasn'tbeensaved,thehyperlinkisundefined.

Remarks

YoucanalsosetthevalueoftheAddresscellintheHyperlinksdialogbox(clickHyperlinksontheInsertmenu).

ToreferencetheAddresscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Hyperlink.Name.AddresswhereHyperlink.Nameisthenameofthehyperlinkrow

ToreferencetheAddresscellbyindexfromaprogram,usetheCellsSRC

Seealso

propertywiththefollowingarguments:

Sectionindex: visSectionHyperlinkRowindex: visRow1stHyperlink+i

wherei=0,1,2…Cellindex: visHLinkAddress

AlignBottomcell(Alignmentsection)

Determinestheverticalposition,relativetotheoriginofitsparent,ofahorizontalguideorguidepointtowhichtheshape'sbottomborderisaligned.

Remarks

ToreferencetheAlignBottomcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AlignBottom

ToreferencetheAlignBottomcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowAlignCellindex: visAlignBottom

Seealso Rows

AlignCentercell(Alignmentsection)

Determinesthehorizontalposition,relativetotheoriginofitsparent,ofaverticalguideorguidepointtowhichtheshape'shorizontalcenterisaligned.

Remarks

ToreferencetheAlignCentercellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AlignCenter

ToreferencetheAlignCentercellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowAlignCellindex: visAlignCenter

Seealso Rows

AlignLeftcell(Alignmentsection)

Determinesthehorizontalposition,relativetotheoriginofitsparent,ofaverticalguideorguidepointtowhichtheshape'sleftborderisaligned.

Remarks

ToreferencetheAlignLeftcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AlignLeft

ToreferencetheAlignLeftcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowAlignCellindex: visAlignLeft

Seealso Rows

Alignmentcell(Tabssection)

Specifiesthetabalignment.

Value Alignment Automationconstant0 Left visTabStopLeft1 Center visTabStopCenter2 Right visTabStopRight3 Decimal visTabStopDecimal4 Comma visTabStopComma

Remarks

ToreferencetheAlignmentcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Tabs.ijwhereiandj=<1>,2,3

ToreferencetheAlignmentcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionTabRowindex: visRowTab+i

wherei=0,1,2…Cellindex: (j*3)+visTabAlign

Seealso Rows

AlignMiddlecell(Alignmentsection)

Determinestheverticalposition,relativetotheoriginofitsparent,ofahorizontalguideorguidepointtowhichtheshape'sverticalcenterisaligned.

Remarks

ToreferencetheAlignMiddlecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AlignMiddle

ToreferencetheAlignMiddlecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowAlignCellindex: visAlignMiddle

Seealso Rows

AlignRightcell(Alignmentsection)

Determinesthehorizontalposition,relativetotheoriginofitsparent,ofaverticalguideorguidepointtowhichtheshape'srightborderisaligned.

Remarks

ToreferencetheAlignRightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AlignRight

ToreferencetheAlignRightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowAlignCellindex: visAlignRight

Seealso Rows

AlignTopcell(Alignmentsection)

Determinestheverticalposition,relativetotheoriginofitsparent,ofahorizontalguideorguidepointtowhichtheshape'stopborderisaligned.

Remarks

ToreferencetheAlignTopcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AlignTop

ToreferencetheAlignTopcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowAlignCellindex: visAlignTop

Seealso Rows

Anglecell(ShapeTransformsection)

Representstheshape'scurrentangleofrotationinrelationtoitsparent.Thedefaultformulafordeterminingtherotationangleofa1-Dshapeis:=ATAN2(EndY-BeginY,EndX-BeginX).

Remarks

ToreferencetheAnglecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Angle

ToreferencetheAnglecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormAngle

Seealso Rows

Askcell(CustomPropertiessection)

Determineswhetherauserisqueriedtoentercustompropertyinformationforashapewhenaninstanceiscreatedortheshapeisduplicatedorcopied.

Value DescriptionTRUE AskusertoentercustompropertydataintheCustomProperties

dialogbox.FALSE Donotaskusertoenterdata.

Remarks

ToreferencetheAskcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.VerifywhereProp.Nameisthenameofthecustompropertyrow

ToreferencetheAskcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso

Sectionindex: visSectionPropRowindex: visRowProp+i

wherei=0,1,2,…Cellindex: visCustPropsAsk

AvenueSizeXcell(PageLayoutsection)

DeterminestheamountofhorizontalspacebetweenshapesonthedrawingpagewhenyoulayoutshapesusingtheLayOutShapesdialogbox(clickLayOutShapesontheShapemenu).

Remarks

YoucanalsosetthisvalueintheLayoutandRoutingSpacingdialogbox(ontheFilemenu,clickPageSetup,clicktheLayoutandRoutingtab,andthenclickSpacing).

ThedynamicgridusesthesettingintheAvenueSizeXcellwhenonlyoneshapeisavailableforcalculatinghorizontalspacing.Tousethedynamicgrid,clickSnap&GlueontheToolsmenu,andthenselecttheDynamicGridcheckboxunderCurrentlyActive.

ToreferencetheAvenueSizeXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AvenueSizeX

ToreferencetheAvenueSizeXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayout

Seealso Rows

Cellindex: visPLOAvenueSizeX

AvenueSizeYcell(PageLayoutsection)

DeterminestheamountofverticalspacebetweenshapesonthedrawingpagewhenyoulayoutshapesusingtheLayOutShapesdialogbox(clickLayOutShapesontheShapemenu).

Remarks

ThedynamicgridusesthesettingintheAvenueSizeYcellwhenonlyoneshapeisavailableforcalculatingverticalspacing.Tousethedynamicgrid,clickSnap&GlueontheToolsmenu,andthenselecttheDynamicGridcheckboxunderCurrentlyActive.

ToreferencetheAvenueSizeYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: AvenueSizeY

ToreferencetheAvenueSizeYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Cellindex: visPLOAvenueSizeY

Bcell(Geometrysection)

Representsdifferentinformationindifferentrows.ThistabledescribestheBcellbasedontherowinwhichit'slocated.

Row DescriptionEllipticalArcTo They-coordinateofanarc'scontrolpoint.NURBSTo ThelastweightofthenonuniformrationalB-spline

(NURBS).SplineStart Thefirstknotofaspline.InfiniteLine Ay-coordinateofapointonaninfiniteline;paired

withx-coordinaterepresentedbytheAcell.Ellipse Ay-coordinateofapointonanellipse;pairedwithx-

coordinaterepresentedbytheAcell.

Remarks

ToreferencetheBcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.Bjwhereiandj=<1>,2,3…

Seealso

Geometryi.B1(InfiniteLineandEllipserows)

ToreferencetheBcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

visRowVertex(InfiniteLineandEllipserows)Cellindex: visControl(EllipticalArcTorow) visNURBSWeight(NURBSTorow) visSplineKnot2(SplineStartrow) visInfiniteLineY2(InfiniteLinerow) visEllipseMajorY(Ellipserow)

BeginArrowcell(LineFormatsection)

Indicateswhetheralinehasanarrowheadorotherlineendformatatitsfirstvertex.Enteranumberfrom0to45ortheUSEfunctionwiththenameofacustomlineend,orusetheLinedialogbox.

Value Description0 Noarrowhead.1-45 Assortedarrowheadstylesthatcorrespondtoindexed

entriesintheLinedialogbox.

Remarks

ThesizeofthearrowheadissetintheBeginArrowSizecell.

ToreferencetheBeginArrowcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BeginArrow

ToreferencetheBeginArrowcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineBeginArrow

Seealso Rows

BeginArrowSizecell(LineFormatsection)

Determinesthesizeofthearrowheadatthebeginningoftheline.

Value Size Automationconstant0 Verysmall visArrowSizeVerySmall1 Small visArrowSizeSmall2 Medium visArrowSizeMedium3 Large visArrowSizeLarge4 Verylarge visArrowSizeVeryLarge5 Jumbo visArrowSizeJumbo6 Colossal visArrowSizeColossal

Remarks

YoucanalsosetthesizeofthearrowheadintheLinedialogbox.

ToreferencetheBeginArrowSizecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BeginArrowSize

ToreferencetheBeginArrowSizecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineBeginArrowSize

BeginXcell(1-DEndpointssection)

Representsthex-coordinateofthebeginpointofthe1-Dshape,inrelationtotheoriginofitsparent.

Remarks

ToreferencetheBeginXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BeginX

ToreferencetheBeginXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXForm1DCellindex: vis1DbeginX

Seealso Rows

BeginYcell(1-DEndpointssection)

Representsthey-coordinateofthebeginpointofthe1-Dshape,inrelationtotheoriginofitsparent.

Remarks

ToreferencetheBeginYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BeginY

ToreferencetheBeginYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXForm1DCellindex: vis1DbeginY

Seealso Rows

BegTriggercell(GlueInfosection)

Containsatriggerformulageneratedbytheapplicationthatdetermineswhethertomovethebeginpointofa1-Dshapetomaintainitsconnectiontoanothershape.

Remarks

Whenyougluea1-Dshapetoanothershapeusingdynamicglue,theapplicationgeneratesaformulathatreferstotheEventXFModcelloftheothershape.Whenthatshapeischanged,VisiorecalculatesanyformulathatreferstoitsEventXFModcell,includingtheformulaintheBegTriggercell.Otherformulasforthe1-DshaperefertotheBegTriggercellandmovethebeginpointofthe1-Dshapeoraltertheshapeasneeded.

ToreferencetheBegTriggercellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BegTrigger

ToreferencetheBegTriggercellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowGroupCellindex: visBegTrigger

Seealso Rows

BlockSizeXcell(PageLayoutsection)

Determinesthehorizontalblocksize,theareainwhicheachofyourshapesmustfitonthedrawingpagewhenyoulayoutshapesusingtheLayOutShapesdialogbox(clickLayOutShapesontheShapemenu).

Remarks

ToreferencetheBlockSizeXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BlockSizeX

ToreferencetheBlockSizeXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOBlockSizeX

Seealso Rows

BlockSizeYcell(PageLayoutsection)

Determinestheverticalblocksize,theareainwhicheachofyourshapesmustfitonthedrawingpagewhenyoulayoutshapesusingtheLayOutShapesdialogbox(clickLayOutShapesontheShapemenu).

Remarks

ToreferencetheBlockSizeYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BlockSizeY

ToreferencetheBlockSizeYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOBlockSizeY

Seealso Rows

Blurcell(ImagePropertiessection)

Blursorsoftensabitmapimage.Thedefaultvalueis0%.

Remarks

ToreferencetheBlurcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Blur

ToreferencetheBlurcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageBlur

Seealso Rows

BottomMargincell(TextBlockFormatsection)

Determinesthedistancebetweenthebottomborderofthetextblockandthelastlineoftextitcontains.Thedefaultis0.1inch.Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,thebottommarginremainsthesame.

Remarks

ToreferencetheBottomMargincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: BottomMargin

ToreferencetheBottomMargincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkBottomMargin

Seealso Rows

Brightnesscell(ImagePropertiessection)

Adjuststhebrightnessofabitmapimage.Decreasebrightnessofanimagebyenteringavaluebetween0%and49%,orincreasebrightnessbyenteringavaluebetween51%and100%.Thedefaultvalueis50%.

Remarks

ToreferencetheBrightnesscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Brightness

ToreferencetheBrightnesscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageBrightness

Seealso Rows

Bulletcell(Paragraphsection)

Determinesthebulletstyle.

Value Bulletstyle0 None1234567

Remarks

Youcanalsosetthevalueofthiscellbyselectingashape,clickingTextontheFormatmenu,andthenclickingtheBulletstab.

ToreferencetheBulletcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.Bullet[i]wherei=<1>,2,3,…

ToreferencetheBulletcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionParagraphRowindex: visRowParagraph+i

wherei=0,1,2,…Cellindex: visBulletIndex

BulletStringcell(Paragraphsection)

Allowsyoutocreateacustombulletstyle.Enterthestyleasastring(withinquotationmarks).Forexample,youcouldenterthestring,"ooo."

Remarks

Youcanalsosetthevalueofthiscellbyselectingashape,clickingTextontheFormatmenu,andthenclickingtheBulletstab.

ToreferencetheBulletStringcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.BulletStr[i]wherei=<1>,2,3,…

ToreferencetheBulletStringcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2,…Cellindex: visBulletString

Seealso Rows

Ccell(Geometrysection)

Representsdifferentinformationindifferentrows.ThistabledescribestheCcellbasedontherowinwhichit'slocated.

Row DescriptionEllipticalArcTo Theangleofanarc'smajoraxisrelativetothex-axis

ofitsparent.NURBSTo ThefirstknotofthenonuniformrationalB-spline

(NURBS).SplineStart Thelastknotofaspline.Ellipse Anx-coordinateofapointonanellipse;pairedwith

they-coordinaterepresentedbytheDcell.

Remarks

ToreferencetheCcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.Cjwhereiandj=<1>,2,3…

Geometryi.C1(Ellipserow)

Seealso

ToreferencetheCcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

visRowVertex(Ellipserow)Cellindex: visEccentricityAngle(EllipticalArcTorow) visNURBSKnotPrev(NURBSTorow) visSplineKnot3(SplineStartrow) visEllipseMinorX(Ellipserow)

CanGluecell(Controlssection)

Determineswhetheracontrolhandlecanbegluedtoothershapes.

Value DescriptionTRUE Controlhandlecanbeglued.FALSE Controlhandlecannotbeglued.

Remarks

ToreferencetheCanGluecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.CanGlue[i]wherei=<1>,2,3,…

ToreferencetheCanGluecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionControlsRowindex: visRowControl+i

wherei=0,1,2,…Cellindex: visCtlGlue

Seealso Rows

Casecell(Charactersection)

Determinesthecaseofashape'stext.Allcapital(uppercase)letters(1)andinitialcapitalletters(2)donotchangetheappearanceoftextthatwasenteredinallcapitalletters.Thetextmustbeenteredinlowercaselettersfortheseoptionstoshowaneffect.

Value Description Automationconstant0 Normalcase visCaseNormal1 Allcapital(uppercase)letters visCaseAllCaps2 Initialcapitallettersonly visCaseInitialCaps

Remarks

ToreferencetheCasecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Case[i]wherei=<1>,2,3,…

ToreferencetheCasecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionCharacterRowindex: visRowCharacter+i

wherei=0,1,2,…Cellindex: visCharacterCase

Seealso Rows

Checkedcell(Actionssection)

Togglesthedisplayofacheckmarkbesidethecommandnameontheshortcutmenu.

Value DescriptionTRUE Checkmarkisdisplayed.FALSE Checkmarkisnotdisplayed.

Remarks

ToreferencetheCheckedcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Actions.Ciwherei=<1>,2,3,…

ToreferencetheCheckedcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2,…Cellindex: visActionChecked

Seealso Rows

Colorcell(Charactersection)

Determinesthecolorusedfortheshape'stext.

Remarks

Tosetthecolor,enteranumberfrom0to23.Thisnumbercorrespondstoacolorinthecurrentcolorpalette,whichyoucanalsosetintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

Toenteracustomcolor,usetheRGBorHSLfunction.ThevalueofacustomcolorisitsRGBcolor,andRGB(r,g,b),ratherthananumber,willbeshownintheShapeSheetwindow.Whenusedinnumericoperations,customcolorshavevaluesof24andabove.

YoucansetthetransparencyofthetextcolorintheTransparencycell.

ToreferencetheColorcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Color[i]wherei=<1>,2,3,…

ToreferencetheColorcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2,…Cellindex: visCharacterColor

Colorcell(Layerssection)

Specifiesthecolorusedtodisplaythelayer.

Remarks

Tosetthecolor,enteranumberfrom0to23.Thisnumbercorrespondstoacolorinthecurrentcolorpalette,whichyoucanalsosetintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

ThiscellcorrespondstotheColoroptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

YoucansetthetransparencyofthelayercolorintheTransparencycell.

ToreferencetheColorcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Color[i]wherei=<1>,2,3,…

ToreferencetheColorcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2,…Cellindex: visLayerColor

Commentcell(Miscellaneoussection)

Containsthecommenttextinstringformatforashape.

Remarks

YoucanalsoinsertacommentusingtheCommentdialogbox(clickCommentontheInsertmenu).

ToreferencetheCommentcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Comment

ToreferencetheCommentcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visComment

Seealso Rows

ConFixedCodecell(ShapeLayoutsection)

Determineswhenaconnectorreroutes.

Value Description Automationconstant0 Reroutefreely visSLOConFixedRerouteFreely1 Rerouteasneeded(manual

reroute)visSLOConFixedRerouteAsNeeded

2 Neverreroute visSLOConFixedRerouteNever3 Rerouteoncrossover visSLOConFixedRerouteOnCrossover4 Forinternaluseonly visSLOConFixedByAlgFrom5 Forinternaluseonly visSLOConFixedByAlgTo6 Forinternaluseonly visSLOConFixedByAlgFromTo

Remarks

Youcanalsosetthevalueofthiscellbyselectingaconnector,clickingBehaviorontheFormatmenu,andthenclickingtheConnectortab.

ToreferencetheConFixedCodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConFixedCode

ToreferencetheConFixedCodecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOConFixedCode

ConLineJumpCodecell(ShapeLayoutsection)

Determineswhenaconnectorjumps.

Value Description Automationconstant0 Aspagespecifies;ontheFilemenu,click

PageSetup,andthenclicktheLayoutandRoutingtabtoseethepagespecifications

visSLOJumpDefault

1 Never visSLOJumpNever2 Always visSLOJumpAlways3 Otherconnectorjumps visSLOJumpOther4 Neitherconnectorjumps visSLOJumpNeither

Remarks

Youcanalsosetthevalueofthiscellbyselectingaconnector,clickingBehaviorontheFormatmenu,andthenclickingtheConnectortab.

ToreferencetheConLineJumpCodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConLineJumpCode

ToreferencetheConLineJumpCodecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOJumpCode

ConLineJumpDirXcell(ShapeLayoutsection)

Determinesthelinejumpdirectionforlinejumpsoccurringonahorizontaldynamicconnectorforashape.

Value Linejumpdirection Automationconstant0 Pagedefault visLOJumpDirXDefault1 Up visLOJumpDirXUp2 Down visLOJumpDirXDown

Remarks

Tosetthedefaulthorizontaldirectionforallconnectorjumpsonapage,usethePageLineJumpDirXcellinthePageLayoutsection.

ToreferencetheConLineJumpDirXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConLineJumpDirX

ToreferencetheConLineJumpDirXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayout

Cellindex: visSLOJumpDirX

ConLineJumpDirYcell(ShapeLayoutsection)

Determinesthelinejumpdirectionforlinejumpsoccurringonaverticaldynamicconnectorforashape.

Value LineJumpDirection Automationconstant0 Pagedefault visLOJumpDirYDefault1 Left visLOJumpDirYLeft2 Right visLOJumpDirYRight

Remarks

Tosetthedefaultverticaldirectionforallconnectorjumpsonapage,usethePageLineJumpDirYcellinthePageLayoutsection.

ToreferencetheConLineJumpDirYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConLineJumpDirY

ToreferencetheConLineJumpDirYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Cellindex: visSLOJumpDirY

ConLineJumpStylecell(ShapeLayoutsection)

Determinesthelinejumpstyleforlinejumpsonadynamicconnector.

Value LineJumpStyle Automationconstant0 Pagedefault visLOJumpStyleDefault1 Arc visLOJumpStyleArc2 Gap visLOJumpStyleGap3 Square visLOJumpStyleSquare4 Triangle visLOJumpStyleTriangle5 3sides visLOJumpStyle2Point6 4sides visLOJumpStyle3Point7 5sides visLOJumpStyle4Point8 6sides visLOJumpStyle5Point9 7sides visLOJumpStyle6Point

Remarks

Youcanalsosetthevalueofthiscellbyselectingadynamicconnector,clickingBehaviorontheFormatmenu,andthenclickingtheConnectortab.

ToreferencetheConLineJumpStylecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConLineJumpStyle

Seealso Rows

ToreferencetheConLineJumpStylecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOJumpStyle

ConLineRouteExtcell(ShapeLayoutsection)

Determinestheappearanceofaconnector.

Value Description Automationconstant0 Default;usepagesetting visLORouteExtDefault1 Straight visLORouteExtStraight2 Curved visLORouteExtNURBS

Remarks

ToreferencetheConLineRouteExtcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConLineRouteExt

ToreferencetheConLineRouteExtcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOLineRouteExt

Contrastcell(ImagePropertiessection)

Adjuststhecontrastofabitmapimage.Decreasethecontrastofanimagebyenteringavaluebetween0%and49%,orincreasethecontrastbyenteringavaluebetween51%and100%.Thedefaultvalueis50%.

Remarks

ToreferencetheContrastcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Contrast

ToreferencetheContrastcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageContrast

Seealso Rows

CtrlAsInputcell(PageLayoutsection)

Determineswhichshapeistheparentwhenusingshapeswithcontrolhandles.Thiscellsetsthebehaviorforalltheshapesonthedrawingpage.

Value DescriptionTRUE Settheshapethatthecontrolhandleisconnectedtoas

theparent.FALSE Thedefault.Setshapethatcontainsthecontrolhandle

astheparent.

Remarks

ToreferencetheCtrlAsInputcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: CtrlAsInput

ToreferencetheCtrlAsInputcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOCtrlAsInput

Seealso Rows

Dcell(ConnectionPointssection)

Ascratchcellthatyoucanuseforenteringortestingformulas.

Remarks

ToaccesstheDcell,right-clickarow,andthenclickChangeRowTypeontheshortcutmenu.

ToreferencetheDcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Connections.AutoGen[i]wherei=<1>,2,3…

ToreferencetheDcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionConnectionPtsRowindex: visRowConnectionPts+i

wherei=0,1,2…Cellindex: visCnnctAutoGen

Seealso

Dcell(Geometrysection)

Representsdifferentinformationindifferentrows.ThistabledescribestheDcellbasedontherowinwhichit'slocated.

Row DescriptionEllipticalArcTo Theratioofanarc'smajoraxistoitsminoraxis.

Despitetheusualmeaningofthesewords,the"major"axisdoesnothavetobegreaterthanthe"minor"axis,sothisratiodoesnothavetobegreaterthan1.Settingthiscelltoavaluelessthanorequalto0orgreaterthan1000canleadtounpredictableresults.

NURBSTo ThefirstweightofthenonuniformrationalB-spline(NURBS).

SplineStart Thedegreeofaspline(anintegerfrom1to25).Ellipse Ay-coordinateofapointonanellipse;pairedwiththe

x-coordinaterepresentedbytheCcell.

Remarks

ToreferencetheDcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.Djwhereiandj=<1>,2,3…

Geometryi.D1(Ellipserow)wherei=<1>,2,3…

ToreferencetheDcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

visRowVertex(Ellipserow)Cellindex visAspectRatio(EllipticalArcTorow) visNURBSWeightPrev(NURBSTorow) visSplineDegree(SplineStartrow) visEllipseMinorY(Ellipserow)

Defaultcell(Hyperlinkssection)

Determinesthedefaulthyperlinkforashapeorpage.SetthevalueofthiscelltoTRUEtosetahyperlinkasthedefault.

Remarks

Youcanalsosetthedefaulthyperlinkbyselectingashape,clickingHyperlinksontheInsertmenu,selectingahyperlink,andthenclickingDefault.Thedefaulthyperlinkappearsinboldtext.

ToreferencetheDefaultcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Hyperlink.Name.DefaultwhereHyperlink.Nameistherowname

ToreferencetheDefaultcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso

wherei=0,1,2…Cellindex: visHLinkDefault

DefaultTabstopcell(TextBlockFormatsection)

Determinestheintervalofthedefaulttabstopsinatextblock.Thedefaultvalueis0.5inchesfordocumentscreatedinimperialunitsand1.5centimetersfordocumentscreatedinmetricunits.

Remarks

WhetheradocumentiscreatedinimperialormetricunitsdependsonthesettinginthePageboxontheRegionaltabintheOptionsdialogbox(ontheToolsmenu,clickOptions.)

ToreferencetheDefaultTabstopcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DefaultTabstop

ToreferencetheDefaultTabstopcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkDefaultTabStop

Seealso Rows

Denoisecell(ImagePropertiessection)

Removesnoise(pixelswithrandomlydistributedcolorlevels)fromabitmapimage.Thedefaultvalueis0%.

Remarks

ToreferencetheDenoisecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Denoise

ToreferencetheDenoisecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageDenoise

Seealso Rows

Descriptioncell(Hyperlinkssection)

Representsadescriptivetextstringforahyperlink.Usethiscelltostorecommentsaboutthehyperlink;forexample,"LinktoourpricingWebsite."

Remarks

YoucanalsosetthevalueofthiscellusingtheHyperlinksdialogbox(clickHyperlinksontheInsertmenu).

ToreferencetheDescriptioncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Description

ToreferencetheDescriptioncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageDescription

Seealso

DirX/Acell(ConnectionPointssection)

Determinesthex-componentfortherequiredalignmentvectorofamatchingconnectionpoint.TheDirX/Acellisalsousedtoorienttheattachedlegofadynamicconnector.Thiscelltakesafloatingpointvalue.

Remarks

ToreferencetheDirX/Acellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Connections.DirX[i]wherei=<1>,2,3…

ToreferencetheDirX/Acellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2

Seealso

Cellindex: visCnnctDirX(non-extendedrows)visCnnctA(extendedrows)

Forinformationaboutnon-extendedandextendedrows,seeConnections.Rowrow.

DirY/Bcell(ConnectionPointssection)

Determinesthey-componentfortherequiredalignmentvectorofamatchingconnectionpoint.Itisalsousedtoorienttheattachedlegofadynamicconnector.Thiscelltakesafloatingpointvalue.

Remarks

ToreferencetheDirY/Bcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DirY[i]wherei=<1>,2,3…

ToreferencetheDirY/Bcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…

Seealso

Cellindex: visCnnctDirY(non-extendedrows)visCnnctB(extendedrows)

Disabledcell(Actionssection)

Togglesthedisplayofthecommandnameontheshortcutmenu.

Value DescriptionTRUE Disable(dim)commandname.FALSE Enable(highlight)commandname.

Remarks

ToreferencetheDisabledcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Actions.Diwherei=<1>,2,3…

ToreferencetheDisabledcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visActionDisabled

Seealso Rows

DisplayModecell(GroupPropertiessection)

Determineshowthegroupshapeanditsmembersaredisplayed.

Value DisplayMode Automationconstant0 Hidesthegroupshapeandtext. visGrpDispModeNone1 Displaysthegroupshapebehind

membershapes.visGrpDispModeBack

2 Displaysthegroupshapeinfrontofmembershapes.

visGrpDispModeFront

Remarks

Youcanalsosetthisvaluebyselectingthegroup,clickingBehaviorontheFormatmenu,andthenselectingadisplaymodefromtheGroupdatalist.

ToreferencetheDisplayModecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DisplayMode

ToreferencetheDisplayModecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowGroup

Seealso Rows

Cellindex: visGroupDisplayMode

DontMoveChildrencell(GroupPropertiessection)

Determineswhetheryoucandragshapesinagroupusingthemouse.

Value DescriptionTRUE Don'tallowshapesinagrouptobedraggedusingthemouse.FALSE Allowshapesinagrouptobedraggedusingthemouse.

Remarks

WhenthevalueofthiscellisTRUE,youcanstillflip,rotate,resize,orrepositionshapesingroupsusingothermethods.

ThevalueofthiscellisTRUEforgroupsinmastersandgroupsininstancesofmastersthatwerecreatedinversionsofMicrosoftVisioearlierthanVisio2000.

ToreferencetheDontMoveChildrencellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DontMoveChildren

ToreferencetheDontMoveChildrencellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowGroupCellindex: visGroupDontMoveChildren

Seealso Rows

DoubleULinecell(Charactersection)

Determineswhethertherangeoftexthasadoubleunderlinebelowit.

Value DescriptionTRUE Texthasadoubleunderlinebelowit.FALSE Textdoesnothaveadoubleunderlinebelowit.

Remarks

TheDoubleULinecellcontainsformattinginformationappliedtoasub-rangeofashape'stextiftheCharacterssectioncontainsmultiplerows.Otherwise,itcontainsformattinginformationforalloftheshape'stext.

YoucanalsosetthevalueofthiscellbyusingtheTextdialogbox(clickTextontheFormatmenu).

ToreferencetheDoubleULinecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.DblUnderline[i]wherei=<1>,2,3…

ToreferencetheDoubleULinecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…

Seealso Rows

Cellindex: visCharacterDblUnderline

DrawingScalecell(PagePropertiessection)

Representsthevalueofthedrawingunitinthecurrentdrawingscale.ThedrawingscaleforthepageistheratioofthepageunitshowninthePageScalecelltothedrawingunit.

Remarks

ThiscellcorrespondstothesettingsinthePageSetupdialogbox(clickPageSetupontheFilemenu).

TheunitsoftheformulaintheDrawingScalecelldeterminethemeasurementunitsusedbytherulersinthedrawingwindow.Ifyoudonotwanttoalsochangethedrawing'sscale,youcandooneofthefollowing:

KeepthedistanceexpressedintheDrawingScalecellthesamebutexpressitindifferentunits.

ChangethedistanceexpressedinthePageScalecellbythesamefactorthatyouchangeDrawingScale.

ToreferencetheDrawingScalecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DrawingScale

ToreferencetheDrawingScalecellbyindexfromaprogram,usetheCellsSRC

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageDrawingScale

Example

YoucansettheDrawingScalecelltochangetheunitsofapage'srulersfromaprogram.Here'sanexampleofchangingthemeasurementunitsfrominchestocentimetersfromaprogram.InthiscaseweusetheConvertResultmethodtokeepthedistancethesamebutexpressitindifferentunits.

PublicSubSetActivePageMeasurementToCM()DimdsCellAsVisio.CellSetdsCell=ActivePage.PageSheet.Cells("DrawingScale")dsCell.Result(visCentimeters)=_Application.ConvertResult_(dsCell.ResultIU,visInches,visCentimeters)EndSub

YoucandeterminethemeasurementsysteminadrawingbyexaminingtheUnitspropertyoftheDrawingScalecell.AfterrunningtheabovemacrothefollowingstatementexecutedintheVisualBasicEditorImmediatewindowwillreturnTrue.

debug.printActivePage.PageSheet.Cells("DrawingScale").Units=_visCentimeters

DrawingScaleTypecell(PagePropertiessection)

DeterminesthedrawingscaleselectedinthePageSetupdialogbox(clickPageSetupontheFilemenu).

Value Description Automationconstant0 NoScale visNoScale1 ArchitecturalScale visArchitectural2 CivilEngineeringScale visEngineering3 CustomScale visScaleCustom4 Metric visScaleMetric5 MechanicalEngineeringScale visScaleMechanical

Remarks

ToreferencetheDrawingScaleTypecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DrawingScaleType

ToreferencetheDrawingScaleTypecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageDrawScaleType

Seealso Rows

DrawingSizeTypecell(PagePropertiessection)

Determinesthedrawingsize.

Value Description Automationconstant0 Sameasprinter visPrintSetup1 Fitpagetodrawingcontents visTight2 Standard visStandard3 Custompagesize visCustom4 Customscaleddrawingsize visLogical5 Metric(ISO) visDSMetric6 ANSIEngineering visDSEngr7 ANSIArchitectural visDSArch

Remarks

Tosetthedrawingsize,usethePageSetupdialogbox(clickPageSetupontheFilemenu)ormanuallyresizethepagewiththemouse.

ToreferencetheDrawingSizeTypecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DrawingSizeType

ToreferencetheDrawingSizeTypecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageDrawSizeType

DynamicsOffcell(PageLayoutsection)

Determineswhetherplaceableshapesmoveandconnectorsreroutearoundothershapesandconnectorsonthedrawingpage.

Value DescriptionTRUE Disabledynamics.FALSE Enabledynamics.

Remarks

Youcandisabledynamicstoincreaseyoursolution'sperformance.Forexample,ifyoursolutionaddsplaceableshapestoadrawingandyoudon'twanttheapplicationtorerouteconnectorsandrepositionshapeseachtimeyouaddashape,youcandisabledynamics.Afteryoursolutionaddstheshapes,re-enabledynamics.

ToreferencetheDynamicsOffcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DynamicsOff

ToreferencetheDynamicsOffcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Cellindex: visPLODynamicsOff

DynFeedbackcell(Miscellaneoussection)

Changesthetypeofvisualfeedbackprovidedtouserswhentheydragaconnector.Whenthemousebuttonisreleased,theresultingconnectorshapeisnotaffectedbythissetting.Thissettingdoesnotapplytoroutableconnectors.

Value Description Automationconstant0 Remainsstraight(nolegs). visDynFBDefault1 Showsthreelegswhendragged. visDynFBUCon3Leg2 Showsfivelegswhendragged. visDynFBUCon5Leg

Remarks

ToreferencetheDynFeedbackcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: DynFeedback

ToreferencetheDynFeedbackcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visDynFeedback

Seealso Rows

Ecell(Geometrysection)

ContainsanonuniformrationalB-spline(NURBS)formula.

Remarks

ToreferencetheEcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.Ejwhereiandj=<1>,2,3…

ToreferencetheEcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Cellindex: visNURBSData

Seealso

EditModecell(TextFieldssection)

Reservedforfutureuse.

Seealso Rows

EnableFillPropscell(StylePropertiessection)

Determineswhetherastyleincludesfillproperties.

Value DescriptionTRUE Includefillproperties.FALSE Excludefillproperties.

Remarks

YoucanalsosetthisvaluebyusingtheDefineStylesdialogbox(clickDefineStylesontheFormatmenu).

ToreferencetheEnableFillPropscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EnableFillProps

ToreferencetheEnableFillPropscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowStyleCellindex: visStyleIncludesFill

Seealso Rows

EnableGridcell(PageLayoutsection)

Determineswhethertheapplicationlaysoutshapesbasedonaninternal,invisiblepagegridwhenusingtheLayOutShapescommand.ThisgridiscreatedusingtheSpacebetweenshapesandtheAverageshapesizevaluesintheLayoutandRoutingSpacingdialogbox(clickLayOutShapesontheShapemenu,andthenclickSpacing).

Value DescriptionTRUE Usetheinternalpagegrid.FALSE Donotusetheinternalpagegrid.

Remarks

Whenyouenablethisfeature,theapplicationalignseachplaceableshape'scenterpointwiththecenterofablockontheinternalpagegrid.

ToreferencetheEnableGridcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EnableGrid

ToreferencetheEnableGridcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOEnableGrid

Seealso Rows

EnableLinePropscell(StylePropertiessection)

Determineswhetherastyleincludeslineproperties.

Value DescriptionTRUE Includelineproperties.FALSE Excludelineproperties.

Remarks

ToreferencetheEnableLinePropscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EnableLineProps

ToreferencetheEnableLinePropscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowStyleCellindex: visStyleIncludesLine

Seealso Rows

EnableTextPropscell(StylePropertiessection)

Determineswhetherastyleincludestextproperties.

Value DescriptionTRUE Includetextproperties.FALSE Excludetextproperties.

Remarks

ToreferencetheEnableTextPropscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EnableTextProps

ToreferencetheEnableTextPropscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowStyleCellindex: visStyleIncludesText

Seealso Rows

EndArrowcell(LineFormatsection)

Indicateswhetheralinehasanarrowheadorotherlineendformatatitslastvertex.

Value Description0 Noarrowhead.1-45 Assortedarrowheadstylesthatcorrespondtoindexedentriesin

theLinedialogbox.

Remarks

YoucanalsosetthisvalueintheLinedialogbox(clickLineontheFormatmenu).ThesizeofthearrowheadissetintheEndArrowSizecell.

YoucanspecifyacustomlineendusingtheUSEfunctioninthiscell.

ToreferencetheEndArrowcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EndArrow

ToreferencetheEndArrowcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineEndArrow

EndArrowSizecell(LineFormatsection)

Determinesthesizeofthearrowheadattheendoftheline.

Value Size Automationconstant0 Verysmall visArrowSizeVerySmall1 Small visArrowSizeSmall2 Medium visArrowSizeMedium3 Large visArrowSizeLarge4 Extralarge visArrowSizeVeryLarge5 Jumbo visArrowSizeJumbo6 Colossal visArrowSizeColossal

Remarks

YoucanalsosetthisvalueintheLinedialogbox(clickLineontheFormatmenu).

ToreferencetheEndArrowSizecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EndArrowSize

ToreferencetheEndArrowSizecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineEndArrowSize

EndTriggercell(GlueInfosection)

Containsatriggerformulageneratedbytheapplicationthatdetermineswhethertomovetheendpointofa1-Dshapetomaintainitsconnectiontoanothershape.

Remarks

Whenyougluea1-Dshapetoanothershapeusingdynamicglue,VisiogeneratesaformulathatreferstotheEventXFModcelloftheothershape.Whenthatshapeischanged,VisiorecalculatesanyformulathatreferstoitsEventXFModcell,includingtheformulaintheEndTriggercell.Otherformulasofthe1-DshaperefertotheEndTriggercellandmovetheendpointofthe1-Dshapeoraltertheshapeasneeded.

ToreferencetheEndTriggercellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EndTrigger

ToreferencetheEndTriggercellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visEndTrigger

EndXcell(1-DEndpointssection)

Representsthex-coordinateoftheendpointofthe1-Dshape,inrelationtotheoriginofitsparent.

Remarks

ToreferencetheEndXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EndX

ToreferencetheEndXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXForm1DCellindex: vis1DendX

Seealso Rows

EndYcell(1-DEndpointssection)

Representsthey-coordinateoftheendpointofthe1-Dshape,inrelationtotheoriginofitsparent.

Remarks

ToreferencetheEndYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EndY

ToreferencetheEndYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXForm1DCellindex: vis1DendY

Seealso Rows

EventDblClickcell(Eventssection)

Aneventcellthatisevaluatedwhenashapeisdouble-clicked.

Remarks

Eventcellsareevaluatedonlywhentheeventoccurs,notuponformulaentry.

ToreferencetheEventDblClickcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EventDblClick

ToreferencetheEventDblClickcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowEventCellindex: visEvtCellDblClick

Seealso Rows

EventDropcell(Eventssection)

Aneventcellthatisevaluatedwhenashapeisdroppedonthedrawingpage,eitherasaninstanceorwhentheshapeisduplicatedorpasted.

Remarks

ToreferencetheEventDropcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EventDrop

ToreferencetheEventDropcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowEventCellindex: visEvtCellDrop

Seealso Rows

EventXFModcell(Eventssection)

Aneventcellthatisevaluatedwhenashape'spositionororientationonthepageistransformed("XF").

Remarks

ToreferencetheEventXFModcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: EventXFMod

ToreferencetheEventXFModcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowEventCellindex: visEvtCellXFMod

Seealso Rows

ExtraInfocell(Hyperlinkssection)

RepresentsastringthatpassesinformationtobeusedinresolvingaURL,suchasthecoordinatesofanimagemap.Forexample,intheExtraInfocell,"x=41&y=7"specifiesthecoordinatesofanimagemap.

Remarks

ToreferencetheExtraInfocellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Hyperlink.Name.FramewhereHyperlink.Nameistherowname

ToreferencetheExtraInfocellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…

Seealso

Cellindex: visHLinkExtraInfo

FillBkgndcell(FillFormatsection)

Determinesthecolorusedforthebackground(fill)oftheshape'sfillpattern.

Remarks

Tosetthecolor,enteranumberfrom0to23.Thenumbercorrespondstoacolorinthecurrentcolorpalette,whichyoucanalsosetintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

YoucansetthetransparencyofthebackgroundfillintheFillBkgndTranscell.

ToreferencetheFillBkgndcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FillBkgnd

ToreferencetheFillBkgndcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillBkgnd

FillBkgndTranscell(FillFormatsection)

Determinesthetransparencylevelforthebackground(fill)coloroftheshape'sfillpattern.

Value Description0–100 Representsthepercentageoftransparency.Thedefaultis0%

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithacompletelytransparentfillappearsthesameasashapewithnofillonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheFilldialogbox(clickFillontheFormatmenu).Thisvaluecontrolsthevalueofboththebackgroundandforegroundfilltransparencies.Tosetthesevaluesindependently,youmustenterthemintheShapeSheetwindow.

ToreferencetheFillBkgndTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FillBkgndTrans

ToreferencetheFillBkgndTranscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillBkgndTrans

FillForegndcell(FillFormatsection)

Determinesthecolorusedfortheforeground(stroke)oftheshape'sfillpattern.

Remarks

Tosetthecolor,enteranumberfrom0to23.Thenumbercorrespondstoacolorinthecurrentcolorpalette,whichissetintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

YoucansetthetransparencyoftheforegroundfillintheFillForegndTranscell.

ToreferencetheFillForegndcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FillForegnd

ToreferencetheFillForegndcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillForegnd

FillForegndTranscell(FillFormatsection)

Determinesthetransparencylevelfortheforeground(fill)coloroftheshape'sfillpattern.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithacompletelytransparentfillappearsthesameasashapewithnofillonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheFilldialogbox(clickFillontheFormatmenu).Thisvaluecontrolsthevalueofboththebackgroundandforegroundfilltransparencies.Tosetthesevaluesindependently,youmustenterthemintheShapeSheetwindow.

ToreferencetheFillForegndTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FillForegndTrans

ToreferencetheFillForegndTranscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillForegndTrans

FillPatterncell(FillFormatsection)

Determinesthefillpatternfortheshape.Tospecifyacustomfillpattern,usetheUSEfunctioninthiscell.

Value Description0 None(transparentfill).1 Solidforegroundcolor.2-40 AssortedfillpatternsthatcorrespondtoindexedentriesintheFill

dialogbox.

Remarks

YoucanalsosetthisvalueusingtheFilldialogbox(clickFillontheFormatmenu).

ToreferencetheFillPatterncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FillPattern

ToreferencetheFillPatterncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillPattern

FlipXcell(ShapeTransformsection)

Indicateswhethertheshapehasbeenflippedhorizontally.

Value DescriptionTRUE Theshapehasbeenflippedhorizontally.FALSE Theshapehasnotbeenflippedhorizontally.

Remarks

ToreferencetheFlipXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FlipX

ToreferencetheFlipXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormFlipX

Seealso Rows

FlipYcell(ShapeTransformsection)

Indicateswhethertheshapehasbeenflippedvertically.

Value DescriptionTRUE Theshapehasbeenflippedvertically.FALSE Theshapehasnotbeenflippedvertically.

Remarks

ToreferencetheFlipYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FlipY

ToreferencetheFlipYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormFlipY

Seealso Rows

Fontcell(Charactersection)

Representsthenumberofthefontusedtoformatthetext.Fontnumbersvaryaccordingtothefontsinstalledonyoursystem.Thenumber0representsthedefaultfont,whichistypicallyArial.

Remarks

ToreferencetheFontcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Font[i]wherei=<1>,2,3…

ToreferencetheFontcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterFont

Seealso Rows

Formatcell(CustomPropertiessection)

Specifiestheformattingofacustompropertythatisastring,afixedlist,anumber,avariablelist,adateortime,aduration,oracurrency.

Remarks

Custompropertytype

Value Formatcellcontents

String 0 Aformatpictureappropriateforthedatatype

Fixedlist 1 Theitemstoappearinthelist,separatedbycommas

Number 2 Aformatpictureappropriateforthedata

Variablelist 4 Theitemstoappearinthelist,separatedbycommas

Dateortime 5 Aformatpictureappropriateforthedatatype

Duration 6 Aformatpictureappropriateforthedatatype

Currency 7 Aformatpictureappropriateforthedatatype

Asanexampleofspecifyingaformatpictureappropriateforthedatatype,theformatpicture"##/4UU"formatsthenumber12.43in.as122/4INCHES.Formoreinformationaboutspecifyingaformatpicture,seeAboutformatpictures.

Anexampleofspecifyingitemsforalistis"Engineering;HumanResources;Sales;Marketing".

Datevalues(Type=5)aredisplayedintheshortdateformat.Currencyvalues(Type=7)aredisplayedusingtheuser'scurrentRegionalSettingsforcurrency.

Anumber(Type=2)canrepresentadimension,scalar,angle,date,time,orcurrency.Toensurethataninputnumberisalwaysevaluatedasadate,time,orcurrency,usetheDATETIMEorCYfunctionintheFormatcellinsteadofaformatpicture.

ToreferencetheFormatcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.FormatwhereProp.Nameistherowname

ToreferencetheFormatcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCustPropsFormat

Formatcell(TextFieldssection)

Specifiestheformattingofatextfieldthatisastring,anumber,adateortime,aduration,oracurrency.

Remarks

IfthevalueoftheTypecellis0,2,5,6,or7(string,number,dateortime,duration,orcurrency,respectively),specifyaformatpictureappropriateforthedatatype.Forexample,theformatpicture"##/4UU"formatsthenumber12.43in.as122/4INCHES.Formoreinformationaboutspecifyingaformatpicture,seeAboutformatpictures.

Anumber(Type=2)canrepresentadimension,scalar,angle,date,time,orcurrency.Toensurethataninputnumberisalwaysevaluatedasadate,time,orcurrency,usetheDATETIMEorCYfunctionintheFormatcellinsteadofaformatpicture.

ToreferencetheFormatcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Fields.Format[i]wherei=<1>,2,3…

ToreferencetheFormatcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionTextField

Rowindex: visRowField+iwherei=0,1,2…

Cellindex: visFieldFormat

Framecell(Hyperlinkssection)

RepresentsthenameofaframetotargetwhentheapplicationisopenasanActivedocumentinacontainerapplication.Thedefaultisanemptystring.

Remarks

ToreferencetheFramecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Hyperlink.Name.FramewhereHyperlink.Nameistherowname

ToreferencetheFramecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visHLinkFrame

Seealso

Gammacell(ImagePropertiessection)

Adjustsorcorrectstheintensityofanimageforaparticularoutputdevice,suchasamonitororscanner.Thedefaultvalueis1(nocorrection).

Remarks

ToreferencetheGammacellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Gamma

ToreferencetheGammacellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageGamma

Seealso Rows

Gluecell(Layerssection)

Specifieswhethershapesbelongingtothelayercanbeglued.

Value DescriptionTRUE Glueisenabled.FALSE Glueisdisabled.

Remarks

ThiscellcorrespondstotheGlueoptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

ToreferencetheGluecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Glue[i]wherei=<1>,2,3…

ToreferencetheGluecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visLayerGlue

Seealso Rows

GlueTypecell(GlueInfosection)

Determineswhethera1-Dshapeusesstatic(point-to-point)ordynamic(shape-to-shape)gluewhenitisgluedtoanothershape.

Value Description Automationconstant&H0 Default.Allowdynamicgluefor

thedynamicconnectoronly;otherwise,usestaticglue.

visGlueTypeDefault

&H1 Allowdynamicglue. ObsoleteinMicrosoftVisio2002&H2 Allowdynamicglue. visGlueTypeWalking&H4 Donotallowdynamicglue. visGlueTypeNoWalking&H8 Donotallowthis2-Dshapetobe

connectedtowithdynamicglue.visGlueTypeNoWalkingTo

Remarks

Ifthiscellcontainsavalueof1,2or3,dynamicgluewillbeestablishedwheneitherofthefollowingoccurs:

Shapesaredynamicallygluedintheuserinterface.

ShapesaregluedtothePinXorPinYcellofanothershapefromaprogram.

IfshapesaregluedtoshapecellsotherthanPinXorPinYfromaprogram,thenstaticglueisused.

Changingthisvaluefromallowingtonotallowingdynamicgluedoesnotsever

orchangeexistingdynamicglue.ProgramscanestablishdynamicglueevenifdynamicglueisdisabledintheGlueTypecell.

ToreferencetheGlueTypecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: GlueType

ToreferencetheGlueTypecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visGlueType

HAligncell(Paragraphsection)

Determinesthehorizontalalignmentoftextintheshape'stextblock.

Value Description Automationconstant0 Leftalign visHorzLeft1 Center visHorzCenter2 Rightalign visHorzRight3 Justify visHorzJustify4 Forcejustify visHorzForce

Remarks

Justifyaddsspacebetweenwordsineverylineexceptthelastlineoftheparagraphtoalignboththeleftandrightsidesoftextwiththemargins.

Forcejustifyjustifieseverylineintheparagraph,includingthelast.

ToreferencetheHAligncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.HorzAlign[i]wherei=<1>,2,3…

ToreferencetheHAligncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionParagraph

Seealso Rows

Rowindex: visRowParagraph+iwherei=0,1,2…

Cellindex: visHorzAlign

Heightcell(ShapeTransformsection)

Determinestheheightoftheshapeindrawingunits.

Remarks

ToreferencetheHeightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Height

ToreferencetheHeightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormHeight

Seealso Rows

HideForApplycell(StylePropertiessection)

DetermineswhereastyleisshownintheMicrosoftVisiouserinterface.

Value DescriptionTRUE ShowthestyleonlyintheDrawingExplorerandDefineStyles

dialogbox.FALSE ShowthestyleintheDrawingExplorer,DefineStylesdialog

box,Styledialogbox,andAllStyleslistontheFormattingtoolbar.

Remarks

YoucanalsosetthisvalueintheDefineStylesdialogbox(clickDefineStylesontheFormatmenu).

Whenyoubaseanewstyleonastylethatishidden,thenewstyledoesnotinheritthisattribute.

ToreferencetheHideForApplycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: HideForApply

ToreferencetheHideForApplycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowStyleCellindex: visStyleHidden

HideTextcell(Miscellaneoussection)

Hidesthetextforashape.Youcanviewtext,editproperties,andapplystylestothetextinthetextblock,althoughthechangeswillnotappearuntilyouresetHideTexttoFALSE(0).

Value DescriptionTRUE Textishiddenanddoesnotprint.FALSE Textisnothidden.

Remarks

ToreferencetheHideForApplycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: HideForApply

ToreferencetheHideForApplycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowStyleCellindex: visStyleHidden

Seealso Rows

ImgHeightcell(ForeignImageInfosection)

Determinestheheightoftheobject'simagewithinitsborder.Thedefaultformulais:

=Height*1

Remarks

ToreferencetheImgHeightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ImgHeight

ToreferencetheImgHeightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowForeignCellindex: visFrgnImgHeight

Seealso Rows

ImgOffsetXcell(ForeignImageInfosection)

Determinesthedistancetheobjectisoffsethorizontallyfromtheoriginoftheobject'sborder.Thedefaultis0.PanningtheobjectwiththeCroptoolchangesthisvalue.

Remarks

ToreferencetheImgOffsetXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ImgOffsetX

ToreferencetheImgOffsetXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowForeignCellindex: visFrgnImgOffsetX

Seealso Rows

ImgOffsetYcell(ForeignImageInfosection)

Determinesthedistancetheobjectisoffsetverticallyfromtheoriginoftheobject'sborder.Thedefaultis0.PanningtheobjectwiththeCroptoolchangesthisvalue.

Remarks

ToreferencetheImgOffsetYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ImgOffsetY

ToreferencetheImgOffsetYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowForeignCellindex: visFrgnImgOffsetY

Seealso Rows

ImgWidthcell(ForeignImageInfosection)

Determinesthewidthoftheobject'simagewithinitsborder.Thedefaultformulais:

=Width*1

CroppingtheobjectchangesthefactorbywhichWidthismultiplied.

Remarks

ToreferencetheImgWidthcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ImgWidth

ToreferencetheImgWidthcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowForeignCellindex: visFrgnImgWidth

Seealso Rows

IndFirstcell(Paragraphsection)

Representsthedistancethefirstlineofeachparagraphintheshape'stextblockisindentedfromtheleftindentoftheparagraph.Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,thefirstlineindentremainsthesame.

Remarks

ToreferencetheIndFirstcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.IndFirst[i]wherei=<1>,2,3…

ToreferencetheIndFirstcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visIndentFirst

Seealso Rows

IndLeftcell(Paragraphsection)

Representsthedistancealllinesoftextinaparagraphareindentedfromtheleftmarginofthetextblock.Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,theleftindentremainsthesame.

Remarks

ToreferencetheIndLeftcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.IndLeft[i]wherei=<1>,2,3…

ToreferencetheIndLeftcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visIndentLeft

Seealso Rows

IndRightcell(Paragraphsection)

Representsthedistancealllinesoftextinaparagraphareindentedfromtherightmarginofthetextblock.Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,therightindentremainsthesame.

Remarks

ToreferencetheIndRightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.IndRight[i]wherei=<1>,2,3…

ToreferencetheIndRightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visIndentRight

Seealso Rows

InhibitSnapcell(PagePropertiessection)

Determineswhethertheshapesonaforegroundpagesnaptootherobjectsonthepageandshapesonthebackgroundpage.

Value DescriptionTRUE Inhibitallsnappingonthepage,exceptforsnappingtotheruler

andgrid.FALSE Enablesnapping.

Remarks

ToreferencetheInhibitSnapcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: InhibitSnap

ToreferencetheInhibitSnapcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageInhibitSnapIndentRight

Seealso Rows

Invisiblecell(CustomPropertiessection)

SpecifieswhetherthecustompropertyisvisibleintheCustomPropertiesdialogboxorwindow.

Value DescriptionTRUE Custompropertyisnotvisible.FALSE Custompropertyisvisible.

Remarks

ToreferencetheInvisiblecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.InvisiblewhereProp.Nameistherowname

ToreferencetheInvisiblecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso

wherei=0,1,2…Cellindex: visPageInhibitSnapIndentRight

IsDropSourcecell(Miscellaneoussection)

Determineswhethertheshapecanbeaddedtoagroupbydroppingitontothegroup.

Value DescriptionTRUE Canaddtheshapetoagroupbydroppingitontothegroup.FALSE Cannotaddtheshapetoagroup.

Remarks

Youcanalsosetthisvaluebyselectingtheshape,clickingBehaviorontheFormatmenu,andthenselectingtheAddshapetogroupsondropcheckbox.

Inadditiontoenablingthisbehaviorforashape,youmustalsoenableagrouptoacceptshapesthataredraggedintoit.Todoso,selectthegroup,clickBehaviorontheFormatmenu,andthenselecttheAcceptdroppedshapescheckbox.ThisvalueisstoredintheIsDropTargetcellintheGroupPropertiessection.

ToreferencetheIsDropSourcecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: IsDropSource

ToreferencetheIsDropSourcecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visDropSource

IsDropTargetcell(GroupPropertiessection)

Determineswhetherthegroupallowsyoutoaddashapetoitbydroppingitonthegroup.

Value DescriptionTRUE Canaddashapetothegroupbydroppingitontothegroup.FALSE Cannotdropshapeontothegroup.

Remarks

Youcanalsosetthisvaluebyselectingthegroup,clickingBehaviorontheFormatmenu,andthenselectingtheAcceptdroppedshapescheckbox.

Toaddashapetoagroupbydroppingitonthegroup,youmustalsoenablesimilarshapebehavior.Youmustselecttheshape,clickBehaviorontheFormatmenu,andthenselecttheAddshapetogroupsondropcheckbox.ThisvalueisstoredintheIsDropSourcecellintheMiscellaneoussection.

ToreferencetheIsDropTargetcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: IsDropTarget

ToreferencetheIsDropTargetcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowGroupCellindex: visGroupIsDropTarget

IsSnapTargetcell(GroupPropertiessection)

Determineswhetheryousnaptoagrouporshapeswithinthegroup.

Value DescriptionTRUE Enablesnappingtoshapeswithinagroup.FALSE Snaponlytothegroup.

Remarks

Youcanalsosetthisvaluebyselectingthegroup,clickingBehaviorontheFormatmenu,andthenselectingtheSnaptomembershapescheckbox.

ToreferencetheIsSnapTargetcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: IsSnapTarget

ToreferencetheIsSnapTargetcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowGroupCellindex: visGroupIsSnapTarget

Seealso Rows

IsTextEditTargetcell(GroupPropertiessection)

Determinestextassignmentforagroup.

Value DescriptionTRUE Textisaddedtothegroupshape.FALSE Textisaddedtotheshapeinthegroupatthetopofthestacking

order.

Remarks

Youcanalsosetthisvaluebyselectingthegroup,clickingBehaviorontheFormatmenu,andthenselectingtheEdittextofgroupcheckbox.

GroupscreatedinversionsearlierthanMicrosoftVisio2000haveadefaultvalueofFALSE.BeginningwithVisioversion2000,thedefaultvalueisTRUE.

ToreferencetheIsTextEditTargetcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: IsTextEditTarget

ToreferencetheIsTextEditTargetcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Cellindex: visGroupIsTextEditTarget

Labelcell(CustomPropertiessection)

SpecifiesthelabelthatappearstousersintheCustomPropertiesdialogboxandCustomPropertieswindow.Alabelconsistsofalphanumericcharacters,includingtheunderscore(_)character.

Remarks

TheapplicationautomaticallyenclosestheLabelstringinquotationmarksinthecell,butthequotationmarksarenotdisplayedintheCustomPropertiesdialogboxandCustomPropertieswindow.

Ifnolabeltextisfound,Visiodisplaystherowname(Prop.Row)intheCustomPropertiesdialogboxandCustomPropertieswindow.

ToreferencetheLabelcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.LabelwhereProp.Nameistherowname

Seealso

ToreferencetheLabelcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCustPropsLabel

LeftMargincell(TextBlockFormatsection)

Determinesthedistancebetweentheleftborderofthetextblockandthetextitcontains.Thedefaultis0.1inch.Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,theleftmarginremainsthesame.

Remarks

ToreferencetheLeftMargincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LeftMargin

ToreferencetheLeftMargincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkLeftMargin

Seealso Rows

LineAdjustFromcell(PageLayoutsection)

Determineswhichdynamicconnectorstheapplicationspacesapartiftheyrouteontopofeachother.

Value Adjustment Automationconstant0 Unrelatedlines visPLOLineAdjustFromNotRelated1 Alllines visPLOLineAdjustFromAll2 Nolines visPLOLineAdjustFromNone3 Routingstyledefault visPLOLineAdjustFromRoutingDefault

Remarks

YoucanalsosetthevalueofthiscellontheLayoutandRoutingtabinthePageSetupdialogbox(clickPageSetupontheFilemenu).

ToreferencetheLineAdjustFromcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineAdjustFrom

ToreferencetheLineAdjustFromcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Cellindex: visPLOLineAdjustFrom

LineAdjustTocell(PageLayoutsection)

Determineswhichdynamicconnectorslineupontopofoneanother.

Value Adjustment Automationconstant0 Routingstyledefault visPLOLineAdjustToDefault1 Linesthatareclosetoeachother visPLOLineAdjustToAll2 Nolines visPLOLineAdjustToNone3 Relatedlines visPLOLineAdjustToRelated

Remarks

ToreferencetheLineAdjustTocellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineAdjustTo

ToreferencetheLineAdjustTocellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOLineAdjustTo

Seealso Rows

LineCapcell(LineFormatsection)

Indicateswhetheralinehasroundedorsquarelineends.

Value Lineendstyle0 Rounded1 Square

Remarks

YoucanalsosetthevalueofthiscellintheLinedialogbox(clickLineontheFormatmenu).

ToreferencetheLineCapcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineCap

ToreferencetheLineCapcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineEndCap

Seealso Rows

LineColorcell(LineFormatsection)

Determinesthelinecoloroftheshape.

Remarks

Tosetthelinecolor,enteranumberfrom0to23,whichisanindexintoacollectionoflinecolors.YoucanviewthelinecolorcollectionintheLinedialogbox(clickLineontheFormatmenu).YoucanalsosetthevalueofLineColorintheLinedialogbox.Toswitchtoadifferentcolorpalette,usetheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

YoucansetthetransparencyofthelinecolorintheLineColorTranscell.

ToreferencetheLineColorcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineColor

ToreferencetheLineColorcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObject

Rowindex: visRowLineCellindex: visLineColor

LineColorTranscell(LineFormatsection)

Determinesthetransparencylevelofashape'slinecolor.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithacompletelytransparentlinecolorappearsthesameasashapewithnolinesonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheLinedialogbox(clickLineontheFormatmenu).

ToreferencetheLineColorTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineColorTrans

ToreferencetheLineColorTranscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineColorTrans

LineJumpCodecell(PageLayoutsection)

Determinestheconnectorstowhichyouwanttoaddjumps.

Value Connectorstowhichyouwanttoaddjumps

Automationconstant

0 None visPLOJumpNone1 Horizontallines visPLOJumpHorizontal2 Verticallines visPLOJumpVertical3 Lastroutedline visPLOJumpLastRouted4 Lastdisplayedline(top

shapeinthez-order)visPLOJumpDisplayOrder

5 Firstdisplayedline(shapeatthebottomofthez-order)

visPLOJumpReverseDisplayOrder

Remarks

ToreferencetheLineJumpCodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineJumpCode

ToreferencetheLineJumpCodecellbyindexfromaprogram,usetheCellsSRC

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOJumpCode

LineJumpFactorXcell(PageLayoutsection)

Determinesthesizeoflinejumpsonhorizontaldynamicconnectorsonthepage,relativetothevalueoftheLineToLineXcell.Thevalueofthiscellcanrangefrom0to10butfractionalvaluesfrom0to1aresuggested.

Remarks

ToreferencetheLineJumpFactorXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineJumpFactorX

ToreferencetheLineJumpFactorXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOJumpFactorX

Seealso Rows

LineJumpFactorYcell(PageLayoutsection)

Determinesthesizeoflinejumpsonverticaldynamicconnectorsonthepage,relativetothevalueoftheLineToLineYcell.Thevalueofthiscellcanrangefrom0to10butfractionalvaluesfrom0to1aresuggested.

Remarks

ToreferencetheLineJumpFactorYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineJumpFactorY

ToreferencetheLineJumpFactorYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOJumpFactorY

Seealso Rows

LineJumpStylecell(PageLayoutsection)

Determinesthelinejumpstyleforallconnectorsonthedrawingpagethatdon'thavealocallinejumpstyle.

Value Linejumpstyle Automationconstant0 Arc visLOJumpStyleDefault1 Arc visLOJumpStyleArc2 Gap visLOJumpStyleGap3 Square visLOJumpStyleSquare4 2sides visLOJumpStyleTriangle5 3sides visLOJumpStyle2Point6 4sides visLOJumpStyle3Point7 5sides visLOJumpStyle4Point8 6sides visLOJumpStyle5Point9 7sides visLOJumpStyle6Point

Remarks

ToreferencetheLineJumpStylecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineJumpStyle

Seealso Rows

ToreferencetheLineJumpStylecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOJumpStyle

LinePatterncell(LineFormatsection)

Determinesthelinepatternoftheshape.ThevalueenteredintheLinePatterncellisanumberthatisanindexintoacollectionoflinepatterns.

Value Description0 Nolinepattern1 Solid2–23 Assortedlinepatterns

Remarks

YoucanviewthelinepatterncollectionintheLinedialogbox(clickLineontheFormatmenu).

Tospecifyacustomlinepattern,usetheUSEfunctioninthiscell.

ToreferencetheLinePatterncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LinePattern

ToreferencetheLinePatterncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rowindex: visRowPageLayoutCellindex: visPLOJumpStyle

LineRouteExtcell(PageLayoutsection)

Determinesthedefaultappearanceforallconnectorsonadrawingpage.

Value Description Automationconstant0 Default(straight) visLORouteExtDefault1 Straight visLORouteExtStraight2 Curved visLORouteExtNURBS

Remarks

ToreferencetheLineRouteExtcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineRouteExt

ToreferencetheLineRouteExtcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPLOLineRouteExt

LineToLineXcell(PageLayoutsection)

Determinesthehorizontalclearancebetweenallconnectorsonthedrawingpage.

Remarks

YoucanalsosetthevalueofthiscellintheLayoutandRoutingSpacingdialogbox(ontheFilemenu,clickPageSetup,clicktheLayoutandRoutingtab,andthenclickSpacing).

ToreferencetheLineToLineXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineToLineX

ToreferencetheLineToLineXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOLineToLineX

Seealso Rows

LineToLineYcell(PageLayoutsection)

Determinestheverticalclearancebetweenallconnectorsonthedrawingpage.

Remarks

YoucanalsosetthevalueofthiscellintheLayoutandRoutingSpacingdialogbox(ontheFilemenu,clickPageSetup,clicktheLayoutandRoutingtab,andthenclickingSpacing).

ToreferencetheLineToLineYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineToLineY

ToreferencetheLineToLineYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOLineToLineY

Seealso Rows

LineToNodeXcell(PageLayoutsection)

Determinesthehorizontalclearancebetweenallconnectorsandshapesonthedrawingpage.

Remarks

ToreferencetheLineToNodeXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineToNodeX

ToreferencetheLineToNodeXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOLineToNodeX

Seealso Rows

LineToNodeYcell(PageLayoutsection)

Determinestheverticalclearancebetweenallconnectorsandshapesonthedrawingpage.

Remarks

ToreferencetheLineToNodeYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineToNodeY

ToreferencetheLineToNodeYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOLineToNodeY

Seealso Rows

LineWeightcell(LineFormatsection)

Determinesthelineweightofashape.Setthelineweightbyenteringanumberwithavalidunitofmeasure.

Remarks

YoucanalsosetthevalueofLineWeightintheLinedialogbox(clickLineontheFormatmenu).

Iftheunitofmeasureisnotentered,thentheunitofmeasurefortextspecifiedintheOptionsdialogboxisused(clickOptionsontheToolsmenu).Lineweightisindependentofthescaleofthedrawing.Ifthedrawingisscaled,thelineweightremainsthesame.

ToreferencetheLineWeightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineWeight

ToreferencetheLineWeightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineWeight

Lockcell(Layerssection)

Specifieswhethershapesbelongingtothelayerarelockedagainstbeingselectedoredited.

Value DescriptionTRUE Shapesarelocked.FALSE Shapesarenotlocked.

Remarks

YoucanalsosetthisvalueusingtheLockoptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

ToreferencetheLockcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Locked[i]wherei=<1>,2,3…

ToreferencetheLockcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visLayerLock

Seealso Rows

LockAspectcell(Protectionsection)

Lockstheaspectratiooftheshapesotheshapecanonlybesizedproportionally;itcannotbesizedinasingledimension.

Value DescriptionTRUE Aspectratioislocked.FALSE Aspectratioisnotlocked.

Remarks

ToreferencetheLockAspectcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockAspect

ToreferencetheLockAspectcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockAspect

Seealso Rows

LockBegincell(Protectionsection)

Locksthebeginpoint(BeginX,BeginY)ofa1-Dshapetoaspecificlocation.

Value DescriptionTRUE Beginpointislocked.FALSE Beginisnotlocked.

Remarks

ToreferencetheLockBegincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockBegin

ToreferencetheLockBegincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockBegin

Seealso Rows

LockCalcWHcell(Protectionsection)

Locksashape'sselectionrectanglesoitcannotberecalculatedwhenavertexiseditedorarowtypeischangedintheGeometrysection.

Value DescriptionTRUE Widthandheightcannotberecalculated.FALSE Widthandheightcanberecalculated.

Remarks

ToreferencetheLockCalcWHcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockCalcWH

ToreferencetheLockCalcWHcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockCalcWH

Seealso Rows

LockCropcell(Protectionsection)

LocksanobjectfromanotherprogramagainstbeingcroppedwiththeCroptool.

Value DescriptionTRUE ShapecannotbecroppedFALSE Shapecanbecropped.

Remarks

ToreferencetheLockCropcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockCrop

ToreferencetheLockCropcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockCrop

Seealso Rows

LockDeletecell(Protectionsection)

Lockstheshapesothatitcannotbedeleted.

Value DescriptionTRUE ShapecannotbedeletedFALSE Shapecanbedeleted.

Remarks

ToreferencetheLockDeletecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockDelete

ToreferencetheLockDeletecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockDelete

Seealso Rows

LockEndcell(Protectionsection)

Lockstheendpoint(EndX,EndY)ofa1-Dshapetoaspecificlocation.

Value DescriptionTRUE Endpointislocked.FALSE Endpointisnotlocked.

Remarks

ToreferencetheLockEndcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockEnd

ToreferencetheLockEndcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockEnd

Seealso Rows

LockFormatcell(Protectionsection)

Lockstheformattingofashapesoitcannotbechanged.

Value DescriptionTRUE Formattingcannotbechanged.FALSE Formattingcanbechanged.

Remarks

ToreferencetheLockFormatcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockFormat

ToreferencetheLockFormatcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockFormat

Seealso Rows

LockGroupcell(Protectionsection)

Locksagroupsothatitcannotbeungrouped.

Value DescriptionTRUE Groupcannotbeungrouped.FALSE Groupcanbeungrouped.

Remarks

ToreferencetheLockGroupcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockGroup

ToreferencetheLockGroupcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockGroup

Seealso Rows

LockHeightcell(Protectionsection)

Lockstheheightoftheshapesothatitsheightremainsunchangedwhentheshapeisresized.

Value DescriptionTRUE Heightislocked.FALSE Heightisnotlocked.

Remarks

ToreferencetheLockHeightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockHeight

ToreferencetheLockHeightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockHeight

Seealso Rows

LockMoveXcell(Protectionsection)

Locksthehorizontalpositionoftheshapesoitcannotbemovedhorizontally.

Value DescriptionTRUE Horizontalpositionislocked.FALSE Horizontalpositionisnotlocked.

Remarks

ToreferencetheLockMoveXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockMoveX

ToreferencetheLockMoveXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockMoveX

Seealso Rows

LockMoveYcell(Protectionsection)

Lockstheverticalpositionoftheshapesoitcannotbemovedvertically.

Value DescriptionTRUE Verticalpositionislocked.FALSE Verticalpositionisnotlocked.

Remarks

ToreferencetheLockMoveYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockMoveY

ToreferencetheLockMoveYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockMoveY

Seealso Rows

LockPreviewcell(DocumentPropertiessection)

Determineswhetherapreviewissavedeachtimeyousaveadrawing.

Value DescriptionTRUE Donotsaveaprevieweachtimeadrawingissaved.FALSE Saveaprevieweachtimeadrawingissaved.

Remarks

ToreferencetheLockPreviewcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockPreview

ToreferencetheLockPreviewcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowDocCellindex: visDocLockPreview

Seealso Rows

LockRotatecell(Protectionsection)

LockstheshapeagainstbeingrotatedwiththeRotationtoolortheRotateLeftorRotateRightcommand.

Value DescriptionTRUE Shapecannotberotated.FALSE Shapecanberotated.

Remarks

TheLockRotatecelldoesnotpreventa1-Dshapefrombeingrotatedwhenanendpointisdragged.Tolocka1-Dshapeagainstrotation,settheLockWidthcelltoanon-zerovalue(TRUE).

ToreferencetheLockRotatecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockRotate

ToreferencetheLockRotatecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockRotate

LockSelectcell(Protectionsection)

Preventsashapefrombeingselected.

Value DescriptionTRUE Shapecannotbeselected.FALSE Shapecanbeselected.

Remarks

InorderforLockSelecttotakeeffect,theShapescheckboxmustbeselectedintheProtectDocumentdialogbox.

ToreferencetheLockSelectcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockSelect

ToreferencetheLockSelectcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockSelect

Seealso Rows

LockTextEditcell(Protectionsection)

Locksthetextofashapesoitcannotbeedited.

Value DescriptionTRUE Textcannotbeedited.FALSE Textcanbeedited.

Remarks

YoucanstillformattextbyapplyingastyleusingtheFontstylelistoroptionsintheTextdialogbox(clickTextontheFormatmenu).

ToreferencetheLockTextEditcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockTextEdit

ToreferencetheLockTextEditcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockTextEdir

Seealso Rows

LockVtxEditcell(Protectionsection)

Lockstheverticesofashapesotheycannotbeeditedwithanytoolsonthetoolbar.

Value DescriptionTRUE Verticescannotbeedited.FALSE Verticescanbeedited.

Remarks

ToreferencetheLockVtxEditcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockVtxEdit

ToreferencetheLockVtxEditcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockVtxEdit

Seealso Rows

LockWidthcell(Protectionsection)

Locksthewidthoftheshapesothatitswidthremainsunchangedwhentheshapeissized.

Value DescriptionTRUE Widthislocked.FALSE Widthisnotlocked.

Remarks

ToreferencetheLockWidthcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LockWidth

ToreferencetheLockWidthcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLockCellindex: visLockWidth

Seealso Rows

LocPinXcell(ShapeTransformsection)

Representsthex-coordinateoftheshape'spin(centerofrotation)inrelationtotheoriginoftheshape.ThedefaultformulafordeterminingLocPinXis:

=Width*0.5

Remarks

ToreferencetheLocPinXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LocPinX

ToreferencetheLocPinXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormLocPinX

Seealso Rows

LocPinYcell(ShapeTransformsection)

Representsthey-coordinateoftheshape'spin(centerofrotation)inrelationtotheoriginoftheshape.ThedefaultformulafordeterminingLocPinYis:

=Height*0.5

Remarks

ToreferencetheLocPinYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LocPinY

ToreferencetheLocPinYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormLocPinY

Seealso Rows

Menucell(Actionssection)

Definesthenameofthecommandthatappearsonashape'sorpage'sshortcutmenu.Prefixthecommandnamewithanunderscorecharacter(_)todisplayadividerbarabovethecommandinthemenu.Prefixthenamewithapercentcharacter(%)todisplaythecommandatthebottomoftheshortcutmenu.

Remarks

ToreferencetheMenucellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Actions.Menu[i]wherei=<1>,2,3,…

ToreferencetheMenucellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2,…Cellindex: visActionMenu

Seealso Rows

NewWindowcell(Hyperlinkssection)

Specifieswhethertoopenthehyperlinkinanewwindow.

Value DescriptionTRUE Openthelinkedpage,document,orWebsiteinanewwindow.FALSE Default.Donotopenanewwindowforthehyperlink.

Remarks

ToreferencetheNewWindowcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Hyperlink.Name.NewWindowwhereHyperlink.Nameistherowname

ToreferencetheNewWindowcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2,…

Seealso

Cellindex: visHLinkNewWin

NoAlignBoxcell(Miscellaneoussection)

Togglesthedisplayoftheselectionrectangleonandofffortheselectedshape.

Value DescriptionTRUE Selectionrectangleisnotdisplayedwhentheshapeisselected.FALSE Selectionrectangleisdisplayedwhentheshapeisselected.

Remarks

ToreferencetheNoAlignBoxcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: NoAlignBox

ToreferencetheNoAlignBoxcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visNoAlignBox

Seealso Rows

NoCtlHandlescell(Miscellaneoussection)

Togglesthedisplayofcontrolhandlesonandofffortheselectedshape.

Value DescriptionTRUE Controlhandlesarenotdisplayedwhenashapeisselected.FALSE Controlhandlesaredisplayedwhenashapeisselected.

Remarks

ToreferencetheNoCtlHandlescellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: NoCtlHandles

ToreferencetheNoCtlHandlescellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visNoCtlHandles

Seealso Rows

NoFillcell(Geometrysection)

Indicateswhetherapathcanbefilled.

Value DescriptionTRUE Thepathisnotfilledevenifotherpathsintheshapearefilled.FALSE Theshape'sfillappliestothepath,evenifitisn'tclosed.

Remarks

Ifyousetashape'sfillpatterntonone(0),noneofitspathsarefilled.Thiscellisusedtoturnthefilloffselectivelyforapathwithinashape.

ToreferencetheNoFillcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.NoFillwherei=<1>,2,3…

ToreferencetheNoFillcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rowindex: visRowComponentCellindex: visCompNoFill

Seealso Rows

NoLinecell(Geometrysection)

Determineswhetheralineisdrawnaroundtheboundaryofthepath.

Value DescriptionTRUE Alineisnotdrawnaroundtheboundaryofthepaththatisthe

boundaryofafilledregion.FALSE Alineisdrawnaroundtheboundaryofapath.

Remarks

Whenyouchangethecolorofalinetowhite,thelinestillexistseventhoughyoucan'tseeitonawhitebackground.WhenyousetthevalueofthiscelltoTRUE,nolineisdrawn.

ToreferencetheNoLinecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.NoLinewherei=<1>,2,3…

ToreferencetheNoLinecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rowindex: visRowComponentCellindex: visCompNoLine

Seealso Rows

NoLiveDynamicscell(Miscellaneoussection)

Determineswhetherashapedynamicallyresizesorrotatesasyouaremanipulatingit.

Value DescriptionTRUE Donotdynamicallyupdatetheshapewhileyouaremanipulating

it.FALSE Dynamicallyupdatetheshapewhileyouaremanipulatingit.

Remarks

Asyouresizeorrotateatwo-dimensional(2-D)shapewithoutlivedynamics,youseeaselectionbox.Iftheshapeisone-dimensional(1-D),thevisualfeedbackisbasedonthevalueoftheDynFeedbackcell.

ToreferencetheNoLiveDynamicscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: NoLiveDynamics

ToreferencetheNoLiveDynamicscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMisc

Cellindex: visNoLiveDynamics

NonPrintingcell(Miscellaneoussection)

Togglesprintingonandofffortheselectedshape.

Value DescriptionTRUE Printingdisabled,buttheshapewillbedisplayedinthedrawing

window.FALSE Printingenabled.

Remarks

Youcanprintaguidebyselectingit,andthensettingthevalueofitsNonPrintingcelltoFALSE.

ToreferencetheNonPrintingcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: NonPrinting

ToreferencetheNonPrintingcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visNonPrinting

Seealso Rows

NoObjHandlescell(Miscellaneoussection)

Togglesthedisplayofselectionhandlesonandofffortheselectedshape.

Value DescriptionTRUE Selectionhandlesarenotdisplayedwhenashapeisselected.FALSE Selectionhandlesaredisplayedwhenashapeisselected.

Remarks

ToreferencetheNoObjHandlescellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: NoObjHandles

ToreferencetheNoObjHandlescellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visNoObjHandles

Seealso Rows

NoShowcell(Geometrysection)

Indicateswhetherapathisdisplayedonthedrawingpage.

Value DescriptionTRUE Thestrokeandfillofthepathrepresentedbythesectionishidden.FALSE Thestrokeandfillofthepathisshown.

Remarks

ToreferencetheNoShowcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.NoShowwherei=<1>,2,3…

ToreferencetheNoShowcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rowindex: visRowComponentCellindex: visCompNoShow

Seealso Rows

NoSnapcell(Geometrysection)

Determineswhetherothershapessnaptoapath.

Value DescriptionTRUE Donotallowothershapestosnaptothispath.FALSE Allowothershapestosnaptothispath.

Remarks

ToreferencetheNoSnapcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Geometryi.NoSnapwherei=<1>,2,3…

ToreferencetheNoSnapcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rowindex: visRowComponentCellindex: visCompNoSnap

Seealso Rows

ObjTypecell(Miscellaneoussection)

DetermineswhetherobjectsareplaceableorroutableindiagramswhenlayingoutshapesusingtheLayOutShapescommand.

Value Description Automationconstant&H0 Default.Theapplicationdecides

basedonthedrawingcontext.visLOFlagsVisDecides

&H1 Shapeisplaceable. visLOFlagsPlacable&H2 Shapeisroutable.Mustbeaone-

dimensional(1-D)shape.visLOFlagsRoutable

&H4 Shapeisnotplaceable,notroutable.

visLOFlagsDont

&H8 Groupcontainsplaceable/routableshapes.

visLOFlagsPNRGroup

Remarks

Bydefault,theObjTypecellissettoNoFormulaforashape,whichevaluatesto0,meaningthattheapplicationdetermineswhethertheshapecanbeplaceabledependingonitscontext.Forexample,ifyoudrawasimplerectangle,thevalueofitsObjTypecellis0.IfyouthenusetheConnectShapescommandortheConnectortooltoconnecttherectangletoanothershape,MicrosoftVisioresetsthevalueoftherectangle'sObjTypecellto1(placeable).

ThevalueoftheObjTypecellcanbeacombinationofvalues.Ifthenon-placeablebitisset(&H4),however,ittakesprecedenceoverothervaluesexceptthegroupvalue(&H8).

Seealso Rows

ToreferencetheObjTypecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ObjType

ToreferencetheObjTypecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visLOFlags

OutputFormatcell(DocumentPropertiessection)

Determinestheoutputformatforadrawing.Drawingpagesareusuallyformattedforprinting(default);however,youcanchooseotheroutputformats.

Value Outputformat0 Printing(default)1 PowerPointslideshow2 HTMLorGIFoutput

Remarks

ToreferencetheOutputFormatcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: OutputFormat

ToreferencetheOutputFormatcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowDocCellindex: visDocOutputFormat

Seealso Rows

Overlinecell(Charactersection)

Determineswhetherthetexthasalineaboveit.

Value DescriptionTRUE Texthasalineaboveit.FALSE Textdoesnothavealineaboveit.

Remarks

ToreferencetheOverlinecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Overline[i]wherei=<1>,2.3…

ToreferencetheOverlinecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterOverline

Seealso Rows

PageHeightcell(PagePropertiessection)

Containstheheightoftheprintedpageindrawingunits.

Remarks

YoucanalsosetthepageheightinthePageSizetabofthePageSetupdialogbox(clickPageSetupontheFilemenu),orbymanuallyresizingthepagewiththemouse.

ToreferencethePageHeightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PageHeight

ToreferencethePageHeightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageHeight

Seealso Rows

PageLineJumpDirXcell(PageLayoutsection)

Determinesthedirectionoflinejumpsonhorizontaldynamicconnectorsonthedrawingpageforwhichyouhaven'tappliedalocaljumpdirection.

Value Linejumpdirection Automationconstant0 Default;leftorthepage's

settingforshapesvisLOJumpDirXDefault

1 Up visLOJumpDirXUp2 Down visLOJumpDirXDown

Remarks

ToreferencethePageLineJumpDirXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PageLineJumpDirX

ToreferencethePageLineJumpDirXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOJumpDirX

Seealso Rows

PageLineJumpDirYcell(PageLayoutsection)

Determinesthedirectionoflinejumpsonverticaldynamicconnectorsonthedrawingpageforwhichyouhaven'tappliedalocaljumpdirection.

Value Linejumpdirection Automationconstant0 Default;uporthepage's

settingforshapesvisLOJumpDirYDefault

1 Left visLOJumpDirYLeft2 Right visLOJumpDirYRight

Remarks

ToreferencethePageLineJumpDirYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PageLineJumpDirY

ToreferencethePageLineJumpDirYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOJumpDirY

Seealso Rows

PageScalecell(PagePropertiessection)

Determinesthevalueofthepageunitinthecurrentdrawingscale.ThedrawingscaleforthepageistheratioofthepageunittothedrawingunitshownintheDrawingScalecell.

Remarks

YoucanalsosetthevalueofthePageScalecellontheDrawingScaletabinthePageSetupdialogbox(clickPageSetupontheFilemenu).ThevalueofthecellisthefirstofthetwonumbersinthePre-definedscaleboxorCustomscalebox,dependingonthedrawingscalesettingselectedunderDrawingscale.Forexample,ifyouselectanarchitecturalscaleforyourdrawing,thedrawingscaleforthepageis3/32"=1'0".ThevalueinthePageScalecellis0.0938in.(or3/32")andthevalueintheDrawingScalecellis1ft.

ToreferencethePageScalecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PageScale

ToreferencethePageScalecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPage

Cellindex: visPageScale

PageWidthcell(PagePropertiessection)

Determinesthewidthoftheprintedpageindrawingunits.

Remarks

YoucanalsosetthepagewidthonthePageSizetabofthePageSetupdialogbox(clickPageSetupontheFilemenu)orbymanuallyresizingthepagewiththemouse.Todothis,dragtheedgeofthepagewhileholdingdowntheCTRLkey.

ToreferencethePageWidthcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PageWidth

ToreferencethePageWidthcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageWidth

Seealso Rows

Perpendicularcell(Charactersection)

Determineswhetheratextfieldappearsperpendiculartotheothertextinatextblock.

Value DescriptionTRUE Textfieldappearsperpendiculartotheothertextinatextblock.FALSE Textfielddoesnotappearperpendiculartotheothertextinatext

block.

Remarks

ThiscellisusedtoimplementKumimojiinJapanesetext.

ToreferencethePerpendicularcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Perpendicular[i]wherei=<1>,2,3…

ToreferencethePerpendicularcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…

Seealso Rows

Cellindex: visCharacterPerpendicular

PlaceDepthcell(PageLayoutsection)

Determinesthemethodbywhichthedrawingisanalyzedbeforecreatingthelayout,anddeterminesthetypeoflayout.

Value Placementdepthforverticalandhorizontallayouts

Automationconstant

0 Pagedefault visPLOPlaceDepthDefault1 Medium visPLOPlaceDepthMedium2 Deep visPLOPlaceDepthDeep3 Shallow visPLOPlaceDepthShallow

Remarks

YoucanalsosetthevalueofthiscellbyusingtheLayOutShapesdialogbox(clickLayOutShapesontheShapemenu).

ToreferencethePlaceDepthcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PlaceDepth

ToreferencethePlaceDepthcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOPlaceDepth

Seealso Rows

PlaceFlipcell(PageLayoutsection)

Determineshowplaceableshapesflipand/orrotateonapagewhenyouusetheLayOutShapescommand.

Value Description Automationconstant&H0 Default.Donotflip. visLOFlipDefault&H1 Fliphorizontal. visLOFlipX&H2 Flipvertical. visLOFlipY&H4 Flipin90degree

increments.visLOFlipRotate

&H8 Donotflip. visLOFlipNone

Remarks

ThevalueinthePlaceFlipcellhelpsorientaplaceableshapetowardthenextplaceableshapeitisconnectedto.Itistypicallyusedwhenlayingoutdrawingsthatusestaticglue.

Tosetthisbehaviorforaparticularshape,usetheShapePlaceFlipcellintheShapeLayoutsection.

ToreferencethePlaceFlipcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PlaceFlip

ToreferencethePlaceFlipcellbyindexfromaprogram,usetheCellsSRC

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOPlaceFlip

PlaceStylecell(PageLayoutsection)

DetermineshowshapesareplacedonthepagewhenyouarelayingoutshapesusingtheLayOutShapescommand.

Value Placementstyle Automationconstant0 Default;radialforpageand

shapevisPLOPlaceDefault

1 Toptobottom visPLOPlaceTopToBottom2 Lefttoright visPLOPlaceLeftToRight3 Radial visPLOPlaceRadial4 Bottomtotop visPLOPlaceBottomToTop5 Righttoleft visPLOPlaceRightToLeft6 Circular visPLOPlaceCircular

Remarks

YoucanalsosetthevalueofthiscellintheLayOutShapesdialogbox(clickLayOutShapesontheShapemenu).

ToreferencethePlaceStylecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PlaceStyle

ToreferencethePlaceStylecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOPlaceStyle

PinXcell(ShapeTransformsection)

Representsthex-coordinateoftheshape'spin(centerofrotation)inrelationtotheoriginofitsparent.

Remarks

ToreferencethePinXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PinX

ToreferencethePinXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormPinX

Seealso Rows

PinYcell(ShapeTransformsection)

Representsthey-coordinateoftheshape'spin(centerofrotation)inrelationtotheoriginofitsparent.

Remarks

ToreferencethePinYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PinY

ToreferencethePinYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormPinY

Seealso Rows

PlowCodecell(PageLayoutsection)

Determineswhetherplaceableshapesmoveawaywhenyoudropaplaceableshapenearanotherplaceableshapeonthedrawingpage.

Value Description Automationconstant0 Don'tmoveshapes visPLOPlowNone1 Moveshapes visPLOPlowAll

Remarks

YoucanalsosetthevalueofthiscellontheLayoutandRoutingtabinthePageSetupdialogbox(clickPageSetupontheFilemenu)usingtheMoveothershapesawayondropcheckbox.

ToreferencethePlowCodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PlowCode

ToreferencethePlowCodecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOPlowCode

Seealso Rows

Poscell(Charactersection)

Determinesthepositionoftheshape'stextrelativetothebaseline.

Value Description Automationconstant0 Normalposition visPosNormal1 Superscript visPosSuper2 Subscript visPosSub

Remarks

ToreferencethePoscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Pos[i]wherei=<1>,2,3…

ToreferencethePoscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterPos

Seealso Rows

Positioncell(Tabssection)

Specifiesthepositionofatabstop.Thetabpositionisindependentofthescaleofthedrawing.Ifthedrawingisscaled,thetabpositionremainsthesame.

Remarks

ToreferencethePositioncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Tabs.ijwhereiandj=<1>,2,3…

ToreferencethePositioncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionTabRowindex: visRowTab+i

wherei=0,1,2…Cellindex: (j*3)+visTabPos

Seealso Rows

PreviewQualitycell(DocumentPropertiessection)

Determineswhetherthedrawingpreviewisdraftqualityordetailed.

Value Previewquality Automationconstant0 Draft visDocPreviewQualityDraft1 Detailed visDocPreviewQualityDetailed

Remarks

YoucanalsosetthisvalueontheSummarytabinthePropertiesdialogbox(clickPropertiesontheFilemenu).

ToreferencethePreviewQualitycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PreviewQuality

ToreferencethePreviewQualitycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjRowindex: visRowDocCellindex: visDocPreviewQuality

Seealso Rows

PreviewScopecell(DocumentPropertiessection)

Determineswhetheryourdrawingincludesapreview.Ifyourdrawingdoesincludeapreview,itdetermineswhetherthepreviewshowsthefirstpageonlyorallofthepagesinthedrawing.

Value Previewscope Automationconstant0 Firstpage visDocPreviewScope1stPage1 None visDocPreviewScopeNone2 Allpages visDocPreviewScopeAllPages

Remarks

YoucanalsosetthisvalueontheSummarytabinthePropertiesdialogbox(clickPropertiesontheFilemenu).

ToreferencethePreviewScopecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: PreviewScope

ToreferencethePreviewScopecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjRowindex: visRowDoc

Seealso Rows

Cellindex: visDocPreviewScope

Printcell(Layerssection)

Specifieswhethershapesbelongingtothelayercanbeprinted.

Value DescriptionTRUE Shapescanbeprinted.FALSE Shapescannotbeprinted.

Remarks

YoucanalsosetthisvalueusingthePrintoptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

ToreferencethePrintcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Print[i]wherei=<1>,2,3…

ToreferencethePrintcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visDocPreviewScope

Seealso Rows

Promptcell(Actionssection)

BeginningwithMicrosoftVisio2002,thiscellisnolongerused.

Remarks

InearlierversionsofVisio,thiscellspecifiedadescriptivepromptthatappearedinthestatusbarwhenyouselectedthecorrespondingshortcutcommand.

Seealso Rows

Promptcell(CustomPropertiessection)

SpecifiesdescriptiveorinstructionaltextthatappearstousersintheCustomPropertiesboxwhenthepropertyisselected.ThistextalsoappearsasatipwhenthemouseispausedoverthepropertyintheCustomPropertieswindow.

Remarks

ToreferencethePromptcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.PromptwhereNameistherowname

ToreferencethePromptcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…

Seealso

Cellindex: visCustPropsPrompt

Promptcell(User-DefinedCellssection)

Specifiesadescriptivepromptorcommentfortheuser-definedcell.Theapplicationautomaticallyenclosestheprompttextinquotationmarks("")toindicatethatitisatextstring.Ifyoutypeanequalsign(=)andomitthequotationmarks,youcanenteraformulainthiscellthattheapplicationevaluates.

Remarks

ToreferencethePromptcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: User.Name.PromptwhereUser.Nameistherowname

ToreferencethePromptcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionUser

Seealso

Rowindex: visRowUser+iwherei=0,1,2…

Cellindex: visUserPrompt

ResizeModecell(ShapeTransformsection)

Showsthecurrentresizebehaviorsettingfortheshape.

Value Description Automationconstant0 Usegroup'ssetting. visXFormResizeDontCare1 Repositiononly. visXFormResizeSpread2 Scalewithgroup. visXFormResizeScale

Remarks

YoucanalsosetthisvalueontheBehaviortabintheBehaviordialogbox(clickBehaviorontheFormatmenu).ToreferencetheResizeModecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ResizeMode

ToreferencetheResizeModecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormResizeMode

Seealso Rows

ResizePagecell(PageLayoutsection)

DetermineswhethertoenlargethepagetoenclosethedrawingafterlayingoutshapesusingtheLayOutShapescommand(clickLayOutShapesontheShapemenu).

Value DescriptionTRUE Enlargethepage.FALSE Donotenlargethepage.

Remarks

ToreferencetheResizePagecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ResizePage

ToreferencetheResizePagecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLOResizePage

Seealso Rows

RightMargincell(TextBlockFormatsection)

Determinesthedistancebetweentherightborderofthetextblockandthetextitcontains.Thedefaultis0.1inch.

Remarks

Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,therightmarginremainsthesame.

ToreferencetheRightMargincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: RightMargin

ToreferencetheRightMargincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkRightMargin

Seealso Rows

Roundingcell(LineFormatsection)

Indicatestheradiusoftheroundingarcappliedwheretwocontiguoussegmentsofapathmeet.Forexample,roundingcanbeusedtogivearectangleroundedcorners.Tosetrounding,enteravaluewithunitsofmeasure(anumber-unitpair).

Remarks

YoucanalsosetthisvalueintheLinedialogbox(clickLineontheFormatmenu).

ToreferencetheRoundingcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Rounding

ToreferencetheRoundingcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowLineCellindex: visLineRounding

Seealso Rows

RouteStylecell(PageLayoutsection)

Determinestheroutingstyleanddirectionforallconnectorsonthedrawingpagethatdon'thavealocalroutingstyle.

Value Routingstyle Direction Automationconstant0 Default;rightangle None visLORouteDefault1 Rightangle None visLORouteRightAngle2 Straight None visLORouteStraight3 Organizationchart Toptobottom visLORouteOrgChartNS4 Organizationchart Lefttoright visLORouteOrgChartWE5 Flowchart Toptobottom visLORouteFlowchartNS6 Flowchart Lefttoright visLORouteFlowchartWE7 Tree Toptobottom visLORouteTreeNS8 Tree Lefttoright visLORouteTreeWE9 Network None visLORouteNetwork10 Organizationchart Bottomtotop visLORouteOrgChartSN11 Organizationchart Righttoleft visLORouteOrgChartEW12 Flowchart Bottomtotop visLORouteFlowchartSN13 Flowchart Righttoleft visLORouteFlowchartEW14 Tree Bottomtotop visLORouteTreeSN15 Tree Righttoleft visLORouteTreeEW16 Centertocenter None visLORouteCenterToCenter17 Simple Toptobottom visLORouteSimpleNS18 Simple Lefttoright visLORouteSimpleWE

19 Simple Bottomtotop visLORouteSimpleSN20 Simple Righttoleft visLORouteSimpleEW21 Simplehorizontal-

verticalNone visLORouteSimpleHV

22 Simplevertical-horizontal

None visLORouteSimpleVH

Remarks

YoucansetalocalroutingstyleforaconnectorintheShapeRouteStylecelloftheShapeLayoutsection.

ToreferencetheRouteStylecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: RouteStyle

ToreferencetheRouteStylecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageLayoutCellindex: visPLORouteStyle

Scalecell(Charactersection)

Controlsthefontwidth.Thedefaultvalueforthiscellis100%.

Remarks

Setthepercentagebetween1%and99%todecreasethefontwidth.Setitbetween101%and600%toincreasethefontwidth.

ToreferencetheScalecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.FontScale[i]wherei=<1>,2,3…

ToreferencetheScalecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterFontScale

Seealso Rows

SelectModecell(GroupPropertiessection)

Determineshowyouselectagroupshapeanditsmembers.

Value Selectionmode Automationconstant0 Selectthegroupshapeonly. visGrpSelModeGroupOnly1 Selectthegroupshapefirst. visGrpSelModeGroup1st2 Selectthemembersofthe

groupfirst.visGrpSelModeMembers1st

Remarks

YoucanalsosetthisvalueintheBehaviordialogbox(withthegroupshapeselected,clickBehaviorontheFormatmenu,andthenclickamodeintheSelectionlistunderGroupBehavior).

ToreferencetheSelectModecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: SelectMode

ToreferencetheSelectModecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Cellindex: visGroupSelectMode

ShapeFixedCodecell(ShapeLayoutsection)

Specifiesplacementbehaviorforaplaceableshape.

Value Selectionmode Automationconstant&H1 Don'tmovethisshapewhen

shapesarelaidoutusingtheLayOutShapescommand.

visSLOFixedPlacement

&H2 Don'tmovethisshapeanddonotallowshapesthatplowtobeplacedontopofit.

visSLOFixedPlow

&H4 Don'tmovethisshapeandallowshapesthatplowtobeplacedontopofit.

visSLOFixedPermeablePlow

&H20(32) Ignoreconnectionpointlocationswhenbeingroutedto.

visSLOFixedConnPysIgnore

&H40(64) Onlyallowroutingtosideswithconnectionpoints.

visSLOFixedConnPtsOnly

&H80(128) Don'tgluetotheperimeterofthisshape.Gluetotheshape'salignmentboxinstead.

visSLOFixedNoFoldToShape

Remarks

YoucanalsosetthevalueofthiscellonthePlacementtabintheBehavior

dialogbox(withtheshapeselected,clickBehaviorontheFormatmenu).

Youcansetanycombinationofthesevaluesforthiscell.Forexample,youcanenterthevalue3(&H3),whicheliminatesmovementwhenyoulayoutshapesusingtheLayOutShapescommandandwhenotherplaceableshapesareplacedonorneartheshape.

InversionsearlierthanMicrosoftVisio2000,yousetthisbehaviorusingtheObjInteractcellintheMiscellaneoussection.

ToreferencetheShapeFixedCodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShapeFixedCode

ToreferencetheShapeFixedCodecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOFixedCode

ShapePermeablePlacecell(ShapeLayoutsection)

DetermineswhetherplaceableshapescanbeplacedontopofashapewhenlayingoutshapesusingtheLayOutShapescommand.

Value DescriptionTRUE Enableshapestobeplacedontopofashape.FALSE Donotenableshapestobeplacedontopofashape.

Remarks

YoucanalsosetthevalueofthiscellonthePlacementtabintheBehaviordialogbox(withashapeselected,clickBehaviorontheFormatmenu,andthenclickthePlacementtab).

ToreferencetheShapePermeablePlacecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShapePermeablePlace

ToreferencetheShapePermeablePlacecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Rowindex: visRowShapeLayoutCellindex: visSLOPermeablePlace

ShapePermeableXcell(ShapeLayoutsection)

Determineswhetheraconnectorcanroutehorizontallythroughaplaceableshape.

Value DescriptionTRUE Enableconnectorstoroutehorizontallythroughaplaceableshape.FALSE Donotletconnectorsroutehorizontallythroughaplaceable

shape.

Remarks

ToreferencetheShapePermeableXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShapePermeableX

ToreferencetheShapePermeableXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOPermX

ShapePermeableYcell(ShapeLayoutsection)

Determineswhetheraconnectorcanrouteverticallythroughashape.

Value DescriptionTRUE Enableconnectorstorouteverticallythroughashape.FALSE Donotletconnectorsrouteverticallythroughashape.

Remarks

ToreferencetheShapePermeableYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShapePermeableY

ToreferencetheShapePermeableYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Seealso Rows

Cellindex: visSLOPermY

ShapePlaceFlipcell(ShapeLayoutsection)

Determineshowaplaceableshapeflipsand/orrotatesonthepagewhenyouarelayingoutshapesusingtheLayOutShapescommand.

Value Description Automationconstant0 Usepagedefault. visLOFlipDefault1 Fliphorizontal. visLOFlipX2 Flipvertical. visLOFlipY4 Flipin90degree

incrementsbetween0and270.

visLOFlipRotate

8 Donotflip. visLOFlipNone

Remarks

ThevalueintheShapePlaceFlipcellhelpsorientaplaceableshapetowardthenextplaceableshapeitisconnectedto.

Tosetthisbehaviorforalltheshapesonthedrawingpage,usethePlaceFlipcellinthePageLayoutsection.

ToreferencetheShapePlaceFlipcellbynamefromanotherformula,orfromaprogramusingtheCells,use:

Cellname: ShapePlaceFlip

ToreferencetheShapePlaceFlipcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOPlaceFlip

ShapePlowCodecell(ShapeLayoutsection)

Determineswhetherthisplaceableshapemovesawaywhenyoudropanotherplaceableshapenearthisshapeonthedrawingpage.

Value Description Automationconstant0 Plowaspagespecifies. visSLOPlowDefault1 Plownoshapes. visSLOPlowNever2 Ploweveryshape. visSLOPlowAlways

Remarks

YoucanalsosetthevalueofthiscellforaparticularshapeonthePlacementtabintheBehaviordialogbox(withashapeselected,clickBehaviorontheFormatmenu,andthenclickthePlacementtab).

Tosetthisbehaviorforalltheshapesonthedrawingpage,usethePlowCodecellinthePageLayoutsection.

ToreferencetheShapePlowCodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShapePlowCode

ToreferencetheShapePlowCodecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLOPlowCode

ShapeRouteStylecell(ShapeLayoutsection)

Determinestheroutingstyleanddirectionforaselectedconnectoronthedrawingpage.

Value Routingstyle Direction Automationconstant0 Usepagedefault None visLORouteDefault1 Rightangle None visLORouteRightAngle2 Straight None visLORouteStraight3 Organizationchart Toptobottom visLORouteOrgChartNS4 Organizationchart Lefttoright visLORouteOrgChartWE5 Flowchart Toptobottom visLORouteFlowchartNS6 Flowchart Lefttoright visLORouteFlowchartWE7 Tree Toptobottom visLORouteTreeNS8 Tree Lefttoright visLORouteTreeWE9 Network None visLORouteNetwork10 Organizationchart Bottomtotop visLORouteOrgChartSN11 Organizationchart Righttoleft visLORouteOrgChartEW12 Flowchart Bottomtotop visLORouteFlowchartSN13 Flowchart Righttoleft visLORouteFlowchartEW14 Tree Bottomtotop visLORouteTreeSN15 Tree Righttoleft visLORouteTreeEW16 Centertocenter None visLORouteCenterToCenter

17 Simple Toptobottom visLORouteSimpleNS18 Simple Lefttoright visLORouteSimpleWE19 Simple Bottomtotop visLORouteSimpleSN20 Simple Righttoleft visLORouteSimpleEW21 Simplehorizontal-

verticalNone visLORouteSimpleHV

22 Simplevertical-horizontal

None visLORouteSimpleVH

Remarks

YoucanalsosetthevalueofthiscellforaparticularconnectorontheConnectortabintheBehaviordialogbox(withaconnectorselected,clickBehaviorontheFormatmenu,andthenclicktheConnectortab).

Tosetthisbehaviorforalltheconnectorsonapage,usetheRouteStylecellinthePageLayoutsection.

InversionsearlierthanMicrosoftVisio2000,yousetthisbehaviorusingtheObjBehaviorcellintheMiscellaneoussection.

ToreferencetheShapeRouteStylecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShapeRouteStyle

ToreferencetheShapeRouteStylecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowShapeLayoutCellindex: visSLORouteStyle

Sharpencell(ImagePropertiessection)

Sharpensabitmapimage.Thedefaultvalueis0%.Sharpeninganimagefocusesitbyincreasingthecontrastofadjacentpixels.

Remarks

ToreferencetheSharpencellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Sharpen

ToreferencetheSharpencellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageSharpen

Seealso Rows

ShdwBkgndcell(FillFormatsection)

Determinesthecolorusedforthebackground(fill)oftheshape'sdropshadowfillpattern.

Remarks

Tosetthecolor,enteranumberfrom0to23,whichisanindexintoacollectionofcolors.YoucanviewthecollectionintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

Youcansetthetransparencyofthebackgroundcoloroftheshape'sdropshadowfillpatternintheShdwBkgndTranscell.

ToreferencetheShdwBkgndcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwBkgnd

ToreferencetheShdwBkgndcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rowindex: visRowFillCellindex: visFillShdwBkgnd

ShdwBkgndTranscell(FillFormatsection)Determinesthetransparencylevelforthecolorusedforthebackground(fill)oftheshape'sdropshadowfillpattern.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashadowwithacompletelytransparentfillappearsthesameasashadowwithnofillonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheShadowdialogbox(clickShadowontheFormatmenu).Thisvaluecontrolsthevalueofboththebackgroundandforegroundshadowtransparencies.Tosetthesevaluesindependently,youmustenterthemintheShapeSheetwindow.

ToreferencetheShdwBkgndTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwBkgndTrans

ToreferencetheShdwBkgndTranscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillShdwBkgndTrans

ShdwForegndcell(FillFormatsection)

Determinesthecolorusedfortheforeground(stroke)oftheshape'sdropshadowfillpattern.

Remarks

Tosetthecolor,enteranumberfrom0to23,whichisanindexintoacollectionofcolors.YoucanviewthecollectionintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

Youcansetthetransparencyoftheforegroundcoloroftheshape'sdropshadowfillpatternintheShdwForegndTranscell.

ToreferencetheShdwForegndcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwForegnd

ToreferencetheShdwForegndcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillShdwForegnd

ShdwForegndTranscell(FillFormatsection)Determinesthetransparencylevelforthecolorusedfortheforeground(stroke)oftheshape'sdropshadowfillpattern.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashadowwithacompletelytransparentfillappearsthesameasashadowwithnofillonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheShadowdialogbox(clickShadowontheFormatmenu).Thisvaluecontrolsthevalueofboththebackgroundandforegroundshadowtransparencies.Tosetthesevaluesindependently,youmustenterthemintheShapeSheetwindow.

ToreferencetheShdwForegndTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwForegndTrans

ToreferencetheShdwForegndTranscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillShdwForegndTrans

ShdwOffsetXcell(PagePropertiessection)

Determinesthedistanceinpageunitsthatashape'sdropshadowisoffsethorizontallyfromtheshape.

Remarks

ThisvalueissetinthePageSetupdialogbox(clickPageSetupontheFilemenu).Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,theshadowoffsetremainsthesame.

ToreferencetheShdwOffsetXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwOffsetX

ToreferencetheShdwOffsetXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageShdwOffsetX

Seealso Rows

ShdwOffsetYcell(PagePropertiessection)

Determinesthedistanceinpageunitsthatashape'sdropshadowisoffsetverticallyfromtheshape.

Remarks

ThisvalueissetinthePageSetupdialogbox(clickPageSetupontheFilemenu).Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,theshadowoffsetremainsthesame.

ToreferencetheShdwOffsetYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwOffsetY

ToreferencetheShdwOffsetYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowPageCellindex: visPageShdwOffsetY

Seealso Rows

ShdwPatterncell(FillFormatsection)

Determinesthefillpatternforashape'sshadow.

Value Description0 None(transparentfill)1 Solidforegroundcolor2-40 Assortedpatterns

Remarks

Tosetthefillpattern,enteranumberfrom0to40,whichisanindexintoacollectionofpatterns.YoucanviewthefillpatterncollectionintheFilldialogbox(clickFillontheFormatmenu).

ToreferencetheShdwPatterncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ShdwPattern

ToreferencetheShdwPatterncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowFillCellindex: visFillShdwPattern

Seealso Rows

Sizecell(Charactersection)

Determinesthesizeofthetextintheshape'stextblock.

Remarks

Thetext'ssizeisindependentofthescaleofthedrawing.Ifthedrawingisscaled,thetextsizeremainsthesame.

ToreferencetheSizecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Size[i]wherei=<1>,2,3…

ToreferencetheSizecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterSize

Seealso Rows

Snapcell(Layerssection)

Determineswhetherothershapescansnaptoshapesassignedtothelayer.Shapesassignedtothelayercansnaptoothershapes,butothershapescan'tsnaptothem.

Value DescriptionTRUE Othershapescansnaptoshapesonthelayer.FALSE Othershapescannotsnaptoshapesonthelayer.

Remarks

YoucanalsosetthevalueofthiscellusingtheSnapoptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

ToreferencetheSnapcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Snap[i]wherei=<1>,2,3…

ToreferencetheSnapcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visLayerSnap

Seealso Rows

SortKeycell(CustomPropertiessection)

EvaluatestoastringthatinfluencestheorderinwhichitemsintheCustomPropertiesdialogboxandwindowarelisted.

Remarks

ThecalculationusedtocompareSortKeyvaluesislocalespecificandcaseinsensitive.IfSortKeyvaluesareequal,thecustompropertiesarelistedinroworder.Acustompropertywithnosortkeyislistedbeforecustompropertiesthatcontainasortkey.

FollowingisanexampleofusingsortkeystodisplaythecustompropertiesintheCustomPropertiesdialogboxandwindowintheorder:ItemNumber,Quantity,Price.

Row,Label,andSortKeyrefertocellsinthecustompropertyrow.Inthiscase,thecustompropertyrowshavebeennamed.

Row Label SortKey

Seealso

Prop.Item ItemNumber 1Prop.Price Price 3Prop.Quan Quantity 2

ToreferencetheSortKeycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.SortKeywhereProp.Nameisthenameofthecustompropertyrow

ToreferencetheSortKeycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCustPropsSortKey

Spacingcell(Charactersection)

Controlstheamountofspacebetweentwoormorecharacters.Spacecanbeaddedorsubtractedin1/20thpointincrements.

Remarks

ToreferencetheSpacingcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Letterspace[i]wherei=<1>,2,3…

ToreferencetheSpacingcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterspace

Seealso Rows

SpAftercell(Paragraphsection)

Determinestheamountofspaceinsertedaftereachparagraphintheshape'stextblock,inadditiontoanyspacefromtheSpLinecelland,ifitisthelastparagraphinatextblock,theBottomMargincell.

Remarks

Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,theSpaceAftersettingremainsthesame.

ToreferencetheSpAftercellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.SpAfter[i]wherei=<1>,2,3…

ToreferencetheSpAftercellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visSpaceAfter

SpBeforecell(Paragraphsection)

Determinestheamountofspaceinsertedbeforeeachparagraphintheshape'stextblock,inadditiontoanyspacefromtheSpLinecellifitisthefirstparagraphinatextblock,theTopMargincell.

Remarks

Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,theSpaceBeforesettingremainsthesame.

ToreferencetheSpBeforecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.SpBefore[i]wherei=<1>,2,3…

ToreferencetheSpBeforecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visSpaceBefore

SpLinecell(Paragraphsection)

Determinesthedistancebetweenonelineoftextandthenext,expressedasapercentage,where100%istheheightofatextline.

Value Description>0 Absolutespacing,regardlessoftypesize=0 Setsolid(spacing=100%oftypesize)<0 Apercentageoftypesize(forexample,-120%yields120%

spacing)

Remarks

ToreferencetheSpLinecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Para.SpLine[i]wherei=<1>,2,3…

ToreferencetheSpLinecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visSpaceLine

Seealso Rows

Strikethrucell(Charactersection)

Determineswhetherthetextisformattedasstrikethrough.

Value DescriptionTRUE Textisformattedasstrikethrough.FALSE Textisnotformattedasstrikethrough.

Remarks

ToreferencetheStrikethrucellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Strikethru[i]wherei=<1>,2,3…

ToreferencetheStrikethrucellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterStrikethru

Seealso Rows

Stylecell(Charactersection)

Showsthecharacterformattingappliedtoarangeoftextintheshape'stextblock.

Style Value AutomationconstantBold &H1 visBoldItalic &H2 visItalicUnderline &H4 visUnderLineSmallcaps &H8 visSmallCaps

Remarks

TheStylecellcontainsformattinginformationappliedtoasub-rangeofashape'stextiftheCharacterssectioncontainsmultiplerows.Otherwise,itcontainsformattinginformationforalloftheshape'stext.

Thevaluerepresentsabinarynumberinwhicheachbitindicatesacharacterstyle.Forexample,avalueof3representstextformattedinbothitalicandbold.IfthevalueofStyleis0,thetextisplain,orunformatted.YoucantestforaparticularformatusingBooleanBIT*functions.Seeyourprogrammingdocumentationfordetailsaboutthesefunctions.

ToreferencetheStylecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.Style[i]wherei=<1>,2,3…

ToreferencetheStylecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterStyle

Example

SupposetheColorcellinthefirstrowofashape'sCharactersectionissettothisformula:

=IF(BITAND(Char.Style,1)=1,4,3)

Thenifthefirstcharacteroftheshape'stextisbold,thetextcoveredbythefirstCharacterpropertiesrowwillbeblue(4);otherwiseitwillbegreen(3).Thisexampleassumesdefaultcolorsareineffect.

ThefollowingisanexampleofsettingtheStylecellinaprogram.ThefirststatementreferencestheStylecellbyname,andthesecondstatementreferencestheStylecellbyindex.Bothstatementsapplyitalicstothetextcoveredbythesecondrowofashape'sCharactersection.

shpObj.Cells("Char.Style[2]").ResultIU=visItalicshpObj.CellsSRC(visSectionCharacter,visRowCharacter+1,_visCharacterStyle).ResultIU=visItalic

SubAddresscell(Hyperlinkssection)

Specifiesalocationwithinthetargetdocumenttolinkto.

Remarks

Forexample,iftheAddresscellis"Drawing1.vsd",theSubAddresscellcanspecifyapagenamesuchas"Page-3".IftheAddresscellistheMicrosoftExcelfile"Samples.xls",thevalueofthiscellcanbeaworksheetorrangewithinaworksheet,suchas"WorksheetFunctions"or"Sheet1!A1:D10".IftheAddresscellis"http://www.microsoft.com/visio/",thevalueofthiscellcanbeanamedanchorwithinthedocument,suchas"solutions".

YoucanalsosetthevalueofthiscellusingtheHyperlinksdialogbox(clickHyperlinksontheInsertmenu).

ToreferencetheSubAddresscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Hyperlink.Name.SubAddresswhereHyperlink.Nameistherowname

ToreferencetheSubAddresscellbyindexfromaprogram,usetheCellsSRC

Sectionindex: visSectionHyperlinkRowindex: visRowHyperlink+i

wherei=0,1,2…Cellindex: visHLinkSubAddress

TextBkgndcell(TextBlockFormatsection)

Determinesthetextbackgroundcolorforashape.

Remarks

TheTextBkgndcellcanhaveanyvaluefrom0through24,or255.Thevalues0and255(visTxtBlklOpaque)bothindicateatransparenttextbackground.Toselectacolorvalue,add1tothevaluedisplayedintheColorPalettedialogbox(clickColorPaletteontheToolsmenu).

Toenteracustomcolor,usetheRGBorHSLfunctionplusone—forexample,RGB(255,127,255)+1.ThevalueofacustomcolorisitsRGBcolor,andRGB(r,g,b)+1,ratherthananumber,willbeshownintheShapeSheetwindow.Whenusedinnumericoperations,customcolorshavevaluesof25andabove.

YoucansetthetransparencyofthetextbackgroundcolorintheTextBkgndTranscell.

ToreferencetheTextBkgndcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TextBkgnd

ToreferencetheTextBkgndcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkBkgnd

TextBkgndTranscell(TextBlockFormatsection)

Determinesthetransparencylevelforthebackgroundcoloroftheshape'stextblock.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithacompletelytransparenttextbackgroundappearsthesameasashapewithnotextbackgroundonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheTextFormatdialogbox(clickTextontheFormatmenu,thenselecttheTextBlocktab).

ToreferencetheTextBkgndTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TextBkgndTrans

ToreferencetheTextBkgndTranscellbyindexfromaprogram,usethe

CellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkBkgndTrans

TextDirectioncell(TextBlockFormatsection)

Determinesthedirectionofthecharactersinatextblock.

Value Direction Automationconstant0 Horizontal visTxtBlkLeftToRight1 Vertical visTxtBlkTopToBottom

Remarks

InMicrosoftVisioversion5.0Japaneseproducts,thevalueofthiscellwasstoredintheVerticalTextcellintheMiscellaneoussection.

ToreferencetheTextDirectioncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TextDirection

ToreferencetheTextDirectioncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkDirection

Seealso Rows

TheDatacell(Eventssection)

Reservedforfutureuse.

Seealso Rows

TheTextcell(Eventssection)

Aneventcellthatisevaluatedwhenashape'stextortextcompositionchanges.

Remarks

Eventcellsareevaluatedonlywhentheeventoccurs,notuponformulaentry.YoucanusetheTheTextcelltotriggerrecalculations,forexample,torecalculatethetextwidthandheightwiththeTEXTWIDTH()andTEXTHEIGHT()functions.

ToreferencetheTheTextcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TheText

ToreferencetheTheTextcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowEventCellindex: visEvtCellTheText

Tipcell(Controlssection)

Representsadescriptivetextstringthatappearsasatooltipwhenauserpausesthepointeroverashape'scontrolhandle.Theapplicationautomaticallyenclosesthetipstringinquotationmarksinthecell,butthequotationmarksarenotdisplayedinthetooltip.

Remarks

ToreferencetheTipcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.Prompt[i]wherei=<1>,2,3…

ToreferencetheTipcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionControlsRowindex: visRowControl+i

wherei=0,1,2…Cellindex: visCtlTip

Seealso Rows

TopMargincell(TextBlockFormatsection)

Determinesthedistancebetweenthetopborderofthetextblockandthefirstlineoftextitcontains.Thedefaultis4.0000point.Thisvalueisindependentofthescaleofthedrawing.Ifthedrawingisscaled,thetopmarginremainsthesame.

Remarks

ToreferencetheTopMargincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TopMargin

ToreferencetheTopMargincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkTopMargin

Seealso Rows

Transparencycell(Charactersection)

Determinesthetransparencylevelforarangeofashape'stextcolor.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithcompletelytransparenttextappearsthesameasashapewithnotextonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheTextFormatdialogbox(clickTextontheFormatmenu,thenselecttheFonttab).

TheTransparencycellcontainsformattinginformationappliedtoasub-rangeofashape'stextiftheCharacterssectioncontainsmultiplerows.Otherwise,itcontainsformattinginformationforalloftheshape'stext.

ToreferencetheTransparencycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Char.ColorTrans[i]wherei=<1>,2,3…

ToreferencetheTransparencycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCharacterColorTrans

Transparencycell(ImagePropertiessection)Determinesthetransparencylevelforalayercolor.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughalayerwithcompletelytransparentcolorappearsthesameasalayerwithnocoloronthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.YoucanalsosetthisvalueusingtheslidercontrolintheLayerPropertiesdialogbox(clickLayerpropertiesontheViewmenu).

Cellname: Transparency

Sectionindex: visSectionObjectRowindex: visRowImageCellindex: visImageTransparency

Transparencycell(Layerssection)

Determinesthetransparencylevelforalayercolor.

(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughalayerwithcompletelytransparentcolorappearsthesameasalayerwithnocoloronthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.YoucanalsosetthisvalueusingtheslidercontrolintheLayerPropertiesdialogbox(clickLayerpropertiesontheViewmenu).

Cellname: Layers.ColorTrans[i]wherei=<1>,2,3…

wherei=0,1,2…Cellindex: visLayerColorTrans

TxtAnglecell(TextTransformsection)

Determinesthetextblock'scurrentangleofrotationinrelationtothex-axisoftheshape.Thedefaultis0degrees.

Remarks

ToreferencetheTxtAnglecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtAngle

ToreferencetheTxtAnglecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormAngle

Seealso Rows

TxtHeightcell(TextTransformsection)

Determinestheheightofthetextblock.Thedefaultformulais:

=Height*1

Thisformulaevaluatestotheheightoftheshape.

Remarks

ToreferencetheTxtHeightcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtHeight

ToreferencetheTxtHeightcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormHeight

Seealso Rows

TxtLocPinXcell(TextTransformsection)

Determinesthex-coordinateofthetextblock'scenterofrotationinrelationtotheoriginofthetextblock.Thedefaultformulais:

=TxtWidth*0.5

Thisformulaevaluatestothehorizontalcenterofthetextblock.

Remarks

ToreferencetheTxtLocPinXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtLocPinX

ToreferencetheTxtLocPinXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormLocPinX

Seealso Rows

TxtLocPinYcell(TextTransformsection)

Determinesthey-coordinateofthetextblock'scenterofrotationrelativetotheoriginofthetextblock.Thedefaultformulais:

=TxtHeight*0.5

Thisformulaevaluatestotheverticalcenterofthetextblock.

Remarks

ToreferencetheTxtLocPinYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtLocPinY

ToreferencetheTxtLocPinYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormLocPinY

Seealso Rows

TxtPinXcell(TextTransformsection)

Determinesthex-coordinateofthetextblock'scenterofrotationinrelationtotheoriginoftheshape.Thedefaultformulais:

=Width*0.5

Thisformulaevaluatestothehorizontalcenteroftheshape.

Remarks

ToreferencetheTxtPinXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtPinX

ToreferencetheTxtPinXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormPinX

Seealso Rows

TxtPinYcell(TextTransformsection)

Determinesthey-coordinateofthetextblock'scenterofrotationinrelationtotheoriginoftheshape.Thedefaultformulais:

=Height*0.5

Thisformulaevaluatestotheverticalcenteroftheshape.

Remarks

ToreferencetheTxtPinYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtPinY

ToreferencetheTxtPinYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormPinY

Seealso Rows

TxtWidthcell(TextTransformsection)

Determinesthewidthofthetextblock.Thedefaultformulais:

=Width*1

Thisformulaevaluatestothewidthoftheshape.

Remarks

ToreferencetheTxtWidthcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: TxtWidth

ToreferencetheTxtWidthcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextXFormCellindex: visXFormWidth

Seealso Rows

Typecell(CustomPropertiessection)

Specifiesadatatypeforthecustompropertyvalue.

Value Description Automationconstant0 String.Thisisthedefault. visPropTypeString1 Fixedlist.Displaysthelistitemsina

drop-downcomboboxintheCustomPropertiesdialogbox.SpecifythelistitemsintheFormatcell.Userscanselectonlyoneitemfromthelist.

visPropTypeListFix

2 Number.Includesdate,time,duration,andcurrencyvaluesaswellasscalars,dimensions,andangles.SpecifyaformatpictureintheFormatcell.

visPropTypeNumber

3 Boolean.DisplaysFALSEandTRUEasitemsuserscanselectfromadrop-downlistboxintheCustomPropertiesdialogbox.

visPropTypeBool

4 Variablelist.Displaysthelistitemsinadrop-downcomboboxintheCustom

visPropTypeListVar

Propertiesdialogbox.SpecifythelistitemsintheFormatcell.UserscanselectalistitemorenteranewitemthatisaddedtothecurrentlistintheFormatcell.

5 Dateortimevalue.Displaysdays,months,andyears,orseconds,minutes,andhours,oracombineddateandtimevalue.SpecifyaformatpictureintheFormatcell.

visPropTypeDate

6 Durationvalue.Displayselapsedtime.SpecifyaformatpictureintheFormatcell.

visPropTypeDuration

7 Currencyvalue.Usesthesystem'scurrentRegionalSettings.SpecifyaformatpictureintheFormatcell.

visPropTypeCurrency

Remarks

ToreferencetheTypecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.TypewhereProp.Nameistherowname

ToreferencetheTypecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCustPropsType

Typecell(TextFieldssection)

Specifiesadatatypeforthetextfieldvalue.

Value Description0 String.2 Number.Includesdate,time,duration,andcurrencyvaluesaswell

asscalars,dimensions,andangles.SpecifyaformatpictureintheFormatcell.

5 Dateortimevalue.Displaysdays,months,andyears,orseconds,minutes,andhours,oracombineddateandtimevalue.SpecifyaformatpictureintheFormatcell.

6 Durationvalue.Displayselapsedtime.SpecifyaformatpictureintheFormatcell.

7 Currencyvalue.Usesthesystem'scurrentRegionalSettings.SpecifyaformatpictureintheFormatcell.

Remarks

YoucanalsosetthevalueofthiscellusingtheFielddialogbox(withashapeselected,clickFieldontheInsertmenu).

ToreferencetheTypecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Fields.Type[i]wherei=<1>,2,3…

ToreferencetheTypecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionTextFieldRowindex: visRowField+i

wherei=0,1,2…Cellindex: visFieldType

Type/Ccell(ConnectionPointssection)

Determinestheconnectionpointtype.

Value Type Automationconstant0 Inward visCnnctTypeInward1 Outward visCnnctTypeOutward2 Inward&Outward visCnnctTypeInwardOutward

Remarks

YoucanalsosettheconnectionpointtypebychoosingtheConnectortool,selectingashape,andthenright-clickingaconnectionpoint.Todothis,youneedtorunindevelopermode(ontheToolsmenu,clickOptions,clicktheAdvancedtab,andthenselecttheRunindevelopermodecheckbox).

ToreferencetheType/Ccellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Connections.Type[i]

Seealso

wherei=<1>,2,3…

ToreferencetheType/Ccellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCnnctType(non-extendedrows)

visCnnctC(extendedrows)

UICategorycell(TextFieldssection)

DeterminesthecategoryofaninsertedfieldinversionsofMicrosoftVisioearlierthanVisio2000.

Remarks

ThiscelldoesnotappearintheShapeSheetwindow.UsethiscellifyouneedtodealwithbackwardcapabilityissuessuchassavingaVisioversion2000drawinginVisioversion5.0fileformat.

ToreferencetheUICategorycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Fields.UICat[i]wherei=<1>,2,3…

ToreferencetheUICategorycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visFieldUICategory

Seealso Rows

UICodecell(TextFieldssection)

DeterminesthecodeofaninsertedfieldinversionsofMicrosoftVisioearlierthanVisio2000.

Remarks

ThiscelldoesnotappearintheShapeSheetwindow.Usethiscellifyouneedtodealwithbackwardcapabilityissues,suchassavingaVisioversion2000drawinginVisioversion5.0fileformat.

ToreferencetheUICodecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Fields.UICod[i]wherei=<1>,2,3…

ToreferencetheUICodecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visFieldUICode

Seealso Rows

UIFormatcell(TextFieldssection)

DeterminestheformatofaninsertedfieldinversionsofMicrosoftVisioearlierthanVisio2000.

Remarks

ThiscelldoesnotappearintheShapeSheetwindow.Usethiscellifyouneedtodealwithbackwardcapabilityissues,suchassavingaVisioversion2000drawinginVisioversion5.0fileformat.

ToreferencetheUIFormatcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Fields.UIFmt[i]wherei=<1>,2,3…

ToreferencetheUIFormatcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visFieldUIFormat

Seealso Rows

UpdateAlignBoxcell(Miscellaneoussection)

Recalculatestheselectionrectanglewheneveracontrolhandleismoved.

Remarks

ToreferencetheUpdateAlignBoxcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: UpdateAlignBox

ToreferencetheUpdateAlignBoxcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visUpdateAlignBox

Seealso Rows

Valuecell(CustomPropertiessection)

Containstheproperty'svalueasenteredintheCustomPropertiesdialogbox.

Remarks

FormulasenteredinthiscellareoverriddenbyvaluesenteredintheCustomPropertiesdialogbox.ThisistrueevenifyouusetheGUARDfunctiontoprotecttheformula.

ToreferencetheValuecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Prop.Name.ValuewhereProp.Nameistherowname

ToreferencetheValuecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…

Seealso

Cellindex: visCustPropsValue

Valuecell(TextFieldssection)

Containsthefunctionforafield.

Remarks

YoucansetthevalueofthiscellusingtheFielddialogbox(clickFieldontheInsertmenu).Toseealistoffunctions,seetheFunctionslistinthisDeveloperReference.

FormulasenteredinthiscellareoverriddenbyvaluesenteredintheCustomPropertiesdialogbox.ThisistrueevenifyouusetheGUARDfunctiontoprotecttheformula.

Cellname: Prop.Name.ValuewhereProp.Nameistherowname

wherei=0,1,2…Cellindex: visCustPropsValue

Valuecell(User-DefinedCellssection)

Specifiesavalueforthecorrespondinguser-definedcell.

Remarks

Torefertothisvalueinanothercell,specifytheuser-definednameenteredintherowlabelUser.Row.

Cellname: User.Name.ValuewhereUser.Nameistherowname

Sectionindex: visSectionUserRowindex: visRowUser+i

wherei=0,1,2…Cellindex: visUserValue

Seealso

VerticalAligncell(TextBlockFormatsection)

Determinestheverticalalignmentoftextwithinthetextblock.

Value Description Automationconstant0 Top visVertTop1 Middle visVertMiddle2 Bottom visVertBottom

Remarks

ToreferencetheVerticalAligncellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: VerticalAlign

ToreferencetheVerticalAligncellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowTextCellindex: visTxtBlkVerticaAlign

Seealso Rows

Visiblecell(Layerssection)

Specifieswhethershapesbelongingtothelayerarevisibleonthedrawingpage.

Value DescriptionTRUE Shapesarevisible.FALSE Shapesarehidden.

Remarks

ThiscellcorrespondstotheVisibleoptionintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

ToreferencetheVisiblecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Layers.Visible[i]wherei=<1>,2,3…

ToreferencetheVisiblecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visLayerVisible

Seealso Rows

WalkPreferencecell(GlueInfosection)

Determineswhetheranendpointofa1-Dshapemovestoahorizontalorverticalconnectionpointontheshapeitisgluedto,usingdynamicglue,whentheshapeismovedtoanambiguousposition.Bydefault,bothendpointsofthe1-Dshapemovetohorizontalconnectionpoints.

Value Description Automationconstant1 Thebeginpointofthe1-Dshapemoves

toaverticalconnectionpoint,andtheendpointmovestoahorizontalconnectionpoint(top-to-sideorbottom-to-sideconnections).

visWalkPrefBegNS

2 Thebeginpointofthe1-Dshapemovestoahorizontalconnectionpoint,andtheendpointmovestoaverticalconnectionpoint(side-to-toporside-to-bottomconnections).

visWalkPrefEndNS

Remarks

Thiscellhasnoeffectondynamicconnectors.Adynamicconnector'sbehaviorisdeterminedbyitsroutingstyle.SeetheRouteStylecellforthedefaultroutingstylefordynamicconnectorsonapage,ortheShapeRouteStylefortheroutingstyleofaparticulardynamicconnector.

ToreferencetheWalkPreferencecellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: WalkPreference

ToreferencetheWalkPreferencecellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowMiscCellindex: visWalkPref

Widthcell(ShapeTransformsection)

Containsthewidthoftheselectedshapeindrawingunits.Thedefaultformulafordeterminingthewidthofa1-Dshapeis:

=SQRT((EndX-BeginX)^2+(EndY-BeginY)^2)

Remarks

ToreferencetheWidthcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Width

ToreferencetheWidthcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowXFormOutCellindex: visXFormWidth

Seealso Rows

Xcell(ConnectionPointssection)

Representsthex-coordinateforaconnectionpointinlocalcoordinates.

Remarks

ToreferencetheXcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Connections.Xiwherei=<1>,2,3…

ToreferencetheXcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visX

Seealso

Xcell(Controlssection)

Representsthex-coordinatethatindicatesthelocationofashape'scontrolhandleinlocalcoordinates.

Remarks

Cellname: Controls.Xiwherei=<1>,2,3…

Sectionindex: visSectionControlsRowindex: visRowControls+i

wherei=0,1,2…Cellindex: visCtlX

Seealso Rows

Xcell(Geometrysection)

Representsanx-coordinateonashapeinlocalcoordinates.ThistabledescribestheXcellbasedontherowinwhichit'slocated.

Row DescriptionMoveTo IftheMoveTorowisthefirstrowinthesection,theX

cellrepresentsthex-coordinateofthefirstvertexofapath.IftheMoveTorowappearsbetweentworows,theXcellrepresentsthex-coordinateofthefirstvertexafterthebreakinthepath.

LineTo Thex-coordinateoftheendingvertexofastraightlinesegment.

ArcTo Thex-coordinateoftheendingvertexofanarc.EllipticalArcTo Thex-coordinateoftheendingvertexofanelliptical

arc.PolylineTo Thex-coordinateoftheendingvertexofapolyline.NURBSTo Thex-coordinateofthelastcontrolpointofa

nonuniformrationalB-spline(NURBS).SplineStart Thex-coordinateofaspline'ssecondcontrolpoint.SplineKnot Thex-coordinateofacontrolpoint.

Seealso

InfiniteLine Anx-coordinateofapointontheinfiniteline.Ellipse Thex-coordinateofthecenteroftheellipse.

Remarks

Cellname: Geometryi.Xjwhereiandj=<1>,2,3…

Geometryi.X1(InfiniteLineandEllipserows)wherei=<1>,2,3…

visRowVertex(InfiniteLineandEllipserows)Cellindex: visX(MoveTo,LineTo,ArcTo,EllipticalArcTo,

NURBSTo,Polyline,SplineStart,andSplineKnotrows)

visInfiniteLineX1(InfiniteLinerow) visEllipseCenterX(Ellipserow)

XBehaviorcell(Controlssection)

Controlsthetypeofbehaviorthex-coordinateofthecontrolhandlewillexhibitafterthehandleismoved.

Value Behavior Definition Automationconstant0 Proportional Thecontrolhandlecanbe

moved,anditalsomovesinproportionwiththeshapewhenitisstretched.

visCtlProportional

1 Proportionallocked

Thecontrolhandlemovesinproportionwiththeshapebutthecontrolhandleitselfcannotbemoved.

visCtlLocked

2 Offsetfromleftedge

Thecontrolhandleisoffsetaconstantdistancefromtheleftsideoftheshape.

visCtlOffsetMin

3 Offsetfromcenter

Thecontrolhandleisoffsetaconstantdistancefromthecenteroftheshape.

visCtlOffsetMid

4 Offsetfromrightedge

Thecontrolhandleisoffsetaconstantdistancefromtherightsideoftheshape.

visCtlOffsetMax

5 Proportional,hidden

Sameas0,butthecontrolhandleisnotvisible.

visCtlProportionalHidden

6 Proportionallocked,hidden

visCtlLockedHiddenv

7 Offsetfrom Sameas2,butthecontrol visCtlOffsetMinHidden

Seealso Rows

leftedge,hidden

handleisnotvisible.

8 Offsetfromcenter,hidden

visCtlOffsetMidHidden

9 Offsetfromrightedge,hidden

visCtlOffsetMaxHidden

Remarks

ToreferencetheXBehaviorcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.XCon[i]wherei=<1>,2,3…

ToreferencetheXBehaviorcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCtlXCon

XDynamicscell(Controlssection)

Representsthex-coordinateforacontrolhandle'sanchorpointinlocalcoordinates.

Remarks

Theanchorpointisusedforrubber-bandingduringdynamics.

ToreferencetheXDynamicscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.Xdyn[i]wherei=<1>,2,3…

ToreferencetheXDynamicscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCtlXDyn

Seealso Rows

XGridDensitycell(Ruler&Gridsection)

Specifiesthetypeofhorizontalgridtouse.

Value Description Automationconstant0 Fixed visGridFixed2 Coarse visGridCoarse4 Normal(default) visGridNormal8 Fine visGridFine

Remarks

ThiscellcorrespondstothehorizontalGridspacingoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheXGridDensitycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: XGridDensity

ToreferencetheXGridDensitycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visXGridDensity

Seealso Rows

XGridOrigincell(Ruler&Gridsection)

Specifiesthehorizontalcoordinateofthegridorigin.

Remarks

ThiscellcorrespondstothehorizontalGridoriginoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheXGridOrigincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: XGridOrigin

ToreferencetheXGridOrigincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visXGridOrigin

Seealso Rows

XGridSpacingcell(Ruler&Gridsection)

Specifiesthedistancebetweenhorizontallinesinafixedgrid(XGridDensity=0).

Remarks

ThiscellcorrespondstothehorizontalMinimumspacingoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheXGridSpacingcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: XGridSpacing

ToreferencetheXGridSpacingcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visXGridSpacing

XRulerDensitycell(Ruler&Gridsection)

Specifiesthehorizontalsubdivisionsontherulerforthepage.

Value Description Automationconstant0 Fixed visRulerFixed8(&H8) Coarse visRulerCoarse16(&H10) Normal(Default) visRulerNormal32(&H20) Fine visRulerFine

Remarks

ThiscellcorrespondstothehorizontalSubdivisionsoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheXRulerDensitycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: XRulerDensity

ToreferencetheXRulerDensitycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visXRulerDensity

Seealso Rows

XRulerOrigincell(Ruler&Gridsection)

Specifiesthezeropointonthex-axisrulerforthepage.

Remarks

ThiscellcorrespondstothehorizontalRulerzerooptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheXRulerOrigincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: XRulerOrigin

ToreferencetheXRulerOrigincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visXRulerOrigin

Seealso Rows

Ycell(ConnectionPointssection)

Representsthey-coordinateforaconnectionpointinlocalcoordinates.

Remarks

ToreferencetheYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Connections.Yiwherei=<1>,2,3…

ToreferencetheYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visY

Seealso

Ycell(Controlssection)

Representsthey-coordinatethatindicatesthelocationofashape'scontrolhandleinlocalcoordinates.

Remarks

ToreferencetheYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.Yiwherei=<1>,2,3…

ToreferencetheYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCtlY

Seealso Rows

Ycell(Geometrysection)

Representsay-coordinateonashapeinlocalcoordinates.ThistabledescribestheYcellbasedontherowinwhichit'slocated.

Row DescriptionMoveTo IftheMoveTorowisthefirstrowinthesection,theY

cellrepresentsthey-coordinateofthefirstvertexofapath.IftheMoveTorowappearsbetweentworows,theYcellrepresentsthey-coordinateofthefirstvertexafterthebreakinthepath.

LineTo They-coordinateoftheendingvertexofastraightlinesegment.

ArcTo They-coordinateoftheendingvertexofanarc.EllipticalArcTo They-coordinateoftheendingvertexofanelliptical

arc.PolylineTo They-coordinateoftheendingvertexofapolyline.NURBSTo They-coordinateofthelastcontrolpointofa

nonuniformrationalB-spline(NURBS).SplineStart They-coordinateofaspline'ssecondcontrolpoint.SplineKnot They-coordinateofacontrolpoint.

Seealso

InfiniteLine Ay-coordinateofapointontheinfiniteline.Ellipse They-coordinateofthecenteroftheellipse.

Remarks

Cellname: Geometryi.Yjwhereiandj=<1>,2,3…

Geometryi.Y1(InfiniteLineandEllipserows)wherei=<1>,2,3…

visRowVertex(InfiniteLineandEllipserows)Cellindex: visY(MoveTo,LineTo,ArcTo,EllipticalArcTo,

NURBSTo,Polyline,SplineStart,andSplineKnotrows)

visInfiniteLineY1(InfiniteLinerow) visEllipseCenterY(Ellipserow)

YBehaviorcell(Controlssection)

Controlsthetypeofbehaviorthey-coordinateofthecontrolhandlewillexhibitafterthehandleismoved.Theseformulasareavailable.

Value Behavior Definition Automationconstant0 Proportional Thecontrolhandlecanbe

moved,anditalsomovesinproportionwiththeshapewhenitisstretched.

visCtlProportional

1 Proportionallocked

Thecontrolhandlemovesinproportionwiththeshape,butthecontrolhandleitselfcannotbemoved.

visCtlLocked

2 Offsetfrombottomedge

Thecontrolhandleisoffsetaconstantdistancefromthebottomoftheshape.

visCtlOffsetMin

3 Offsetfromcenter

Thecontrolhandleisoffsetaconstantdistancefromthecenteroftheshape.

visCtlOffsetMid

4 Offsetfromtopedge

Thecontrolhandleisoffsetaconstantdistancefromthetopoftheshape.

visCtlOffsetMax

5 Proportional,hidden

visCtlProportionalHidden

6 Proportionallocked,hidden

visCtlLockedHiddenv

Seealso Rows

7 Offsetfromleftedge,hidden

visCtlOffsetMinHidden

8 Offsetfromcenter,hidden

visCtlOffsetMidHidden

9 Offsetfromrightedge,hidden

visCtlOffsetMaxHidden

Remarks

ToreferencetheYBehaviorcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.Ycon[i]wherei=<1>,2,3…

ToreferencetheYBehaviorcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCtlYCon

YDynamicscell(Controlssection)

Representsthey-coordinateforacontrolhandle'sanchorpointinlocalcoordinates.Theanchorpointisusedforrubber-bandingduringdynamics.

Remarks

ToreferencetheYDynamicscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: Controls.YDyn[i]wherei=<1>,2,3…

ToreferencetheXDynamicscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

wherei=0,1,2…Cellindex: visCtlYDyn

Seealso Rows

YGridDensitycell(Ruler&Gridsection)

Specifiesthetypeofverticalgridtouse.

Value Description Automationconstant0 Fixed visGridFixed2 Coarse visGridCoarse4 Normal(default) visGridNormal8 Fine visGridFine

Remarks

ThiscellcorrespondstotheverticalGridspacingoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheYGridDensitycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: YGridDensity

ToreferencetheYGridDensitycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visYGridDensity

Seealso Rows

YGridOrigincell(Ruler&Gridsection)

Specifiestheverticaloriginofthegrid.

Remarks

ThiscellcorrespondstotheverticalGridoriginoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheYGridOrigincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: YGridOrigin

ToreferencetheYGridOrigincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visYGridOrigin

Seealso Rows

YGridSpacingcell(Ruler&Gridsection)

Specifiesthedistancebetweenverticallinesinafixedgrid(YGridDensity=0).

Remarks

CorrespondstotheverticalMinimumspacingoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheYGridSpacingcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: YGridSpacing

ToreferencetheYGridSpacingcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visYGridSpacing

YRulerDensitycell(Ruler&Gridsection)

Specifiestheverticalsubdivisionsontherulerforthepage.

Value Description Automationconstant0 Fixed visRulerFixed8(&H8) Coarse visRulerCoarse16(&H10) Normal(Default) visRulerNormal32(&H20) Fine visRulerFine

Remarks

ThiscellcorrespondstotheverticalSubdivisionsoptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheYRulerDensitycellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: YRulerDensity

ToreferencetheYRulerDensitycellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visYRulerDensity

Seealso Rows

YRulerOrigincell(Ruler&Gridsection)

Specifiesthezeropointonthey-axisrulerforthepage.

Remarks

ThiscellcorrespondstotheverticalRulerzerooptionintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

ToreferencetheYRulerOrigincellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: YRulerOrigin

ToreferencetheYRulerOrigincellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Sectionindex: visSectionObjectRowindex: visRowRulerGridCellindex: visYRulerOrigin

Seealso Rows

ABSfunction

Returnstheabsolutevalueofanumber.

Syntax

ABS(number)

Example

ABS(-1.24)

Returns1.24.

ACOSfunction

Returnsthearccosineofnumber,forexample,theanglewhosecosineisnumber.

Syntax

ACOS(number)

Remarks

Theinputvaluemustbeintherange-1<=number<=1,ora#NUM!errorisreturned.Theresultingangleisintherange0<=angle<=PIradians(0<=angle<=180degrees).

Example

ACOS(0)

Equals90deg.

Seealso

ANDfunction

ReturnsTRUE(1)ifallofthelogicalexpressionssuppliedareTRUE.IfanyofthelogicalexpressionsareFALSEor0,theANDfunctionreturnsFALSE(0).

Syntax

AND(logicalexpression1,logicalexpression2,...,logicalexpressionN)logicalexpression

Acombinationofconstants,operators,functions,andreferencestoShapeSheetcellsthatresultsinavalue.Anyexpressionthatevaluatestoanon-zerovalueisconsideredtobeTRUE.

Example

AND(Height>1,PinX>1)

ReturnsTRUEifbothexpressionsareTRUE.ReturnsFALSEifeitherexpressionisFALSE.

Seealso

ANG360function

Normalizesanangle'srangetobe0<=result<2PIradians(0<=result<360deg.).

Syntax

ANG360(angle)

Remarks

Ifangleisnotspecifiedusingangularunits,itisinterpretedasradians.Ifanglecannotbeconvertedtoavalue,a#VALUE!errorisreturned.

Example1

ANG360(395deg.)

Equals35deg.

Example2

ANG360(-9.8rad.)

Equals2.7664rad.

Example3

ANG360(45)

Equals58.31deg.(1.0177rad.)

Seealso

ANGLETOLOCfunction

Returnsatransformedangleinthedestinationshape'slocalcoordinatesystem.Itconvertsananglefromlocalcoordinatesinasourceshapetothelocalcoordinatesinadestinationshape.YoucanusetheANGLETOLOCfunctiontosetlocalanglecellsinashapeintermsofananglefromanothercoordinatespace.

Syntax

ANGLETOLOC(srcAngle,srcRef,dstRef)srcAngle Anangleinthesourcecoordinatesystem.srcRef Areferencetoacellinthesourceobject,suchasashape,

group,page,andsoon.dstRef Areferencetoacellinthedestinationobject,suchasashape,

group,page,andsoon.

Remarks

Thisfunctionworksevenwhenthesourceanddestinationshapesarewithingroups.Italsoadjustsforrotationandflipsintheintermediatetransformation.

Thesourceanddestinationcoordinatesmustbeonthesamepage.

Seealso

ANGLETOPARfunction

Returnsatransformedangleinthedestinationshape'sparentcoordinatesystem.Itconvertsananglefromlocalcoordinatesinasourceshapetotheparentcoordinatesinadestinationshape.

Syntax

ANGLETOPAR(srcAngle,srcRef,dstRef)srcAngle Anangleinthesourcecoordinatesystem.srcRef Areferencetoacellinthesourceobject,suchasashape,

group,page,andsoon.dstRef Areferencetoacellinthedestinationobject,suchasashape,

group,page,andsoon.

Remarks

Ifthedestinationisapage,whichhasnoparent,theresultisexpressedinpage'slocalcoordinates.

Seealso

ASINfunction

Returnsthearcsineofanumber,forexample,theanglewhosesineisnumber.

Syntax

ASIN(number)

Remarks

Theinputvaluemustbeintherange-1<=number<=1,ora#NUM!errorisreturned.Theresultingangleisintherange-PI/2<=angle<=PI/2radians(-90<=angle<=90degrees).

Example

ASIN(1)

Equals90deg.

Seealso

ATANfunction

Returnsthearctangentofanumber,forexample,theanglewhosetangentisnumber.Theresultingangleisintherange-PI/2<=angle<=PI/2radians(-90<=angle<=90degrees).

Syntax

ATAN(number)

Example

ATAN(1)

Equals45deg.

Seealso

ATAN2function

Returnstheanglebetweenthevectorrepresentedbyx,yandthedirectionofthex-axis.Theresultisanumberinthecurrentunitofmeasureforangles.

Syntax

ATAN2(y,x)

Remarks

Thearctangentistheanglemeasuredcounterclockwisefromthepositivex-axistoalinethatintersectstheorigin(0,0)andthepointrepresentedbyxandy.InMicrosoftVisio,ATAN2(0,0)returns0.ToforcetheresultofATAN2intoadifferentangularmeasurement,usetheDEGorRADfunction.

TheATAN2functionistheantifunctionoftheTANfunction.TheATAN2functionreturnstheanglewhoseangleisequaltoydividedbyx.IfATAN2(y,x)representsanangleinarighttriangle,thenyisthe"oppositeside"andxisthe"adjacentside,"sothefunctioncouldbewrittenasATAN2(opposite,adjacent).

Example1

ATAN2(1.25,2.25)

Returns29.0456degrees.

Example2

ATAN2(1,SQRT(3))

Returns30degrees.

Example3

ATAN2(1,1)

Seealso

Returns45degrees.

BITANDfunction

Returnsa16-bitbinarynumberinwhicheachbitissetto1onlyifthecorrespondingbitinbothbinarynumber1andbinarynumber2is1.Otherwise,thebitissetto0.Thisfunctioncanbeusedtotestandchangepropertiesofashapethatarestoredasbitmasks,forexample,theshape'stextformat.

Syntax

BITAND(binarynumber1,binarynumber2)

Example

BITAND(12,6)

Returns4.The12=0...01100.The6=0...00110.Therefore,BITAND(12,6)=0...00100.

Seealso

BITNOTfunction

Returnsa16-bitbinarynumberinwhicheachbitissetto1onlyifthecorrespondingbitinbinarynumberis0.Otherwise,thebitissetto0.

Syntax

BITNOT(binarynumber)

Example

BITNOT(6)

Returns65529.The6=0...00110.Therefore,BITNOT(6)=1...11001.

Seealso

BITORfunction

Returnsa16-bitbinarynumberinwhicheachbitissetto1ifthecorrespondingbitineitherbinarynumber1orbinarynumber2is1.Thebitissetto0onlyifthecorrespondingbitis0inbothbinarynumber1andbinarynumber2.

Syntax

BITOR(binarynumber1,binarynumber2)

Example

BITOR(12,6)

Returns14.The12=0...01100.The6=0...00110.Therefore,BITOR(12,6)=0...01110.

Seealso

BITXORfunction

Returnsa16-bitbinarynumberinwhicheachbitissetto1ifthecorrespondingbitineitherbutnotbothbinarynumber1andbinarynumber2is1.Otherwise,thebitissetto0.

Syntax

BITXOR(binarynumber1,binarynumber2)

Example

BITXOR(12,6)

Returns10.The12=0...01100.The6=0...00110.Therefore,BITXOR(12,6)=0...01010.

Seealso

BKGPAGENAMEfunction

Returnsabackgroundpagenameasastring.

Syntax

BKGPAGENAME(langID_opt)langID_opt Optionalargument.Usetospecifyalanguageforthestringthe

functionreturns.Use0(defaultvalue)tospecifythelocallanguage.Use750tospecifyuniversallanguage.

Remarks

Ifthepageforwhichyouareusingthefunctiondoesn'thaveabackgroundpage,thestring"<nobackground>"isreturned.

Ifyoupassanillegallanguagecode,thelocallanguageisused.

Seealso

BLUEfunction

Returnsthebluecomponentofacolor.Thereturnvalueisanintegerintherangeof0to255,inclusive.Theinputisanindexofacolorinthedocument'scolortable,anexpressionthatresolvestoacustomcolor(likeRGBorHSL),orareferencetoacellthatcontainsacolorindexorcolorresult.Thefunctionreturns0forinvalidinput.

Syntax

BLUE(expression)

Example1

BLUE(Sheet.4!FillForegnd)

ReturnsthebluecomponentofSheet.4'sfillforegroundcolor.

Example2

BLUE(13)

Returns128ifthedocumentusesthedefaultVisiocolorpalette,wherecyanisthecoloratindex13.

Example3

BLUE(RGB(10,20,30))

Returns30.

Seealso

CALLTHISfunction

CallsaprocedureinaMicrosoftVisualBasicforApplications(VBA)project.

Syntax

CALLTHIS("procedure",["project"],[arg1,arg2,…])procedure Thenameoftheproceduretocall;requiredstring.project Optionalstring.Theprojectthatcontainstheprocedure.arg Anargumentofanytypethatcanincludenumber,string,date,

andcurrencyvalues;passedasparameterstotheprocedure.

Remarks

IntheVBAproject,procedureisdefinedasfollows:

procedure(shpObjAsVisio.shape[arg1Astype,arg2Astype...])

whereshpObjisareferencetotheShapeobjectthatcontainstheCALLTHISformulabeingevaluated,andarg1,arg2...aretheargumentsspecifiedinthatformula.

NoticethatshpObjisverymuchlikethe"this"argumentpassedtoaC++memberprocedure;hencethename"CALLTHIS."Ineffect,acellthatcontainsaformulawithCALLTHISissaying,"Callthisprocedureandpassitareferencetomyshape."

Ifprojectisspecified,Visioscansallopendocumentsfortheonecontainingprojectandcallsprocedureinthatproject.Ifprojectisomittedornull(""),

procedureisassumedtobeintheVBAprojectofthedocumentthatcontainstheCALLTHISformulabeingevaluated.

Numbersinarg1,arg2…arepassedinexternalunits.Forexample,ifyoupassthevalueoftheHeightcellfroma3-cm-tallshape,3ispassed.Topassdifferentunitswithanumber,usetheFORMATEXfunctionorexplicitlycoerceunitsbyaddinganullnumber-unitpair,forexample,0ft+Height.

ThesecondcommaintheCALLTHISfunctionisoptional.Itcorrespondstothenumberofadditionalparametersaddedtoyourprocedure.Ifyoudonotuseanyadditionalparameters,exceptshpObjasVisio.Shape,donotaddthesecondcomma—useCALLTHIS("",).Ifyouaddtwoadditionalparameters,forexample,useCALLTHIS("",,,).

TheCALLTHISfunctionalwaysevaluatesto0,andthecalltoprocedureoccursduringidletimeaftertherecalculationprocessfinishes.Procedurecanreturnavalue,butVisioignoresit.ProcedurecansimulatereturningavaluethatVisiocanrecognizebysettingtheformulaorresultofanothercellinthedocument,butnotthecellthatcalledprocedureunlessyouwanttooverwritetheCALLTHISformula.

TheCALLTHISfunctiondiffersfromtheRUNADDONfunctioninthatadocument'sprojectneednotreferenceanotherprojectinordertocallintothatproject.

NoteVBAcodeinvokedasaresultoftheVisioinstanceevaluatingaCALLTHISfunctioninaformulashouldnotclosethedocumentcontainingthecellusingthefunctionbecauseanapplicationerrorresultsandVisioterminates.

IfyouneedtoclosethedocumentcontainingthecellthatusestheCALLTHISfunction,useoneofthefollowingtechniques:

Closethedocumentfromnon-VBAcode.

Closethedocumentfromaprojectotherthantheonethatisclosing.

Postwindowmessagestoclosewindowsintothedocumentratherthanclosingthedocument.

Example1

CALLTHIS("p",,FORMATEX(Height,"#.00u",,"cm"))

CallstheprocedurenamedplocatedinamoduleandpassesthevalueofHeightincentimeters,suchas7.62cm.

Example2

CALLTHIS("q",,0cm.+Height,Sheet.2!Width)

Callstheprocedurenamedqlocatedinamoduleandpassesthecell'sheightincentimetersandSheet.2'swidthininternalunits.

Example3

UsethefollowingprocedureintheThisDocumentclassmodule.

SubA(shpObjAsVisio.Shape)MsgBox"ClickOK."EndSubSubB(shpObjAsVisio.Shape,strAAsString)MsgBoxstrAEndSubSubC(shpObjAsVisio.Shape,strAAsString,strBAsString)MsgBoxstrA&strBEndSub

Useanyofthefollowingsyntaxinashape'sEventDblClickcellwiththeproceduresabove.

CALLTHIS("ThisDocument.A",)

CALLTHIS("ThisDocument.B",,"Click")

CALLTHIS("ThisDocument.C",,"Click","OK.")

CATEGORYfunction

ReturnsthetextfromtheCategoryfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

CATEGORY()

Seealso

CEILINGfunction

Roundsanumberawayfrom0(zero)tothenextinstanceofmultiple.Ifmultipleisnotspecified,thenumberroundsawayfrom0tothenextinteger.

Syntax

CEILING(number,multiple)

Remarks

Numberandmultiplemusthavethesamesigns,ora#NUM!errorisreturned.Ifeithernumberormultiplecannotbeconvertedtoavalue,a#VALUE!errorisreturned.Ifeithernumberormultipleis0,theresultis0.

Example1

CEILING(3.7)

Equals4.

Example2

CEILING(-3.7)

Equals-4.

Example3

CEILING(3.7,0.25)

Equals3.75.

Seealso

CHARfunction

ReturnstheANSIcharacterforanumber.

Syntax

CHAR(number)

Remarks

Theresultingstringisonecharacterinlength.Thenumbermustbeanintegerbetween1and255(inclusive),orthefunctionreturnsanerror.

Example

CHAR(9)

Returnsthetabcharacter.

Seealso

COMPANYfunction

ReturnsthetextfromtheCompanyfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

COMPANY()

Seealso

COSfunction

Returnsthecosineofanangle.

Syntax

COS(angle)

Remarks

Usesradiansunlessaunitofmeasureisspecifiedwithangle.

Example

COS(45degrees)

Returns0.7071.

COSHfunction

Returnsthehyperboliccosineofanangle.

Syntax

COSH(angle)

Remarks

Usesradiansunlessaunitofmeasureisspecifiedwithangle.

Example

COSH(45degrees)

Returns1.3246.

CREATORfunction

ReturnsthetextfromtheAuthorfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

CREATOR()

Seealso

CYfunction

Returnsacurrencyvalue.

Syntax

CY(value,cyID)value Optional.Anumberorastringthatincludescurrency-specific

formatting.Ifnotspecified,thecurrencyvalueisformattedaccordingtothecurrencystyleinthesystem'sRegionalSettings.

cyID Optional.AnumericcurrencyIDorathree-characterquotedstringfortheISO4217abbreviation.

Remarks

Tospecifyadifferentcurrency,youmustincludeavalidcyID.Foralist,seeAboutcurrencyconstants.

Ifvalueisincompatiblewiththedesignatedcurrencytype,oraninvalidargumentsuchas"notanumber"isspecified,a#VALUE!errorisreturned.Ifvalueisgreaterthan922,337,203,685,477.5807orlessthan-922,337,203,685,477.5808,a#VALUE!errorisreturned.

Forbetterprecisionwithverylargecurrencyvaluesthatincludefractionsofaunit,suchas3.6trillion,usestringargumentsforvalue.

SpecifyinganinvalidcyIDreturnsanerror.

Example1

Iftheuser'sRegionalSettingspecifiesUnitedStates$:

CY(999998.993)

Returns$999,998.99

Example2

CY(12345678.993,"USD")

Returns$12,345,678.99

Example3

CY(12345678.993,"DEM")

Returns12,345,678.99DEM

Example4

CY(12345678.7832,"XXX")

Returns12,345,678.78

DATA1function

ReturnsthetextfromtheData1fieldintheSpecialdialogbox(clickSpecialontheFormatmenu)forashapeasastring.

Syntax

DATA1()

Remarks

Ifthefieldisempty,anemptystringisreturned.

Seealso

DATA2function

ReturnsthetextfromtheData2field(clickSpecialontheFormatmenu)forashapeasastring.

Syntax

DATA2()

Remarks

Seealso

DATA3function

ReturnsthetextfromtheData3field(clickSpecialontheFormatmenu)forashapeasastring.

Syntax

DATA3()

Remarks

Seealso

DATEfunction

Returnsthedaterepresentedbyyear,month,anddayformattedaccordingtotheshortdatestyleinthesystem'sRegionalSettings.Thevaluesforyear,month,anddayreflecttheGregoriancalendar.

Syntax

DATE(year,month,day)

Example1

DATE(1999,6,7)

Returnsthevaluerepresenting6/7/1999.

Example2

DATE(1999,6,7)+4ed.

Example3

FORMAT(DATE(1999,10,14),"C")

ReturnsthevaluerepresentingTuesday,October14,1999.

DATETIMEfunction

Returnsthedateandtimevaluerepresentedbydatetimeorexpression.

Syntax

DATETIME("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

referencetoacellcontainingadateandtime.expression Anyexpressionthatyieldsadateandtime.lcid Optionalargument.Thelocaleidentifiertobeusedin

evaluatinganonlocaldatetime.Thelocaleidentifierisanumberdescribedinthesystemheaderfiles.

Remarks

Ifdatetimeismissingorcannotbeinterpretedasavaliddateortime,returnsa#VALUE!error.

Thereturnedvalueisformattedaccordingtotheshortdatestyleandtimestyleinthesystem'scurrentRegionalSettings.

TheDATETIMEfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthenumberofdayssinceDecember30,1899,andthedecimalportionrepresentsthefractionofadaysincemidnight.

Example1

DATETIME("May30,1997")+5ed.

Example2

FORMAT(DATETIME("5/20/199714:30:45"),"C")

Returnsthestring"Tuesday,May20,19972:30:45PM."

Example3

DATETIME("1:30PM,July19")

Returnsthevaluerepresenting7/19/20011:30PM(assumingthecurrentyearis2001).

Example4

DATETIME(35580.6337)

Returnsthevaluerepresenting5/30/19973:12:32PM.

DATEVALUEfunction

Returnsthedatevaluerepresentedbydatetimeorexpression.

Syntax

DATEVALUE("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

referencetoacellcontainingadateandtime.expression Anyexpressionthatyieldsadateandtime.lcid Optionalargument.Specifiesthelocaleidentifiertobeusedin

Remarks

Anytimecomponentindatetimeorexpressionisdiscarded.

Ifdatetimeismissingorcannotbeconvertedtoavalidresult,returnsa#VALUE!error.

Thereturnedvalueisdisplayedusingtheshortdatestylesetbythesystem'scurrentRegionalSettings.

TheDATEVALUEfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthedayssinceDecember30,1899.

Example1

DATEVALUE(NOW())+5ed.

Returnsthedatefivedaysfromnow.

Example2

DATEVALUE("7/19/199512:30")

Returnsthedate.

Example3

DATEVALUE("May33,1997")

Returnsa#VALUE!error.

Example4

DATEVALUE(35580.6337)

Returns5/30/1997.

DAYfunction

Returnsaninteger,1to31,representingthedayindatetimeorexpression.TheDAYfunctionusestheGregoriancalendar.

Syntax

DAY("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Noroundingisdone.Ifdatetimeismissingorcannotbeconvertedtoavalidresult,thefunctionreturnsanerror.

TheDAYfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthenumberofdayssinceDecember30,1899.

Example1

DAY("May30,19973:45:24PM")

Returns30.

Example2

DAY(DATEVALUE("May30,1997")+7ed.)

Returns6.

Example3

DAY(35580.6337)

Returns30.

DAYOFYEARfunction

Returnsaninteger,1to366,representingthesequentialdayoftheyearindatetimeorexpression.TheDAYOFYEARfunctionusestheGregoriancalendar.

Syntax

DAYOFYEAR("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

TheresultcorrespondstoJanuary1toDecember31.Noroundingisdone.Ifdatetimeismissingorcannotbeinterpretedasavaliddateortime,thefunctionreturnsanerror.

TheDAYOFYEARfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthenumberofdayssinceDecember30,1899.

Example1

DAYOFYEAR("May30,19973:45:24PM")

Returns150.

Example2

DAYOFYEAR(DATEVALUE("May30,1997")+7ed.)

Returns157.

Example3

DAYOFYEAR(35580.6337)

Returns150.

DECIMALSEPfunction

Returnsthedecimalseparatorstringforthecurrentuserlocale.

Syntax

DECIMALSEP()

Example

SETF(GETREF(user.size),user.wholePart&DecimalSep()&user.fracPart)

Seealso

DEFAULTEVENTfunction

Performsthedefaulteventassociatedwiththeobject.

Syntax

DEFAULTEVENT()

Remarks

Object DefaulteventShape Edittext.Group Donothing.OLE Doprimaryverb.Other Donothing.

InearlierversionsofMicrosoftVisio,thisfunctionappearsas_DEFAULTEVENTandthedefaulteventforagroupistoopenagroupwindow.

Seealso

DEGfunction

Convertsthevalueofananglefromradianstodegrees.

Syntax

DEG(angle)

Example

DEG(PI()/4)

Returns45.

Seealso

DEPENDSONfunction

Createsacellreferencedependency.

Syntax

DEPENDSON(cellref[,cellref2,...])

Remarks

ThisfunctionalwaysreturnsFALSE.IthasnoeffectwhenusedinanEventroworanActioncell.

Example

OPENTEXTWIN()+DEPENDSON(PinX,PinY)

Opensthetextblockforashapewhenevertheshape'sPinXorPinYcellschange.

Seealso

DESCRIPTIONfunction

ReturnsthetextfromtheDescriptionfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

DESCRIPTION()

Seealso

DIRECTORYfunction

Returnsthefullpathofthedirectoryinwhichadocumentissavedasastring,oranemptystringifthedocumenthasn'tbeensaved.

Syntax

DIRECTORY()

Seealso

DOCCREATIONfunction

Returnsthedateandtimeadocumentwascreatedasaserialvalue.

Syntax

DOCCREATION()

Remarks

UsetheFORMATfunctiontoformatthevalue.

DOCLASTPRINTfunction

Returnsthedateandtimeadocumentwaslastprintedasaserialvalue.

Syntax

DOCLASTPRINT()

Remarks

DOCLASTSAVEfunction

Returnsthedateandtimeadocumentwaslastsavedasaserialvalue.

Syntax

DOCLASTSAVE()

Remarks

DOOLEVERBfunction

ExecutesaverbfortheOLEobject.

Syntax

DOOLEVERB("verb")

Remarks

InearlierversionsofMicrosoftVisio,thisfunctionappearsas_DOOLEVERB.Visioversions4.0andlateraccepteitherstyle.

Example

DOOLEVERB("edit")

RunstheOLEobjectprogramanddisplaysthelinkedorembeddedobjectsothatitcanbeedited.

Seealso

EVALTEXTfunction

Evaluatesthetextinshapenameasifitwereaformulaandreturnstheresult.

Syntax

EVALTEXT(shapename!theText)shapename!theText Acellthatistriggeredwhentheassociatedshape'stext

compositionchanges.Shapename!canbeusedtorefertothetextofashapeotherthanthecurrentshape.

Remarks

Ifthereisnotext,theresultiszero.Ifthetextcannotbeevaluated,thefunctionreturnsanerror.

Example

EVALTEXT(Line.2!theText)

EvaluatesthetextcontainedintheshapeLine.2.Forexample,ifLine.2contains"4ft+0.5ft",returnsthevalue4.5ft.

Seealso

FIELDPICTUREfunction

ReturnsaformatpicturestringthatmatchestheMicrosoftVisiointernaltextfieldformatcode.

Syntax

FIELDPICTURE(code)code Atextfieldformatcode.

Remarks

FormatpicturestringsareusedintheFORMATfunctiontodefinetheexpansionofvaluestodates,times,numbers,andunitlabels.

Example

FIELDPICTURE(0)

Returnstheformatpicturestring"esc(0)",whichspecifiesanumberwithonedecimalplaceandlowercaseunitdescriptionwhenusedintheFORMATfunction.

FILENAMEfunction

Returnsadocument'sfilenameasastring.

Syntax

FILENAME()

Seealso

FLOORfunction

Roundsanumbertoward0(zero),tothenextinteger,ortothenextinstanceofmultiple.

Syntax

FLOOR(number,multiple)

Remarks

Ifmultipleisnotspecified,thenumberroundstoward0tothenextinteger.

Numberandmultiplemusthavethesamesignsora#NUM!errorisreturned.Ifeithernumberormultiplecannotbeconvertedtoavalue,a#VALUE!errorisreturned.Ifeithernumberormultipleis0,theresultis0.

Example1

FLOOR(3.7)

Returns3.

Example2

FLOOR(-3.7)

Returns-3.

Example3

FLOOR(3.7,0.5)

Returns3.5.

Seealso

FORMATfunction

Returnstheresultofexpressionasastringformattedaccordingtoformatpicture.

Syntax

FORMAT(expression,"formatpicture")

Remarks

Thetypeoftheexpressionandthetypespecifiedintheformatpicturegovernthebehaviorofthereturnedstring.Theformatpicturemustbeappropriateforthetypeofexpression.

Returnsanerroriftheresultofexpressionandthetypeexpectedinformatpictureareofadifferentkindoriftherearesyntaxerrorsinformatpicture.

Example1

FORMAT(1cm/4,"0.000u")

Returns"0.250cm."

Example2

FORMAT(1cm/4,"0.00U")

Returns"0.25CM."

Example3

FORMAT(1cm/4,"0.0u")

Returns"0.3cm."

FORMATEXfunction

Returnstheresultofexpressionevaluatedininputunitasastringformattedaccordingtoformatpictureexpressedinoutputunit.

Syntax

FORMATEX(expression,"formatpicture"[,inputunit][,outputunit])expression Acombinationofconstants,operators,functions,and

referencestoShapeSheetcellsthatresultsinavalue.inputunit Optional.Anumericalvalueorvalidabbreviatedunitof

measure(in,in.,inch,etc.).outputunit Optional.Anumericalvalueorvalidabbreviatedunitof

measure(in,in.,inch,etc.).

Remarks

Thetypeoftheexpressionandthetypespecifiedintheformatpicturegovernthebehaviorofthereturnedstring.Theformatpicturemustbeappropriateforthetypeofexpression.

inputunitisusedtoscaleuntypedexpressionresults,suchas3+4.Iftheresultofexpessionhasanexplicittype,suchas3ft+8ft,theninputunitisignored.

outputunitisusedtospecifytheunitsusedfortheformattedresult.Ifoutputunitisnotspecified,theunitsfortheresultoftheexpressionareused.

Returnsanerroriftheresultofexpressionandthetypeexpectedinformatpictureareofadifferentkind,iftherearesyntaxerrorsinformatpicture,

orifitdoesnotrecognizetheunitspassedasinputunitsoroutputunits.

Example

FORMATEX(5.5,"0.00u","cm","ft")

Returns0.18ft.

GETREFfunction

Referencesacellanddoesn'trecalculatetheformulawhenthereferencedcellchanges.

Syntax

GETREF(cellname)

Example

SETF(GETREF(PinX),5.1)

SetstheformulaofthePinXcellto5.1.

GETVALfunction

Getsthevalueofacellanddoesn'trecalculatetheformulawhenthecell'svaluechanges.

Syntax

GETVAL(cellname)

Example

GETVAL(PinX)+GETVAL(PinY)+Width

ReturnsthesumofthevalueofthePinX,PinY,andWidthcells.

Seealso

GOTOPAGEfunction

Displaysthepagewhosenameispagenameinthecurrentlyactivewindow.

Syntax

GOTOPAGE("pagename")

Remarks

Ifawindowisalreadydisplayingthepage,thatwindowbecomesactive.Ifpagenamedoesnotexist,theapplicationattemptstonavigatetohttp://pagename/.IfMicrosoftVisioisactingasanin-placeserver,theGOTOPAGEfunctionhasnoeffect.

YoucanusetheHYPERLINKfunctiontonavigatetoanyDOS,UNC,orURLpath.

InearlierversionsofVisioproducts,thisfunctionappearsas_GOTOPAGE.Visioversions4.0andlateraccepteitherstyle.

GRAVITYfunction

Calculatesatextblock'scorrectangleofrotationfortheindicatedshaperotationtopreventthetextfromturningupsidedown.

Syntax

GRAVITY(angle,limit1,limit2)angle Theshape'sangle.limit1 Optional.Defaultlimitis90degrees.limit2 Optional.Defaultlimitis270degrees.

Remarks

TheGRAVITYfunctionisusuallyusedintheTxtAnglecell.

Thevaluereturnedis180degreesifangleisbetweentheanglesspecifiedbylimit1andlimit2;otherwisethevaluereturnedis0degrees.

Alloftheargumentsareautomaticallynormalizedbetween0and360degreesbythefunction.Ifanargumentdoesnotspecifyunits,radiansareassumed.

Example1

GRAVITY(Angle)

Returns180degreesifAngleisbetween90and270degrees;otherwise,returns0degrees.

Example2

GRAVITY(2)

Returns180degrees,because2radiansisbetween90and270degrees.

Example3

GRAVITY(100deg.,110deg.,290deg.)

Returns0deg.

Example4

GRAVITY(100deg.,290deg.,110deg.)

Returns0deg.

GREENfunction

Returnsthegreencomponentofacolor.Thereturnvalueisanintegerintherangeof0to255,inclusive.Theinputisanindexofacolorinthedocument'scolortable,anexpressionthatresolvestoacustomcolor(likeRGBorHSL),orareferencetoacellthatcontainsacolorindexorcolorresult.Thefunctionreturns0forinvalidinput.

Syntax

GREEN(expression)

Remarks

Thereturnvalueisanumberintherange0to255,inclusive,oracellreferencethatresolvestoanindex.Ifexpressionisinvalid,itreturns0(black).

Example1

GREEN(Sheet.4!FillForegnd)

ReturnsthegreencomponentofSheet.4'sfillforegroundcolor.

Example2

GREEN(11)

Returns128ifthedocumentusesthedefaultVisiocolorpalette,wheredarkyellowisthecoloratindex11.

Example3

GREEN(RGB(10,20,30))

Returns20.

Seealso

GUARDfunction

Protectsexpressionfromdeletionandchangebyactionsperformedinthedrawingwindow,forexample,moving,sizing,grouping,orungroupingshapes.

Syntax

GUARD(expression)

Remarks

ThecellsmostoftenaffectedbytheGUARDfunctionareWidth,Height,PinX,andPinY.

Guardingaformulainanycellpreventsthatcell'svaluefrombeingchangedbyactionsinthedrawingwindow.However,oneactioninthedrawingwindowcanaffectseveralcells,andeachofthesecellsmustbeguardedifyouwanttopreventunexpectedchangestotheshape'sappearance.

Example

GUARD(TEXTWIDTH(TheText)+0.5in)

ThisexpressionintheWidthcellofashape'sShapeTransformsectionpreventstheexpression(TEXTWIDTH(TheText)+0.5in)frombeingreplacedwithanothervaluewhentheshape'swidthischangedinthedrawingwindow.TheTextisacellthatgetstriggeredwhentheassociatedshape'stextcompositionchanges.

HELPfunction

OpensaWinHelporHTMLHelpfileanddisplaystheSearchdialogboxwiththeselectedkeyword.Oritdisplaysthepop-uphelptopicassociatedwithnumber,anumericIDreferencedintheMAPsectionoftheWinHelpprojectfile(.hpj)ortheHTMLHelpprojectfile(.hhp).

Syntax

HELP("filename.hlp!keyword")orHELP("filename.chm!keyword")HELP("filename.hlp!#number")orHELP("filename.chm#number")

Remarks

IfnokeywordorIDisspecified,theHELPfunctionopensthecontentspageofthehelpfile.

Example1

HELP("visio.hlp!shapesheet")orHELP("visio.chm!shapesheet")

OpensthefileVisio.hlporVisio.chmanddisplaysthetopicwhosekeywordis"shapesheet."

Example2

HELP("shape.hlp!#9000")orHELP("shape.chm#9000")

OpensthefileShape.hlporShape.chmanddisplaysthetopicassociatedwiththeID9000.

Seealso

HOURfunction

Returnsaninteger,0to23,representingthehourofthedayofdatetimeorexpression.

Syntax

HOUR("datetime"|expression[,lcid])datetime Astringcommonlyrecognizedasadateandtimeorareference

toacellcontainingadateandtime.expression Anexpressionthatyieldsadateandtime.lcid Optional.Alocaleidentifiertobeusedinevaluatinganonlocal

datetime.Thelocaleidentifierisanumberdescribedinthesystemheaderfiles.

Remarks

Thedatecomponentindatetimeandexpressionisdiscarded.

Noroundingisdone.Ifthedatetimeismissingorcannotbeconvertedtoavalidresult,thefunctionreturnsanerror.

Thereturnedvalueisformattedaccordingtothetimestylesetbythesystem'scurrentRegionalSettings.

TheHOURfunctionalsoacceptsasinglenumbervalueforexpressionwherethedecimalportionoftheresultrepresentsthefractionofadaysincemidnight.

Example1

HOUR("3:45PM")

Returns15.

Example2

Seealso

HOUR("May30,19973:45:24PM")

Returns15.

Example3

HOUR(0.5)

Returns12.

Example4

HOUR("5/30/1997")

Returns0.

HSLfunction

Returnsavaluerepresentinganindexinthedocument'scolorpalette.Itspecifiesacolorbyitshue,saturation,andluminositycomponents.

Syntax

HSL(hue,saturation,luminosity)hue Thecolor'shue,expressedasanumberintherange0to239,

inclusive,oranexpressionthatevaluatestosuchanumber.saturation Thecolor'ssaturation,expressedasanumberintherange0to

240,inclusive,oranexpressionthatevaluatestosuchanumber.

luminosity Thecolor'sluminosity,expressedasanumberintherange0to240,inclusive,oranexpressionthatevaluatestosuchanumber.

Remarks

Ifthecolorreturnedbythefunctiondoesnotalreadyexistinthecurrentdocument'scolorpalette,itisaddedtothedocument'slistofavailablecolors.

Thefollowingtablelistssomestandardcolorsandtheirhue,saturation,andluminosityvalues.

Color Huevalue Saturationvalue LuminosityvalueBlack 160 0 0Blue 160 240 120Green 80 220 120Cyan 120 240 120Red 0 240 120Magenta 200 240 120Yellow 40 240 120

Seealso

White 160 0 240

Example1

HSL(160,240,120)

Returnstheindexforthecolorblue.

Example2

HSL(HUE(FillForegnd),SAT(FillForegnd),MIN(LUM(FillForegnd)+100,240))

Returnstheindexforacolorthatmirrorsthefillforegroundcolorwithincreasedluminosity.

HUEfunction

Returnsthevalueofacolor'shuecomponent.

Syntax

HUE(expression)

Remarks

Thereturnvalueisanumberintherange0to239,inclusive.Theinputisanindexofacolorinthedocument'scolortable,anexpressionthatresolvestoacustomcolor(likeRGBorHSL),orareferencetoacellthatcontainsacolorindexorcolorresult.Thefunctionreturns0forinvalidinput.

Example1

HUE(Sheet.4!FillForegnd)

ReturnsthehueofSheet.4'sfillforegroundcolor.

Example2

HUE(7)

Returns120ifthedocumentusesthedefaultMicrosoftVisiocolorpalette,wherecyanisthecoloratindex7.

Example3

HUE(HSL(10,20,30))

Returns10.

Seealso

HYPERLINKfunction

Navigatestothespecifiedaddress,whichcanbeaDOS,UNC,orURLpath.

Syntax

HYPERLINK("address"[,"subaddress","extrainfo",window,"frame"])address AfullpathorarelativepathbasedontheHyperlinkbasefield

specifiedinthePropertiesdialogbox(clickPropertiesontheFilemenu).

subaddress Optionalstring.Specifiesalocationwithinaddresstolinkto.Forexample,ifaddressisaMicrosoftVisiofile,subaddresscanbeapagename;ifaMicrosoftExcelfile,subaddresscanbeaworksheetorrangewithinaworksheet;ifaURLforanHTMLpage,subaddresscanbeananchor.

extrainfo Optionalstring.PassesinformationusedinresolvingtheURL,suchasthecoordinatesofanimagemap.

window Optionalargument.Specifieswhetherthehyperlinkisopenedinanewwindow.ThedefaultvalueisFALSE.

frame Optionalstring.SpecifiesthenameofaframetotargetwhenVisioisopenasanActivedocumentinanActiveXbrowser,suchasMicrosoftInternetExplorer3.0orlater.Thedefaultisanemptystring.

Remarks

Ifthedocumenthasnobasepath,Visionavigatesaccordingtothedocumentpath.Ifthedocumenthasn'tbeensaved,thehyperlinkisundefined.

YoucanusetheGOTOPAGEfunctiontonavigatetopagesofadocument.

Example1

HYPERLINK("C:\MyDocuments\Drawing1.vsd")

Example2

HYPERLINK("\\Server\Share\Drawing1.vsd")

Example3

HYPERLINK("http://www.microsoft.com")

Example4

HYPERLINK("..\data.xls","sheet1!A1")

HYPERLINKBASEfunction

ReturnsthetextfromtheHyperlinkbasefieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

HYPERLINKBASE()

Seealso

IDfunction

Returnsashape'sinternalIDasanumber.

Syntax

Seealso

IFfunction

ReturnsvalueiftrueiflogicalexpressionisTRUE.Otherwise,itreturnsvalueiffalse.

Syntax

IF(logicalexpression,valueiftrue,valueiffalse)

Example

IF(Height>1.25in.,5,7)

Returns5iftheshape'sheightisgreaterthan1.25inches.Returns7iftheshape'sheightislessthanorequalto1.25inches.

Seealso

INDEXfunction

Returnsthesubstringatthezero-basedlocationindexinthelistdelimitedbydelimiter.Or,itreturns-1ifnotfound.

Syntax

INDEX(index,"list"[,[delimiter][,[errorvalue]]])index Thelocationthatyouwanttofind.list Thelistinwhichyouwanttosearch.delimiter Thestringtouseasadelimiterwithinlist.Adelimiterstring

canbemorethanonecharacterinlengthandincludemultibytecharacters.Thedefaultisasemicolon.

errorvalue Optional.Auser-specifiedvaluetoreturniftheindexisoutofrange.Thedefaultisanemptystring.

Remarks

Ifthelistbeginsorendswithadelimiter,anullstringisassumedtoexistbeforeorafterthelist.Consecutivedelimitersimplyanullstringinbetween.

Iftheindexisoutofrange,MicrosoftVisioreturnsanemptystringortheoptionaltokenprovidedastheerrorvalueargument.

Example1

INDEX(3,"cat;rat;;goat")

Returns"goat".

Example2

INDEX(54,";1;2;3;",,"ERROR")

Returns"ERROR."

Seealso

INTfunction

Roundsanumberdowntothenextinteger.

Syntax

INT(number)

Example1

INT(7.2)

Returns7.

Example2

INT(-7.2)

Returns-8.

Seealso

INTERSECTXfunction

Returnsthex-coordinate(inthelocalcoordinatesystem)ofthepointwheretwolinesintersect.Eachlineisdefinedasapoint(x,y)andanangle.

Syntax

INTERSECTX(x1,y1,angle1,x2,y2,angle2)x1 Thex-coordinateofapointonthefirstline.y1 They-coordinateofapointonthefirstline.angle1 ThevalueoftheAnglecellforthefirstline.x2 Thex-coordinateofapointonthesecondline.y2 They-coordinateofapointonthesecondline.angle2 ThevalueoftheAnglecellforthesecondline.

Remarks

MicrosoftVisiousesthisfunctioninthePinXcellofashapegluedtoarotatedguide.

Ifthelinesdon'tintersect,thefunctionreturnsadivide-by-zeroerror(#DIV/0!),whichVisioignores,restoringthelastknownvalueforthepoint.

Example

INTERSECTX(VertGuide!PinX,VertGuide!PinY,VertGuide!Angle,HorzGuide!PinX,HorzGuide!PinY,HorzGuide!Angle)

Returnsthex-coordinateoftheintersectionpointofVertGuideandHorzGuideinpageunits.

Seealso

INTERSECTYfunction

Returnsthey-coordinate(inthelocalcoordinatesystem)ofthepointwheretwolinesintersect.Eachlineisdefinedasapoint(x,y)andanangle.

Syntax

INTERSECTX(x1,y1,angle1,x2,y2,angle2)x1 Thex-coordinateofapointonthefirstline.y1 They-coordinateofapointonthefirstline.angle1 ThevalueoftheAnglecellforthefirstline.x2 Thex-coordinateofapointonthesecondline.y2 They-coordinateofapointonthesecondline.angle2 ThevalueoftheAnglecellforthesecondline.

Remarks

MicrosoftVisiousesthisfunctioninthePinYcellofashapegluedtoarotatedguide.

Ifthelinesdon'tintersect,thefunctionreturnsadivide-by-zeroerror(#DIV/0!),whichVisioignores,restoringthelastknownvalueforthepoint.

Example

INTERSECTY(VertGuide!PinX,VertGuide!PinY,VertGuide!Angle,HorzGuide!PinX,HorzGuide!PinY,HorzGuide!Angle)

Returnsthey-coordinateoftheintersectionpointofVertGuideandHorzGuideinpageunits.

Seealso

INTUPfunction

Roundsanumberuptothenextinteger.

Syntax

INTUP(number)

Example1

INTUP(3.2)

Returns4.

Example2

INTUP(-3.2)

Returns-3.

Example3

INTUP(3)

Returns3.

Seealso

ISERRfunction

ReturnsTRUEifthevalueofcellreferenceisanyerrortypeexcept#N/A;otherwise,itreturnsFALSE.TheISERRfunctionisusedinformulasthatrefertoanothercell.

Syntax

ISERR(cellreference)

Example1

Cell Formula ValuereturnedScratch.A1 =NA() #N/A!Scratch.B1 =ISERR(Scratch.A1) FALSE

ReturnsFALSEbecausethe#N/A!errorisnotrecognizedbytheISERRfunction.UseISERRORtofindallerrortypes.

Example2

Cell Formula ValuereturnedScratch.X1 ="House" #VALUE!Scratch.A1 =ISERR(Scratch.X1) TRUE

ReturnsTRUEbecausethe#VALUE!errorisrecognizedbytheISERRfunction.

ISERRNAfunction

ReturnsTRUEifthevalueofcellreferenceiserrortype#N/A!(notavailable);otherwise,itreturnsFALSE.TheISERRNAfunctionisusedinformulasthatrefertoanothercell.

Syntax

ISERRNA(cellreference)

Example1

Cell Formula ValuereturnedScratch.A1 ="5+3" "8"Scratch.B1 =ISERRNA(Scratch.A1) FALSE

ReturnsFALSEbecausethevaluereturnedisavailable.

Example2

Cell Formula ValuereturnedScratch.A1 =NA() #N/A!Scratch.B1 =ISERRNA(Scratch.A1) TRUE

ReturnsTRUEbecausethevaluereturnediserrortype#N/A!

Seealso

ISERRORfunction

ReturnsTRUEifthevalueofcellreferenceisanyerrortype;otherwise,itreturnsFALSE.TheISERRORfunctionisusedinformulasthatrefertoanothercell.

Syntax

ISERROR(cellreference)

Example1

Cell Formula ValuereturnedScratch.A1 =NA() #N/A!Scratch.B1 =ISERROR(Scratch.A1) TRUE

ReturnsTRUEbecausethe#N/A!errorisrecognizedbytheISERRORfunction.YoucanuseISERRtofindalltypesbutthe#N/A!error.

Example2

Cell Formula ValuereturnedScratch.X1 ="House" #VALUE!Scratch.B1 =ISERR(Scratch.X1) TRUE

ReturnsTRUEbecausethe#VALUE!errorisrecognizedbytheISERRORfunction.Tobuildanexpressionbasedonthe#VALUE!error,usetheISERRVALUEfunction.

ISERRVALUEfunction

ReturnsTRUEifthevalueofcellreferenceiserrortype#VALUE,whereanargumentintheformulaisthewrongtype.TheISERRVALUEfunctionisusedinlogicalexpressionsthatrefertoanothercell.

Syntax

ISERRVALUE(cellreference)

Remarks

ScratchcellsAthroughDwon'treturna#VALUE!errorbecausetheformulacancontainnumbersandlettersinthesamestring.CellsXandYmustcontainnumbersonly.

Example1

Cell Formula ValuereturnedScratch.X1 ="House" #VALUE!Scratch.A1 =If

(ISERRVALUE(Scratch.X1),2,Scratch.X1)2

Returns2becausethevaluereturnedisa#VALUE!error,andtheexpressioninstructsMicrosoftVisiotoreturna2inplaceoftheerror.

Example2

Cell Formula ValuereturnedScratch.A1 ="5+7" 5+7Scratch.B1 =If

(ISERRVALUE(Scratch.A1),2,Scratch.A1)5+7

Returns12becausethevaluereturnedisnota#VALUE!error,andtheexpressioninstructstheVisioapplicationtoreturnthevalueoftheoriginalcell.

Seealso

KEYWORDSfunction

ReturnsthetextfromtheKeywordsfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

KEYWORDS()

Seealso

LISTSEPfunction

Returnsthelistseparatorstringforthecurrentuserlocale.

Syntax

LISTSEP()

Example

SETF(GETREF(user.extent),"MAX(Width"&ListSep()&"Height)")

Seealso

LNfunction

Returnsthenaturallogarithmofanumber.Thenumbermustbepositive,orLNreturnstheerrorvalue#NUM.

Syntax

LN(number)

Example

LN(42)

Returns3.7377.

Seealso

LOCfunction

Takesapointdefinedinoneshape'slocalcoordinatesandreturnstheequivalentpointexpressedinthelocalcoordinatesoftheshapeassociatedwiththeformula.Localcoordinatesaremeasuredfromthelower-leftcorneroftheshape'sselectionrectangle.Bothshapesmustbeonthesamepage.

Syntax

LOC(point)

Example

LOC(PNT(Sheet.5!LocPinX,Sheet.5!LocPinY))

Inthisexpression,PNTconvertsasetoflocalcoordinatesinSheet.5toapoint.(Sheet.5isanothershapeonthesamedrawingpage.)LOCthenconvertsthatpointtoanequivalentpointinthecurrentshape'slocalcoordinatesystem,relativetothelower-leftcorneroftheselectionrectangleofthecurrentshape.

The5inSheet.5istheIDnumberfortheshape,whichisdisplayedintheSpecialdialogbox(clickSpecialontheFormatmenu).

Seealso

LOCTOLOCfunction

Returnsatransformedpointinlocalcoordinatesinthedestinationcoordinatesystem.

Syntax

LOCTOLOC(srcPoint,srcRef,dstRef)srcPoint Apointinlocalcoordinatesinthesourcecoordinatesystem.srcRef Areferencetoacellinthesourceobject.dstRef Areferencetoacellinthedestinationobject.

Remarks

TheLOCTOLOCfunctionconvertsapointfromlocalcoordinatesinasourceshapetolocalcoordinatesinadestinationshape.Youcanusethisfunctiontoconstructashape,forexample,intermsofapointfromanothercoordinatespace.Youcanalsousethisfunctiontotransformalocalpointtopagecoordinates,orviceversa.

Example

LOCTOLOC(PNT(LocPinX,LocPinY),Width,ThePage!PageWidth)

Convertsthelocalpinoftheshapeassociatedwiththeformulatoapointonthepage.

Seealso

LOCTOPARfunction

Returnsatransformedpointinparentcoordinatesinthedestinationcoordinatesystem.

Syntax

LOCTOPAR(srcPoint,srcRef,dstRef)srcPoint Apointinlocalcoordinatesinthesourcecoordinatesystem.srcRef Areferencetoacellinthesourceobject.dstRef Areferencetoacellinthedestinationobject.

Remarks

Convertsapointfromlocalcoordinatesinasourceshapetoparentcoordinatesinadestinationshape.YoucanusetheLOCTOPARfunctiontosetparentcoordinatesincells,suchasPinX,PinY,BeginX,andBeginYinashapeusinganotherpointfromanothercoordinatesystem.

Ifthedestinationisapage,whichhasnoparent,theresultisexpressedinthepage'slocalcoordinates.

Example

LOCTOPAR(PNT(LocPinX,LocPinY),Width,Sheet.4!Width)

ConvertsthelocalpinoftheshapeassociatedwiththeformulatoparentcoordinatesofSheet.4.

Seealso

LOG10function

Returnsthebase10logarithmofanumber.ThenumbermustbepositiveorLOG10returnstheerrorvalue#NUM.

Syntax

LOG10(number)

Example

LOG10(42)

Returns1.6232.

Seealso

LOOKUPfunction

Returnsazero-basedindexthatindicatesthelocationofthesubstringkeyinalist,orreturns-1ifthetargetstringcontainsthedelimiter.

Syntax

LOOKUP("key","list"[,"delimiter"])key Thestringthatyouwanttolookup.list Thelistinwhichyouwanttosearch.delimiter Thestringtouseasadelimiterwithinlist.Adelimiterstring

canbemorethanonecharacterinlengthandmayincludemultibytecharacters.Thedefaultisasemicolon.

Remarks

TheLOOKUPfunctionusesacase-insensitivesearch.Ifthelistbeginsorendswithadelimiter,anullstringisassumedtoexistbeforeorafterthelist.Consecutivedelimitersimplyanullstringinbetween.

Alltheargumentsmustbestringsorabletobeconvertedtostrings.Iftheyarenot,anemptystringissubstitutedfortheoffendingargument.

Example1

LOOKUP("rat","cat;rat;;goat")

Returns1.

Example2

LOOKUP("",";cat;rat;;goat")

Returns0.

Seealso

Example3

LOOKUP("t","cat;rat;;goat","a")

Returns3.

LOTUSNOTESfunction

BeginningwithMicrosoftVisio2002,thisfunctionisobsolete.

Remarks

InversionsearlierthanVisio2002,youcouldreturninformationreadfromLotusNotesintoyourformula.

Seealso

LOWERfunction

Returnsastringconvertedtolowercase.

Syntax

LOWER(expression)expression Astring,acellreference,oranexpression;theresultis

convertedtoastringwhichisthenconvertedtolowercase.

Remarks

Thecaseconversionislocalespecific,basedonthecurrentusersettings.

Example

LOWER("mIxEdCAse")

Returns"mixedcase".

Seealso

LUMfunction

Returnsthevalueofacolor'sluminositycomponent.

Syntax

LUM(expression)

Remarks

Thereturnvalueisanumberintherange0to240,inclusive.Theinputisanindexofacolorinthedocument'scolortable,orareferencetoacellthatcontainsacolorindex.Thefunctionreturns0forinvalidinput.

Example1

LUM(Sheet.4!FillForegnd)

ReturnstheluminosityofSheet.4'sfillforegroundcolor.

Example2

LUM(6)

Returns120ifthedocumentusesthedefaultVisiocolorpalette,wheremagentaisthecoloratindex6.

Example3

LUM(HSL(10,20,30))

Returns30.

Seealso

MAGNITUDEfunction

ReturnsthemagnitudeofthevectorwhoseriseisAandwhoserunisB,multipliedbytherespectiveconstantsconstantAandconstantB.MAGNITUDEiscalculatedaccordingtothefollowingformula:

SQRT((constantA*A)^2+(constantB*B)^2)

Syntax

MAGNITUDE(constantA,A,constantB,B)

Example

MAGNITUDE(1,3,1,4)

Returns5.

Seealso

MANAGERfunction

ReturnsthetextfromtheManagerfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

MANAGER()

Seealso

MASTERNAMEfunction

Returnsasheet'smasternameasastring,orthestring,"<nomaster>"ifthesheetdoesn'thaveamaster.

Syntax

MASTERNAME(langID_opt)langID_opt Optionalargument.Usetospecifyalanguageforthestringthe

Remarks

Seealso

MAXfunction

Returnsthelargestnumberfromalist.Largestmeansclosesttopositiveinfinity.

Syntax

MAX(number1,number2,...,numberN)

Example

MAX(13in.,1ft,20cm)

Returns13in.

Seealso

MINfunction

Returnsthesmallestnumberfromalist.Smallestmeansclosesttonegativeinfinity.

Syntax

MIN(number1,number2,...,numberN)

Example

MIN(13in.,1ft,20cm)

Returns20cm.

Seealso

MINUTEfunction

Returnsaninteger,0to59,representingtheminutescomponentofdatetimeorexpression.

Syntax

MINUTE("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Thedatecomponentindatetimeandexpressionisdiscarded.

Noroundingisdone.Ifdatetimeismissingorcannotbeconvertedtoavalidresult,thefunctionreturnsanerror.

Thereturnedvalueisformattedaccordingtothetimestylesetbythesystem'scurrentRegionalSettings.

TheMINUTEfunctionalsoacceptsasinglenumbervalueforexpressionwherethedecimalportionrepresentsthefractionofadaysincemidnight.

Example1

MINUTE("7/7/19993:45:24PM")

Returns45.

Example2

Seealso

MINUTE(TIMEVALUE("Jan.25,199912:07:45")+6em.)

Returns13.

Example3

MINUTE(0.575)

Returns48.

MODULUSfunction

Returnstheremainder(modulus)resultingwhenanumberisdividedbyadivisor.Theresulthasthesamesignasthedivisor.A#DIV/0!errorisreturnedifthedivisoris0.

Syntax

MODULUS(number,divisor)

Remarks

Inalmostallsituations,theMODULUSfunctionshouldbeusedratherthantheMODfunction.

Example1

MODULUS(5,1.4)

Returns0.8.

Example2

MODULUS(5,-1.4)

Returns-0.6.

Example3

MODULUS(-5,1.4)

Returns0.6.

Example4

MODULUS(-5,-1.4)

Seealso

Returns-0.8.

MONTHfunction

Returnsaninteger,1to12,representingamonth.

Syntax

MONTH("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Thetimecomponentofdatetimeorexpressionisdiscarded.

Noroundingisdone.Iftheinputstringismissingorcannotbeconvertedtoavalidresult,thisfunctionreturnsanerror.

Thereturnedvalueisformattedaccordingtotheshortdatestylesetbythesystem'scurrentRegionalSettings.

TheMONTHfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthenumberofdayssinceDecember30,1899.

Example1

MONTH("May30,19993:45:24PM")

Returns5.

Example2

Seealso

MONTH(DATEVALUE("May30,1999")+7ed.)

Returns6.

Example3

MONTH(35580.6337)

Returns5.

NAfunction

Returnstheerrorvalue#NA!.NAistheerrorvaluethatmeans"novalueavailable."

Syntax

Remarks

UsetheNAfunctioninaShapeSheetcellwhereinformationismissing,sothatthecell'sdefaultvalueisnotusedincalculations.

Seealso

NAMEfunction

Returnsasheet'snameasastring.

Syntax

NAME(langID_opt)langID_opt Optionalargument.Usetospecifyalanguageforthestringthe

Remarks

Seealso

NOTfunction

ReturnsTRUE(1)iflogicalexpressionisFALSE.Otherwise,itreturnsFALSE(0).

Syntax

NOT(logicalexpression)

Example

NOT(Height>0.75in.)

Returns1ifHeightislessthanorequalto0.75inches.Returns0ifHeightisgreaterthan0.75inches.

Seealso

NOWfunction

Returnsthecurrentdateandtimevalue.

Syntax

Remarks

NOWisautomaticallyrecalculatedeveryminute.

Example1

Returnsthecurrentdateandtime,suchas9/27/199912:03:30PM.

Example2

FORMAT(NOW(),"ddMMM.,yyyyhh:mm")

Returnsthecurrentdateandtimeformattedas27Sep.,199912:03.

Example3

NOW()+2EW.

Returnsthecurrentdateandtimeplustwoelapsedweeks,suchas10/11/9912:03:30PM.

Seealso

NURBSfunction

ReturnsanonuniformrationalB-spline(NURBS).ThisfunctionisusedintheEcellintheNURBSTogeometryrows.

Syntax

NURBS(knotLast,degree,xType,yType,x1,y1,knot1,weight1,…)knotLast Thelastknot.degree Thespline'sdegree.xType Specifieshowtointerpretthexinputdata.IfxTypeis0,the

inputx-dataisinterpretedasapercentageofWidth.IfxTypeis1,theinputx-dataisinterpretedasalocalcoordinate.

yType Specifieshowtointerprettheyinputdata.IfyTypeis0,theinputy-dataisinterpretedasapercentageofHeight.IfyTypeis1,theinputy-dataisinterpretedasalocalcoordinate.Specifieshowtointerpretthexandyinputdata,respectively.IfxTypeoryTypeis0,theinputdataisinterpretedasapercentageoftheheight.IfxTypeoryTypeis1,theinputdataisinterpretedasalocalcoordinate.

x1 Anx-coordinate.y1 Ay-coordinate.knot1 AknotontheB-spline.weight1 AweightontheB-spline.

Remarks

Foreveryxargument,theremustbeayargument,otherwiseanerrorisreturned.

Youmustspecifyanx,y,knot,andweightargument,otherwiseanerrorisreturned.

OPENFILEfunction

OpensaMicrosoftVisiodocument,ifit'snotalreadyopen,andactivatesthedocumentwindow.

Syntax

OPENFILE("filename")

Remarks

MultipleOPENFILEfunctioncallsarequeuedandexecutedinorderofevaluation.IfthecurrentVisiodocumentisactivatedforvisual(in-place)editing,anewVisioinstanceislaunchedwiththerequestedfilename.

ThisfunctionalwaysreturnsFALSE.

InearlierversionsoftheVisioapplication,thisfunctionappearsas_OPENFILE.Visioversions4.0andlateraccepteitherstyle.

Example

OPENFILE("basic.vss")

OpensthespecifiedstencilfileBasic.vssinanewwindow,oractivatesthewindowifthestencilisalreadyopen.

Seealso

OPENGROUPWINfunction

Opensthegroupinthegroupwindow.Iftheobjectisnotagroup,thisfunctiondoesnothing.

Syntax

OPENGROUPWIN()

Remarks

InearlierversionsofMicrosoftVisio,thisfunctionappearsas_OPENGROUPWIN.Visioversions4.0andlateraccepteitherstyle.

Seealso

OPENPAGEfunction

Displaysapagenameinnewwindow.

Syntax

OPENPAGE("pagename")

Remarks

Ifawindowisalreadydisplayingthepagewhosenameispagename,thatwindowbecomesactive.Ifthepagenamedoesnotexist,orifMicrosoftVisioisactingasanin-placeserver,theOPENPAGEfunctionhasnoeffect.

InearlierversionsofVisio,thisfunctionappearsas_OPENPAGE.Visioversions4.0andgreateraccepteitherstyle.

Seealso

OPENSHEETWINfunction

OpenstheShapeSheetwindowinanewwindow.

Syntax

OPENSHEETWIN()

Remarks

InearlierversionsofMicrosoftVisio,thisfunctionappearsas_OPENSHEETWIN.Visioversions4.0andlateraccepteitherstyle.

Seealso

OPENTEXTWINfunction

Openstheshape'stextblocksothatthetextcanbeedited.

Syntax

OPENTEXTWIN()

Remarks

InearlierversionsofMicrosoftVisio,thisfunctionappearsas_OPENTEXTWIN.Visioversions4.0andlateraccepteitherstyle.

Seealso

ORfunction

ReturnsTRUE(1)ifanyofthelogicalexpressionsareTRUE.

Syntax

OR(logicalexpression1,logicalexpression2,...,logicalexpressionN)

Remarks

Anyexpressionthatevaluatestoanon-zerovalueisconsideredTRUE.IfallofthelogicalexpressionsareFALSEorequal0,thisfunctionreturnsFALSE.

Example

OR(Height>1,PinX>1)

ReturnsTRUE(1)ifeitherexpressionisTRUE.ReturnsFALSE(0)onlyifbothexpressionsareFALSE.

Seealso

PAGECOUNTfunction

Returnsthenumberofforegroundpagesinadocument.

Syntax

PAGECOUNT()

Seealso

PAGENAMEfunction

Returnsthepagenameasastring.

Syntax

PAGENAME(langID_opt)langID_opt Optionalargument.Usetospecifyalanguageforthestringthe

Remarks

Seealso

PageNumberfunctionReturnsthenumberofthepagethatcontainstheshape.

Syntax

PageNumber()

Remarks

Ifthecurrentpageisabackgroundpage(unnumbered),orifanerroroccurs,thePageNumberfunctionreturnszero.

PARfunction

Returnsthex,ycoordinatesofapointinthecoordinatesystemoftheshape'sparent.

Syntax

PAR(point)

Remarks

InMicrosoftVisio,apointisasinglevaluethatembodiesapairofx-andy-coordinates.Iftheshapeisinagroup,itsparentisthegroup.Iftheshapeisnotinagroup,itsparentisthepage.

Example

PAR(PNT(PinX,PinY))

Inthisexpression,PNTconvertsapairofcoordinatesinthecurrentshapeintoapoint.PARthenconvertsthepointintoapairofcoordinatesinrelationtothelower-leftcornerofthepageorgroupthatcontainsthecurrentshape.

Seealso

PIfunction

Returnsthemathematicalconstantpi,whichis3.1415926535898.

Syntax

Example

(14in./2)^2*PI()

Returns153.9380in.,theareaofacirclewhosediameteris14inches.

Seealso

PLAYSOUNDfunction

Playsasoundfileorsystemsound.

Syntax

PLAYSOUND("filename"|"alias",isAlias,beep,synch)filename Thenameofthesoundfileyouwanttoplay.alias Asystemsoundrepresentedbyanalias.isAlias Specifieswhethertheprecedingexpressionisanaliasorfile

name;useanon-zerovaluetospecifyanalias.beep SpecifieswhetherMicrosoftVisiobeepswhensoundcan'tbe

played;useanon-zeronumbertobeep.synch Determineswhethersoundsareplayedasynchronously(0)or

synchronously(1).

Remarks

SoundsshouldusuallybeplayedasynchronouslysoVisiocancontinueprocessingwhilethesoundisbeingplayed.Tostringseveralsoundstogether,playthemsynchronouslyorsomemightfailtoplay.

Example1

PLAYSOUND("chord.wav",0,0,0)

Playsthewaveaudiofilechord.wavasynchronouslywithnowarningbeep.

Example2

PLAYSOUND("SystemExclamation",1,0,0)

Playsthesystemexclamationsoundasynchronouslywithnowarningbeep.

Seealso

PNTfunction

Returnsthepointrepresentedbythecoordinatesxandyasasinglevalue.

Syntax

PNT(x,y)

Remarks

Convertingcoordinatestopointsallowsyoutochangeashape'sgeometrywithouthavingtomanipulatex-andy-coordinatesseparately.

Example

PNT(PinX,PinY)

ReturnsthepointrepresentedbyPinXandPinY.

Seealso

PNTXfunction

Returnsthex-coordinateofapoint.

Syntax

PNTX(point)

Example

PNTX(PNT(7,12))

Returns7.

Seealso

PNTYfunction

Returnsthey-coordinateofapoint.

Syntax

PNTY(point)

Example

PNTY(PNT(7,12))

Returns12.

Seealso

POLYLINEfunction

Returnsapolyline.ThisfunctionisusedintheAcellofPolyLineTogeometryrows.

Syntax

POLYLINE(xType,yType,x1,y1…)xType Specifieshowtointerpretthexinputdata.IfxTypeis0,the

inputx-dataisinterpretedasapercentageofWidth.IfxTypeis1,theinputx-dataisinterpretedasalocalcoordinate.

yType Specifieshowtointerpretthey-inputdata.IfyTypeis0,theinputy-dataisinterpretedasapercentageofHeight.IfyTypeis1,theinputy-dataisinterpretedasalocalcoordinate.

x1 Anx-coordinate.y1 Ay-coordinate.

Remarks

Foreveryxargument,theremustbeayargument,otherwiseanerrorisreturned.

Example

POLYLINE(0,0,0,0,0,1,1,1,1,0,0,0)

ReturnsarectangleusingWidthxHeight.

Seealso

POWfunction

Returnsanumberraisedtothepowerofanexponent.

Syntax

POW(number,exponent)

Remarks

Bothnumberandexponentmaybenon-integers,andtheymaybenegative.Ifnumberisnot0andexponentis0,thisfunctionreturns1.Ifnumberis0andexponentisnegative,thisfunctionreturns0.0.Ifbothnumberandexponentare0,orifnumberisnegativeandexponentisnotaninteger,thisfunctionreturns0.0.

Example

POW(5,2)

Returns25.

Seealso

RADfunction

Convertsthevalueofananglefromdegreestoradians.

Syntax

RAD(angle)

Example

RAD(45)

Returns0.7854.

Seealso

RANDfunction

Returnsarandomfloatingpointnumberfrom0.0to1.0.Itreturnsadifferentnumbereachtimethefunctionisevaluated,whichisonceperminuteaccordingtothesystemclock.

Syntax

RAND()

Remarks

Usethisfunctiontocreateanimationeffectsbysettingshapes'propertiestorandomvalues.

Example

RAND()

Returnsadecimalfractionsuchas0.3503.

Seealso

RECTSECTfunction

Calculatesthesectorofarectangleassociatedwithxandyandreturnsaninteger0to4,indicatingthesector.

Syntax

RECTSECT(width,height,x,y,option)width Widthoftherectangle.height Heightoftherectangle.x Anx-coordinate.y Ay-coordinate.option Specifieshowpointsthatfallonthediagonalsaretreated.Set

thevalueto0tousetheleftandrightsectorsforpointsonadiagonal.Setthevalueto1tousethetopandbottomsectorsforpointsonadiagonal.

Remarks

Considerarectanglethathasawidthandaheight,andapoint(x,y)fromthecenterpointoftherectangle.Drawdiagonallinesthroughthecornersoftherectangletodivideitintofoursectorsandacenterpoint.Thesectors0through4representthecenter-point,right,top,left,andbottomrespectively.

Example

RECTSECT(1in.,2in.,1in.,-7in.,0)

Returns4.

Seealso

REDfunction

Returnstheredcomponentofacolor.Thereturnvalueisanintegerintherangeof0to255,inclusive.Theinputisanindexofacolorinthedocument'scolortable,anexpressionthatresolvestoacustomcolor(likeRGBorHSL),orareferencetoacellthatcontainsacolorindexorcolorresult.Thefunctionreturns0forinvalidinput.

Syntax

RED(expression)

Remarks

Thereturnvalueisanumberintherange0to255,inclusive,oracellreferencethatresolvestoanindex.Ifexpressionisinvalid,thisfunctionreturns0(black).

Example1

RED(22)

Returns51ifthedocumentusesthedefaultMicrosoftVisiocolorpalette,wheredarkgrayisthecoloratindex22.

Example2

RED(Char.Color)

Returnsthevalueoftheredcomponentofthecurrentfontcolor.

Example3

RED(RGB(10,20,30))

Returns10.

Seealso

REFfunctionTheREFfunctionreturnstheerrorvalue#REF!.

Syntax

Example

Returns#REF!.

RGBfunction

Returnsavaluerepresentinganindexinthedocument'scolorpalette.Itspecifiesacolorbyitsred,green,andbluecomponents,whereeachisanumberintherange0to255,inclusive,oranexpressionthatevaluatestosuchanumber.

Syntax

RGB(red,green,blue)

Remarks

Ifthecolorreturnedbythefunctiondoesnotalreadyexistinthecurrentdocument'scolorpalette,itisaddedtothepalette.

Thefollowingtablelistssomestandardcolorsandtheirred,green,andbluevalues.

Color Redvalue Greenvalue BluevalueBlack 0 0 0Blue 0 0 255Green 0 255 0Cyan 0 255 255Red 255 0 0Magenta 255 0 255Yellow 255 255 0White 255 255 255

Example1

RGB(0,0,255)

Returnstheindexforthecolorblue.

Seealso

Example2

RGB(RED(Sheet.1!FillForegnd),120,0)

ReturnstheindexforacolorwhoseredcomponentmirrorsSheet.1'sfillforeground.

ROUNDfunction

Roundsanumbertotheprecisionrepresentedbynumberofdigits.

Syntax

ROUND(number,numberofdigits)

Remarks

Ifnumberofdigitsisgreaterthan0,numberisroundedbynumberofdigitstotherightofthedecimal.Ifnumberofdigitsis0,numberisroundedtoaninteger.Ifnumberofdigitsislessthan0,numberisroundedbynumberofdigitstotheleftofthedecimal.

Example1

ROUND(123.654,2)

Returns123.65.

Example2

ROUND(123.654,0)

Returns124.

Example3

ROUND(123.654,-1)

Returns120.

Seealso

RUNADDONfunction

Executesanadd-onorpassescodetobeexecutedtotheMicrosoftVisualBasicforApplications(VBA)projectofthedocumentcontainingtheoperand.

Syntax

RUNADDON("string")string Thenameofanadd-onoralineofcodethatVBArecognizes,

suchasthenameofamacro,aprocedurewitharguments,oracommandthattheVBAImmediatewindowcanexecute.

Remarks

Iftheprojectcannotexecutestring,MicrosoftVisiorunstheadd-onnamedstring.Ifnoadd-onnamedstringcanbefound,Visiodoesnothingandreportsnoerror.

InearlierversionsofVisio,thisfunctionappearsas_RUNADDON.Visioversions4.0andlateraccepteitherstyle.

BeginningwithMicrosoftVisio2002,evaluationofRUNADDONdoesnotcreateanewproject.Inearlierversions,aVBAprojectwascreatedintheoperand'sdocumentifnoprojectexistedalready.Forexample,inVisio2002,theevaluationof=RUNADDON("msgbox""hello""")showsthemessageboxifthedocumentcontainsaproject;otherwise,itdoesnothing.YoucancreateadocumentprojectbyopeningtheVisualBasicEditorwhenthedocumentisopen.

NoteVBAcodeinvokedasaresultofaVisioinstanceevaluatingaRUNADDONoperandinaformulashouldnotusetheDocument.Closemethodtoclosethedocumentcontainingthefunction'scellbecauseanapplicationerrorresultsandVisioterminates.

IfyouneedtoclosethedocumentcontainingthecellthatusestheRUNADDON

Seealso

function,useoneofthefollowingtechniques:

Example1

RUNADDON("Calendar.exe")

LaunchestheCalendar.exeadd-on.

Example2

RUNADDON("summation1,2,3")

CallstheVBAprocedurenamedsummationandpassesthreearguments.

Example3

RUNADDON("debug.print""xyz""")

Prints"xyz"intheVBAImmediatewindow.

Example4

RUNADDON("ThisDocument.Save")

Savesthedocumentcontainingthefunction.

RUNADDONWARGSfunction

Runsfilenameandpassesthecommandlineargumentstotheprogramasastring.

Syntax

RUNADDONWARGS("filename","arguments")

Remarks

Inpractice,argumentsshouldbe50charactersorfewer.UsetheRUNADDONWARGSfunctiontobindaprogram,suchasanadd-on,toanActioncell.

InearlierversionsofMicrosoftVisio,thisfunctionappearsas_RUNADDONWARGS.Visioapplicationversions4.0andlateraccepteitherstyle.

NoteVBAcodeinvokedasaresultoftheVisioinstanceevaluatingaRUNADDONWARGSfunctioninaformulashouldnotclosethedocumentcontainingthecellusingthefunctionbecauseanapplicationerrorresultsandVisioterminates.

IfyouneedtoclosethedocumentcontainingthecellthatusestheRUNADDONWARGSfunction,useoneofthefollowingtechniques:

Example

RUNADDONWARGS("GRAPHMKR.EXE","/GraphMaker=Stack")

Launchestheadd-onGraphmkr.exeandpassesittheargument/GraphMaker=Stack.

SATfunction

Returnsthevalueofacolor'ssaturationcomponent.

Syntax

SAT(expression)

Remarks

Thereturnvalueisanumberintherange0to240,inclusive.Theinputisanindexofacolorinthedocument'scolortable,anexpressionthatresolvestoacustomcolor(likeRGBorHSL),orareferencetoacellthatcontainsacolorindexorcolorresult.Thefunctionreturns0forinvalidinput.

Example1

SAT(Sheet.4!FillForegnd)

ReturnsthesaturationofSheet.4'sfillforegroundcolor.

Example2

SAT(8)

Returns240ifthedocumentusesthedefaultMicrosoftVisiocolorpalette,wheredarkredisthecoloratindex8.

Example3

SAT(HSL(10,20,30))

Returns20.

Seealso

SECONDfunction

Returnsaninteger,0to59,representingthesecondscomponentofdatetimeorexpression.

Syntax

SECOND("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Thedatecomponentindatetimeorexpressionisdiscarded.

Noroundingisdone.Ifdatetimeismissingorcannotbeconvertedtoavalidresult,thisfunctionreturnsanerror.

TheSECONDfunctionalsoacceptsasinglenumbervalueforexpressionwherethedecimalportionoftheresultrepresentsthefractionofadaysincemidnight.

Example1

SECOND("05/30/19973:45:32PM")

Returns32.

Example2

SECOND(TIMEVALUE("May30,199612:07:45")+7es.)

Seealso

Returns52.

Example3

SECOND(0.6337)

Returns32.

SETFfunction

Setsacell'sformula.

Syntax

SETF(GETREF(cell),formula)SETF(GETREF(cell),"formula")SETF(GETREF(cell),"""formula""")SETF("cell",formula)SETF("cell","formula")SETF("cell","""formula""")

Remarks

Whenevaluated,theresultoftheexpressioninformulabecomesthenewformulaincell.Ifformulaisenclosedinquotationmarks,thequotedexpressioniswrittentocell.Tosetcelltoastring,encloseformulainthreesetsofquotationmarks.

ThetargetcellmustbespecifiedusingaGETREF()referenceorasastringtoavoidcircularity.UsingGETREFispreferred,becauseMicrosoftVisiocanadjustreferenceswhentheshapeismovedtoadifferentdocument.

IfcellisnotspecifiedusingGETREForasastring,thefunctionreturnsanerror,andnocell'sformulaischanged.Ifformulacontainsasyntaxerror,thefunctionreturnsanerror,andtheformulaincellisnotchanged.

Example1

SETF(GETREF(Scratch.A1),1.5in.*6+1ft.)

SetstheformulaofScratch.A1to21in.

Example2

Seealso

SETF(GETREF(Scratch.A1),"1.5in.*6+1ft.")

SetstheformulaofScratch.A1totheexpression1.5in.*6+1ft.

Example3

SETF(GETREF(Scratch.A1),"""Say""""ahh""""""")

SetstheformulaofScratch.A1tothestring"Say""ahh"""whichevaluatestoSay"ahh".

SHAPETEXTfunction

Retrievesthetextfromashape.

Syntax

SHAPETEXT(shapename!TheText,flag)shapename!TheText AreferencetothecellnamedTheTextinthetargetshape.

Shapename!isthenameoftheshapefromwhichyouwanttoretrievethetext.

flag Optional.Abitthatspecifiestheformatofthetext.Thedefaultflag(0)showsthetextexactlyasitisshownintheshape.

Remarks

YoucanuseanycombinationofthefollowingflagswiththeSHAPETEXTfunction.

Flag Description0 Showtextexactlyasshowninshape.1 Includediscretionaryhyphens.2 Don'tincludeexpandedtextinfields.4 Converttabstoasinglespace.8 Converttabstoasetofspaces.16 Convertcarriagereturnsandlinefeedstospaces.32 Converttypographerquotestoregularquotes.64 Convertadjacentwhitespacetoasinglespace.

Example1

SHAPETEXT(sheetN!theText)

ReturnsthetextoftheshapenamedsheetN,exactlyasitisshownintheshape.

Seealso

Example2

SHAPETEXT(theText)

Returnsthetextofthecurrentshapeexactlyasitisshownintheshape.

Example3

SHAPETEXT(theText,84)

Returnsthetextofthecurrentshape.Italsoconvertsadjacentwhitespacetoasinglespace(64),convertscarriagereturnsandlinefeedstospaces(16),andconvertstabstoasinglespace(4).Thesumoftheseflagsis84.

SIGNfunction

Returnsavaluethatrepresentsthesignofanumber.

Syntax

SIGN(number,fuzz)number Thenumberforwhichyouwanttodeterminethesign.fuzz Optional.Specifieshowclosetozerothenumbermustbein

ordertobeconsideredequaltozero.

Remarks

TheSIGNfunctionreturns1ifnumberispositive,0ifnumberiszero,or-1ifnumberisnegative.

Fuzzhelpsavoidfloating-pointroundofferrorswhenacalculationisalmostzero.Ifyoudonotspecifyafuzzvalue,MicrosoftVisiouses1E-9(0.000000001).Youmaywanttosupplyadifferentvaluewhenyouscaledrawingsorwhenyouwantanexactcomparison.

Example1

SIGN(-5)

Returns-1.

Example2

SIGN(0)

Returns0.

Example3

Seealso

SIGN(0.00000000001)

Returns0.

Example4

SIGN(0.00000000001,0)

Returns1.

SINfunction

Returnsthesineofanangle.

Syntax

SIN(angle)

Remarks

TheSINfunctionusesradiansunlessaunitofmeasureisspecifiedwithangle.

Example

SIN(45degrees)

Returns0.7071.

SINHfunction

Returnsthehyperbolicsineofanangle.

Syntax

SINH(angle)

Remarks

TheSINHfunctionusesradiansunlessaunitofmeasureisspecifiedwithangle.

Example

SINH(45degrees)

Returns0.8687.

SQRTfunction

Returnsthesquarerootofanumber.

Syntax

SQRT(number)

Remarks

Ifnumberisnegative,theSQRTfunctionreturnstheerrorvalue#NUM!.

Example

SQRT(2)

Returns1.4142.

Seealso

STRSAMEfunction

Determineswhetherstringsarethesame.ItreturnsTRUEiftheyarethesameandFALSEiftheyaren't.Tocomparemulti-bytestringsortodocomparisonsusingcaserulesforaspecificlocaleusetheSTRSAMEEXfunction.

Syntax

STRSAME("string1","string2",ignoreCase)string1 Thefirststringtocompare.string2 Thesecondstringtocompare.ignoreCase Optional.ABooleanvariable.TRUEtoignorethecaseand

FALSEtocomparethecase.ThedefaultisFALSE.

Example1

STRSAME("cat","dog")

ReturnsFALSE.

Example2

STRSAME("cat","cat")

ReturnsTRUE.

Example3

STRSAME("cat","cat",TRUE)

ReturnsTRUE.

Example4

STRSAME("cat","CAT")

ReturnsFALSE.

Example5

STRSAME("cat","CAT",TRUE)

ReturnsTRUE.

Example6

STRSAME("cät","CAT",TRUE)

ReturnsFALSE.

Example7

STRSAME("cät","CÄT",TRUE)

ReturnsTRUE.

STRSAMEEXfunction

Determineswhetherstringsarethesame.ItreturnsTRUEiftheyarethesameandFALSEiftheyaren't.Usethisfunctiontocomparemulti-bytestringsortodocomparisonsusingcaserulesforaspecificlocale.

Syntax

STRSAMEEX("string1","string2",localeID,flag)string1 Thefirststringtocompare.string2 Thesecondstringtocompare.localeID ThelocaleIDcode.flag Abitthatspecifiesthetypeofcomparison.

Remarks

YoucanuseacombinationofanyofthefollowingflagswiththeSTRSAMEEXfunction.

Flag Description1 Ignorecase.2 Ignorenon-spacingcharacters.4 Ignoresymbols.4096 Treatpunctuationthesameassymbols.65536 Don'tdifferentiatebetweenHiraganaandKatakana

characters.131072 Don'tdifferentiatebetweenasingle-bytecharacterandthe

samecharacterasadouble-bytecharacter.

Seealso

SUBJECTfunction

ReturnsthetextfromtheSubjectfieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

SUBJECT()

Seealso

SUMfunction

Returnsthesumofalistofnumbers.

Syntax

SUM(number1,number2,...,number14)

Example

SUM(5,7,12)

Returns24.

Seealso

TANfunction

Returnsthetangentofanangle.

Syntax

TAN(angle)

Remarks

TheTANfunctionusesradiansunlessaunitofmeasureisspecifiedwithangle.

Example

TAN(45degrees)

Returns1.

Seealso

TANHfunction

Returnsthehyperbolictangentofanangle.

Syntax

TANH(angle)

Remarks

TheTANHfunctionusesradiansunlessaunitofmeasureisspecifiedwithangle.

Example

TANH(-45)

Returns-0.6558.

TEXTHEIGHTfunction

Returnstheheightofthecomposedtextinashapewherenotextlineexceedsmaximumwidth.

Syntax

TEXTHEIGHT(shapename!TheText,maximumwidth)shapename! Anamethatreferstothetextofashapeotherthanthecurrent

shape.Defaultequalsthecurrentshape.TheText Acellthatgetstriggeredwhentheassociatedshape'stext

compositionchanges.maximumwidth Optional.Themaximumwidthofthetextblock.

Remarks

Thereturnedvalueincludestheheightofthetextincludingthespacebeforeandaftertext,thelinespacingintext,andthetopandbottomtextblockmargins.Thisfunctioniscommonlyusedtoadjusttheheightofashapetofitthetextitcontains.

Example

TEXTHEIGHT(TheText,(Width-0.5in.))

Returnstheheightofthetextwhenwrappedtothewidthoftheshapeminus0.5inches.

TEXTWIDTHfunction

Returnsthewidthofthecomposedtextinashape.

Syntax

TEXTWIDTH(shapename!TheText,maximumwidth)shapename! Anamethatreferstothetextofashapeotherthanthecurrent

shape.Defaultequalsthecurrentshape.TheText Acellthatgetstriggeredwhentheassociatedshape'stext

compositionchanges.maximumwidth Optional.Themaximumwidthofthetextblock.

Remarks

TheTEXTWIDTHfunctioniscommonlyusedtoadjustthewidthofashapetofitthetextitcontains.

Ifmaximumwidthisspecified,theresultisthelongestlineoftextthatfitswithinmaximumwidth.Ifmaximumwidthisomitted,theresultisthetotalwidthofthetext.

Example

TEXTWIDTH(TheText)

Returnsthetotallengthofthetextinthecurrentshape.

Seealso

TIMEfunction

Returnsthetimerepresentedbyhour,minute,andsecond.

Syntax

TIME(hour,minute,second)

Example1

TIME(15,30,30)

Returnsthevaluerepresenting3:30:30PM.

Example2

FORMAT(TIME(15,30,30),"HH:mm")

Returnsthevaluerepresenting15:30.

Example3

TIME(15,30,30)+8eh.

Seealso

TIMEVALUEfunction

Returnsthetimevaluerepresentedbydatetimeorexpression.

Syntax

TIMEVALUE("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Anydatecomponentindatetimeorexpressionisdiscarded.

Ifdatetimeismissingorcannotbeconvertedtoavalidresult,thisfunctionreturnsa#VALUE!error.

TheTIMEVALUEfunctionalsoacceptsasinglenumbervalueforexpressionwherethedecimalportionoftheresultrepresentsthefractionofadaysincemidnight.

Example1

TIMEVALUE("6:00AM")

Returnsthevaluerepresenting6:00AM.

Example2

TIMEVALUE("14:30")+4eh.+30em.

Seealso

Example3

TIMEVALUE("11AM,July1,1997")

Returnsthevaluerepresenting11:00AM.

Example4

TIMEVALUE(0.6337)

Example5

TIMEVALUE("7:89")

Returnsa#VALUE!error.

TITLEfunction

ReturnsthetextfromtheTitlefieldofadocument'sproperties(clickPropertiesontheFilemenu).

Syntax

TITLE()

Seealso

TRUNCfunction

Returnsanumbertruncatedtonumberofdigits.

Syntax

TRUNC(number,numberofdigits)

Remarks

Ifnumberofdigitsisgreaterthan0,numberistruncatedtonumberofdigitstotherightofthedecimal.Ifnumberofdigitsis0,numberistruncatedtoaninteger.Ifnumberofdigitsislessthan0,numberistruncatedtonumberofdigitstotheleftofthedecimal.

Example1

TRUNC(123.654,2)

Returns123.65.

Example2

TRUNC(123.654,0)

Returns123.

Example3

TRUNC(123.654,-1)

Returns120.

Seealso

TYPEfunction

Returnsanobject'sinternaltypeasanumber.

Syntax

TYPE()

Remarks

Thefollowingtablelistsinternalobjecttypesanumbers.

Object NumberPage 70Group 71Shape 72Style 74Guide 77Foreign 78Document 79

Seealso

TYPEDESCfunction

Returnsadescriptivestringforanobject'sinternaltype.

Syntax

TYPEDESC()

Remarks

Thefollowingtablelistsstringsforinternalobjects.

Object StringPage "PageSheet"Group "Group"Shape "Shape"Style "Style"Guide "Guide"Foreign(metafile) "Metafile"Foreign(bitmap) "Bitmap"Foreign(OLElink) "OLELinkedObject"Foreign(OLEembeddedobject) "OLEEmbeddedObject"Foreign(OLEcontrol) "Control"Document "DocumentSheet"Unknown "Shape"

Seealso

UPPERfunction

Returnsastringconvertedtouppercase.

Syntax

UPPER(expression)expression Astring,acellreference,oranexpression;theresultis

convertedtoastringwhichisthenconvertedtouppercase.

Remarks

Thecaseconversionislocalespecific,basedonthecurrentusersettings.

Example

UPPER("mIxEdCAse")

Returns"MIXEDCASE".

Seealso

USEfunction

Appliesthelinepattern,fillpattern,orlineendcallednametotheshapewhenplacedintheLinePattern,FillPattern,BeginArrow,orEndArrowcell.Thisfunctionalwaysreturns254.

Syntax

USE("name")name Anystringthatisavalidmastername.

Remarks

Ifamasterwithnameispresentonadocumentstencilofthedocument,thepatternisappliedasalinepattern,fillpattern,beginarrow,orendarrow.

Example

USE("RailroadTracks")

FormatstheshapebyapplyingthemasterpatternnamedRailroadTrackstotheshapecontainingtheformula.

USERUIfunction

Evaluatesoneofthetwoexpressionsdependingonthevalueofstate.

Syntax

USERUI(state,defaultexpression,userexpression)

Remarks

Ifstateis0,theUSERUIfunctionevaluatesthedefaultexpression.Ifstateis1,itevaluatestheuserexpression.

Example

USERUI(1,if(Width>6in.,6in.,Width),Width*0.75)

EvaluatestheexpressionWidth*.075andreturnstheresult.

Seealso

WEEKDAYfunction

Returnsaninteger,1to7,representingtheweekdayindatetimeorexpression.

Syntax

WEEKDAY("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Thetimecomponentindatetimeorexpressionisdiscarded.

TheresultcorrespondstoMonday(1)throughSunday(7).Noroundingisdone.Ifdatetimeismissingorcannotbeinterpretedasavaliddateortime,thefunctionreturnsa#VALUE!error.

TheWEEKDAYfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthenumberofdayssinceDecember30,1899.

Example1

WEEKDAY("May30,1999")

Returns5.

Example2

WEEKDAY(DATEVALUE("May30,1999")+2ed.)

Seealso

Returns7.

Example3

WEEKDAY(35880.6337)

Returns5.

YEARfunction

ReturnsanintegerrepresentingtheGregorianyearindatetimeorexpressionformattedaccordingtotheshortdatestylesetbythesystem'scurrentRegionalSettings.

Syntax

YEAR("datetime"|expression[,lcid])datetime Anystringcommonlyrecognizedasadateandtimeora

Remarks

Thetimecomponentindatetimeorexpressionisdiscarded.

Noroundingisdone.Ifdatetimeismissingorcannotbeinterpretedasavaliddateortime,returnsanerror.

TheYEARfunctionalsoacceptsasinglenumbervalueforexpressionwheretheintegerportionoftheresultrepresentsthenumberofdayssinceDecember30,1899.

Example1

YEAR("10/27/19993:45:24PM")

Returns1999.

Example2

Seealso

YEAR(DATEVALUE("Dec.25,1998")+7ed.)

Returns1999.

Example3

YEAR(35580.6337)

Returns1997.

ArcTorow(Geometrysection)

Containsthex-andy-coordinatesandbowofacirculararc.

AnArcTorowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateoftheendingvertexofanarc.Y They-coordinateoftheendingvertexofanarc.A Thedistancefromthearc'smidpointtothemidpointof

itschord.

Remarks

ArcsdrawninMicrosoftVisioareellipticalarcs,eveniftheyarebasedonacircle.Bydefault,drawnarcsarerepresentedbyanEllipticalArcTorowinaShapeSheetwindow.ToshowanArcTorowinaShapeSheetwindow,youmustdrawanarc,andthenchangetheEllipticalArcTorowtypetoanArcTorowtype;ineffectyouarechanginganellipticalarctoacirculararc.

Tochangearowtype,right-clickarow,andthenclickChangeRowTypeontheshortcutmenu.

Connections.Rowrow(ConnectionPointssection)

Containsthex-andy-coordinates,horizontalandverticaldirection,andtypeforasingleconnectionpointonashape.Coordinatesofconnectionpointsaremeasuredfromtheoriginoftheshape.

AConnections.Rowrowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateforaconnectionpointinlocalcoordinates.Y They-coordinateforaconnectionpointinlocalcoordinates.DirX/A Thex-componentfortherequiredalignmentvectorofa

matchingconnectionpoint.Itisalsousedtoorienttheattachedlegofadynamicconnector.Thiscelltakesafloatingpointvalue.

DirY/B They-componentfortherequiredalignmentvectorofamatchingconnectionpoint.Itisalsousedtoorienttheattachedlegofadynamicconnector.Thiscelltakesafloatingpointvalue.

Type/C Theconnectionpointtype(0=inward;1=outward;2=inward

Seealso

+outward).D Ascratchcellthatyoucanuseforenteringortestingformulas.

Toaccessthiscell,right-clickarow,andthenclickChangeRowTypeontheshortcutmenu.

Remarks

CellsintheConnections.RowrowarelabeledDirX/A,DirY/B,andType/Cbecausetheserowscanbeextendedornon-extendedrows.

Mostconnectionpoints(allconnectionpointscreatedthroughtheuserinterface)arenon-extendedandhaveDirX,DirYandTypecells.TheirrowtypeisvisTagCnnctPtorvisTagCnnctNamed.

Innon-extendedrowstheDirXandDirYcellstogetherdefineadirectionvectorthatinfluencestherotationofshapesinvolvedinconnectionsusingtheconnectionpoint.Ifbotharezerothepointisdirectionless.Connectionpointsareoftype

Inward(0),whichmeansthatshapesgluetothem.Thisisthedefault.

Outward(1),whichmeanstheseconnectionpointswillgluetoinwardconnectionpoints.

Bothinwardandoutward(2),inwhichcasethedirectionistheinwarddirection,whichisreversedifusedasanoutwardconnection.

ExtendedrowshaveA,B,C,andDcellsandbehavelikedirectionlessnon-extendedrowsoftypeInward.Extendedrowsarenotcommonlyused,butyoumightusethemtoassociatedatawithaconnectionpointintheA,B,CandD,cells.TheirrowtypeisvisTagCnnctPtABCDorvisTagCnnctNamedABCD.ExtendedrowscanbeidentifiedbythepresenceofaformulaintheDcell.

Youcanreferenceconnectionrowcellsbytheirrowname,whichappearsinaShapeSheetwindowinredtext.Tochangetherowname,clickit,andthentypeCustom,forexample,tocreatetherownameConnections.Custom.YoucanthenreferencetheXcellusingConnections.Custom.X,forexample,orConnections.X1ifyouwanttousetherownumber.

Therownameyouentermustbeuniquewithinthesection.Whenyoucreatea

nameforonerowintheConnectionPointssection,MicrosoftVisionamesalltherowsinthesectionwiththedefaultname,Connections.Row_n.

NamedconnectionpointrowsarenotcompatiblewithversionsofVisioearlierthan5.0.WhensavingaVisiodrawingfilewithnamedconnectionpointrowstoanearlierformat,referencestonamedconnectionpointrowsareconvertedtoindexedreferences,andtherownamesarelost.

Ellipserow(Geometrysection)

Containsthex-andy-coordinatesoftheellipse'scenterpointandtwopointsontheellipse.

AnEllipserowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateofthecenterpoint.Y They-coordinateofthecenterpoint.A Thex-coordinateofonepointontheellipse;pairedwithy-

coordinaterepresentedbytheBcell.B They-coordinateofonepointontheellipse;pairedwithx-

coordinaterepresentedbytheAcell.C Thex-coordinateofanotherpointontheellipse;pairedwith

y-coordinaterepresentedbytheDcell.D They-coordinateofanotherpointontheellipse;pairedwith

y-coordinaterepresentedbytheCcell.

Remarks

AgeometrysectionthatcontainsanEllipseoranInfiniteLinerowshouldnot

containanyotherrows.

EllipticalArcTorow(Geometrysection)

Containsx-andy-coordinatesofanellipticalarc'sendpoint,x-andy-coordinatesofthecontrolpointsonthearc,anglefromthex-axistotheellipse'smajoraxis,andratiobetweentheellipse'smajorandminoraxes.

AnEllipticalArcTorowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateoftheendingvertexonanarc.Y They-coordinateoftheendingvertexonanarc.A Thex-coordinateofthearc'scontrolpoint—apointonthe

arc.Thecontrolpointisbestlocatedabouthalfwaybetweenthebeginningandendingverticesofthearc.Otherwise,thearcmaygrowtoanextremesizeinordertopassthroughthecontrolpoint,withunpredictableresults.

B They-coordinateofanarc'scontrolpoint.C Theangleofanarc'smajoraxisrelativetothex-axisofits

parent

Seealso

D Theratioofanarc'smajoraxistoitsminoraxis.Despitetheusualmeaningofthesewords,the"major"axisdoesnothavetobegreaterthanthe"minor"axis,sothisratiodoesnothavetobegreaterthan1.Settingthiscelltoavaluelessthanorequalto0orgreaterthan1000canleadtounpredictableresults.

Hyperlink.Rowrow(Hyperlinkssection)

Containstheinformationforasinglehyperlinkassociatedwithashape.AshapewillcontainoneHyperlink.Rowrowforeachhyperlink.

AHyperlink.Rowrowcontainsthefollowingcells.Formoredetails,seethespecificcelltopics.

Cell DescriptionDescription Adescriptivetextstringforahyperlink.Address AURLaddress,DOSfilename,orUNCpathtowhichto

jump.SubAddress Alocationwithinthetargetdocumenttolinkto.ExtraInfo Astringthatpassesinformationtobeusedinresolvinga

URL.Frame ThenameofaframetotargetwhenMicrosoftVisioisopenas

anActivedocumentinanActiveXcontainer.Thedefaultisanemptystring.

NewWindow Specifieswhethertoopenthehyperlinkinanewwindow.If

Seealso

TRUE,opensthelinkedpage,document,orWebsiteinanewwindow.ThedefaultisFALSE.

Default Thedefaulthyperlinkforashapeorpage.

Remarks

Youcanassignmeaningfulnamestohyperlinkrows.Tochangetherowname,clickit,andthentypeMarketing,forexample,tocreatetherownameHyperlink.Marketing.Youcanthenreferencethesecellsbytheirrowname,whichappearsintheShapeSheetwindowinredtext.Forexample,intheabovenamedrowyoucanreferencetheDescriptioncellusingHyperlink.Marketing.Description.

Therownameyouentermustbeuniquewithinthesection.

InfiniteLinerow(Geometrysection)

Containsthex-andy-coordinatesoftwopointsonaninfiniteline.

AnInfiniteLinerowcontainsthefollowingcells.

Cell DescriptionX Anx-coordinateofapointontheinfiniteline;pairedwith

y-coordinaterepresentedbytheYcell.Y Ay-coordinateofapointontheinfiniteline;pairedwithx-

coordinaterepresentedbytheXcell.A Anx-coordinateofapointontheinfiniteline;pairedwith

y-coordinaterepresentedbytheBcell.B Ay-coordinateofapointonaninfiniteline;pairedwithx-

coordinaterepresentedbytheAcell.

Remarks

AgeometrysectionthatcontainsanEllipseorInfiniteLinerowshouldnotcontainanyotherrows.

LineTorow(Geometrysection)

Containsx-andy-coordinatesoftheendingvertexofastraightlinesegment.

ALineTorowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateoftheendingvertexofastraightline

segment.Y They-coordinateoftheendingvertexofastraightline

segment.

Seealso

MoveTorow(Geometrysection)

Containsthex-andy-coordinatesofthefirstvertexofashape,orrepresentsthex-andy-coordinatesofthefirstvertexafterabreakinapath.

AMoveTorowcontainsthefollowingcells.

Cell DescriptionX IftheMoveTorowisthefirstrowinthesection,theXcell

representsthex-coordinateofthefirstvertexofashape.IftheMoveTorowappearsbetweentworows,theXcellrepresentsthex-coordinateofthefirstvertexafterthebreakinthepath.

Y IftheMoveTorowisthefirstrowinthesection,theYcellrepresentsthey-coordinateofthefirstvertexofashape.IftheMoveTorowappearsbetweentworows,theYcellrepresentsthey-coordinateofthefirstvertexafterthebreakinthepath.

Remarks

TheMoveTorowcontainsthex-andy-coordinatesofthefirstvertexforthe

Seealso

shapeiftheMoveTorowisthefirstrowinthesection.Usuallythisisthefirstvertexplacedwhentheshapewasdrawn,anditdoesnotnecessarilycorrespondtothebeginpointofa1-Dshape.

AgeometrysectionmustbeginwithaMoveTorow,butyoucanalsousetheMoveTorowtorepresentagapinthestrokingofashape'spath.However,whenthepathisusedtodefinetheboundaryofafilledregion,thisgapisinterpretedasastraightlinesegment.Toinsertsuchagap,insertarowbetweentworowsandchangetherowtypetoMoveTo.IftheMoveTorowisbetweentworows,itcontainsthex-andy-coordinatesofthefirstvertexofthelineafterthebreakintheshape'spath.

NURBSTorow(Geometrysection)

Containsthex-andy-coordinates,positionofthesecondtolastknot,positionofthelastweight,positionofthefirstknot,positionofthefirstweight,andtheformulaforanonuniformrationalB-spline(NURBS).

ANURBSTorowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateofthelastcontrolpointofaNURBS.Y They-coordinateofthelastcontrolpointofaNURBS.A ThesecondtothelastknotoftheNURBS.B ThelastweightoftheNURBS.C ThefirstknotoftheNURBS.D ThefirstweightoftheNURBS.E ANURBSformula.

Remarks

NURBSisacommonwaytorepresentacurvemathematically.YoucancreateaNURBSwiththeFreeformtool.

Seealso

PolylineTorow(Geometrysection)

Containsx-andy-coordinatesofthelastpointofapolylineandapolylineformula.

APolylineTorowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateoftheendingvertexofapolyline.Y They-coordinateoftheendingvertexofapolyline.A Thepolylineformula.

Remarks

LinesrepresentedasaPolylinerowareequivalenttolinesrepresentedasasequenceofLineTorows,butaPolylinerowismoreefficient.YoucanchangeaPolylineTorowtoaLineTorowsoyoucaneasilyseetheshapegeometry.Todothis,right-clickthePolylineTorow,andthenclickExpandRowontheshortcutmenu.

TochangearowtypetoaPolylineTorow,right-clicktherow,andthenclickChangeRowTypeontheshortcutmenu.

Prop.Namerow(CustomPropertiessection)

Containstheinformationforasinglecustompropertyassociatedwithashape.AshapewillcontainoneProp.Namerowforeachcustomproperty.

AProp.Namerowcontainsthefollowingcells.Formoredetails,seethespecificcelltopics.

Cell DescriptionLabel TheLabelcellspecifiesthelabelthatappearstousersin

theCustomPropertiesdialogboxorwindow.Prompt ThePromptcellspecifiesdescriptiveorinstructionaltext

thatappearstousersintheCustomPropertiesdialogboxorwindowwhenthepropertyisselected.

Type Specifiesadatatypeforthecustompropertyvalue:string(0),afixedlist(1),anumber(2),aBooleanvalue(3),avariablelist(4),adateortime(5),aduration(6),oracurrency(7).

Format Specifiestheformattingofacustomproperty.FordetailsseetheFormatcell.

Seealso

Value Containstheproperty'svalueasenteredintheCustomPropertiesdialogboxorwindow.

SortKey SpecifiesakeybywhichitemsintheCustomPropertiesdialogboxorwindowarelisted.

Invisible SpecifieswhetherthecustompropertyisvisibleintheCustomPropertiesdialogboxorwindow.TRUE=notvisible;FALSE=visible.

Ask Determineswhetherauserisqueriedtoentercustompropertyinformationforashapewhenaninstanceiscreatedortheshapeisduplicatedorcopied.

Remarks

Youcanreferencethesecellsbytheirrowname,whichappearsinaShapeSheetwindowinredtext.Tochangetherowname,clickit,andthentypePrice,forexample,tocreatetherownameProp.Price.YoucanthenreferencetheLabelcellusingProp.Price.Label.

SplineKnotrow(Geometrysection)

Containsx-andy-coordinatesforaspline'scontrolpointandaspline'sknot.

ASplineKnotrowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateofacontrolpoint.Y They-coordinateofacontrolpoint.A Oneofthespline'sknots(otherthanthelastoneorthefirst

Remarks

MicrosoftVisiodisplaysthedefinitionofasplineinaGeometrysectionthatcontainsaSplineStartrowfollowedbyoneormoreSplineKnotrows.TheSplineStartrowmustbeprecededbyanotherkindofrow,suchasaMoveTorow,toindicatethefirstcontrolpointofthespline.TheprecedingrowcanbeaLineTo,ArcTo,NURBSTo,PolylineTo,orEllipticalArcTorowifthesplinefollowsasegmentofthattype.

SplineStartrow(Geometrysection)

Containsx-andy-coordinatesforaspline'ssecondcontrolpoint,itssecondknot,itsfirstknot,thelastknot,andthedegreeofthespline.

ASplineStartrowcontainsthefollowingcells.

Cell DescriptionX Thex-coordinateofaspline'ssecondcontrolpoint.Y They-coordinateofaspline'ssecondcontrolpoint.A Thesecondknotofthespline.B Thefirstknotofaspline.C Thelastknotofaspline.D Thedegreeofaspline(anintegerfrom1to25).

Remarks

MicrosoftVisiodisplaysthedefinitionofasplineinaGeometrysectionthatcontainsaSplineStartrowfollowedbyoneormoreSplineKnotrows.TheSplineStartrowmustbeprecededbyanotherkindofrow,suchasaMoveTorow,toindicatethefirstcontrolpointofthespline.TheprecedingrowcanbeaLineTo,ArcTo,NURBSTo,PolylineTo,orEllipticalArcTorowifthespline

followsasegmentofthattype.

User.Rowrow(User-DefinedCellssection)

Containsthevalueanddescriptivepromptforanyuser-definedcellsinyoursolution.AshapewillcontainoneUser.Rowrowforeachuser-definedcell.

AUser.Rowrowcontainsthefollowingcells.Formoredetails,seethecelltopics.

Cell DescriptionValue TheValuecellspecifiesavalueforthecorrespondinguser-

definedcell.Prompt ThePromptcellspecifiesadescriptivepromptorcomment

fortheuser-definedcell.

Remarks

User-definedcellscanbeusedforenteringformulasorconstantsthatarereferredtobyothercellsoradd-ons.Valuesinuser-definedcellsareportable,thatis,ifashapethatreferstoauser-definedcellinoneshapeiscopiedtoanothershapethatdoesnothavethesameuser-definedcell,thecellisaddedto

Seealso

theshape.

Youcanreferencethesecellsbytheirrowname,whichappearsinaShapeSheetwindowinredtext.YoucanassignmeaningfulnamestoUser.Rowrows.Tochangetherowname,clickit,andthentypeOffset,forexample,tocreatetherownameUser.Offset.YoucanthenreferencethePromptcellusingUser.Offset.Prompt.

1-DEndpointssection

Containsx-andy-coordinatesofthebeginpointandendpointofa1-Dshape.Thissectionappearsfor1-Dshapesonly.

Seealso Rows

Actionssection

Definescustomcommandnamesthatappearonanobject'sshortcutmenuandspecifiestheactionsthatthecommandstake.

Seealso Rows

Alignmentsection

Indicatesthealignmentofashapewithrespecttotheguideorguidepointtowhichtheshapeisglued.TheAlignmentsectionappearsonlyforshapesthataregluedtoguides.

Seealso Rows

Charactersection

Showstheformattingattributesfortheshape'stext,suchasfont,color,textstyle,case,positionrelativetothebaseline,andpointsize.

Remarks

EachcharacterstyleinashapehasacorrespondingrowintheCharactersectionasviewedintheShapeSheetwindow.Thenameoftherowrepresentsthenumberofcharactersthecharacterstyleappliesto.

TextformatscanbesetwiththeTextdialogbox(clickTextontheFormatmenu),byapplyingatextstyle,orbymakinganentryinaCharactersectioncell.

Seealso Rows

ConnectionPointssection

Containsarowandcellsforeachconnectionpointdefinedfortheshape.

Remarks

YoucandefineconnectionpointsintheConnectionPointssectionintheShapeSheetwindoworbyusingtheConnectionPointtoolontheStandardtoolbar.

IfyourshapehasnoConnectionPointssectionyoucaninsertaConnectionPointssectionintheShapeSheetwindow.OntheInsertmenu,clickSection,andthenclickConnectionpoints.ToaddconnectionpointstoanexistingConnectionPointssection,right-clickarowandclickInsertRowontheshortcutmenu.

Youcanchangetherowtypeofaconnectionpointinthissectiontodisplayadditionalcellsthatyoucanuseforscratchcalculations.Todothis,right-clicktherow,andthenclickChangeRowTypeontheshortcutmenu.

Seealso

Controlssection

Containscellsforthex-andy-coordinatesofeachcontrolhandledefinedforashapeandcellsthatspecifythewaythecontrolhandleshouldbehave.

Seealso Rows

CustomPropertiessection

Containsonerowforeachcustompropertyandcellsforassociatingdatawithashape.

Remarks

CustompropertiescanbedefinedusingtheCustomPropertieswindoworthecellsintheCustomPropertiessection.

IntheShapeSheetwindow,youcandefinecustompropertiesintheCustomPropertiessection.OntheInsertmenu,clickSection,thenclickCustomproperties.YoucanaddasmanyProp.Namerowsasyouneed,assignmeaningfulnamestotherows,andsetcellvalues.

Inthedrawingwindow,youcandefinecustompropertiesintheCustomPropertieswindow.OntheViewmenu,clickCustomPropertiesWindow.ToaccesstheDefineCustomPropertiesdialogbox,right-clicktheCustomPropertieswindow,andthenclickDefinePropertiesontheshortcutmenu.

Seealso

DocumentPropertiessection

Containscellsforadocumentthatcontrolpreviewquality,scope,andoutputformat.YoucanalsosetthesevaluesusingthePropertiesdialogbox.Or,youcanright-clickadrawingintheDrawingExplorer,andthenclickPropertiesontheshortcutmenu.

Seealso Rows

Eventssection

Containsformulasthatcontrolshapeevents.Eventcellsareevaluatedonlywhentheeventoccurs,notuponformulaentry.

Seealso Rows

FillFormatsection

Showsthecurrentfillformattingattributesfortheshapeandtheshape'sdropshadow,includingpattern,foregroundcolor,andbackgroundcolor.FillformatscanbesetwiththeFilldialogbox,byapplyingafillstyle,orbymakinganentryinaFillFormatcell.

Seealso Rows

ForeignImageInfosection

ContainsthewidthandheightofanobjectfromanotherprogramusedinaMicrosoftVisiodrawingandappearsintheShapeSheetwindowonlyforsuchobjects.Italsoindicatesthedistancetheobject'simageisoffsetwithinitsborders.

Remarks

InversionsofVisioproductsearlierthanVisioversion2000,thissectionwasnamedImageInfo.

Seealso Rows

Geometrysection

Containsrowsthatlistthecoordinatesoftheverticesforthelinesandarcsthatmakeuptheshape.Iftheshapehasmorethanonepath,thereisaGeometrysectionforeachpath.

TheGeometrysectioncontainsthefollowingrowtypes.Fordetails,seetherowtopics.

Row DescriptionMoveTo Movetoacoordinate.LineTo Drawalinetoacoordinate.ArcTo Drawacirculararctoacoordinate.EllipticalArcTo Drawanellipticalarctoacoordinate.PolylineTo Drawapolyline,orconsecutivelines,toacoordinate.NURBSTo DrawanonuniformrationalB-spline(NURBS)toa

coordinate.SplineStart Startaspline.SplineKnot Drawasplinesegmenttoaknotcoordinate.InfiniteLine Drawaninfinitelinefromonecoordinatetoanother.Ellipse Drawanellipsefromacentercoordinateanda

Seealso

major/minoraxis.

Remarks

Tochangearowtypeinthissection,right-clicktherow,andthenclickChangeRowTypeontheshortcutmenu.

GlueInfosection

Containsformulasgeneratedfora1-Dshapewhenthe1-Dshapeisgluedtoothershapes.

Seealso Rows

GroupPropertiessection

Containscellsforagroupthatcontrolhowyouaddshapestoagroup,movemembersofagroup,andselectgroups.YoucanalsosetthesevaluesontheBehaviortabintheBehaviordialogbox(clickBehaviorontheFormatmenu).

Seealso Rows

Hyperlinkssection

Containscellsforcreatingmultiplejumpsbetweenashapeordrawingpageandanotherdrawingpage,anotherfile,oraWebsite.

Remarks

Todefineahyperlink,youcanentervaluesinthecellsofthissection,orusetheHyperlinksdialogbox(clickHyperlinksontheInsertmenu).

TheHyperlinkssectioncanbeaddedtoashape,group,page,orforeignobjectinaShapeSheetwindow.

Seealso

ImagePropertiessection

Containsthegamma,brightness,contrast,blur,sharpen,anddenoisevaluesforbitmaps(animagethatconsistsofpixels)andappearsintheShapeSheetwindowonlyforsuchobjects.

Seealso Rows

LayerMembershipsection

Containsonerowthatlistseachlayertowhichtheshapeisassigned.

Remarks

Thelayerassignmentisshownasanindextothelistoflayersonthepage.ThelayerindexcorrespondstotheorderofthelayersintheLayerPropertiesdialogbox(ontheViewmenu,clickLayerProperties).Thefirstnameinthedialogboxislayer0,thesecondislayer1,andsoforth.

Ifashapeisassignedtomorethanonelayer,eachlayerindexappearsintheLayerMembershipcellseparatedbyasemicolon.

TorefertothevalueoftheLayerMembershipcellinaformula,usethenameLayerMember.

Seealso Rows Cells

Layerssection

Showsalllayersdefinedforthepageandthepropertiessetforeachlayer.ThissectionisapagepropertythatcanbeviewedonlyintheShapeSheetwindowforapage.ItscellscorrespondtotheoptionsintheLayerPropertiesdialogbox(clickLayerPropertiesontheViewmenu).

Seealso Rows

LineFormatsection

Containscellsthatcontrollineattributesforashape,suchaspattern,weight,andcolor.Theydeterminewhetherthelineendsareformatted(forexample,withanarrowhead),thesizeoflineendformats,radiusoftheroundingcircleappliedtotheline,andlinecapstyle(roundorsquare).

Remarks

YoucansetlineformatsbyusingtheLinedialogbox,byapplyingalinestyle,orbyenteringaformulainaLineFormatcell.

Seealso Rows

Miscellaneoussection

Containsvariousattributesofshapesandgroups,suchascontrolselectionhighlightingandvisibility.

Remarks

YoucansetthevalueofmanyofthecellsinthissectionintheShapeSheetwindow,orontheBehaviortabintheBehaviordialogboxinthedrawingwindow(clickBehaviorontheFormatmenu,andthenclicksettingsontheBehaviortab).YoucansetothergrouppropertiesusingcellsintheGroupPropertiessection.

InMicrosoftVisioversion5.0products,thissectionincludedObjInteractandObjBehaviorcells.ThebehaviorintheObjInteractcellisnowmappedtothefollowingcellsintheShapeLayoutsection:ShapeFixedCode,ShapePermeableX,ShapePermeableY,andShapePermeablePlace.ThebehaviorintheObjBehaviorcellisnowmappedtotheConFixedCodeandShapeRouteStylecells.

InVisioversion5.0Japaneseproducts,thissectionincludedaVerticalTextcell.InVisioversion2000productsandlater,thevalueofthiscellisstoredintheTextDirectioncellintheTextBlockFormatsection.

PageLayoutsection

Containscellsthatcontrolthepagesettingsforshapesandconnectors,suchasthespacingbetweenallshapesonthepage,spacingbetweenallconnectorsonthepage,androutingstyleforallconnectorsonthepage.

Remarks

Tooverridethepagedefaultsforaspecificshape,usethecellsintheShapeLayoutsection.

YoucanalsosetthevaluesofthecellsinthissectionontheLayoutandRoutingtabinthePageSetupdialogbox(clickPageSetupontheFilemenu).

Seealso Rows

PagePropertiessection

Containscellsthatcontrolpageattributes,suchasthepagewidth,height,andscale.

Remarks

YoucansetthevaluesofpagepropertiesbymakinganentryinthePagePropertiessectioncell,orusingthePageSetupdialogboxinthedrawingwindow(clickPageSetupontheFilemenu).

Seealso Rows

Paragraphsection

Showstheparagraphformattingattributesfortheshape'stext,suchasindents,linespacing,bullets,andhorizontalalignmentofparagraphs.

Remarks

ParagraphformatscanbesetbymakinganentryinaParagraphsectioncellbyapplyingatextstyle,orbyenteringvaluesintheTextdialogbox(clickTextontheFormatmenu).

TheParagraphsectiondoesnotincludecellsfortabsettings.Tosettabsforashape'stext,usetheTextdialogbox.

Seealso Rows

Protectionsection

ShowsthecurrentlocksettingssetwiththeProtectioncommandplusafewadditionallocksthatcanbesetonlyinaShapeSheetwindow.

Remarks

LockinghelpspreventinadvertentchangestotheshapebutdoesnotpreventMicrosoftVisiofromresettingvaluesinothercircumstances.ItalsodoesnotprotectagainstchangesmadeintheShapeSheetwindow.

Toprotectaformulafrombeingchanged,usetheGUARDfunction.

Ruler&Gridsection

Showsthecurrentsettingsofthepage'srulersandgrid.

Remarks

ThissectionisapagepropertythatcanbeviewedonlyintheShapeSheetwindowforapage.ThecellsitcontainscorrespondtothesettingsintheRuler&Griddialogbox(clickRuler&GridontheToolsmenu).

Seealso Rows

Scratchsection

Aworkareaforenteringandtestingformulasthatcanbereferredtobyothercells.

Remarks

YoucanaddthissectionusingtheInsertSectiondialogbox.MakesuretheShapeSheetwindowistheactivewindow,thenontheInsertmenu,clickSection.

TheScratchsectionistypicallyusedtoisolaterepeatedcomplexcalculations.Ifyoursolutionhasawell-definedpurpose,it'swisertouseacellintheUser-DefinedCellssectionforclaritybecauseUsercellscanbenamed.

CellsintheScratchsectionuseunitsintwodifferentways.XandYcellsusedrawingunits;AthroughDcellsdon'tuseunits.(InCprogrammers'jargon,XandYcellsare"typed,"andcellsAthroughDare"void.")TheScratchXandYcellsareoftenusedforderivingx-andy-coordinates,suchasPinXandPinY,ortheXandYcellsfoundinaGeometrysectioncell.ScratchcellsAthroughDcandisplaywhateverunitsyouspecify.

Afurtherdifferenceisthewaythesecellsstorepointvalues.ApointinMicrosoftVisioisasingledatapackageforan(x,y)coordinate.Whenaformulareturnsapointvalue,thatvalueisinterpretedinoneofthreeways,dependingontheShapeSheetcelltheformulaisin.Cellsthatrelatetox-coordinates(forexample,PinX,orcellsintheXcolumnofaGeometrysection)extractjustthex-coordinatepartofapointvalue.Cellsthatrelatetoy-coordinatesextractjustthey-coordinatepartofapointvalue.

Rows Cells

Forexample,VisioextractstheformulaPNT(3,4)inthesethreeways.

Cell Ifyouenter Visiotreatsitas ResultX PNT(3,4) PNTX(PNT(3,4)) 3.0000in.Y PNT(3,4) PNTY(PNT(3,4)) 4.0000in.A-D PNT(3,4) PNT(3,4) PNT(3.0000in.,4.0000

ShapeLayoutsection

Containscellsthatcontrolshapeplacementandconnectorroutingsettings.

Remarks

Youcanalsosetthevaluesoftheshape-specificcellsinthissectionusingthePlacementtabintheBehaviordialogbox(clickBehaviorontheFormatmenu).Youcansetthevaluesoftheconnector-specificcellsinthissectionusingtheConnectortabintheBehaviordialogbox.(ToseetheConnectortab,selecttheconnectorinthedrawingwindow,andthenclickBehaviorontheFormatmenu.)

YoucanusevaluesintheShapeLayoutsectiontooverridedefaultvaluescontainedinthePageLayoutsection.

Seealso Rows

ShapeTransformsection

Containsgeneralpositioninginformationaboutashape:forexample,itswidth,height,angle,andcenterofrotation(pin);whethertheshapehasbeenflipped;andhowtheshapeshouldbehavewhenresizedwithinagroup.

Seealso Rows

StylePropertiessection

Includescellsthatcontrolstylebehavior,suchaswhetherastyleincludestext,line,andfillattributes.

Remarks

YoucanalsosettheseattributesusingtheDefineStylesdialogbox(clickDefineStylesontheFormatmenu).

Seealso Rows

Tabssection

Containscellsforshapesorstylesthatcontroltabstoppositionandalignment.

Remarks

YoucanalsosetthesevaluesusingtheTabstabintheTextdialogbox(clickTextontheFormatmenu)orusingtheTextRuler.ToshowtheTextRuler,right-clickthetextwhileintext-editingmode,andthenclickTextRulerontheshortcutmenu.

Youcansettabstopsforspecificcharactersbyselectingthetext,andthensettingthetabstop.Whenyousettabstopsforspecificcharacters,anewrowisaddedintheShapeSheetwindow.Thenameoftherowrepresentsthenumberofcharactersthetabstopcontains.

Seealso Rows

TextBlockFormatsection

Containscellsthatcontrolthealignment,margins,anddefaulttabstoppositionoftextinashape'stextblock.

Remarks

YoucanalsosetthesetextattributesusingtheTextdialogbox(clickTextontheFormatmenu).

Seealso Rows

TextFieldssection

Displaysfunctionsandformulasinsertedintheshape'stextusingtheFielddialogbox.

Remarks

TheonlywaytoaddthissectionistoinsertafieldintoashapeusingtheFielddialogbox(clickFieldontheInsertmenu).

EachtextfieldinatextblockhasacorrespondingrowintheShapeSheetwindow.Thenameoftherowrepresentsthenumberofcharactersthefieldcontains.

Seealso Rows

TextTransformsection

Containspositioninginformationaboutashape'stextblock.

Remarks

Toaddthissection,usetheInsertSectiondialogbox(withtheShapeSheetwindowactive,clickSectionontheInsertmenu).SettingvaluesintheTextTransformsectioniscomparabletoworkingwiththetextblockusingtheTextBlocktool.

Seealso Rows

User-DefinedCellssection

Aworkareaforenteringformulasinuser-specificcellsthatcanbereferredtobyothercellsandadd-ontools.

Remarks

LiketheScratchsection,theUser-DefinedCellssectioncanbeusedbyyoursolutioninmanydifferentways.TheadvantageoftheUser-DefinedCellssectionisthatcellscanbenamed—cellsintheScratchsectioncannotbenamed.

Ifyoursolutionhasawell-definedpurposeitissuggestedthatyouusecellsintheUser-DefinedCellssectionforclaritybecauseUsercellscanbenamed.TheScratchsectionistypicallyusedtoisolaterepeatedcomplexcalculations.

Toaddthissection,usetheInsertSectiondialogbox(withtheShapeSheetwindowactive,clickSectionontheInsertmenu).

Seealso

About the ShapeSheet spreadsheetMicrosoft Visio formulas are similar to typical spreadsheet formulas...

Documents

Transcript of About the ShapeSheet spreadsheetMicrosoft Visio formulas are similar to typical spreadsheet formulas...

Visio 2007 TechDays – 7 février 2007 Julien Jouhanneaud – Ingénieur d’Affaires Visio

Visio tutorial

Visio Drawings

PowerCenter Mapping Architect for Visio · vii Preface The PowerCenter Mapping Architect for Visio Guide PowerCenter Mapping Architect for Visio Guide

Automating Visio Infrastructure Diagrams€¦ · Automating Visio Infrastructure Diagrams David Cuthbertson Square Mile Systems Debby Binns Premier Computer Solutions . Advanced Visio

Visio icons

Visio 2007 Advanced - Microsoft Office Training · Visio 2007 Advanced . Best STL ... • MS Project • MS Visio + more Trainer hints ... With Visio you can choose Building Plan

VISIO Product Data - VIVA Railingsvivarailings.com/Visio_Downloads/visio-product-catalog-web.pdf · visio tm railing system infill options tempered glass visio tm railing system specifications

Guide Mapping Architect for Visio Documentation/5/PC_1… · 1 for Visio • • • • Using Mapping Architect for Visio, 12 mapping. •

Visio 2003 & 12 자산관리 - DBGuide.net · 2006. 9. 20. · Session 1 Visio 2003 자산관리를위한사용자지정속성 Visio 2007 새로운기능소개

Visio Communications

Nova Visio

VISIO - Diagramas

Microsoft Visio 2010. How to use visio for network planning.pdf

Microsoft Office Visio 2007 Advanced Concepts &Solutionssharepoint.visibility.biz/visibility.biz/Shared Documents... · 2010-11-02 · Visio 2007 Advanced Topics • Visio and Project

Visio 2011

Microsoft Visio 2010 - Wikispaces · PDF fileMicrosoft Visio 2010 essentials Page 1 of 154 Microsoft Visio 2010

DESIGNING DATABASES WITH VISIO …media.lanecc.edu/users/loftl/CS275/TextReferenceMaterial/AppA.pdfP review DESIGNING DATABASES WITH VISIO PROFESSIONAL: A TUTORIAL Microsoft Visio

Developing Visio Solutions Visio 2000

Interaction Design Interaction Design - Joan Cahill - Visio Interaction Design: Visio.