หมายเหตุ: ฟังก์ชัน วิธีการ วัตถุ หรือคุณสมบัติที่อธิบายไว้ในหัวข้อนี้จะถูกปิดใช้งานถ้า Microsoft Jet Expression Service ทํางานในโหมด Sandbox ซึ่งจะป้องกันการประเมินนิพจน์ที่อาจไม่ปลอดภัย สําหรับข้อมูลเพิ่มเติมเกี่ยวกับโหมด Sandbox ให้ค้นหา "โหมด Sandbox" ในวิธีใช้
ส่งกลับการอ้างอิงไปยังวัตถุที่ให้มาโดยคอมโพเนนต์ ActiveX
ไวยากรณ์
GetObject([pathname ] [, class ] )
ไวยากรณ์ของฟังก์ชัน GetObject มีอาร์กิวเมนต์ดังนี้
อาร์กิวเมนต์ |
คำอธิบาย |
---|---|
pathname |
ไม่จำเป็น ตัวแปร (สตริง) เส้นทางแบบเต็มและชื่อของไฟล์ที่มีวัตถุที่จะเรียกใช้ ถ้าไม่มีการใส่ชื่อเส้นทาง จะต้องระบุคลาส |
คลาส |
ไม่จำเป็น ตัวแปร (สตริง) สตริงที่แสดง คลาส ของวัตถุ |
คลาส อาร์กิวเมนต์ ใช้ชื่อแอปไวยากรณ์objecttype และมีส่วนเหล่านี้:
ส่วน |
คำอธิบาย |
---|---|
ชื่อแอป |
จำเป็น ตัวแปร (สตริง) ชื่อของแอพลิเคชันที่จัดหาวัตถุ |
ชนิดวัตถุ |
จำเป็น ตัวแปร (สตริง) ชนิดหรือคลาสของวัตถุที่จะสร้าง |
ข้อสังเกต
หมายเหตุ: ตัวอย่างต่อไปนี้จะสาธิตการใช้ฟังก์ชันนี้ในโมดูล Visual Basic for Applications (VBA) สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการทํางานกับ VBA ให้เลือก การอ้างอิงสําหรับนักพัฒนา ในรายการดรอปดาวน์ที่อยู่ถัดจาก ค้นหา แล้วใส่คําอย่างน้อยหนึ่งคําในกล่องค้นหา
ใช้ฟังก์ชัน 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")
ถ้าคุณไม่ได้ระบุ คลาสของวัตถุ Automation จะกําหนดแอปพลิเคชันที่จะเริ่มต้นและวัตถุเพื่อเปิดใช้งาน ตามชื่อไฟล์ที่คุณระบุ อย่างไรก็ตาม บางไฟล์อาจสนับสนุนคลาสวัตถุมากกว่าหนึ่งคลาส ตัวอย่างเช่น รูปวาดอาจสนับสนุนวัตถุสามชนิดได้แก่ วัตถุ Application วัตถุ รูปวาด และวัตถุ Toolbar ซึ่งทั้งหมดเป็นส่วนหนึ่งของไฟล์เดียวกัน เมื่อต้องการระบุวัตถุในไฟล์ที่คุณต้องการเปิดใช้งาน ให้ใช้อาร์กิวเมนต์ class (ระบุหรือไม่ก็ได้) ตัวอย่างเช่น
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"
หมายเหตุ: ใช้ฟังก์ชัน GetObject เมื่อมีอินสแตนซ์ปัจจุบันของวัตถุ หรือถ้าคุณต้องการสร้างวัตถุที่มีการโหลดไฟล์ไว้แล้ว ถ้าไม่มีอินสแตนซ์ปัจจุบัน และคุณไม่ต้องการให้วัตถุเริ่มต้นด้วยไฟล์ที่โหลด ให้ใช้ฟังก์ชัน CreateObject
ถ้าวัตถุได้ลงทะเบียนตัวเองเป็นวัตถุอินสแตนซ์เดียว อินสแตนซ์เดียวของวัตถุจะถูกสร้างขึ้นไม่ว่าจะดําเนินการ CreateObject กี่ครั้งก็ตาม ด้วยวัตถุอินสแตนซ์เดียว GetObject จะส่งกลับอินสแตนซ์เดียวกันเสมอเมื่อถูกเรียกใช้ด้วยไวยากรณ์สตริงที่มีความยาวเป็นศูนย์ ("") และจะก่อให้เกิดข้อผิดพลาดถ้าอาร์กิวเมนต์ pathname ถูกละไว้ คุณไม่สามารถใช้ GetObject เพื่อรับการอ้างอิงไปยังคลาสที่สร้างด้วย Visual Basic ได้
ตัวอย่าง
ตัวอย่างนี้ใช้ฟังก์ชัน GetObject เพื่อรับการอ้างอิงไปยังเวิร์กชีต Excel ที่ระบุ (MyXL) ซึ่งจะใช้คุณสมบัติ แอปพลิเคชัน ของเวิร์กชีตเพื่อทําให้ Excel มองเห็นได้ ปิด และอื่นๆ เมื่อใช้การเรียก API สองตัว กระบวนงาน ย่อย DetectExcel จะค้นหา Excel และถ้ากําลังทํางานอยู่ ให้ใส่ในตารางวัตถุที่กําลังทํางานอยู่ การเรียก GetObject ครั้งแรกจะทําให้เกิดข้อผิดพลาดถ้า Microsoft Excel ไม่ได้ทํางานอยู่ ในตัวอย่าง ข้อผิดพลาดทําให้ค่าสถานะ ExcelWasNotRunning ถูกตั้งค่าเป็น True การโทรครั้งที่สอง GetObject จะระบุไฟล์ที่จะเปิด ถ้า Excel ไม่ได้ทํางานอยู่ การโทรครั้งที่สองจะเริ่มต้นและส่งกลับการอ้างอิงไปยังเวิร์กชีตที่แสดงโดยไฟล์ที่ระบุ mytest.xls แฟ้มต้องมีอยู่ในตําแหน่งที่ตั้งที่ระบุ มิฉะนั้น จะเกิดข้อผิดพลาด Visual Basic Error Automation จากนั้น โค้ดตัวอย่างจะทําให้ทั้ง Excel และหน้าต่างที่มีเวิร์กชีตที่ระบุสามารถมองเห็นได้ สุดท้าย ถ้าไม่มี Excel เวอร์ชันก่อนหน้าทํางาน อยู่ โค้ดจะใช้เมธอด Quit ของวัตถุ Application เพื่อปิด Excel ถ้าโปรแกรมประยุกต์ทํางานอยู่แล้ว จะไม่มีการพยายามปิดโปรแกรมประยุกต์นั้น การอ้างอิงจะถูกเผยแพร่โดยการตั้งค่าเป็น ไม่มี
' 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