ฟังก์ชัน GetObject

ส่งกลับการอ้างอิงไปยังวัตถุที่ให้โดยคอมโพเนนต์ ActiveX

ไวยากรณ์

GetObject([pathname ] [, class ] )

ไวยากรณ์ของฟังก์ชัน GetObject มีอาร์กิวเมนต์ดังนี้

อาร์กิวเมนต์	คำอธิบาย
pathname	ไม่จำเป็น ตัวแปร (สตริง) เส้นทางแบบเต็มและชื่อของไฟล์ที่มีวัตถุที่จะเรียกใช้ ถ้า pathname ถูกละไว้ จําเป็นต้องมี class
คลาส	ไม่จำเป็น ตัวแปร (สตริง) สตริงที่แสดงคลาสของวัตถุ

อาร์กิวเมนต์คลาสใช้ไวยากรณ์ appname.objecttype และมีส่วนต่างๆ ดังนี้:

ส่วน	คำอธิบาย
AppName	จำเป็น ตัวแปร (สตริง) ชื่อของแอปพลิเคชันที่ทําให้เกิดวัตถุ
objecttype	จำเป็น ตัวแปร (สตริง) ชนิดหรือคลาสของวัตถุที่จะสร้าง

ข้อสังเกต

ใช้ฟังก์ชัน GetObject เพื่อเข้าถึงวัตถุ ActiveX จากไฟล์ และกําหนดวัตถุเป็นตัวแปรของวัตถุ ใช้คําสั่ง Set เพื่อกําหนดวัตถุที่ส่งกลับโดย GetObject เป็นตัวแปรของวัตถุ ตัวอย่างเช่น

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

เมื่อโค้ดนี้ถูกดําเนินการ แอปพลิเคชันที่เชื่อมโยงกับ ชื่อเส้นทาง ที่ระบุจะเริ่มทํางาน และวัตถุในไฟล์ที่ระบุจะถูกเปิดใช้งาน

ถ้า pathname เป็นสตริงที่มีความยาวเป็นศูนย์ ("") GetObject จะส่งกลับอินสแตนซ์วัตถุใหม่ของชนิดที่ระบุ ถ้าอาร์กิวเมนต์ pathname ถูกละไว้ GetObject จะส่งกลับวัตถุที่ใช้งานอยู่ในปัจจุบันของชนิดที่ระบุ ถ้าไม่มีวัตถุของชนิดที่ระบุอยู่ จะเกิดข้อผิดพลาดขึ้น

บางแอปพลิเคชันอนุญาตให้คุณเปิดใช้งานส่วนของไฟล์ เพิ่มเครื่องหมายอัศเจรีย์ (!) ต่อท้ายชื่อไฟล์ แล้วตามด้วยสตริงที่ระบุส่วนของไฟล์ที่คุณต้องการเปิดใช้งาน สําหรับข้อมูลเกี่ยวกับวิธีการสร้างสตริงนี้ ให้ดูเอกสารสําหรับแอปพลิเคชันที่สร้างวัตถุ

ตัวอย่างเช่น ในแอปพลิเคชันรูปวาด คุณอาจมีหลายชั้นของรูปวาดที่จัดเก็บไว้ในไฟล์ คุณสามารถใช้โค้ดต่อไปนี้เพื่อเปิดใช้งานเลเยอร์ภายในรูปวาดที่เรียกว่า SCHEMA.CAD:

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

ถ้าคุณไม่ได้ระบุ คลาสของวัตถุ ระบบอัตโนมัติจะกําหนดแอปพลิเคชันเพื่อเริ่มต้นและวัตถุที่จะเปิดใช้งาน โดยยึดตามชื่อไฟล์ที่คุณระบุไว้ อย่างไรก็ตาม บางไฟล์อาจสนับสนุนวัตถุมากกว่าหนึ่งคลาส ตัวอย่างเช่น รูปวาดอาจสนับสนุนวัตถุสามชนิดแตกต่างกัน คือ วัตถุ แอปพลิเคชัน วัตถุ รูปวาด และวัตถุ แถบเครื่องมือ ซึ่งทั้งหมดนี้เป็นส่วนหนึ่งของไฟล์เดียวกัน เมื่อต้องการระบุวัตถุในไฟล์ที่คุณต้องการเปิดใช้งาน ให้ใช้อาร์กิวเมนต์ คลาส เสริม ตัวอย่างเช่น

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

