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. This function is available only in the Medical Imaging Suite toolkits.

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;
}