G Toolbox User's Guide

G Toolbox is a collection of 180+ VIs built with CIN for experienced LabVIEW programmers.

C    D    E    F    G    H    J    K    L    M    N    O    P    Q    R    S    T    U    V    W

BMP.vi

Input:
winName - Specify the window name.
bmpName - Specify the bitmap file path & name.
position - Specify the position for the bitmap window in pixel (client coordinate).
x - the x coordinate of the upper-left corner of the bitmap window.
y - the y coordinate of the upper-left corner of the bitmap window.

Output:
hWnd - Handle of the specified window.
hWndBMP - Handle of the bitmap window.
error - Error code.

Example:
G Toolbox 2.2\Examples\BMP Demo.vi

Bitmap Shape Window.vi

Input:
hWnd - Handle of the specified window.
bkColor - Define background color.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\Bitmap Shape Window Demo.vi

Client to LV.vi

Input:
reference - Specify the vi reference.
position in client coordinate - Specify the x & y cooridnates in the client coordinate.
x - the horizontal component in the client coordinate.
y - the vertical component in the client coordinate.

Output:
reference dup - Copy of reference.
position in LV coordinate - Specify the x & y coordinates in the LV coordinate.
x - the horizontal component in the LV coordinate.
y - the vertical component in the LV coordinate.

Drag & Drop

DragDrop Init.vi

Initialize Drag & Drop for the specified window at run-time.



Input:
hWnd - Handle of the specified window.
DropEvent - occurrence to be set when drop event occur.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Note: This VI can't be called twice in a roll for the same window. Before close the specified window, one must call DragDrop Close.vi.

---

Dropped File.vi

This VI retrieves the dropped file, and the dropping position.



Input:
hWnd - Handle of the specified window.

Output:
Position - where the files was dropped.
x - the horizontal component in the client coordinate.
y - the vertical component in the client coordinate.
Dropped File - Name and path of the dropped file.
hWnd dup - Copy of the window handle.
err code - Window error code.
error - error indicator.

---

Dropped Files.vi

This VI retrieves the name of the dropped files.



Input:
hWnd - Handle of the specified window.
Number of Files - Specify the number of files to be retrieved.

Output:
hWnd dup - Copy of the window handle.
Files - Name and path of the dropped files.
error - error indicator.

---

Number of Dropped Files.vi

This VI gets the number of dropped files, and the dropped position.



Input:
hWnd - Handle of the specified window.

Output:
hWnd dup - Copy of the window handle.
Number of Files - Number of the dropped files.
Position - where the files was dropped.
x - the horizontal component in the client coordinate.
y - the vertical component in the client coordinate.
error - error indicator.

---

DragDrop Close.vi

Terminate DragDrop support for LabVIEW at run time.



Input:
hWnd - Handle of the specified window.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Drag Object

Input:
hWnd - Handle of the specified window.
option - initial, get drag start position & drop position.
occurrence - occurrence to be set when drop event occur.

Output:
Drag init Point - where drag starts (x0, y0).

x0 - the horizontal coordinate of drag start point.
y0 - the vertical coordinate of drag start point.
Drop end Point - where object dropped (x1, y1).

x1 - the horizontal coordinate of drop point.
y1 - the vertical coordinate of drop point.
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\DragObject Demo.vi

Draw BMP.vi

Input:
hWnd - Handle of the specified window.
hBitmap - handle of the bitmap image.
position - Specify the where to draw the bitmap (in client coordinate).
x - the horizontal component in the client coordinate.
y - the vertical component in the client coordinate.

Output:
hWnd dup - Copy of the window handle.
hPic - handle of the image.
err code - window error code.
error - error indicator.

Empty Recycle Bin.vi

Input:
none.


Output:
error - error indicator.

Enumerate Child.vi

Input:
hWnd parent - Handle of the specified parental window.

Output:
hWnd - array of handles of found child windows.
window title - array titles of found child windows.
count - number of found child windows.

Enumerate Windows.vi

Input:
none.


Output:
hWnd - array of handles of found windows.
window title - array titles of found windows.
count - number of found windows.

File Exist.vi

