LToolbar::Create

#include "ltwrappr.h"

L_INT LToolbar::Create (hwndParent, pszTitle, dwFlags)

HWND hwndParent;	/* window handle */
LPCSTR pszTitle;	/* window title string */
L_UINT32 dwFlags;	/* flag that indicates the toolbar type */

Creates a toolbar.

Parameter	Description
hwndParent	Window handle to the toolbar's parent window.
pszTitle	Pointer to a null-terminated string to be used as the title for the toolbar window.
dwFlags	Flags that will indicate the type of the toolbar to be created. Possible values are:
	Value	Meaning
	TOOLBAR_PAINT	Creates a DigitalPaint toolkit toolbar.
	TOOLBAR_VECTOR	Creates a vector toolkit toolbar.
	TOOLBAR_EMPTY	Creates an empty toolbar.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

LToolbar::Initialize must be called before calling this function.

The toolbar is created as a child window to the window specified in hwndParent.

Note:

The Vector and DigitalPaint toolbars are Automation toolbars. When using the Automation Class Library in addition to the Toolbar Class Library, these toolbars automatically handle the buttons and the necessary function calls. If automation is not used, then it is the user's responsibility to create buttons, assign ID numbers, process the events and handle all necessary function calls.

The DigitalPaint toolbar contains the following buttons:

Description	Button ID
$image\Apbrush.gif$ Paintbrush tool	ID_TOOL_PAINT_BRUSH
$image\Alinetool.gif$ Line shape tool	ID_TOOL_PAINT_SHAPE_LINE
$image\Arecttool.gif$ Rectangle shape tool	ID_TOOL_PAINT_SHAPE_RECT
$image\RndRctTl.gif$ Rounded rectangle shape tool	ID_TOOL_PAINT_SHAPE_ROUNDRECT
$image\EllipseTl.gif$ Ellipse shape tool	ID_TOOL_PAINT_SHAPE_ELLIPSE
$image\PylgnTool.gif$ Polygon shape tool	ID_TOOL_PAINT_SHAPE_POLYGON
$image\Bezier.gif$ Bezier shape tool	ID_TOOL_PAINT_SHAPE_BEZIER
$image\RectRgn.gif$ Region rectangle tool	ID_TOOL_PAINT_REGION_RECT
$image\RndRctRgn.gif$ Rounded rectangle region tool	ID_TOOL_PAINT_REGION_ROUNDRECT
$image\EllpsRgn.gif$ Ellipse region tool	ID_TOOL_PAINT_REGION_ELLIPSE
$image\PlygnRgn.gif$ Polygon region tool	ID_TOOL_PAINT_REGION_POLYGON
$image\SurfRgn.gif$ Surface region tool	ID_TOOL_PAINT_REGION_SURFACE
$image\BordRgn.gif$ Border region tool	ID_TOOL_PAINT_REGION_BORDER
$image\ColorRgn.gif$ Color region tool	ID_TOOL_PAINT_REGION_COLOR
$image\SurfFill.gif$ Surface fill tool	ID_TOOL_PAINT_FILL_SURFACE
$image\BordFill.gif$ Border fill tool	ID_TOOL_PAINT_FILL_BORDER
$image\ClrRplc.gif$ Color replace tool	ID_TOOL_PAINT_FILL_COLORREPLACE
$image\TextTool.gif$ Text tool	ID_TOOL_PAINT_TEXT
$image\Zoom.gif$ Zoom tool	ID_TOOL_PAINT_ZOOM
$image\BdrClrPkr.gif$ Border color picker tool	ID_TOOL_PAINT_BORDERCOLORPICKER
$image\MovrTool.gif$ Mover tool	ID_TOOL_PAINT_MOVER

The vector toolbar contains the following buttons:

$image\Neutral.gif$ Neutral (No tool selected)	ID_TOOL_VECTOR_NONE
$image\Select.gif$ Select object(s)	ID_TOOL_VECTOR_SELECT
$image\Vertex.gif$ Vertex	ID_TOOL_VECTOR_VERTEX
$image\Line.gif$ Line	ID_TOOL_VECTOR_LINE
$image\Rectang.gif$ Rectangle	ID_TOOL_VECTOR_RECTANGLE
$image\Polyline.gif$ Polyline	ID_TOOL_VECTOR_POLYLINE
$image\Pbezier.gif$ Polybezier	ID_TOOL_VECTOR_POLYBEZIER
$image\Polygon.gif$ Polygon	ID_TOOL_VECTOR_POLYGON
$image\VEllipse.gif$ Ellipse	ID_TOOL_VECTOR_ELLIPSE
$image\VCircle.gif$ Circle	ID_TOOL_VECTOR_CIRCLE
$image\Varc.gif$ Arc	ID_TOOL_VECTOR_ARC
$image\VText.gif$ Text	ID_TOOL_VECTOR_TEXT
$image\VPie.gif$ Pie	ID_TOOL_VECTOR_PIE
$image\VChord.gif$ Chord	ID_TOOL_VECTOR_CHORD
$image\VRaster.gif$ Raster	ID_TOOL_VECTOR_RASTER
$image\VRotate.gif$ Rotate	ID_TOOL_VECTOR_ROTATE
$image\VPan.gif$ Pan	ID_TOOL_VECTOR_PAN

Required DLLs and Libraries

LTTLB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	LToolbar::Initialize, LToolbar::Free, LToolbar::IsValid, Class Members
Topics:	Creating a Toolbar

Example

This example will initiate, create a toolbar, set its position and make it visible.

/* Global LEAD toolbar handle */
L_INT LToolbar__CreateExample( HWND hWnd, pTOOLBARHANDLE g_pLeadToolbar, LToolbar* tlb)
{
   UNREFERENCED_PARAMETER(g_pLeadToolbar);
   L_INT nRet;
   /* Initiate the toolbar handle */
   nRet = tlb->Initialize () ;
   if(nRet != SUCCESS)
      return nRet;
    /* Check the validity of the handle */
    if ( tlb->IsValid () )
    {
       POINT pt = { 0, 0 } ;
      /* Initiate the point to be used to align the toolbar at the top-left of its owner client area */
      ::ClientToScreen ( hWnd, &pt ) ;
      /* Create the toolbar  */
      nRet = tlb->Create (hWnd, TEXT("Tools Window"), TOOLBAR_PAINT ) ;
      if(nRet != SUCCESS)
         return nRet;
      /* Set the toolbar position */
      nRet = tlb->SetPosition (&pt, TOOLBAR_POSITION_TOP | TOOLBAR_POSITION_LEFT ) ;
      if(nRet != SUCCESS)
         return nRet;
      /* Show the toolbar */
      nRet = tlb->SetVisible (TRUE ) ; 
      if(nRet != SUCCESS)
         return nRet;
    }
   return SUCCESS ;
}