Funkcija GetObject

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). Pilns tā faila ceļš un nosaukums, kurā atrodas izgūstamais objekts. Ja ceļa nosaukums ir izlaists, klase ir nepieciešama.
klase	Neobligāts arguments. Variants (virkne). Virkne, kas apzīmē objekta klasi.

Klasesarguments izmanto sintaksi appname.objecttype, un tam 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

Izmantojiet funkciju GetObject , lai piekļūtu ActiveX objektam no faila un piešķirtu objektu objekta mainīgajam. 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")

Izpildot šo kodu, tiek startēta ar norādīto ceļa nosaukumu saistītā lietojumprogramma un tiek aktivizēts objekts norādītajā failā.

Ja ceļa nosaukums ir nulles garuma virkne (""), GetObject atgriež jauna norādītā tipa objekta instanci. Ja arguments ceļa nosaukums ir izlaists, GetObject atgriež pašlaik aktīva norādītā tipa objektu. Ja norādītā tipa objekts nepastāv, rodas kļūda.

Dažas lietojumprogrammas ļauj aktivizēt daļu faila. Pievienojiet izsaukuma zīmi (!) faila nosaukuma beigās un aiz tās pievienojiet virkni, kas identificē aktivizējamo faila daļu. Informāciju par to, kā izveidot šo virkni, skatiet tās lietojumprogrammas dokumentācijā, kas izveidoja objektu.

Piemēram, zīmēšanas programmā failā glabātam zīmējumam var būt vairāki slāņi. Varat izmantot tālāk norādīto kodu, lai aktivizētu slāni zīmējumā ar nosaukumu SCHEMA.CAD:

Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")

Ja nenorādāt objekta klasi, automatizācija nosaka startējamo lietojumprogrammu un aktivizējamo objektu, pamatojoties uz norādīto faila nosaukumu. Taču daži faili var atbalstīt vairākas objektu klases. Piemēram, zīmējums var atbalstīt trīs dažādus objektu tipus: lietojumprogrammas objektu, zīmēšanas objektu un rīkjoslas objektu, kas visi ir viena faila daļa. Lai norādītu, kuru objektu failā vēlaties aktivizēt, izmantojiet neobligāto klases argumentu. Piemērs.

Dim MyObject As Object
Set MyObject = GetObject("C:\DRAWINGS\SAMPLE.DRW", _
    "FIGMENT.DRAWING")

Šajā piemērā ir zīmēšanas lietojumprogrammas nosaukums un DRAWING ir viens no objektu tipiem, FIGMENT ko tā atbalsta.

Kad objekts ir aktivizēts, jūs atsaucaties uz to kodā, izmantojot definēto objekta mainīgo. Iepriekšējā piemērā piekļuve jaunā objekta rekvizītiem un metodēm tiek izmantota, izmantojot objekta mainīgo MyObject. Piemērs.

MyObject.Line 9, 90
MyObject.InsertText 9, 100, "Hello, world."
MyObject.SaveAs "C:\DRAWINGS\SAMPLE.DRW"

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īts CreateObject . Vienas instances objektam GetObject vienmēr atgriež to pašu instanci, kad tas tiek izsaukts ar nulles garuma virknes ("") sintaksi, un, izlaižot ceļa nosaukuma argumentu, rodas kļūda. GetObject nevar izmantot, lai iegūtu atsauci uz klasi, kas izveidota ar Visual Basic.

Piemērs

Šajā piemērā 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 to utt. Izmantojot divus API izsaukumus, procedūra DetectExcel Sub meklē programmu Excel, un, ja tā darbojas, ievada to izpildāmo objektu tabulā. Pirmais GetObject izsaukums izraisa kļūdu, ja programma Microsoft Excel vēl nedarbojas. Šajā piemērā kļūdas dēļ karodziņš ExcelWasNotRunning ir iestatīts kā Patiess. Otrais GetObject izsaukums norāda atveramo failu. Ja programma Excel vēl nedarbojas, to sāk otrais izsaukums un atgriež atsauci uz darblapu, ko pārstāv norādītais fails, mytest.xls. Failam jāatrodas norādītajā vietā; Pretējā gadījumā tiek ģenerēta Visual Basic kļūdu automatizācijas kļūda. Pēc tam piemēra kods padara redzamu gan programmu Excel, gan logu, kurā atrodas norādītā darblapa. Visbeidzot, ja nedarbojās neviena iepriekšējā Excel versija, kods izmanto lietojumprogrammas objekta metodi Beigt darbu, lai aizvērtu programmu Excel. Ja lietojumprogramma jau darbojās, netiek veikts nekāds mēģinājums to aizvērt. Pati atsauce tiek atbrīvota, 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