Input:
path - Specify the full path of the file to be determined.

Output:
exist? - Return TRUE if file exist; FALSE otherwise.

File Property.vi

Input:
path - Specify the path of the file of which property dialog box will popup.
no error dialog box - Option of showing/hiding error dialog box.

Output:
error - error indicator.

File Time.vi

Input:
path - Specify the full path.
option - option of "Get" or "Set" file time.
creation time
last access time
last write time - a cluster of 8 U16 controls: year, month, day of week, day of month, hour, minute, second, and milliseconds.

Output:
creation time
last access time
last write time - a cluster of 8 U16 indicators: year, month, day of week, day of month, hour, minute, second, and milliseconds.

Find Executable.vi

Input:
file - Specify the name of the file.
path - Specify the full path.

Output:
exe - Name and path of the executable file.
err code - Window error code.
error - error indicator.

Get Short Paht.vi

Input:
longPath - long window file name.

Output:
shortPath - the corresponding short DOS name.

Get Window Status.vi

Input:
hWnd - Handle of the specified window.

Output:
hWnd dup - Copy of the window handle.
Window Status - a cluster of 5 boolean indicators.
Is it a window ?
Is it visible ?
Is it maximized ?
Is it minimized ?
Is it enabled?

Hide SysCtrls.vi

Input:
Sys Ctrls - option of Taskbar, Start button, or Desktop icons.
Cmd - option of Hide, Normal, Maximum, Show, Minimum, or Restore.

Output:
hCtl - handle of the system control.
err code - window error code.
error - error indicator.

Key Down.vi
Key Up.vi

Input:
hWnd - Handle of the specified window.
key - specify the key to simulate. option of: A..Z, F1..F12, 0..9, PAD 0.. PAD 9, *, +, -, --, /, BackSP, TAB, CR, SHIFT, CTRL, ALT, Pause, CapLock, ESCAPE, SPACE, PageUP, PageDN, END, HOME, LEFT, UP, RIGHT, DOWN, PrintScreen, Insert, and DEL.
shift state - option of SHIFT, CTRL, or ALT.

Output:
hWnd dup - Copy of the window handle.

Load BMP.vi

Input:
DLL - Specify the path of the DLL.
resource id - Specify the resource id number of the bitmap.

Output:
hBitmap - handle of the bitmap image.
err code - window error code.
error - error indicator.

Load BMP to Clipboard.vi

Input:
path - Specify the path of the bitmap.
edge - Option of removing the edge of the bitmap (in pixel).

Output:
path dup - Copy of the input path.
error - error indicator.

LV to Client.vi

Input:
reference - Specify the vi reference.
position in LV coordinate - Specify the x & y coordinates in the LV coordinate.
x - the horizontal component in the LV coordinate.
y - the vertical component in the LV coordinate.

Output:
reference dup - Copy of reference.
position in client coordinate - Specify the x & y cooridnates in the client coordinate.
x - the horizontal component in the client coordinate.
y - the vertical component in the client coordinate.

Example:
G Toolbox 2.2\Examples\Coordinate Convert Demo.vi

Module Path.vi

Input:
Module - Name and extension (.exe, .dll, etc.) of the loaded module.

Output:
Module path - The full path and filename of the module if found.
found - Return TRUE if found; FALSE otherwise.

Mouse & Keyboard Events.vi

Input:
hWnd - Handle of the specified window.
flag - Specify the start/end tracking events.
occurs - Specify the corresponding occurance to be set whenever event occur.
hover - cursor entered the specified window.
leave - cursor left the specified window.
moves - cursor moved within the frame of the specified window.
chars - key pressed.
l button - left button down/up.
m button - middle button down/up.
r button - right button down/up.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\Mouse & Keyboard Events Demo.vi

Open File Dialog.vi

Input:
Start path - Specify the directory to start browse with.
file type - Specify the file extension. Files with matching extension will be list in the dialog window.

Output:
path - selected path.
Selected files - user selected file names.
error - error indicator.

Picture to Data.vi

Input:
picture - the curve picture.
step - Step size in pixel on horizontal axis. Default 1 pixel.
picture size - Size of the picture control in pixel (Note: not the actual picture size, only the visible part counts).