ในตัวอย่าง เป็น FIGMENT ชื่อของแอปพลิเคชันรูปวาดและ DRAWING เป็นหนึ่งในชนิดวัตถุที่สนับสนุน

เมื่อวัตถุถูกเปิดใช้งาน คุณจะอ้างอิงวัตถุนั้นในโค้ดโดยใช้ตัวแปรวัตถุที่คุณกําหนด ในตัวอย่างก่อนหน้า คุณเข้าถึงคุณสมบัติและเมธอดของวัตถุใหม่โดยใช้ตัวแปรวัตถุMyObject ตัวอย่างเช่น

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

ถ้าวัตถุลงทะเบียนตัวเองเป็นวัตถุอินสแตนซ์เดียว จะมีการสร้างอินสแตนซ์ของวัตถุเพียงเดียว ไม่ว่า CreateObject จะถูกดําเนินการกี่ครั้งก็ตาม ด้วยวัตถุอินสแตนซ์เดียว GetObject จะส่งกลับอินสแตนซ์เดียวกันเสมอเมื่อถูกเรียกใช้ด้วยไวยากรณ์สตริงความยาวเป็นศูนย์ ("") และจะทําให้เกิดข้อผิดพลาดถ้าไม่ใส่อาร์กิวเมนต์ชื่อเส้นทาง คุณไม่สามารถใช้ GetObject เพื่อรับการอ้างอิงไปยังคลาสที่สร้างด้วย Visual Basic

ตัวอย่าง

ตัวอย่างนี้ใช้ฟังก์ชัน GetObject เพื่อรับการอ้างอิงไปยังเวิร์กชีต Excel ที่ระบุ (MyXL) ซึ่งใช้คุณสมบัติ แอปพลิเคชัน ของเวิร์กชีตเพื่อทําให้ Excel ปรากฏ ปิด และอื่นๆ ใช้การเรียก API สองครั้ง กระบวนการ ย่อย DetectExcel จะค้นหา Excel และถ้ากําลังทํางานอยู่ ให้ใส่ลงในตารางวัตถุที่กําลังทํางานอยู่ การเรียกใช้ GetObject ครั้งแรกจะทําให้เกิดข้อผิดพลาดถ้า Microsoft Excel ไม่ได้ทํางานอยู่ ในตัวอย่าง ข้อผิดพลาดทําให้ค่าสถานะ ExcelWasNotRunning ถูกตั้งค่าเป็น True การเรียกใช้ GetObject ครั้งที่สองจะระบุไฟล์ที่จะเปิด ถ้า Excel ยังไม่ทํางาน การเรียกใช้ครั้งที่สองจะเริ่มทํางานและส่งกลับการอ้างอิงไปยังเวิร์กชีตที่แสดงแทนโดยไฟล์ mytest.xls ที่ระบุ ไฟล์จะต้องอยู่ในตําแหน่งที่ตั้งที่ระบุ มิฉะนั้น ข้อผิดพลาด Visual Basic โดยอัตโนมัติจะถูกสร้างขึ้น ต่อไป โค้ดตัวอย่างนี้ทําให้ทั้ง Excel และหน้าต่างที่มีเวิร์กชีตที่ระบุสามารถมองเห็นได้ สุดท้าย ถ้าไม่มี Excel เวอร์ชันก่อนหน้าทํางานอยู่ โค้ดจะใช้วิธี Quitของวัตถุแอปพลิเคชันเพื่อปิด Excel ถ้าแอปพลิเคชันกําลังทํางานอยู่ จะไม่มีการพยายามปิด การอ้างอิงนั้นจะถูกปล่อยโดยการตั้งค่าเป็น Nothing.

' 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