Variant (data type)
Issue 2.0 June 2002 431
Operations on Variants
Normally, a 
Variant
behaves just like the data it contains. One exception to this rule is that, in 
arithmetic operations, variants are automatically promoted when an overflow occurs. Consider the 
following statements:
Dim a As Integer,b As Integer,c As Integer
Dim x As Variant,y As Variant,z As Variant
a% = 32767
b% = 1
c% = a% + b% 'This will overflow.
x = 32767
y = 1
z = x + y
'z becomes a Long because of Integer
'overflow.
In the above example, the addition involving 
Integer
variables overflows because the result (32768) 
overflows the legal range for integers. With 
Variant
variables, on the other hand, the addition 
operator recognizes the overflow and automatically promotes the result to a 
Long
.
Adding Variants
The 
+
operator is defined as performing two functions: when passed strings, it concatenates them; 
when passed numbers, it adds the numbers.
With variants, the rules are complicated because the types of the variants are not known until 
execution time. If you use 
+
, you may unintentionally perform the wrong operation.
It is recommended that you use the 
&
operator if you intend to concatenate two 
String
variants. This 
guarantees that string concatenation will be performed and not addition.
Variants That Contain No Data
Variant
can be set to a special value indicating that it contains no valid data by assigning the 
Variant
to 
Null
:
Dim a As Variant
a = Null
The only way that a 
Variant
becomes 
Null
is if you assign it as shown above.
The 
Null
value can be useful for catching errors since its value propagates through an expression.
Variant Storage
Variants require 16 bytes of storage internally:
A 2-byte type
A 2-byte extended type for data objects
4 bytes of padding for alignment
An 8-byte value
Pdf find 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 select text in pdf and copy; make pdf text searchable
Pdf find 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
search text in multiple pdf; select text pdf file
Chapter 1   A-Z Reference
432 IC Scripts VBA Scripting Reference
Unlike other data types, writing variants to 
Binary
or 
Random
files does not write 16 bytes. With 
variants, a 2-byte type is written, followed by the data (2 bytes for 
Integer
and so on).
Disadvantages of Variants
The following list describes some disadvantages of variants:
1 Using variants is slower than using the other fundamental data types (i.e., 
Integer
Long
Single
Double
Date
Object
String
Currency
, and 
Boolean
). Each operation involving a 
Variant
requires 
examination of the variant's type.
2 Variants require more storage than other data types (16 bytes as opposed to 8 bytes for a 
Double
2 bytes for an 
Integer
, and so on).
3 Unpredictable behavior. You may write code to expect an 
Integer
variant. At runtime, the variant 
may be automatically promoted to a 
Long
variant, causing your code to break.
Passing Nonvariant Data to Routines Taking Variants
Passing nonvariant data to a routine that is declared to receive a variant by reference prevents that 
variant from changing type within that routine. For example:
Sub Foo(v As Variant)
v = 50
'OK.
v = "Hello, world."
'Get a type-mismatch error here!
End Sub
Sub Main()
Dim i As Integer
Foo i
'Pass an integer by reference.
End Sub
In the above example, since an 
Integer
is passed by reference (meaning that the caller can change 
the original value of the 
Integer
), the caller must ensure that no attempt is made to change the 
variant's type.
Passing Variants to Routines Taking Nonvariants
Variant variables cannot be passed to routines that accept nonvariant data by reference, as 
demonstrated in the following example:
Sub Foo(i as Integer)
End Sub
Sub Main()
Dim a As Variant
Foo a
'Compiler gives type-mismatch error here.
End Sub
See Also
Currency
(data type); 
Date
(data type); 
Double
(data type); 
Integer
(data type); 
Long
(data type); 
Object
(data type); 
Single
(data type); 
String
(data type); 
Boolean
(data type); 
Def
Type
(statement); 
CVar
(function); 
VarType
(function).
Platform(s) All.
C# Word - Search and Find Text in Word
C# Word - Search and Find Text in Word. Learn How to Search Text in PDF Document and Obtain Text Content and Location Information. Overview.
pdf text search; how to select all text in pdf file
C# PowerPoint - Search and Find Text in PowerPoint
C# PowerPoint - Search and Find Text in PowerPoint. Learn How to Search Text in PDF Document and Obtain Text Content and Location Information. Overview.
find text in pdf image; search text in pdf image
VarType (function)
Issue 2.0 June 2002 433
VarType (function)
Syntax
VarType(
varname
)
Description
Returns an Integer representing the type of data in
varname
.
Comments
The 
varname
parameter is the name of any 
Variant
.
The following table shows the different values that can be returned by 
VarType
:
When passed an object, the 
VarType
function returns the type of the default property of that object. 
If the object has no default property, then either 
ebObject
or 
ebDataObject
is returned, depending on 
the type of variable.
Example
Sub Main()
Dim v As Variant
v = 5&
'Set v to a Long.
If VarType(v) = ebInteger Then
Msgbox "v is an Integer."
ElseIf VarType(v) = ebLong Then
Msgbox "v is a Long."
End If
End Sub
See Also
Variant
(data type).
Platform(s) All.
Value
Constant
Data Type
0
ebEmpty
Uninitialized
1
ebNull
No valid data
2
ebInteger
Integer
3
ebLong
Long
4
ebSingle
Single
5
ebDouble
Double
6
ebCurrency
Currency
7
ebDate
Date
8
ebString
String
9
ebObject
Object (OLE Automation object)
10
ebError
User-defined error
11
ebBoolean
Boolean
12
ebVariant
Variant (not returned by this function)
13
ebDataObject
Non–OLE Automation object
C# Excel - Search and Find Text in Excel
Easy to search and find text content and get its location details. Allow to search defined Excel file page or the whole document. C# PDF: Example of Finding Text
select text in pdf file; cannot select text in pdf
VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
When you have downloaded the RasterEdge Image SDK for .NET, you can unzip the package to find the RasterEdge.Imaging.PDF.dll in the bin folder under the root
how to make a pdf document text searchable; search pdf documents for text
Chapter 1   A-Z Reference
434 IC Scripts VBA Scripting Reference
Viewport.Clear (method)
Syntax
Viewport.Clear
Description Clears the open viewport window.
Comments
The method has no effect if no viewport is open.
Example
Sub Main()
Viewport.Open
Print "This will be displayed in the viewport window."
Sleep 2000
Viewport.Clear
Print "This will replace the previous text."
Sleep 2000
Viewport.Close
End Sub
See Also
Viewport.Close
(method); 
Viewport.Open
(method).
Platform(s) 16-bit Windows, 32-bit Windows.
Viewport.Close (method)
Syntax
Viewport.Close
Description This method closes an open viewport window.
Comments
The method has no effect if no viewport is opened.
Example
Sub Main()
Viewport.Open
Print "This will be displayed in the viewport window."
Sleep 2000
Viewport.Close
End Sub
See Also
Viewport.Open
(method).
Platform(s) 16-bit Windows, 32-bit Windows.
Viewport.Open (method)
Syntax
Viewport.Open [
title
[,
XPos
,
YPos
[,
width
,
height
]]]
Description Opens a new viewport window or switches the focus to the existing viewport window.
C# HTML5 Viewer: Load, View, Convert, Annotate and Edit Excel
HTML5 Viewer for C# .NET, users can convert Excel to PDF document, export C#.NET RasterEdge HTML5 Viewer also enable users to quickly find text content by
pdf search and replace text; text select tool pdf
VB.NET PDF File & Page Process Library SDK for vb.net, ASP.NET
document. If you find certain page in your PDF document is unnecessary, you may want to delete this page directly. Moreover, when
can't select text in pdf file; pdf select text
Viewport.Open (method)
Issue 2.0 June 2002 435
Comments
The 
Viewport.Open
method accepts the following named :
If a viewport window is already open, then it is given the focus. Otherwise, a new viewport 
window is created.
Combined with the 
Print
statement, a viewport window is a convenient place to output debugging 
information.
The viewport window is closed when the IC Script host application is terminated.
The following keys work within a viewport window:
UpScrolls up by one line.
DownScrolls down by one line.
HomeScrolls to the first line in the viewport window.
EndScrolls to the last line in the viewport window.
PgDnScrolls the viewport window down by one page.
PgUpScrolls the viewport window up by one page.
Ctrl+PgUpScrolls the viewport window left by one page.
Ctrl+PgDnScrolls the viewport window right by one page.
Only one viewport window can be open at any given time. Any scripts with 
Print
statements will 
output information into the same viewport window.
When printing to viewports, the end-of-line character can be any of the following: a carriage 
return, a line feed, or a carriage-return/line-feed pair. Embedded null characters are printed as 
spaces.
Example
Sub Main()
Viewport.Open "IC Script Viewport",100,100,500,500
Print "This will be displayed in the viewport window."
Sleep 2000
Viewport.Close
End Sub
See Also
Viewport.Close
(method).
Named Parameter
Description
title
Specifies a String containing the text to appear in the 
viewport's caption.
XPos, YPos
Specifies Integer coordinates given in twips indicating the 
initial position of the upper left corner of the viewport.
width
,
height
Specifies Integer values indicating the initial width and 
height of the viewport.
C# WPF Viewer: Load, View, Convert, Annotate and Edit Excel
function will help users to freely convert Excel document to PDF, Tiff and Text search and select functionalities and manipulate help to find text contents on
pdf find and replace text; pdf searchable text
XDoc.Word for .NET, Support Processing Word document and Page in .
Able to view and edit Word rapidly. Convert. Convert Word to PDF. Convert Word to ODT. Text & Image Process. Search and find text in Word. Insert image to Word page
search pdf files for text; search a pdf file for text
Chapter 1   A-Z Reference
436 IC Scripts VBA Scripting Reference
Platform(s) 16-bit Windows, 32-bit Windows.
Platform Notes
Windows: The buffer size for the viewport is 32K. Information from the start of the buffer is 
removed to make room for additional information being appended to the end of the buffer.
VLine (statement)
Syntax
VLine [
lines
]
Description Scrolls the window with the focus up or down by the specified number of lines.
Comments
The 
lines
parameter is an 
Integer
specifying the number of lines to scroll. If this parameter is 
omitted, then the window is scrolled down by one line.
Example
'This example prints a series of lines to the viewport, then
'scrolls back up the lines to the top using VLine.
Sub Main()
Viewport.Open "IC Script Viewport",100,100,500,200
For i = 1 to 50
Print "This will be displayed on line#: " & i
Next i
MsgBox "We will now go back 40 lines..."
VLine -40
MsgBox "...and here we are!"
Viewport.Close
End Sub
See Also
VPage
(statement); 
VScroll
(statement).
Platform(s) 16-bit Windows.
VPage (statement)
Syntax
VPage [
pages
]
Description Scrolls the window with the focus up or down by the specified number of pages.
Comments
The 
pages
parameter is an 
Integer
specifying the number of lines to scroll. If this parameter is 
omitted, then the window is scrolled down by one page.
Example
'This example scrolls the viewport window up five pages.
Sub Main()
Viewport.Open "IC Script Viewport",100,100,500,200
For i = 1 to 500
Print "This will be displayed on line#: " & i
Next i
MsgBox "We will now go back 5 pages..."
VLine -5
MsgBox "...and here we are!"
Viewport.Close
End Sub
VScroll (statement)
Issue 2.0 June 2002 437
See Also
VLine
(statement); 
VScroll
(statement).
Platform(s) 16-bit Windows.
VScroll (statement)
Syntax
VScroll
percentage
Description Sets the thumb mark on the vertical scroll bar attached to the current window.
Comments
The position is given as a percentage of the total range associated with that scroll bar. For example, 
if the percentage parameter is 50, then the thumb mark is positioned in the middle of the scroll bar.
Example
'This example prints a bunch of lines to the viewport, then
'scrolls back to the top using VScroll.
Sub Main()
Viewport.Open "IC Script Viewport",100,100,500,200
For i = 1 to 50
Print "This will be displayed on line#: " & i
Next i
MsgBox "We will now go to the 0% thumb mark poisiton (the top)..."
VScroll 0
MsgBox "...and here we are!"
Viewport.Close
End Sub
See Also
VLine
(statement); 
VPage
(statement).
Platform(s) 16-bit Windows.
Weekday (function)
Syntax
Weekday(
date
[,
firstdayofweek
])
Description Returns an 
Integer
value representing the day of the week given by date. Sunday is 1, Monday is 2, 
and so on.
The 
Weekday
function takes the following named parameters:
Named Parameter
Description
date
Any expression representing a valid date.
firstdayofweek
Indicates the first day of the week. If omitted, then sunday 
is assumed (i.e., the constant ebSunday described below).
Chapter 1   A-Z Reference
438 IC Scripts VBA Scripting Reference
The 
firstdayofweek
parameter, if specified, can be any of the following constants:
Example
'This example gets a date in an input box and displays the day
'of the week and its name for the date entered.
Sub Main()
Dim a$(7)
a$(1) = "Sunday"
a$(2) = "Monday"
a$(3) = "Tuesday"
a$(4) = "Wednesday"
a$(5) = "Thursday"
a$(6) = "Friday"
a$(7) = "Saturday"
Reprompt:
bd = InputBox$("Please enter your birthday.","Enter Birthday")
If Not(IsDate(bd)) Then Goto Reprompt
dt = DateValue(bd)
dw = WeekDay(dt)
Msgbox "You were born on day " & dw & ", which was a " & a$(dw)
End Sub
See Also
Day
(function); 
Minute
(function); 
Second
(function); 
Month
(function); 
Year
(function); 
Hour
(function); 
DatePart
(function).
Platform(s) All.
While...Wend (statement)
Syntax
While
condition
[
statements
]
Wend
Description Repeats a statement or group of statements while a condition is 
True
.
Comments
The condition is initially and then checked at the top of each iteration through the loop.
Constant
Value
Description
ebUseSystem
0
Use the system setting for 
firstdayofweek
.
ebSunday
1
Sunday (the default)
ebMonday
2
Monday
ebTuesday
3
Tuesday
ebWednesday
4
Wednesday
ebThursday
5
Thursday
ebFriday
6
Friday
ebSaturday
7
Saturday
Width# (statement)
Issue 2.0 June 2002 439
Example
'This example executes a While loop until the random number
'generator returns a value of 1.
Sub Main()
x% = 0
count% = 0
While x% <> 1 And count% < 500
x% = Rnd(1)
If count% > 1000 Then
Exit Sub
Else
count% = count% + 1
End If
Wend
MsgBox "The loop executed " & count% & " times."
End Sub
See Also
Do...Loop
(statement); 
For...Next
(statement).
Platform(s) All.
Platform Notes
16-bit Windows, 32-bit Windows: Due to errors in program logic, you can inadvertantly create 
infinite loops in your code. Under Windows and Win32, you can break out of infinite loops using 
Ctrl+Break.
UNIX: Due to errors in program logic, you can inadvertantly create infinite loops in your code. 
Under UNIX, you can break out of infinite loops using Ctrl+C.
OS/2: Due to errors in program logic, you can inadvertantly create infinite loops in your code. 
Under OS/2, you can break out of infinite loops using Ctrl+C or Ctrl+Break.
Width# (statement)
Syntax
Width#
filenumber
,
width
Description
Specifies the line width for sequential files opened in either Output or Append
mode.
Comments
The 
Width#
statement requires the following named parameters:
When a file is initially opened, there is no limit to line length. This command forces all subsequent 
output to the specified file to use the specified value as the maximum line length.
Named Parameter
Description
filenumber
Integer used by IC Script to refer to the open file—the 
number passed to the Open statement.
width
Integer between 0 to 255 inclusive specifying the new width. 
If 
width
is 0, then no maximum line length is used.
Chapter 1   A-Z Reference
440 IC Scripts VBA Scripting Reference
The 
Width
statement affects output in the following manner: if the column position is greater than 1 
and the length of the text to be written to the file causes the column position to exceed the current 
line width, then the data is written on the next line.
The 
Width
statement also affects output of the 
Print
command when used with the 
Tab
and 
Spc
functions.
Example
'This statement sets the maximum line width for file number 1
'to 80 columns.
Sub Main()
Width #1,80
End Sub
See Also
Print
(statement); 
Print#
(statement); 
Tab
(function); 
Spc
(function).
Platform(s) All.
WinActivate (statement)
Syntax
WinActivate [
window_name$
|
window_object
] [,
timeout
]
Description
Activates the window with the given name or object value.
Comments
The 
WinActivate
statement requires the following parameters:
If 
window_name$
and 
window_object
are omitted, then no action is performed.
Parameter
Description
window_name$
String containing the name that appears on the desired 
application's title bar. Optionally, a partial name can be used, 
such as "Word" for "Microsoft Word."
A hierarchy of windows can be specified by separating each 
window name with a vertical bar (|), as in the following 
example:
WinActivate "Notepad|Find"
In this example, the top-level windows are searched for a 
window whose title contains the word "Notepad". If found, the 
windows owned by the top level window are searched for one 
whose title contains the string "Find".
window_object
HWND object specifying the exact window to activate. This 
can be used in place of the 
window_name$
parameter to 
indicate a specific window to activate.
timeout
Integer specifying the number of milliseconds for which to 
attempt activation of the specified window. If not specified (or 
0), then only one attempt will be made to activate the 
window. This value is handy when you are not certain that the 
window you are attempting to activate has been created.
Documents you may be interested
Documents you may be interested