Funkcja GetObject

Uwaga: Funkcja, metoda, obiekt lub właściwość opisana w tym temacie jest wyłączona, jeśli usługa wyrażeń programu Microsoft Jet działa w trybie piaskownicy, co uniemożliwia ocenę potencjalnie niebezpiecznych wyrażeń. Aby uzyskać więcej informacji na temat trybu piaskownicy, wyszukaj "tryb piaskownicy" w Pomocy.

Zwraca odwołanie do obiektu udostępnianego przez składnik ActiveX.

Składnia

GetObject([nazwa_ścieżki] [ , klasa ] )

W składni funkcji GetObject występują następujące argumenty:

Argument

Opis

nazwa_ścieżki

Argument opcjonalny. Wariant(ciąg). Pełna ścieżka i nazwa pliku zawierającego obiekt do pobrania. Jeśli nazwa_ścieżki zostanie pominięta, wymagana jest klasa.

klasa

Argument opcjonalny. Wariant(ciąg). Ciąg reprezentujący klasa obiektu.


W tejargument ma nazwę aplikacji składni.obiektotyp i zawiera następujące części:

Segment

Opis

nazwa_aplikacji

Argument wymagany. Wariant(ciąg). Nazwa aplikacji udostępniacej obiekt.

typ_obiektu

Argument wymagany. Wariant(ciąg). Typ lub klasa obiektu do utworzenia.


Spostrzeżenia

Uwaga: Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.

Użyj funkcji GetObject, aby uzyskać dostęp do obiektu ActiveX z pliku i przypisać ten obiekt do zmienna obiektu. Użyj instrukcji Set, aby przypisać obiekt zwrócony przez obiekt GetObject do zmiennej obiektu. Przykład:

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

Po wykonaniu tego kodu zostanie uruchomiona aplikacja skojarzona z określoną nazwą ścieżki i obiekt w określonym pliku zostanie aktywowany.

Jeśli nazwa_ścieżki jest ciągiem o zerowej długości (""), funkcja GetObject zwraca nowe wystąpienie obiektu określonego typu. Jeśli argument nazwa_ścieżki zostanie pominięty, funkcja GetObject zwraca obecnie aktywny obiekt określonego typu. Jeśli nie istnieje żaden obiekt o określonym typie, wystąpi błąd.

Niektóre aplikacje umożliwiają aktywowanie części pliku. Dodaj wykrzyknik (!) na końcu nazwy pliku i postępuj zgodnie z nim ciągiem określającym część pliku, którą chcesz aktywować. Aby uzyskać informacje na temat tworzenia tego ciągu, zapoznaj się z dokumentacją aplikacji, która utworzyła obiekt.

Na przykład w aplikacji do rysowania w pliku może być przechowywanych wiele warstw do rysunku. Aby aktywować warstwę na rysunku o nazwie SCHEMA.CAD, można użyć następującego kodu:

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

Jeśli nie określisz klasy obiektu,automatyzacja określa aplikację do uruchomienia oraz obiekt do aktywowania na podstawie nazwy pliku, która zostanie podana. Niektóre pliki mogą jednak obsługiwać więcej niż jedną klasę obiektów. Na przykład rysunek może obsługiwać trzy różne typy obiektów: obiekt aplikacji,obiekt rysunek i obiekt paska narzędzi, z których wszystkie są częścią tego samego pliku. Aby określić obiekt w pliku, który ma zostać aktywowany, użyj opcjonalnego argumentu klasy. Przykład:

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

W tym przykładzie FIGMENT nazwą aplikacji do rysowania, a DRAWING jest jednym z typów obiektów, które obsługuje.

Po aktywowaniu obiektu należy do niego odwoływać się w kodzie przy użyciu zdefiniowanej zmiennej obiektu. W poprzednim przykładzie uzyskujesz dostęp do właściwości i metod nowego obiektu przy użyciu zmiennej MyObject. Przykład:

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

Uwaga:  Funkcji GetObject należy używać, gdy istnieje bieżące wystąpienie obiektu lub jeśli chcesz utworzyć obiekt z już załadowanym plikiem. Jeśli nie ma bieżącego wystąpienia i nie chcesz, aby obiekt zaczynał się od załadowania pliku, użyj funkcji CreateObject.

Jeśli obiekt zarejestrował się jako obiekt jedno wystąpienie, zostanie utworzone tylko jedno wystąpienie tego obiektu, niezależnie od tego, ile razy jest wykonywany element CreateObject. W przypadku obiektu jedno wystąpienie funkcja GetObject zawsze zwraca to samo wystąpienie w przypadku połączenia z składnią ciągu o zerowej długości ("") i powoduje błąd, jeśli argument nazwa_ścieżki zostanie pominięty. Za pomocą funkcji GetObject nie można uzyskać odwołania do klasy utworzonej za pomocą języka Visual Basic.

Przykład

W tym przykładzie użyto funkcji GetObject w celu uzyskania odwołania do określonego Microsoft Office Excel 2007 arkusza (MyXL). Używa ona właściwości Application arkusza, aby program Excel był widoczny, aby go zamknąć i tak dalej. Za pomocą dwóch wywołań interfejsu API procedura DetectExcel Sub wyszukuje program Excel, a jeśli jest uruchomiony, wprowadza go do uruchomionej tabeli obiektów. Pierwsze wywołanie do programu GetObject powoduje błąd, jeśli program Microsoft Excel nie jest jeszcze uruchomiony. W tym przykładzie błąd powoduje, że flaga ExcelWasNotRunning ma wartość Prawda. Drugie wywołanie do getObject określa plik do otwarcia. Jeśli program Excel nie jest jeszcze uruchomiony, zostanie uruchomione drugie wywołanie i zwróci odwołanie do arkusza reprezentowanego przez mytest.xls. Plik musi znajdować się w określonej lokalizacji. w przeciwnym razie zostanie wygenerowany błąd automatyzacji języka Visual Basic. Następnie w przykładowym kodzie widać zarówno program Excel, jak i okno zawierające określony arkusz. Na koniec, jeśli nie było poprzedniej wersji programu Excel, kod używa metody Quit obiektu Application do zamknięcia programu Excel. Jeśli aplikacja była już uruchomiona, nie jest podejmowana próba jej zamknięcia. Odwołanie jest zwalniane przez ustawienie wartości Nic.

' 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

Potrzebna dalsza pomoc?

Rozwijaj umiejętności związane z pakietem Office
Poznaj szkolenia
Uzyskuj nowe funkcje w pierwszej kolejności
Dołącz do niejawnych testerów pakietu Office