Data 7 Design Thumbnail OCX Help

www.data7consultancy.com

Use the Data 7 Design Thumbnail OCX to display an embroidery design file. The Data 7 Design
Thumbnail control is compatible with many different design formats.

Note: This OCX comes with a developer LIC file that is required so it can be used with your own development
code. Under no circumstances must the LIC be included in any installation packages or distributed without
prior consent from Data 7 Consultancy.

Properties
BackColour
Blueblue
BorderSize
BorderStyle
ColourNumber
Colours
DesignHeight
DesignWidth
DrawNeedle
Greengreen
MaxX
MaxY
MinX
MinY
NeedleChanges
PaletteColour
Picture
Red
Stitches
Image

Methods
Showshowdesign

Compatible Design Formats

The Data 7 Design Thumbnail Control can read the following design
formats:

- Data 7 Quick Expanded .QEP
- Barudan DOS .U01
- Babylock, Bernina, Brother .PES-
- Compucon .XXX
- Elna .EMD
- Generations .VST
- Happy .TAP
- Janome .JEF
- Janome .SEW
- Melco .EXP
- Pfaff .KSM
- Pfaff .PCS
- Pfaff .PCM
- Tajima .DSB (Barudan stitch data)
- Tajima .DST (Eltac stitch data)
- Tajima .DSZ (Fortron stitch data)
- Toyota .10O
- Wilcom Barudan .T03 (Barudan stitch data)
- Wilcom Tajima .T01 (Eltac stitch data)
- Wilcom Zangs .T04 (Fortron stitch data)
- Wilcom ZSK .T05 (Fortron stitch data)
BackColour Property

Returns or sets the background colour of the thumbnail control.

Syntax
thumbnailcontrol.BackColour [= colour]
Setting Description
Normal RGB colours Colours specified by using the standard RGB Colour palette

Available only at run-time

Blue Property


Returns an integer representing the blue element of the design colour pointed to by the
ColourNumber property. The value returned is a number in the range 0-255

Syntax
thumbnailcontrol.Blue

Available only at run-time
BorderSize Property

Returns or sets the BorderSize in pixels. This is reflected as a space around the control/design. The
range is 0-20.
Syntax
thumbnailcontrol.BorderSize = [value]
The BorderSize property settings are:
Setting Description
0 None (no border space from edge of control to
design).
1-20 Space in pixels from edge on control to design.


Available only at run-time
ColourNumber Property

Returns or sets the colour number of a design currently displayed by the thumbnail control. The
ColourNumber property is used to return values for the PaletteColour, Red, Greenand Blue
properties
Syntax
thumbnailcontrol.ColourNumber = [value]
Setting Description
0-thumbnailcontrol.Colours Colour number to return PaletteColour, Red,
Green or Blue property.


Available only at run-time
Colours Property

Returns the total number of colours in the sequence for the currently displayed design in the
thumbnail control. This number is then used as the maximum number passed to the ColourNumber
Syntax
thumbnailcontrol.Colours

Available only at run-time
DesignHeight Property


Returns the height of the design currently displayed in the thumbnail control. This value is in
1/10mm

Syntax
thumbnailcontrol.DesignHeight

Available only at run-time
DesignWidth Property

Returns the width of the design currently displayed in the thumbnail control. This value is in
1/10mm

Syntax
thumbnailcontrol.DesignWidth

Available only at run-time
DrawNeedle Property

Returns or sets the colour number of a design to be drawn.
Syntax
thumbnailcontrol.DrawNeedle = [value]
Setting Description
0 Draw entire design
1-thumbnailcontrol.Colours Draws only colour set by this property

Remarks

If the DrawNeedle property is set to a none zero value which is not greater than the Colours
property then only this colour is drawn and the Stitchesproperty will equal the total stitches in that
colour only.


Available only at run-time
Green Property


Returns an integer representing the green element of the design colour pointed to by the
ColourNumber property. The value returned is a number in the range 0-255
Syntax
thumbnailcontrol.Green
Available only at run-time

MaxX Property


Returns an integer representing the maximum x co-ordinate of the currently drawn design.
Syntax
thumbnailcontrol.MaxX
Available only at run-time
MaxY Property


Returns an integer representing the maximum y co-ordinate of the currently drawn design.
Syntax
thumbnailcontrol.MaxY
Available only at run-time
MinX Property


Returns an integer representing the minimum x co-ordinate of the currently drawn design.
Syntax
thumbnailcontrol.MinX
Available only at run-time
MinY Property


Returns an integer representing the minimum y co-ordinate of the currently drawn design.
Syntax
thumbnailcontrol.MinY
Available only at run-time
NeedleChanges Property


Returns the total number of needle changes in the currently displayed design in the thumbnail
control.

Syntax
thumbnailcontrol.NeedleChanges

Available only at run-time
Red Property

Returns an integer representing the red element of the design colour pointed to by the ColourNumber
property. The value returned is a number in the range 0-255

Syntax
thumbnailcontrol.Red

Available only at run-time
Stitches Property


Returns the total number of stitches in the currently displayed design in the thumbnail control unless
the DrawNeedle property was first set to a value between 1 and the total number of Colours.


Syntax
thumbnailcontrol.Stitches

Available only at run-time
ShowDesign Method

Sets the design to be drawn.
Syntax
Retval=thumbnailcontrol.ShowDesign(Design)
The ShowDesign method syntax has these parts:
Part Description
Design Full design name and path of design to be drawn by the control

Returns an integer.
0 Design drawn successfully
None Zero Error drawing design. Return value is error code.


Available only at run-time
PaletteColour Property


Returns the position of the colour in the design palette pointed to by the ColourNumber property.

e.g.
A design has 10 colours in it sequence and 9 needle changes but only has 5 colours in the design
palette.

Colour Number 1 2 3 4 5 6 7 8 9 10
Palette Position 4 1 2 5 3 5 3 2 5 4

if ColourNumber equals 4 then PaletteColour would equal 5 which would be the palette position 5.
Syntax
thumbnailcontrol.PaletteColour

Available only at run-time
BorderStyle Property
Returns or sets the border style for the thumbnail control.
Syntax
thumbnailcontrol.BorderStyle = [value]
The BorderStyle property settings are:
Setting Description
0 None (no border or border-related elements).
1 Fixed Single

Image Property


Returns the a snapshot image of whatever is within the control.

Syntax
LPPictureDisp = thumbnailcontrol.Image

Available only at run-time