Pastaba: Šioje temoje aprašyta funkcija, metodas, objektas arba ypatybė yra išjungta, jei "Microsoft Jet Expression Service" veikia smėlio dėžės režimu, kuris neleidžia įvertinti galimai nesaugių reiškinių. Jei reikia daugiau informacijos apie smėlio dėžės režimą, žinyne ieškokite "smėlio dėžės režimas".
Pateikia objekto, kurį pateikė "ActiveX" komponentas, nuorodą.
Sintaksė
GetObject([kelio pavadinimas ] [, klasė ] )
Funkcijos GetObject sintaksė turi tokius argumentus:
|
Argumentas |
Aprašas |
|
kelio pavadinimas |
Pasirinktinis. Variantas (eilutė). Visas failo, kuriame yra objektas, kelias ir pavadinimas, kurį reikia nuskaityti. Jei pathname nenurodytas, būtina klasė . |
|
klasė |
Pasirinktinis. Variantas (eilutė). Eilutė, vaizduojanti objekto klasė. |
Klasės argumentas naudoja sintaksę appname.objecttype ir yra šių dalių:
|
Dalis |
Aprašas |
|
taikomosios programos pavadinimas |
Būtinas. Variantas (eilutė). Objektą teikiančios taikomosios programos pavadinimas. |
|
objekto tipas |
Būtinas. Variantas (eilutė). Kuriamo objekto tipas arba klasė. |
Pastabos
Pastaba: Pateiktuose pavyzdžiuose parodyta, kaip naudoti šią funkciją „Visual Basic for Applications“ (VBA) modulyje. Daugiau informacijos apie darbą su VBA rasite išplečiamajame sąraše pasirinkę Kūrėjų nuoroda (šalia Ieškos) ir ieškos lauke įvedę vieną ar daugiau sąlygų.
Naudokite funkciją GetObject , kad pasiektumėte ActiveX objektą iš failo ir priskirtumėte objektą objekto kintamasis. Naudokite sakinį Nustatyti , kad priskirtumėte objektą, kurį GetObject grąžino objekto kintamajam. Pavyzdžiui:
Dim CADObject As Object
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")
Vykdant šį kodą, su nurodytu kelio pavadinimu susieta programa paleidžiama ir suaktyvinamas nurodytame faile esantis objektas.
Jei pathname yra nulinio ilgio eilutė (""), GetObject grąžina naują nurodyto tipo objekto egzempliorių. Jei kelio pavadinimo argumentas praleistas, GetObject pateikia šiuo metu aktyvų nurodyto tipo objektą. Jei nurodyto tipo objekto nėra, įvyksta klaida.
Kai kurios programos leidžia suaktyvinti dalį failo. Failo vardo pabaigoje įtraukite šauktuką (!) ir sekite juo eilutę, identifikuojančią failo, kurį norite aktyvinti, dalį. Informacijos, kaip sukurti šią eilutę, ieškokite programos, kuri sukūrė objektą, dokumentacijoje.
Pavyzdžiui, piešinio taikomojoje programoje gali būti keli piešinio sluoksniai, saugomi faile. Galite naudoti šį kodą norėdami suaktyvinti sluoksnį piešinyje, vadinamą SCHEMA.CAD:
Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")
Jei nenurodysite objekto klasės, automatizavimas nustatys programą paleisti ir aktyvinti norimą objektą pagal jūsų nurodytą failo vardą. Tačiau kai kurie failai gali palaikyti daugiau nei vieną objekto klasę. Pvz., piešinys gali palaikyti trijų tipų objektus : programos objektą, piešimo objektą ir įrankių juostos objektą, kurie visi yra to paties failo dalis. Norėdami nurodyti, kurį objektą norite aktyvinti faile, naudokite pasirinktinį klasės argumentą. Pavyzdžiui:
Dim MyObject As Object
Set MyObject = GetObject("C:\DRAWINGS\SAMPLE.DRW", _
"FIGMENT.DRAWING")
Pavyzdyje FIGMENT yra piešimo programos pavadinimas, DRAWING yra vienas iš palaikomų objektų tipų.
Suaktyvinę objektą, jį nurodote kode naudodami apibrėžtą objekto kintamąjį. Ankstesniame pavyzdyje galite pasiekti naujo objekto ypatybes ir metodus naudodami objekto kintamąjį MyObject. Pavyzdžiui:
MyObject.Line 9, 90
MyObject.InsertText 9, 100, "Hello, world."
MyObject.SaveAs "C:\DRAWINGS\SAMPLE.DRW"
Pastaba: Naudokite funkciją GetObject , kai yra dabartinis objekto egzempliorius, arba jei norite sukurti objektą su jau įkeltu failu. Jei dabartinio egzemplioriaus nėra ir nenorite, kad objektas būtų pradėtas su įkeltu failu, naudokite funkciją CreateObject .
Jei objektas užregistravo save kaip vieno egzemplioriaus objektą, sukuriamas tik vienas objekto egzempliorius, neatsižvelgiant į tai, kiek kartų vykdomas CreateObject . Naudojant vieno egzemplioriaus objektą, GetObject visada pateikia tą patį egzempliorių, kai iškviečiamas naudojant nulinio ilgio eilutės ("") sintaksę, ir dėl to įvyksta klaida, jei kelio pavadinimo argumentas praleistas. Negalite naudoti GetObject norėdami gauti nuorodą į klasę, sukurtą naudojant Visual Basic.
Pavyzdys
Šiame pavyzdyje funkcija GetObject naudojama norint gauti nuorodą į konkretų Microsoft Office Excel 2007 darbalapį (MyXL). Ji naudoja darbalapio ypatybę Programa , kad programa "Excel" būtų matoma, uždaryta ir t. t. Naudojant du API iškvietimus, "DetectExcel" antrinė procedūra ieško "Excel" ir, jei ji veikia, įveda ją į lentelę Vykdoma. Jei programa "Microsoft Excel" dar nepaleista, pirmą kartą iškviečiant " GetObject " įvyksta klaida. Pavyzdyje dėl klaidos "ExcelWasNotRunning" vėliavėlė nustatoma kaip Teisinga. Antrasis GetObject iškvietimas nurodo failą, kurį reikia atidaryti. Jei programa "Excel" dar nepaleista, antrasis skambutis paleidžiamas ir pateikiama nuoroda į darbalapį, kurį nurodo nurodytas failas, mytest.xls. Failas turi būti nurodytoje vietoje; kitu atveju sugeneruojama Visual Basic klaidos automatizavimo klaida. Tada pagal pavyzdinį kodą matoma ir "Excel", ir langas, kuriame yra nurodytas darbalapis. Galiausiai, jei ankstesnės "Excel" versijos nebuvo paleista, programai "Excel" uždaryti kodas naudoja programos objektoquit metodą. Jei taikomoji programa jau buvo paleista, jos uždaryti nebandyta. Nuoroda išleidžiama nustatant reikšmę Nieko.
' 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
