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

Cut.

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)

mk:@MSITStore:Vis_SDR.chm::/DAR_Properties_(B-C)_431.htm


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:

Rows



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:


Rows



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:

Rows




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

Rows



Cellindex: visSLOJumpDirX

ConLineJumpDirYcell(ShapeLayoutsection)

Determinesthelinejumpdirectionforlinejumpsoccurringonaverticaldynamicconnectorforashape.

Value LineJumpDirection Automationconstant0 Pagedefault visLOJumpDirYDefault1 Left visLOJumpDirYLeft2 Right visLOJumpDirYRight

Remarks

Tosetthedefaultverticaldirectionforallconnectorjumpsonapage,usethePageLineJumpDirYcellinthePageLayoutsection.

ToreferencetheConLineJumpDirYcellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: ConLineJumpDirY

ToreferencetheConLineJumpDirYcellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:


Rows



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

Rows



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

Rows




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

mk:@MSITStore:Vis_SDR.chm::/DAR_Methods_(B-C)_460.htm

mk:@MSITStore:Vis_SDR.chm::/DAR_Properties_(U-Z)_997.htm

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

Rows



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

Rows



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

Rows



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

Rows


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

Rows



FillForegndTranscell(FillFormatsection)

Determinesthetransparencylevelfortheforeground(fill)coloroftheshape'sfillpattern.


(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithacompletelytransparentfillappearsthesameasashapewithnofillonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheFilldialogbox(clickFillontheFormatmenu).Thisvaluecontrolsthevalueofboththebackgroundandforegroundfilltransparencies.Tosetthesevaluesindependently,youmustenterthemintheShapeSheetwindow.

ToreferencetheFillForegndTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: FillForegndTrans

Rows


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

Rows



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

type

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

Rows



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

Rows

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:

Rows



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:

Rows



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

Rows



Rowindex: visRowLineCellindex: visLineColor

LineColorTranscell(LineFormatsection)

Determinesthetransparencylevelofashape'slinecolor.


(completelyopaque).

Remarks

Valuesareroundedtothenearesthalfpercent.Avalueof100%iscompletelytransparent.Althoughashapewithacompletelytransparentlinecolorappearsthesameasashapewithnolinesonthedrawingpage,itwillinteractwithotherobjectsonthepageinthesamewaysasifitstransparencyis0%.

YoucanalsosetthisvalueusingtheslidercontrolintheLinedialogbox(clickLineontheFormatmenu).

ToreferencetheLineColorTranscellbynamefromanotherformula,orfromaprogramusingtheCellsproperty,use:

Cellname: LineColorTrans

ToreferencetheLineColorTranscellbyindexfromaprogram,usetheCellsSRCpropertywiththefollowingarguments:

Rows



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:


Rows



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

Rows



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

Rows



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

Rows



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

Rows



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

Rows



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

Rows




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

Rows

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

Rows

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:

Rows


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:

Rows



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

Rows

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:


Rows



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:

Rows



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

Rows



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

Rows



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…

Rows


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:

Rows



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

Rows


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

Rows



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…

Rows


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…



Rows



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…

Rows


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

Rows



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.

Rows

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

Rows



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

Rows



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

ID()

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

NA()

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

NOW()

Remarks

NOWisautomaticallyrecalculatedeveryminute.

Example1

NOW()

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

PI()

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

REF()

Example

REF()

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

two).

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.

Rows

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.

Rows

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

in.)

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