Obs!: Funksjonen, metoden, objektet eller egenskapen som beskrives i dette emnet, er deaktivert hvis Microsoft Jet Expression Service kjører i sandkassemodus, noe som forhindrer evaluering av potensielt usikre uttrykk. Hvis du vil ha mer informasjon om sandkassemodus, kan du søke etter «sandkassemodus» i Hjelp.
Returnerer en referanse til et objekt levert av en ActiveX-komponent.
Syntaks
GetObject([pathname ] [, class ] )
Syntaksen for funksjonen GetObject har følgende argumenter:
|
Argument |
Beskrivelse |
|
Banenavn |
Valgfritt. Variant (streng). Den fullstendige banen og navnet på filen som inneholder objektet som skal hentes. Hvis banenavn utelates, kreves klassen . |
|
klasse |
Valgfritt. Variant (streng). En streng som representerer objektets klasse. |
Klassen argument bruker syntaksappnavnet.objecttype og har disse delene:
|
Del |
Beskrivelse |
|
appname |
Obligatorisk. Variant (streng). Navnet på programmet som inneholder objektet. |
|
objecttype |
Obligatorisk. Variant (streng). Objekttypen eller klassen som skal opprettes. |
Kommentarer
Obs!: I eksemplene nedenfor vises bruken av denne funksjonen i en VBA-modul (Visual Basic for Applications). Hvis du vil ha mer informasjon om hvordan du arbeider med VBA, velger du Utviklerreferanse fra rullegardinlisten ved siden av Søk og skriver inn ett eller flere søkeord i søkeboksen.
Bruk GetObject-funksjonen til å få tilgang til et ActiveX-objekt fra en fil og tilordne objektet til en objektvariabel. Bruk Set-setningen til å tilordne objektet som returneres av GetObject til objektvariabelen. Eksempel:
Dim CADObject As Object
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")
Når denne koden kjøres, startes programmet som er knyttet til det angitte banenavnet , og objektet i den angitte filen aktiveres.
Hvis pathname er en tom streng (""), returnerer GetObject en ny objektforekomst av den angitte typen. Hvis banenavnargumentet utelates, returnerer GetObject et aktivt objekt av den angitte typen. Hvis det ikke finnes noe objekt av den angitte typen, oppstår det en feil.
Noen programmer lar deg aktivere en del av en fil. Legg til et utropstegn (!) på slutten av filnavnet, og følg det med en streng som identifiserer den delen av filen du vil aktivere. Hvis du vil ha informasjon om hvordan du oppretter denne strengen, kan du se dokumentasjonen for programmet som opprettet objektet.
I et tegneprogram kan du for eksempel ha flere lag på en tegning som er lagret i en fil. Du kan bruke følgende kode til å aktivere et lag i en tegning kalt SCHEMA.CAD:
Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")
Hvis du ikke angir objektets klasse, bestemmer Automatisering programmet som skal starte, og objektet som skal aktiveres, basert på filnavnet du oppgir. Noen filer kan imidlertid støtte mer enn én klasse med objekter. En tegning kan for eksempel støtte tre forskjellige typer objekter: et programobjekt , et tegneobjekt og et verktøylinjeobjekt , som alle er en del av samme fil. Hvis du vil angi hvilket objekt i en fil du vil aktivere, bruker du det valgfrie klasseargumentet . Eksempel:
Dim MyObject As Object
Set MyObject = GetObject("C:\DRAWINGS\SAMPLE.DRW", _
"FIGMENT.DRAWING")
I eksemplet er FIGMENT navnet på et tegneprogram, og DRAWING er én av objekttypene den støtter.
Når et objekt er aktivert, refererer du det til i kode ved hjelp av objektvariabelen du definerte. I eksemplet ovenfor får du tilgang til egenskaper og metoder for det nye objektet ved hjelp av objektvariabelen MyObject. Eksempel:
MyObject.Line 9, 90
MyObject.InsertText 9, 100, "Hello, world."
MyObject.SaveAs "C:\DRAWINGS\SAMPLE.DRW"
Obs!: Bruk GetObject-funksjonen når det finnes en gjeldende forekomst av objektet, eller hvis du vil opprette objektet med en fil som allerede er lastet inn. Hvis det ikke finnes noen gjeldende forekomst, og du ikke vil at objektet skal startes med en fil som lastes inn, bruker du CreateObject-funksjonen .
Hvis et objekt har registrert seg som et enkeltforekomstobjekt, opprettes bare én forekomst av objektet, uansett hvor mange ganger CreateObject kjøres. Med et enkeltforekomstobjekt returnerer GetObject alltid den samme forekomsten når den kalles med nulllengdestrengen («»), og det forårsaker en feil hvis banenavnargumentet utelates. Du kan ikke bruke GetObject til å hente en referanse til en klasse som er opprettet med Visual Basic.
Eksempel
I dette eksemplet brukes GetObject-funksjonen til å få en referanse til et bestemt Microsoft Office Excel 2007 regneark (MyXL). Den bruker programegenskapen i regnearket til å gjøre Excel synlig, lukke den og så videre. Ved hjelp av to API-kall ser DetectExcel Sub-prosedyren etter Excel, og hvis den kjører, skriver du den inn i tabellen Som kjører objekt. Det første kallet til GetObject forårsaker en feil hvis Microsoft Excel ikke allerede kjører. I eksemplet fører feilen til at ExcelWasNotRunning-flagget settes til Sann. Det andre kallet til GetObject angir en fil som skal åpnes. Hvis Excel ikke allerede kjører, starter det andre kallet det og returnerer en referanse til regnearket som representeres av den angitte filen, mytest.xls. Filen må finnes på den angitte plasseringen. Ellers genereres feilautomatiseringsfeilen i Visual Basic. Eksempelkoden gjør deretter både Excel og vinduet som inneholder det angitte regnearket synlig. Hvis det ikke var noen tidligere versjon av Excel som kjørte, bruker koden application object's Quit-metode til å lukke Excel. Hvis programmet allerede kjører, gjøres det ikke noe forsøk på å lukke det. Selve referansen utgis ved å sette den til Ingenting.
' Declare necessary API routines:
Declare Function FindWindow Lib "user32" Alias _
"FindWindowA" (ByVal lpClassName as String, _
ByVal lpWindowName As Long) As Long
Declare Function SendMessage Lib "user32" Alias _
"SendMessageA" (ByVal hWnd as Long,ByVal wMsg as Long, _
ByVal wParam as Long, _
ByVal lParam As Long) As Long
Sub GetExcel()
Dim MyXL As Object ' Variable to hold reference
' to Microsoft Excel.
Dim ExcelWasNotRunning As Boolean ' Flag for final release.
' Test to see if there is a copy of Microsoft Excel already running.
On Error Resume Next ' Defer error trapping.
' GetObject function called without the first argument returns a
' reference to an instance of the application. If the application isn't
' running, an error occurs.
Set MyXL = GetObject(, "Excel.Application")
If Err.Number <> 0 Then ExcelWasNotRunning = True
Err.Clear ' Clear Err object in case error occurred.
' Check for Microsoft Excel. If Microsoft Excel is running,
' enter it into the Running Object table.
DetectExcel
' Set the object variable to reference the file you want to see.
Set MyXL = GetObject("c:\vb4\MYTEST.XLS")
' Show Microsoft Excel through its Application property. Then
' show the actual window containing the file using the Windows
' collection of the MyXL object reference.
MyXL.Application.Visible = True
MyXL.Parent.Windows(1).Visible = True
Do manipulations of your file here.
' ...
' If this copy of Microsoft Excel was not running when you
' started, close it using the Application property's Quit method.
' Note that when you try to quit Microsoft Excel, the
' title bar blinks and a message is displayed asking if you
' want to save any loaded files.
If ExcelWasNotRunning = True Then
MyXL.Application.Quit
End IF
Set MyXL = Nothing ' Release reference to the
' application and spreadsheet.
End Sub
Sub DetectExcel()
' Procedure dectects a running Excel and registers it.
Const WM_USER = 1024
Dim hWnd As Long
' If Excel is running this API call returns its handle.
hWnd = FindWindow("XLMAIN", 0)
If hWnd = 0 Then ' 0 means Excel not running.
Exit Sub
Else
' Excel is running so use the SendMessage API
' function to enter it in the Running Object Table.
SendMessage hWnd, WM_USER + 18, 0, 0
End If
End Sub