Width - Width of the picture control in pixel.
Height - Height of the picture control in pixel.
max - maximum scale.
x max - maximum scale on horizontal axis.
y max - maximum scale on vertical axis.
min - minimum scale.
x min - minimum scale on horizontal axis.
y min - minimum scale on vertical axis.

Output:
picture dup - Copy of the input picture
data - array of data points retrieved from the picture.
x - the horizontal component in the client coordinate.
y - the vertical component in the client coordinate.

Pie Chart.vi

Input:
hWnd - Handle of the specified window.
label option - show label or not.
Chart size - Define pie chart position (client coordinate) & size.
x - the x coordinate of the upper-left corner of the chart.
y - the y coordinate of the upper-left corner of the chart.
width - the width of the chart.
height - the height of the chart.
Pie - Data for pie chart.
lable - description of the slice of the pie.
angle - swept of the slice.
color - color of the slice.

Output:
hPie - Handle of the chart.
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\Pie Chart Demo.vi

Polar.vi

Input:
hWnd - Handle of the specified window.
hPolar - Handle of the Polar plot. Optional, if zero, new one will be created.
data - phase & magnitude of data points.
phase - direction of the data point.
magnitude - magnitude of the data point.
polar - Polar plot color, position, size, ...
x0 - the x coordinate of the upper-left corner of the polar plot.
y0 - the y coordinate of the upper-left corner of the polar plot.
radius - the maximium magnitude.
max. - the label of the maximium magnitude.
init orientation - the direction for the "0" degree.
grid - grid color.
bkg - background color.

style - Data curve style: color, line width, line style.
data - data points color.
line width - for solid line only, igored for dashed line.
line style - option of solid, dash, dot, dash-dot, dash-dot-dot, & invisible.

Output:
hPolar - Handle of the polar plot.
hWnd dup - Copy of the window handle.
err - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\LineStyle Demo.vi

Popup Menu

Input:
hWnd - Handle of the specified window.
option - Option of "shift right click", "right click" (Note: if "right click" is selected, the LabVIEW right click feature will be disabled).
menu items - array of items expected on the popup menu.

Item Name - Specify the name of the item.
Shortcut (Ctrl + ) - Specify the corresponding menu shortcut.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - error indicator.

Example:
G Toolbox 2.2\Examples\Popup Menu Demo.vi

Redraw Event

Input:
hWnd - Handle of the specified window.
redraw - Occurance to be set whenever window redraw occur.

Output:
hWnd dup - Copy of the window handle.
err - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\RedrawEvent Demo.vi

Replace Extension.vi

Input:
path in - input path, which extension is going to be replaced.
new extension - will be used to replace the extension of input path.

Output:
path out - path with new extension.

Save Pic.vi

Input:
hPic - Specify the handle of the picture.
type - Specify the image type. Option of bmp, jpg, and png.
path - Specify where the picture should be saved.

Output:
hPic - Copy of the handle of the picture.
err code - Window error code.
error - error indicator.

Example:
G Toolbox 2.2\Examples\Save Pic Demo.vi

Scolling Text

Input:
hWnd - Handle of the specified window.
String - Specify the scrolling string.
delay (ms) - Delay in milliseconds between string updates.
flag - begin: create the scrolling string; stop: destroy the scrolling string.
rect - Define the rectangular area to be used to draw the scrolling string.
left - the x coordinate of the upper-left corner of the rectangular.
top - the y coordinate of the upper-left corner of the rectangular.
right - the x coordinate of the lower-right corner of the rect.
bottom - the y coordinate of the lower-right corner of the rect.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\Scrolling Text Demo.vi

SemiTransparent String.vi

Input:
hWnd - Handle of the specified window.
txt color - String color.
bk color - Background color.
String - The string.
position - The position & size of the string.
x - the x coordinate of the upper-left corner of the string.
y - the y coordinate of the upper-left corner of the string.
width - the width of the string.
height - the height of the string.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\RedrawEvent Demo.vi

SemiTransparent Window.vi

Input:
hWnd - Handle of the specified window.
alpha - level of transparency.

