Arbeide med skjemavinduer
Når du arbeider programmatisk med et Microsoft Office InfoPath 2003-skjema, kan du skrive skriptkode for å få tilgang til skjemavinduene og deretter tilpasse elementer i dem. InfoPath-objektmodellen støtter tilgang til skjemavinduer gjennom bruk av Window-objektet sammen Windows-samlingen.
Det finnes to typer vinduer i et InfoPath-skjema: redigeringsvinduet, som brukes som skjemaområde når en bruker fyller ut et skjema, og utformingsvinduet, som brukes som utformingsmodus når en bruker utformer et skjema. Når du skriver skriptkode i et skjema, er det redigeringsvinduet som har den nyttigste funksjonaliteten fordi du bruker det tilknyttede Window-objektet for å få tilgang til en rekke egenskaper og metoder for tilpassing av skjemaer.
Oversikt over Windows-samlingen
Windows-samlingen inneholder følgende egenskaper som skjemautviklere kan bruke til å behandle Windows-objektene i samlingen:
| Navn | Beskrivelse |
|---|---|
| Count-egenskapen | Returnerer antallet Window-objekter i samlingen |
| Item-egenskapen | Returnerer en referanse til det angitte Window-objektet |
Window-objektet inneholder følgende metoder og egenskaper som skjemautviklere kan bruke til å arbeide interaktivt med et InfoPath-vindu:
| Navn | Beskrivelse |
|---|---|
| Activate-metoden | Gjør vinduet til aktivt vindu |
| Active-egenskapen | Returnerer en boolsk verdi som angir om vinduet er det aktive vinduet |
| Caption Property (Window Object)-egenskapen | En lese-/skriveegenskap som returnerer eller angir bildeteksten for vinduet som er representert av Window-objektet. |
| Close-metoden | Lukker et vindu |
| CommandBars-egenskapen | Returnerer en referanse til CommandBars-objektet i Microsoft Office |
| Height-egenskapen | En lese- og skrivebeskyttet egenskap av typen langt heltall, som angir høyden til vinduet som representeres av Window-objektet, målt i punkter. |
| Left-egenskapen | En lese- og skrivebeskyttet egenskap av typen langt heltall, som angir den horisontale plasseringen av vinduet som representeres av Window-objektet, målt i punkter. |
| MailEnvelope-egenskapen | Returnerer en referanse til MailEnvelope-objektet |
| TaskPanes-egenskapen | Returnerer en referanse til TaskPanes-samlingen |
| Top-egenskapen | En lese- og skrivebeskyttet egenskap av typen langt heltall, som angir den vertikale plasseringen av vinduet som representeres av Window-objektet, målt i punkter. |
| Type-egenskapen | Returnerer et nummer som angir vindustype, basert på XdWindowType-nummereringen |
| Width-egenskapen | En lese- og skrivebeskyttet egenskap av typen langt heltall, som angir bredden av vinduet som representeres av Window-objektet, målt i punkter. |
| WindowState | En lese- og skrivebeskyttet egenskap av typen XdWindowState, som returnerer eller setter statusen for vinduet som representeres av Window-objektet. |
| XDocument-egenskapen | Returnerer en referanse til XDocument-objektet som er knyttet til vinduet |
Bruke Windows-samlingen og Window-objektet
Windows-samlingen er tilgjengelig via Windows-egenskapen for Application-objektet. Når du bruker Windows-samlingen til å få tilgang til vinduene i et skjema, overfører du et langt heltall til Item-metoden for å returnere en referanse til et Window-objekt. Følgende kode angir for eksempel en referanse til det første Window-objektet i Windows-samlingen:
var objWindow;
objWindow = Application.Windows(0);
Du kan imidlertid gå direkte til gjeldende åpne vindu ved hjelp av ActiveWindow-egenskapen for Application-objektet, uten å gå via Windows-samlingen, som følgende kode viser:
var objWindow;
objWindow = Application.ActiveWindow;
Du kan også få tilgang til et Window-objekt ved hjelp av Window-egenskapen for View-objektet, som er knyttet til skjemaets underliggende XML-dokument. View-egenskapen for XDocument-objektet brukes til å få tilgang til View-objektet. Følgende kode angir for eksempel en referanse til Window-objektet som er knyttet til visningen av et skjemas underliggende XML-dokument:
var objWindow;
objWindow = XDocument.View.Window;
Obs! Noen av egenskapene og metodene for Window-objektet brukes bare for redigeringsvindutypen. Hvis de brukes sammen med utformingsvindutypen, vil de returnere en feil.