O
Issue 2.0 June 2002 301
O
This section contains functions and methods with names that begin with the letter O.
Name (statement)
Syntax
Name
oldfile$
As
newfile$
Description Renames a file.
Comments
Each parameter must specify a single filename. Wildcard characters such as * are not allowed.
Some platforms allow naming of files to different directories on the same physical disk volume. 
For example, the following rename will work under Windows:
Name "c:\samples\mydoc.txt" As "c:\backup\doc\mydoc.bak"
You cannot rename files across physical disk volumes. For example, the following will error under 
Windows:
Name "c:\samples\mydoc.txt" As "a:\mydoc.bak"'This will
’error!
To rename a file to a different physical disk, you must first copy the file, then erase the original:
FileCopy "c:\samples\mydoc.txt","a:\mydoc.bak"'Make a copy.
Kill "c:\samples\mydoc.txt"'Delete the original.
Example
’This example creates a file called test.dat and then renames it ’to test2.dat.
Sub Main()
On Error Resume Next
If FileExists("test.dat") Then
Name "test.dat" As "test2.dat"
If Err <> 0 Then
msg = "File exists and cannot be renamed! Error: " & Err
Else
msg = "File exists and renamed to test2.dat."
End If
Else
Open "test.dat" For Output As #1
Close
Name "test.dat" As "test2.dat"
If Err <> 0 Then
msg = "File created but not renamed! Error: " & Err
Else
msg = "File created and renamed to test2.dat."
End If
End If
MsgBox msg
End Sub
See Also
Kill
(statement); 
FileCopy
(statement).
Platform(s) All.
Pdf editor with 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
search text in pdf using java; converting pdf to searchable text format
Pdf editor with 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 searchable text; cannot select text in pdf
Chapter 1   A-Z Reference
302 IC Scripts VBA Scripting Reference
Named Parameters (topic) 
Many language elements in IC Script support named parameters. Named parameters allow you to 
specify parameters to a function or subroutine by name rather than in adherence to a predetermined 
order. The following table contains examples showing various calls to 
MsgBox
both using 
parameter by both name and position.
By NameMsgBox Prompt:= "Hello, world."
By PositionMsgBox "Hello, world."
By NameMsgBox Title:="Title", Prompt:="Hello, world."
By PositionMsgBox "Hello, world",,"Title"
By NameMsgBox HelpFile:="BASIC.HLP", _
Prompt:="Hello, world.", HelpContext:=10
By PositionMsgBox "Hello, world.",,,"BASIC.HLP",10
Using named parameter makes your code easier to read, while at the same time removes you from 
knowing the order of parameter. With function that require many parameters, most of which are 
optional (such as 
MsgBox
), code becomes significantly easier to write and maintain.
When supported, the names of the named parameter appear in the description of that language 
element.
When using named parameter, you must observe the following rules:
Named parameter must use the parameter name as specified in the description of that language 
element. Unrecognized parameter names cause compiler errors.
All parameters, whether named or positional, are separated by commas.
The parameter name and its associated value are separated with 
:=
If one parameter is named, then all subsequent parameter must also be named as shown below:
MsgBox "Hello, world", Title:="Title" ’OK
MsgBox Prompt:="Hello, world.",,"Title"’WRONG!!!
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.
search pdf files for text programmatically; find and replace text in pdf file
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
find and replace text in pdf; find text in pdf image
Net.AddCon (method)
Issue 2.0 June 2002 303
Net.AddCon (method)
Syntax
Net.AddCon
netpath$
,
password$
,
localname$
Description Redirects a local device (a disk drive or printer queue) to the specified shared device or remote 
server.
Comments
The 
Net.AddCon
method takes the following parameters:
A runtime error will result if no network is present.
Example
’This example sets N: so that it refers to the network path ’SYS:\PUBLIC.
Sub Main()
Net.AddCon "SYS:\PUBLIC","","N:"
End Sub
See Also
Net.CancelCon
(method); 
Net.GetCon$
(method).
Platform(s) 16-bit Windows.
Net.Browse$ (method)
Syntax
Net.Browse$(
type
)
Description Calls the currently installed network's browse dialog box, requesting a particular type of 
information.
Comments
The 
type
parameter is an 
Integer
specifying the type of dialog box to display:
Parameter
Description
netpath$
String containing the name of the shared device or the name of a 
remote server. This parameter can contain the name of a shared 
printer queue (such as that returned by Net.Browse[1]) or the 
name of a network path (such as that returned by Net.Browse[0]).
password$
String containing the password for the given device or server. 
This parameter is mainly used to specify the password on a 
remote server.
localname$
String containing the name of the local device being redirected, 
such as "LPT1" or "D:".
Type
Description
0
If 
type
is 0, then this method displays a dialog box that allows the 
user to browse network volumes and directories. Choosing OK 
returns the completed pathname as a String.
1
If 
type
is 1, then this function displays a dialog box that allows the 
user to browse the network's printer queues. Choosing OK returns 
the complete name of that printer queue as a String. This string is 
the same format as required by the Net.AddCon method.
C# HTML5 PDF Viewer SDK to view, annotate, create and convert PDF
framework class. An advanced PDF editor enable C# users to edit PDF text, image and pages in Visual Studio .NET project. Support to
select text in pdf reader; how to search text in pdf document
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.
text searchable pdf; text searchable pdf file
Chapter 1   A-Z Reference
304 IC Scripts VBA Scripting Reference
This dialog box differs depending on the type of network installed.
A runtime error will result if no network is present.
Example
’This example retrieves a valid network path.
Sub Main()
s$ = Net.Browse$(0)
If s$ <> "" Then
MsgBox "The following network path was selected: " & s$
Else
MsgBox "Dialog box was canceled."
End If
End Sub
See Also
Net.Dialog
(method).
Platform(s) 16-bit Windows.
Net.CancelCon (method)
Syntax
Net.CancelCon
connection$
[,
isForce
]
Description Cancels a network connection.
Comments
The Net.
CancelCon
method takes the following parameters:
A runtime error will result if no network is present.
Example
’This example deletes the drive mapping associated with drive N:.
Sub Main()
Net.CancelCon "N:"
End Sub
See Also
Net.AddCon
(method); 
Net.GetCon$
(method).
Platform(s) 16-bit Windows.
Parameter
Description
connection$
String containing the name of the device to cancel, such as 
"LPT1" or "D:".
isForce
Boolean specifying whether to force the cancellation of the 
connection if there are open files or open print jobs. If this 
parameter is True, then this method will close all open files and 
open print jobs before the connection is closed. If this parameter 
is False, this the method will issue a runtime error if there are any 
open files or open print jobs.
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
how to search pdf files for text; how to select all text in pdf file
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.
pdf find text; pdf text select tool
Net.Dialog (method)
Issue 2.0 June 2002 305
Net.Dialog (method)
Syntax
Net.Dialog
Description Displays the dialog box that allows configuration of the currently installed network.
Comments
The displayed dialog box depends on the currently installed network. The dialog box is 
modalÑscript execution will be paused until the dialog box is completed.
A runtime error will result if no network is present.
Example
’This example invokes the network driver dialog box.
Sub Main()
Net.Dialog
End Sub
See Also
Net.Browse$
(method).
Platform(s) 16-bit Windows.
Net.GetCaps (method)
Syntax. 
Net.GetCaps(
type
)
Description.  Returns an 
Integer
specifying information about the network and its capabilities.
Comments.  The 
type
parameter specifies what type of information to retrieve:
Value of 
type
Description
1
Returns the version of the driver specification to which the 
currently installed network driver conforms. The high byte of the 
returned value contains the major version number and the low 
byte contains the minor version number. These values can be 
retrieved using the following code:
MajorVersionNumber
= Net.GetCaps(1) \ 256
MinorVersionNumber
= Net.GetCaps(1) And &H00FF
2
Returns the type of network. The network type is returned in the 
high byte and the subnetwork type is returned in the low byte. 
These values can be obtained using the following code:
NetType
= Net.GetCaps(2) \ 256
SubNetType
= Net.GetCaps(2) And &H00FF
C# WPF PDF Viewer SDK to view PDF document in C#.NET
WPF Viewer & Editor. WPF: View PDF. WPF: Annotate PDF. Read. Text: Extract Text from PDF. Text: Search Text in PDF. to PDF. Text: Delete Text from PDF. Text: Replace
pdf find and replace text; search text in multiple pdf
C# PDF Convert to Text SDK: Convert PDF to txt files in C#.net
PDF to Text. |. C#.NET PDF SDK - Convert PDF to Text in C#.NET. Empower C# Users to Convert PDF to Text (TXT) in Visual C# with .NET XDoc.PDF Converter Library.
how to select text in pdf; pdf search and replace text
Chapter 1   A-Z Reference
306 IC Scripts VBA Scripting Reference
Using the above values, 
NetType
can be any of the following 
values:
0 No network is installed.
1 Microsoft Network.
2 Microsoft LAN Manager.
3 Novell NetWare.
4 Banyan Vines.
5 10Net.
6 Locus
7 SunSoft PC NFS.
8 LanStep.
9 9 Titles.
10 Articom Lantastic.
11 IBM AS/400.
12 FTP Software FTP NFS.
13 DEC Pathworks.
If 
NetType
is 128, then 
SubNetType
is any of the following values 
(you can test for any of these values using the And operator):
bit &H0001Microsoft Network.
bit &H0002Microsoft LAN Manager.
bit &H0004Windows for Workgroups.
bit &H0008Novell NetWare.
bit &H0010Banyan Vines.
bit &H0080Other unspecified network.
3
Returns the network driver version number.
4
Returns 1 if the Net.User$ property is supported; returns 0 
otherwise.
6
Returns any of the following values indicating which connections 
are supported (you can test for these values using the And 
operator):
bit &H0001Driver supports Net.AddCon.
bit &H0002Driver supports Net.CancelCon.
bit &H0004Driver supports Net.GetCon.
bit &H0008Driver supports auto connect.
bit &H0010Driver supports Net.Browse$.
Value of 
type
Description
Net.GetCaps (method)
Issue 2.0 June 2002 307
A runtime error will result if no network is present.
7
Returns a value indicating which printer function are available 
(you can test for these values using the And operator):
bit &H0002Driver supports open print job.
bit &H0004Driver supports close print job.
bit &H0010Driver supports hold print job.
bit &H0020Driver supports release print job.
bit &H0040Driver supports cancel print job.
bit &H0080Driver supports setting the number
of print copies.
bit &H0100Driver supports watch print queue.
bit &H0200Driver supports unwatch print
queue.
bit &H0400Driver supports locking queue data.
bit &H0800Driver supports unlocking queue
data.
bit &H1000Driver supports queue change
message.
bit &H2000Driver supports abort print job.
bit &H4000Driver supports no arbitrary lock.
bit &H8000Driver supports write print job.
8
Returns a value indicating which dialog functions are available 
(you can test for these values using the And operator):
bit &H0001Driver supports Device Mode dialog.
bit &H0002Driver supports the Browse dialog.
bit &H0004Driver supports the Connect dialog.
bit &H0008Driver supports the Disconnect
dialog.
bit &H0010Driver supports the View Queue
dialog.
bit &H0020Driver supports the Property
dialog.
bit &H0040Driver supports the Connection
dialog.
bit &H0080Driver supports the Printer Connect
dialog.
bit &H0100Driver supports the Shares dialog.
bit &H0200Driver supports the Share As
dialog.
Value of 
type
Description
Chapter 1   A-Z Reference
308 IC Scripts VBA Scripting Reference
Examples
Sub Main()
'This example checks the type of network.
If Net.GetCaps(2) = 768 Then MsgBox "This is a Novell network."
'This checks whether the net supports retrieval of the user name.
If Net.GetCaps(4) And 1 Then MsgBox "User name is: " + Net.User$
'This checks whether this net supports the Browse dialog boxes.
If Net.GetCaps(6) And &H0010 Then MsgBox Net.Browse$(1)
End Sub
Platform(s) 16-bit Windows.
Net.GetCon$ (method)
Syntax
Net.GetCon$(
localname$
)
Description Returns the name of the network resource associated with the specified redirected local device.
Comments
The 
localname$
parameter specifies the name of the local device, such as "LPT1" or "D:".
The function returns a zero-length string if the specified local device is not redirected.
A runtime error will result if no network is present.
Example
’This example finds out where drive Z is mapped.
Sub Main()
NetPath$ = Net.GetCon$("Z:")
MsgBox "Drive Z is mapped as " & NetPath$
End Sub
See Also
Net.CancelCon
(method); 
Net.AddCon
(method).
Platform(s) 16-bit Windows.
Net.User$ (property)
Syntax
Net.User$
Description Returns the name of the user on the network.
Comments
A runtime error is generated if the network is not installed.
Examples
Sub Main()
'This example tells the user who he or she is.
MsgBox "You are " & Net.User$
'This example makes sure this capability is supported.
If Net.GetCaps(4) And 1 Then MsgBox "You are " & Net.User$
End Sub
Platform(s) 16-bit Windows.
New (keyword)
Issue 2.0 June 2002 309
New (keyword)
Syntax 1
Dim
ObjectVariable
As New
ObjectType
Syntax 2
Set
ObjectVariable
= New
ObjectType
Description Creates a new instance of the specified object type, assigning it to the specified object variable. 
Comments
The 
New
keyword is used to declare a new instance of the specified data object. This keyword can 
only be used with data object types.
At runtime, the application or extension that defines that object type is notified that a new object is 
being defined. The application responds by creating a new physical object (within the appropriate 
context) and returning a reference to that object, which is immediately assigned to the variable 
being declared.
When that variable goes out of scope (i.e., the 
Sub
or 
Function
procedure in which the variable is 
declared ends), the application is notified. The application then performs some appropriate action, 
such as destroying the physical object.
See Also
Dim
(statement); 
Set
(statement).
Platform(s) All.
Not (operator)
Syntax
Not
expression
Description Returns either a logical or binary negation of 
expression
.
Comments
The result is determined as shown in the following table:
If the expression is
then the result is
True
False
False
True
Null
Null
Any numeric type
A binary negation of the number. If the number is an 
Integer, then an Integer is returned. Otherwise, the 
expression is first converted to a Long, then a binary 
negation is performed, returning a Long.
Empty
Treated as a Long value 0.
Chapter 1   A-Z Reference
310 IC Scripts VBA Scripting Reference
Example
’This example demonstrates the use of the Not operator in ’comparing logical
expressions and for switching a True/False ’toggle variable.
Const crlf = Chr$(13) + Chr$(10)
Sub Main()
a = False
b = True
If (Not a and b) Then msg = "a = False, b = True" & crlf
toggle% = True
msg = msg & "toggle% is now " & Format(toggle%,"True/False") & crlf
toggle% = Not toggle%
msg = msg & "toggle% is now " & Format(toggle%,"True/False") & crlf
toggle% = Not toggle%
msg = msg & "toggle% is now " & Format(toggle%,"True/False")
MsgBox msg
End Sub
See Also
Boolean
(data type); Comparison Operators (topic).
Platform(s) All.
Now (function)
Syntax
Now[()]
Description Returns a 
Date
variant representing the current date and time.
Example
’This example shows how the Now function can be used as an ’elapsed-time counter.
Sub Main()
t1# = Now()
MsgBox "Wait a while and click OK."
t2# = Now()
t3# = Second(t2#) - Second(t1#)
MsgBox "Elapsed time was: " & t3# & " seconds."
End Sub
See Also
Date
Date$
(functions); 
Time
Time$
(functions).
Platform(s) All.
NPer (function)
Syntax
NPer(
rate
,
pmt
,
pv
,
fv
,
due
)
Description Returns the number of periods for an annuity based on periodic fixed payments and a constant rate 
of interest.
Comments
An annuity is a series of fixed payments paid to or received from an investment over a period of 
time. Examples of annuities are mortgages, retirement plans, monthly savings plans, and term 
loans.
Documents you may be interested
Documents you may be interested