alpha = 0 --> transparent;
alpha = 255 --> opaque.

Output:
hWnd dup - Copy of the window handle.

Example:
G Toolbox 2.2\Examples\SemiTransparent Window Demo.vi

Set Parent plus.vi

Input:
hWnd parent - Handle of the parent window.
hWnd child - Handle of the child window.

Output:
hWnd parent dup - Copy of the parent window handle.
hWnd previous parent - handle of the previous parent window.

Shortcut.vi

Input:
Run - run time window status option: normal, minimized, or maxmized.
Target - path & name of the target file that this shortcut points to.
Start dir - working directory where contains related files.
to path - path to save this shortcut.
argument - parameters for the target application.

Output:
err code - Window error code.
error - Boolean error indecator.

Simulate Click.vi

Input:
button event - left down, left up; right down, right up; middle down, middle up.

Output:
none.

Example:
G Toolbox 2.2\Examples\Click Demo.vi

SnapView

Input:
path - Specify the path & name for the bmp file.
cursor - Include or exclude the cursor image.
rect - Define the rectangular area to be captured (in screen coordinate).
left - the x coordinate of the upper-left corner of the rectangular.
top - the y coordinate of the upper-left corner of the rectangular.
right - the x coordinate of the lower-right corner of the rect.
bottom - the y coordinate of the lower-right corner of the rect.

Output:
err code - Window error code.
error - Boolean error indecator.

Strip Extension.vi

Input:
path in - input path, to be stripped.

Output:
path out - extension stripped path.

SysTray Icon.vi

Input:
hWnd - Handle of the specified window.
tipText - Specify the text which shown up when cursor hove the icon.
hIcon - Handle of the icon to be added to the system tray.
flag - ADD: add icon into system tray; DELETE: remove the icon; MODIFY: change icon, or tip text.
Occur - The occurance to be set whenever the icon is clicked.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.
Occur dup - Copy of the occurance.

Example:
G Toolbox 2.2\Examples\SysTray Demo.vi

SysTray II.vi

Input:
hWnd - Handle of the specified window.
tipText - Specify the text which shown up when cursor hove the icon.
hIcon - Handle of the icon to be added to the system tray.
flag - ADD: add icon into system tray; DELETE: remove the icon; MODIFY: change icon, or tip text.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Time Zone

Input:
timeZone - Specify the time zone to be set.

Output:
Valid TimeZones - Retrieve all valid time zones.
TimeZone Info - Retrieve time zone information.

StdName - Name for the standard time. e.g. Central Standard Time.
DltName - Name for the daylight saving time on this operating system.
Bias - the difference, in minutes, between Coordinated Universal Time (UTC) and local time.
StdBias - a bias value to be used during local time translations that occur during standard time. This value is added to the value of the Bias to form the bias used during standard time. In most time zones, the value of this member is zero.
DltBias - a bias value to be used during local time translations that occur during daylight saving time. This value is added to the value of the Bias to form the bias used during daylight saving time. In most time zones, the value of this member is -60.
display - The time zone name displayed in the (Control Panel) Date & Time Properties dialog.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\World Clock.vi

Vertical Text.vi

Input:
hWnd - Handle of the specified window.
text - The string & its font, color, ...
Text - the string.
Font - the font for the string.
x - the x coordinate of the upper-left corner of the string.
y - the y coordinate of the upper-left corner of the string.
size - the size of the font.
color - the color of the string.

Output:
hTxt - Handle of the vertical text.
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Window - O.vi

Input:
hWnd - Handle of the specified window.
Titlebar - Titlebar option: Don't care, or visible.
bounding box - the smallest box which can hold the elliptic window. Window coordinates.
x0 - the x coordinate of the upper-left corner of the rectangular.
y0 - the y coordinate of the upper-left corner of the rectangular.
x1 - the x coordinate of the lower-right corner of the rect.
y1 - the y coordinate of the lower-right corner of the rect.

Output:
hWnd dup - Copy of the window handle.
err code - Window error code.
error - Boolean error indecator.

Example:
G Toolbox 2.2\Examples\World Clock.vi
Multi-Media Player