E
Issue 2.0 June 2002 171
E
This section contains functions and methods with names that begin with the letter E.
EditEnabled (function)
Syntax
EditEnabled(
name$
|
id
)
Description Returns 
True
if the given text box is enabled within the active window or dialog box; returns 
False
otherwise.
Comments
The 
EditEnabled
function takes the following parameters:
A runtime error is generated if a text box control with the given name or ID cannot be found within 
the active window.
If enabled, the text box can be given the focus using the 
ActivateControl 
statement.
Note:   The 
EditEnabled
function is used to determine whether a text box is enabled in another 
application's dialog box. Use the 
DlgEnable
function in dynamic dialog boxes.
Example
'This example adjusts the left margin if this control is enabled.
Sub Main()
Menu "Format.Paragraph"
If EditEnabled("Left:") Then
SetEditText "Left:","5 pt"
End If
End Sub
See Also
EditExists
(function); 
GetEditText$
(function); 
SetEditText
(statement).
Platform(s) 16-bit Windows.
Parameter
Description
name$
String containing the name of the text box.
The name of a text box is determined by scanning the window 
list looking for a text control with the given name that is 
immediately followed by a text box.
id
Integer specifying the ID of the text box.
Pdf search and replace text - search text inside PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Learn how to search text in PDF document and obtain text content and location information
how to search text in pdf document; cannot select text in pdf file
Pdf search and replace text - VB.NET PDF Text Search Library: search text inside PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Learn How to Search Text in PDF Document and Obtain Text Content and Location Information in VB.NET application
pdf text select tool; searching pdf files for text
Chapter 1   A-Z Reference
172 IC Scripts VBA Scripting Reference
EditExists (function)
Syntax
EditExists(
name$
|
id
)
Description Returns 
True
if the given text box exists within the active window or dialog box; returns 
False
otherwise.
Comments
The 
EditExists
function takes the following parameters:
A runtime error is generated if a text box control with the given name or ID cannot be found within 
the active window.
If there is no active window, 
False
will be returned.
Note:   The 
EditExists
function is used to determine whether a text box exists in another application's 
dialog box. There is no equivalent function for use with dynamic dialog boxes.
Example
'This example adjusts the left margin if this control exists
' and is enabled.
Sub Main()
Menu "Format.Paragraph"
If EditExists("Left:") Then
If EditEnabled("Left:") Then
SetEditText "Left:","5 pt"
End If
End If
End Sub
See Also
EditEnabled
(function); 
GetEditText$
(function); 
SetEditText
(statement).
Platform(s) 16-bit Windows.
End (statement)
Syntax
End
Description Terminates execution of the current script, closing all open files.
Example
'This example uses the End statement to stop execution.
Sub Main()
MsgBox "The next line will terminate the script."
End
End Sub
Parameter
Description
name$
String containing the name of the text box.
The name of a text box is determined by scanning the window 
list looking for a text control with the given name that is 
immediately followed by a text box.
id
Integer specifying the ID of the text box.
C# PDF replace text Library: replace text in PDF content in C#.net
public void Replace(String oldString, String newString, RESearchOption option specified string text that match the search option from specified PDF page.
text searchable pdf; how to make a pdf file text searchable
VB.NET PDF replace text library: replace text in PDF content in vb
NET: Replace Text in PDF File. The following coding example illustrates how to perform PDF text replacing function in your VB.NET project, according to search
pdf make text searchable; how to select text in pdf
Environ, Environ$ (functions)
Issue 2.0 June 2002 173
See Also
Close
(statement); 
Stop
(statement); 
Exit For
(statement); 
Exit Do 
(statement); 
Exit Function
(statement); 
Exit Sub
(statement).
Platform(s) All.
Environ, Environ$ (functions)
Syntax
Environ[$](
variable$
|
VariableNumber
)
Description Returns the value of the specified environment variable.
Comments
Environ$
returns a 
String
, whereas 
Environ
returns a 
String
variant.
If 
variable$
is specified, then this function looks for that 
variable$
in the environment. If the 
variable$
name cannot be found, then a zero-length string is returned.
If 
VariableNumber
is specified, then this function looks for the Nth variable within the environment 
(the first variable being number 1). If there is no such environment variable, then a zero-length 
string is returned. Otherwise, the entire entry from the environment is returned in the following 
format: 
variable = value
Example
'This example looks for the DOS Comspec variable and displays
'the value in a dialog box.
Sub Main()
Dim a$(1)
a$(1) = Environ$("COMSPEC")
MsgBox "The DOS Comspec variable is set to: " & a$(1)
End Sub
See Also
Command
Command$
(functions).
Platform(s) All.
EOF (function)
Syntax
EOF(
filenumber
)
Description Returns 
True
if the end-of-file has been reached for the given file; returns 
False
otherwise.
Comments
The 
filenumber
parameter is an 
Integer
used by IC Script to refer to the open file—the number 
passed to the 
Open
statement.
With sequential files, 
EOF
returns 
True
when the end of the file has been reached (i.e., the next file 
read command will result in a runtime error).
With Random or Binary files, 
EOF
returns 
True
after an attempt has been made to read beyond the 
end of the file. Thus, 
EOF
will only return 
True
when 
Get
was unable to read the entire record.
C# PDF delete text Library: delete, remove text from PDF file in
option). Description: Delete specified string text that match the search option from PDF file. Parameters: Name, Description, Valid Value.
pdf text searchable; search pdf for text
VB.NET PDF- View PDF Online with VB.NET HTML5 PDF Viewer
Text from PDF. Text: Search Text in PDF. Image: Extract Image from PDF. PDF Write. Text: Insert Text to PDF. Text: Delete Text from PDF. Text: Replace Text in PDF
pdf text search; make pdf text searchable
Chapter 1   A-Z Reference
174 IC Scripts VBA Scripting Reference
Example
'This example opens the autoexec.bat file and reads lines from
'the file until the end-of-file is reached.
Const crlf = Chr$(13) + Chr$(10)
Sub Main()
Dim s$
Open "c:\autoexec.bat" For Input As #1
Do While Not EOF(1)
Input #1,s$
Loop
Close
MsgBox "The last line was:" & crlf & s$
End Sub
See Also
Open
(statement); 
Lof
(function).
Platform(s) All.
Eqv (operator)
Syntax
result
=
expression1
Eqv
expression2
Description Performs a logical or binary equivalence on two expressions.
Comments
If both expressions are either 
Boolean
Boolean
variants, or 
Null
variants, then a logical equivalence is 
performed as follows:
If either expression is 
Null
, then 
Null
is returned.
Binary Equivalence
If the two expressions are 
Integer
, then a binary equivalence is performed, returning an 
Integer
result. 
All other numeric types (including 
Empty
variants) are converted to 
Long
and a binary equivalence 
is then performed, returning a 
Long
result.
Binary equivalence forms a new value based on a bit-by-bit comparison of the binary 
representations of the two expressions, according to the following table:
If 
expression1
is
and 
expression2
is
then the 
result
is
True
True
True
True
False
False
False
True
False
False
False
True
If bit in 
expression1
is
and bit in 
expression2
is
the 
result
is
1
1
1
VB.NET PDF Page Replace Library: replace PDF pages in C#.net, ASP.
Text from PDF. Text: Search Text in PDF. Image: Extract Image from PDF. PDF Write. Text: Insert Text to PDF. Text: Delete Text from PDF. Text: Replace Text in PDF
search pdf documents for text; convert pdf to searchable text
C# PDF Page Replace Library: replace PDF pages in C#.net, ASP.NET
You can replace an entire PDF page with another PDF page from another PDF file. All information, data on the original page are removed, including text, images
pdf searchable text converter; how to select text in pdf reader
Erase (statement)
Issue 2.0 June 2002 175
Example
'This example assigns False to A, performs some equivalent
'operations, and displays a dialog box with the result. Since A
'is equivalent to False, and False is equivalent to 0, and by
'definition, A = 0, then the dialog box will display "A is False."
Sub Main()
a = False
If ((a Eqv False) And (False Eqv 0) And (a = 0)) Then
MsgBox "a is False."
Else
MsgBox "a is True."
End If
End Sub
See Also
Operator Precedence (topic); 
Or
(operator); 
Xor
(operator); 
Imp
(operator); 
And
(operator).
Platform(s) All.
Erase (statement)
Syntax
Erase array1 [,array2]...
Description Erases the elements of the specified arrays.
Comments
For dynamic arrays, the elements are erased, and the array is redimensioned to have no dimensions 
(and therefore no elements). For fixed arrays, only the elements are erased; the array dimensions 
are not changed.
After a dynamic array is erased, the array will contain no elements and no dimensions. Thus, 
before the array can be used by your program, the dimensions must be reestablished using the 
Redim
statement.
Up to 32 parameters can be specified with the 
Erase
statement.
The meaning of erasing an array element depends on the type of the element being erased:
0
1
0
1
0
0
0
0
1
Element Type
What Erase Does to That Element
Integer
Sets the element to 0.
Boolean
Sets the element to False.
Long
Sets the element to 0.
Double
Sets the element to 0.0.
Date
Sets the element to December 30, 1899.
If bit in 
expression1
is
and bit in 
expression2
is
the 
result
is
C# HTML5 PDF Viewer SDK to view PDF document online in C#.NET
Text from PDF. Text: Search Text in PDF. Image: Extract Image from PDF. PDF Write. Text: Insert Text to PDF. Text: Delete Text from PDF. Text: Replace Text in PDF
pdf find highlighted text; convert pdf to searchable text online
C# PDF Text Highlight Library: add, delete, update PDF text
Description: Highlight specified string text that match the search option from PDF file. Parameters: Name, Description, Valid Value.
search multiple pdf files for text; pdf search and replace text
Chapter 1   A-Z Reference
176 IC Scripts VBA Scripting Reference
Example
'This example puts a value into an array and displays it. Then
'it erases the value and displays it again.
Sub Main()
Dim a$(10) 'Declare an array.
a$(1) = Dir$("*") 'Fill element 1 with a filename.
MsgBox "Array before Erase: " & a$(1)'Display element 1.
Erase a$
'Erase all elements in the array.
MsgBox "Array after Erase: " & a$(1)'Display element 1
'again (should be
'erased).
End Sub
See Also
Redim
(statement); Arrays (topic).
Platform(s) All.
Erl (function)
Syntax
Erl[()]
Description Returns the line number of the most recent error.
Comments
The first line of the script is 1, the second line is 2, and so on.
The internal value of 
Erl
is reset to 0 with any of the following statements: 
Resume
Exit Sub
Exit 
Function
. Thus, if you want to use this value outside an error handler, you must assign it to a 
variable.
Example
'This example generates an error and then determines the line
'on which the error occurred.
Sub Main()
Dim i As Integer
On Error Goto Trap1
i = 32767 'Generate an error--overflow.
i = i + 1
Single
Sets the element to 0.0.
String (variable-length)
Frees the string, then sets the element to a zero-
length string.
String (fixed-length)
Sets every character of each element to zero 
(Chr$(0)).
Object
Decrements the reference count and sets the 
element to Nothing.
Variant
Sets the element to Empty.
User-defined type
Sets each structure element as a separate variable.
Element Type
What Erase Does to That Element
Err.Clear (method)
Issue 2.0 June 2002 177
Exit Sub
Trap1:
MsgBox "Error on line: " & Erl
Exit Sub
'Reset the error handler.
End Sub
See Also
Error Handling (topic).
Platform(s) All.
Err.Clear (method) 
Syntax
Err.Clear
Description Clears the properties of the 
Err
object.
Comments
After this method has been called, the properties of the 
Err
object will have the following values:
The properties of the 
Err
object are automatically reset when any of the following statements are 
executed:
Resume
Exit Function
On Error
Exit Sub
Example
'The following script gets input from the user using error
'checking.
Sub Main()
Dim x As Integer
On Error Resume Next
x = InputBox("Type in a number")
If Err.Number <> 0 Then
Err.Clear
x = 0
End If
MsgBox x
End Sub
See Also
Error Handling (topic); 
Err.Description
(property); 
Err.HelpContext
(property); 
Err.HelpFile
(property); 
Err.LastDLLError
(property); 
Err.Number
(property); 
Err.Source
(property).
Platform(s) All.
Property
Value
Err.Description
""
Err.HelpContext
0
Err.HelpFile
""
Err.LastDLLError
0
Err.Number
0
Err.Source
""
Chapter 1   A-Z Reference
178 IC Scripts VBA Scripting Reference
Err.Description (property) 
Syntax
Err.Description [=
stringexpression
]
Description Sets or retrieves the description of the error.
Comments
For errors generated by IC Script, the 
Err.Description
property is automatically set.
For user-defined errors, you should set this property to be a description of your error. If you set the 
Err.Number
property to one of IC Script’s internal error numbers and you don’t set the 
Err.Description
property, then the 
Err.Description
property is automatically set when the error is generated (i.e., with 
Err.Raise
).
Example
'The following script gets input from the user using error
'checking. When an error occurs, the Err.Description property
'is displayed to the user and execution continues with a default
'value.
Sub Main()
Dim x As Integer
On Error Resume Next
x = InputBox("Type in a number")
If Err.Number <> 0 Then
MsgBox "The following error occurred: " & Err.Description
x = 0
End If
MsgBox x
End Sub
See Also
Error Handling (topic); Err.Clear (method); Err.HelpContext (property); Err.HelpFile
(property); Err.LastDLLError (property); Err.Number (property); Err.Source (property).
Platform(s) All.
Err.HelpContext (property) 
Syntax
Err.HelpContext [=
contextid
]
Description Sets or retrieves the help context ID that identifies the help topic for information on the error.
Comments
The 
Err.HelpContext
property, together with the 
Err.HelpFile
property, contain sufficient information to 
display help for the error.
When IC Script generates an error, the 
Err.HelpContext
property is set to 0 and the and the 
Err.HelpFile
property is set to ""; the value of the 
Err.Number
property is sufficient for displaying help in this 
case. The exception is with errors generated by an OLE automation server; both the 
Err.HelpFile
and 
Err.HelpContext
properties are set by the server to values appropriate for the generated error.
When generating your own user-define errors, you should set the 
Err.HelpContext
property and the 
Err.HelpFile
property appropriately for your error. If these are not set, then IC Script displays its own 
help at an appropriate place.
Err.HelpFile (property)
Issue 2.0 June 2002 179
Example
'This example defines a replacement for InputBox that deals
'specifically with Integer values. If an error occurs, the
'function generates a user-defined error that can be trapped
'by the caller.
Function InputInteger(Prompt,Optional Title,Optional Def)
On Error Resume Next
Dim x As Integer
x = InputBox(Prompt,Title,Def)
If Err.Number Then
Err.HelpContext = "WIDGET.HLP"
Err.HelpContext = 10
Err.Description = "Integer value expected"
InputInteger = Null
Err.Raise 3000
End If
InputInteger = x
End Function
Sub Main
Dim x As Integer
Do
On Error Resume Next
x = InputInteger("Enter a number:")
Loop Until Err.Number <> 3000
End Sub
See Also
Error Handling (topic); 
Err.Clear
(method); 
Err.Description
(property); 
Err.HelpFile
(property); 
Err.LastDLLError
(property); 
Err.Number
(property); 
Err.Source
(property).
Platform(s) All.
Err.HelpFile (property) 
Syntax
Err.HelpFile [=
filename
]
Description Sets or retrieves the name of the help file associated with the error.
Comments
The 
Err.HelpFile
property, together with the 
Err.HelpContents
property, contain sufficient information 
to display help for the error.
When IC Script generates an error, the 
Err.HelpContents
property is set to 0 and the and the 
Err.HelpFile
property is set to ""; the value of the 
Err.Number
property is sufficient for displaying help 
in this case. The exception is with errors generated by an OLE automation server; both the 
Err.HelpFile
and 
Err.HelpContext
properties are set by the server to values appropriate for the generated 
error.
When generating your own user-define errors, you should set the 
Err.HelpContext
property and the 
Err.HelpFile
property appropriately for your error. If these are not set, then IC Script displays its own 
help at an appropriate place.
Chapter 1   A-Z Reference
180 IC Scripts VBA Scripting Reference
Example
'This example defines a replacement for InputBox that deals
'specifically with Integer values. If an error occurs, the
'function generates a user-defined error that can be trapped
'by the caller.
Function InputInteger(Prompt,Optional Title,Optional Def)
On Error Resume Next
Dim x As Integer
x = InputBox(Prompt,Title,Def)
If Err.Number Then
Err.HelpContext = "WIDGET.HLP"
Err.HelpContext = 10
Err.Description = "Integer value expected"
InputInteger = Null
Err.Raise 3000
End If
InputInteger = x
End Function
Sub Main
Dim x As Integer
Do
On Error Resume Next
x = InputInteger("Enter a number:")
Loop Until Err.Number <> 3000
End Sub
See Also
Error Handling (topic); 
Err.Clear
(method); 
Err.HelpContext
(property); 
Err.Description
(property); 
Err.LastDLLError
(property); 
Err.Number
(property); 
Err.Source
(property).
Platform(s) All.
Platform Notes
16-bit Windows, 32-bit Windows: On these platforms, the 
Err.HelpFile
property can be set to any 
valid Windows help file (i.e., a file with a .HLP extension compatible with the WINHELP help 
engine).
Err.LastDLLError (property) 
Syntax
Err.LastDLLError
Description Returns the last error generated by an external call—i.e., a call to a routine declared with the 
Declare
statement that resides in an external module.
Comments
The 
Err.LastDLLError
property is automatically set when calling a routine defined in an external 
module. If no error occurs within the external call, then this property will automatically be set to 0.
The 
Err.LastDLLError
property will always return 0 on platform where this property is not 
supported., 
Example
'The following script calls the GetCurrentDirectoryA. If an
'error occurs, this Win32 function sets the Err.LastDLLError
'property which can be checked for.
Declare Sub GetCurrentDirectoryA Lib "kernel32" (ByVal DestLen _
As Integer,ByVal lpDest As String)
Documents you may be interested
Documents you may be interested