L_DispContainerShowTitlebar

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerShowTitlebar(hCon, uShow, uFlags)

HDISPCONTAINER hCon;	/* handle to the container */
L_UINT uShow;	/* flag */
L_UINT uFlags;	/* reserved for future use */

Shows or hides the title bar.

Parameter	Description
hCon	Handle to the container.
uShow	Flag that indicates whether to show the title bar. Possible values are:
	Value	Meaning
	TRUE	Show the title bar.
	FALSE	Do not show the title bar.
uFlags	Reserved for future use. Pass 0.

Returns

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

Required DLLs and Libraries

LTIVW

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:

L_DispContainerCreate, L_DispContainerDestroy, L_DispContainerIsTitlebarIconChecked, L_DispContainerGetIconProperties L_DispContainerGetTitlebarProperties, L_DispContainerIsTitlebarEnabled, L_DispContainerSetIconProperties, L_DispContainerSetTitlebarProperties, L_DispContainerCheckTitlebarIcon

Topics:

Image Viewer Cells

Image Viewer Functions: Image Viewer Cells

Example

This function maniplulates the title bar feature. In this sample we assume that the user has opened one cell that contains one frame.

L_INT DispContainerShowTitlebarExample(HDISPCONTAINER hCon) 
{
   L_INT                          nI;
   DISPCONTAINERTITLEBARPROPS     DispContainerTitlebarProps;
   DISPCONTAINERTITLEBARICONPROPS DispContainerIconProps;
   L_INT                          nRet;

   // Check if the title bar is already shown or not.
   if (!L_DispContainerIsTitlebarEnabled(hCon, 0))
      // Show the title bar.
      L_DispContainerShowTitlebar(hCon, TRUE, 0);

   DispContainerTitlebarProps.uMask = DCTITLEBAR_ALL;
   DispContainerTitlebarProps.uStructSize = sizeof(DISPCONTAINERTITLEBARPROPS);
   // Set a brighter color for the title bar.
   L_DispContainerGetTitlebarProperties(hCon, &DispContainerTitlebarProps, 0);

   if (DispContainerTitlebarProps.bCustomTitlebarColor)
   {
      DispContainerTitlebarProps.crColor = RGB(min(255, GetRValue(DispContainerTitlebarProps.crColor) + 10),
                                               min(255, GetGValue(DispContainerTitlebarProps.crColor) + 10),
                                               min(255, GetBValue(DispContainerTitlebarProps.crColor) + 10));

      L_DispContainerSetTitlebarProperties(hCon, &DispContainerTitlebarProps, 0);
   }

   // Invert the button icon status for all the cells.
   for (nI = 0; nI < 8; nI++)
   {
      DispContainerIconProps.uMask = DCTITLEBAR_ICONPROPS_ALL;
      DispContainerIconProps.uStructSize = sizeof(DISPCONTAINERTITLEBARICONPROPS);

      nRet = L_DispContainerGetIconProperties(hCon, nI, &DispContainerIconProps, 0);

      if (!DispContainerIconProps.bReadOnly)
      {
         L_DispContainerCheckTitlebarIcon(hCon, 0, 0, nI, !L_DispContainerIsTitlebarIconChecked(hCon, 0, 0, nI, 0), 0);
      }
      nRet = L_DispContainerSetIconProperties(hCon, nI, &DispContainerIconProps, 0);
   }
   return SUCCESS;
}