Funktsioon GetObject

Tagastab ActiveX-komponendi võimaldatava objektiviite.

Süntaks

GetObject([pathname ] [, class ] )

Funktsiooni GetObject süntaksil on järgmised argumendid.

Argument	Kirjeldus
pathname	Valikuline. Variant (String). Toodavat objekti sisaldava faili täielik tee ja nimi. Kui teenimi puudub, on klass nõutav.
klass	Valikuline. Variant (String). Objekti klassi tähistav string.

Argument classkasutab süntaksit appname.objecttype ja selle osad on järgmised.

Osa	Kirjeldus
rakendusenimi	Nõutav. Variant (String). Objekti võimaldava rakenduse nimi.
objektitüüp	Nõutav. Variant (String). Loodava objekti tüüp või klass.

Kommentaarid

Funktsiooni GetObject abil pääsete failist ActiveX-objektile juurde ja määrate objektimuutujale. Funktsiooni GetObject tagastatud objektile objektimuutuja määramiseks saate kasutada lauset Set. Siin on näide.

Dim CADObject As Object
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")

Koodi käivitamisel käivitatakse määratud teenimega seostatud rakendus ja aktiveeritakse määratud failis olev objekt.

Kui pathname on nullpikkusega string (""), tagastab GetObject määratud tüüpi uue objektieksemplari. Kui argument pathname puudub, tagastab GetObject määratud tüüpi aktiivse objekti. Juhul kui määratud tüüpi objekti pole, ilmneb tõrge.

Teatud rakendused võimaldavad faili osaliselt aktiveerida. Lisage failinime lõppu hüüumärk (!) ja järgige seda stringiga, mis tuvastab failiosa, mille soovite aktiveerida. Sellise stringi koostamise kohta leiate teavet objekti loonud rakenduse dokumentatsioonist.

Näiteks on võimalik, et joonistusrakendust kasutades talletatakse teie joonistuse mitu kihti failis. Joonistuse kihi aktiveerimiseks nimega SCHEMA.CAD:

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

Kui te ei määra objekti klassi, määratleb automatiseerimine teie sisestatud failinime põhjal käivitatava rakenduse ja aktiveeritava objekti. Mõned failid võivad toetada mitut klassi objekte. Näiteks võib joonistus toetada kolme eri tüüpi, kuid ühe ja sama faili osaks olevat objekti: Application (Rakendus), Drawing (Joonistus) ja Toolbar (Tööriistariba). Failis aktiveeritava objekti määramiseks kasutage valikulist argumenti klass . Siin on mõned näited.

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

Näites FIGMENT on joonistusrakenduse nimi ja DRAWING see on üks toetatud objektitüüpidest.

Kui objekt on aktiveeritud, siis viidatakse sellele koodis määratletud objektimuutujat kasutades. Eelmises näites kasutate uue objekti atribuutidele ja meetoditele juurdepääsuks objektimuutujat MyObject. Siin on mõned näited.

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

Juhul kui objekt on registreeritud ühekordse objektina, luuakse ainult üks objekti eksemplar, olenemata sellest, kui palju funktsiooni CreateObject käivitatakse. Ühe eksemplariga objekti korral tagastab GetObject nullpikkusega stringi ("") süntaksiga kutsumisel alati sama eksemplari ja põhjustab vea, kui argument pathname puudub. Funktsiooni GetObject ei saa kasutada Visual Basicu abil loodud klassile viite toomiseks.

Näide

Selles näites kasutatakse funktsiooni GetObject mõnele kindlale Exceli töölehele (MyXL) viitamiseks. Funktsioon kasutab Exceli nähtavaks muutmiseks, sulgemiseks jne töölehe atribuuti Rakendus. Protseduur DetectExcel Sub otsib kaht API-kutset kasutades Excelit ning kui Excel juba töötab, siseneb sellesse töötavate objektide tabeli (Running Object Table) kaudu. Kui Microsoft Excel ei tööta, põhjustab funktsiooni GetObject esimene kutse vea. Selles näites määratakse lipule ExcelWasNotRunning väärtus „True“. Funktsiooni GetObject teine kutse määrab avatava faili. Kui Excel ei tööta, siis teine kutse käivitab selle ning tagastab määratud failiga (mytest.xls) tähistatud töölehe viite. Fail peab olema määratud asukohas, muidu ilmneb Visual Basicu automatiseerimistõrge. Näidiskoodis muudetakse nähtavaks nii Excel kui ka määratud töölehe aken. Kui Exceli varasemat versiooni ei käitatud, kasutab kood Exceli sulgemiseks objekti Application meetodit Quit . Juhul kui rakendus juba töötas, siis seda sulgeda ei proovita. Viite vabastamiseks määratakse sellele väärtus Nothing (Pole).

' 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