BlockView_PreLoadDwg Method
Description
This method preload a drawing into the BlockView control for displaying it's internal blocks. Use the BlockView_DisplayBlock (Using Camera Offset) or BlockView_DisplayBlock (Using Preset Views) method to display any blocks that reside in the Dwg file that this method will have just loaded.
Parameters
- MyControlReference
- Reference to the control in the form of MyProject_MyForm_MyControl.
- ProjectFile
- String identifying the project as it was passed in LoadProject.
- DialogName
- String identifying the dialog by name.
- ControlName
- String identifying the control by name.
- sDwgFileName
- String identifying the file name of the drawing to preload.
Return Values
Returns the following according to the situation:
AutoLISP Syntax
The recommended convention is passing the control identifier directly:
 Copy Code |
|---|
(Odcl_BlockView_PreLoadDwg MyControlReference [as Reference] sDwgFileName [as String] ) |
An alternative convention is to identify the control by providing the project file, the dialog name and the control name:
| Copy Code |
|---|
(Odcl_BlockView_PreLoadDwg ProjectFile [as String] DialogName [as String] ControlName [as String] sDwgFileName [as String] ) |
Applies For
Example
| Copy Code |
|---|
; Preload this drawing (Odcl_BlockView_PreLoadDwg MyProject_MyForm_MyControl "C:\Program Files\AutoCAD 2010\Sample\Dynamic Blocks\Structural - Metric.dwg") |