Piezīme.: Šajā tēmā aprakstītā funkcija, metode, objekts vai rekvizīts tiek atspējots, ja Microsoft Jet Expression Service darbojas smilškastes režīmā, tā neļauj novērtēt potenciāli nedrošas izteiksmes. Lai iegūtu papildinformāciju par smilškastes režīmu, meklējiet "smilškastes režīms" sadaļā Palīdzība.
Atgriež atsauci uz objektu, ko nodrošina ActiveX komponents.
Sintakse
GetObject([ceļa_nosaukums ] [, klase ] )
Funkcijas GetObject sintaksē ir šādi argumenti:
|
Arguments |
Apraksts |
|---|---|
|
ceļa_nosaukums |
Neobligāts arguments. Variants (Virkne). Tā faila pilns ceļš un nosaukums, kurā atrodas izgūstamais objekts. Ja ceļa nosaukums ir izlaists, ir jānorāda klase. |
|
klase |
Neobligāts arguments. Variants (Virkne). Virkne, kas klase objekta daļu. |
Klases nosaukumsarguments izmantota sintakses lietojumprogrammas nosaukums.objecttype un ir šādas daļas:
|
Daļa |
Apraksts |
|---|---|
|
programmas_nosaukums |
Obligāts arguments. Variants (Virkne). Tās lietojumprogrammas nosaukums, kas nodrošina objektu. |
|
objekta tips |
Obligāts arguments. Variants (Virkne). Izveidojamā objekta tips vai klase. |
Piezīmes
Piezīme.: Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Lai iegūtu papildinformāciju par darbu ar VBA, nolaižamajā sarakstā atlasiet Uzziņas materiāli izstrādātājiem blakus meklēšanas lodziņam un ievadiet šajā lodziņā vienu vai vairākus vārdus.
Izmantojiet funkciju GetObject , lai piekļūtu ActiveX objektam no faila un piešķirtu objektu objekta mainīgais. Izmantojiet priekšrakstu Set , lai objekta mainīgajam piešķirtu GetObject atgriezto objektu. Piemērs.
Dim CADObject As Object
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")
Kad tiek izpildīts šis kods, tiek startēta programma, kas saistīta ar norādīto ceļa nosaukumu, un tiek aktivizēts norādītajā failā norādītais objekts.
Ja ceļa_nosaukums ir nulles garuma virkne (""), GetObject atgriež jaunu norādītā tipa objekta instanci. Ja ceļa nosaukuma arguments ir izlaists, GetObject atgriež pašlaik aktīvu norādītā tipa objektu. Ja neviena norādītā tipa objekts nepastāv, rodas kļūda.
Dažas lietojumprogrammas ļauj aktivizēt faila daļu. Faila nosaukuma beigās pievienojiet izsaukuma zīmi (!) un aiz tās ievadiet virkni, kas identificē aktivizējamā faila daļu. Informāciju par to, kā izveidot šo virkni, skatiet tās lietojumprogrammas dokumentācijā, kura izveidoja objektu.
Piemēram, zīmēšanas lietojumprogrammā var būt vairāki slāņi zīmējumam, kas tiek glabāts failā. Lai zīmējumā aktivizētu slāni, ko sauc par "ievilkšanu", varat izmantot SCHEMA.CAD:
Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")
Ja nenorādījat objekta klasi, automatizācija nosaka lietojumprogrammu, kuru vēlaties startēt, un objektu, kas jāaktivizē, pamatojoties uz jūsu nodrošinātu faila nosaukumu. Tomēr daži faili var atbalstīt vairāk nekā vienu objekta klasi. Piemēram, zīmējums var atbalstīt trīs dažādu veidu objektus: lietojumprogrammas objektu, zīmēšanas objektu un rīkjoslas objektu, kas ir daļa no viena faila. Lai norādītu, kuru objektu failā vēlaties aktivizēt, izmantojiet argumentu papildu klasei . Piemērs.
Dim MyObject As Object
Set MyObject = GetObject("C:\DRAWINGS\SAMPLE.DRW", _
"FIGMENT.DRAWING")
Šajā piemērā FIGMENT ir zīmēšanas lietojumprogrammas nosaukums, un DRAWING ir viens no objektu tipiem, ko tā atbalsta.
Kad objekts ir aktivizēts, atsauce uz to tiek izmantota kodā, izmantojot definēto objekta mainīgo. Iepriekšējā piemērā var piekļūt jaunā objekta rekvizītiem un metodēm, izmantojot objekta mainīgo MyObject. Piemērs.
MyObject.Line 9, 90
MyObject.InsertText 9, 100, "Hello, world."
MyObject.SaveAs "C:\DRAWINGS\SAMPLE.DRW"
Piezīme.: Izmantojiet funkciju GetObject , ja ir pašreizējā objekta instance vai vēlaties izveidot objektu ar jau ielādētu failu. Ja pašlaik nav instances un nevēlaties, lai objekts startētu ar ielādētu failu, izmantojiet funkciju CreateObject .
Ja objekts ir reģistrēts kā vienas instances objekts, tiek izveidota tikai viena objekta instance neatkarīgi no tā, cik reižu tiek izpildīta CreateObject . Izmantojot vienas instances objektu, GetObject vienmēr atgriež to pašu instanci, kas tiek izsaukta ar nulles garuma virknes ("") sintaksi, un tā izraisa kļūdu, ja ceļa nosaukuma arguments ir izlaists. GetObject nevar izmantot, lai iegūtu atsauci uz klasi, kas izveidota ar Visual Basic.
Piemērs
Šajā piemērā tiek izmantota funkcija GetObject , lai iegūtu atsauci uz konkrētu Excel darblapu (MyXL). Tas izmanto darblapas rekvizītu Application , lai padarītu programmu Excel redzamu, aizvērtu un veiktu citas darbības. Izmantojot divus API izsaukumus, procedūra DetectExcel Sub meklē excel; ja tā darbojas, tā tiek ievadīta objektu tabulā, kas darbojas. Pirmais GetObject zvans izraisa kļūdu , ja programma Microsoft Excel vēl nedarbojas. Šajā piemērā kļūda liek karodziņam ExcelWasNotRunning iestatīt vērtību True. Otrais zvans uz GetObject norāda atveramo failu. Ja programma Excel vēl nedarbojas, otrais zvans to sāk un atgriež atsauci uz darblapu, kuru attēlo norādītais fails, un pēc tam mytest.xls. Failam ir jābūt norādītajā atrašanās vietā. pretējā gadījumā tiek ģenerēta Visual Basic kļūdu automatizācijas kļūda. Pēc tam parauga kods padara redzamu gan programmu Excel, gan logu, kurā ir norādītā darblapa. Visbeidzot, ja programmas Excel iepriekšējās versijas nav izmantota, kods izmanto objekta Applicationobjekta Quit metodi, lai aizvērtu programmu Excel. Ja programma jau darbojas, netiek mēģināts to aizvērt. Pati atsauce tiek izlaista, iestatot to uz Nekas.
' 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
