Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2012
Visual C++
MFC and ATL
MFC Desktop Applications
Classes
CDC Class
CDC::AbortDoc
CDC::AbortPath
CDC::AddMetaFileComment
CDC::AlphaBlend
CDC::AngleArc
CDC::Arc
CDC::ArcTo
CDC::Attach
CDC::BeginPath
CDC::BitBlt
CDC::CDC
CDC::Chord
CDC::CloseFigure
CDC::CreateCompatibleDC
CDC::CreateDC
CDC::CreateIC
CDC::DeleteDC
CDC::DeleteTempMap
CDC::Detach
CDC::DPtoHIMETRIC
CDC::DPtoLP
CDC::Draw3dRect
CDC::DrawDragRect
CDC::DrawEdge
CDC::DrawEscape
CDC::DrawFocusRect
CDC::DrawFrameControl
CDC::DrawIcon
CDC::DrawState
CDC::DrawText
CDC::DrawTextEx
CDC::Ellipse
CDC::EndDoc
CDC::EndPage
CDC::EndPath
CDC::EnumObjects
CDC::Escape
CDC::ExcludeClipRect
CDC::ExcludeUpdateRgn
CDC::ExtFloodFill
CDC::ExtTextOut
CDC::FillPath
CDC::FillRect
CDC::FillRgn
CDC::FillSolidRect
CDC::FlattenPath
CDC::FloodFill
CDC::FrameRect
CDC::FrameRgn
CDC::FromHandle
CDC::GetArcDirection
CDC::GetAspectRatioFilter
CDC::GetBkColor
CDC::GetBkMode
CDC::GetBoundsRect
CDC::GetBrushOrg
CDC::GetCharacterPlacement
CDC::GetCharABCWidths
CDC::GetCharABCWidthsI
CDC::GetCharWidth
CDC::GetCharWidthI
CDC::GetClipBox
CDC::GetColorAdjustment
CDC::GetCurrentBitmap
CDC::GetCurrentBrush
CDC::GetCurrentFont
CDC::GetCurrentPalette
CDC::GetCurrentPen
CDC::GetCurrentPosition
CDC::GetDCBrushColor
CDC::GetDCPenColor
CDC::GetDeviceCaps
CDC::GetFontData
CDC::GetFontLanguageInfo
CDC::GetGlyphOutline
CDC::GetGraphicsMode
CDC::GetHalftoneBrush
CDC::GetKerningPairs
CDC::GetLayout
CDC::GetMapMode
CDC::GetMiterLimit
CDC::GetNearestColor
CDC::GetOutlineTextMetrics
CDC::GetOutputCharWidth
CDC::GetOutputTabbedTextExtent
CDC::GetOutputTextExtent
CDC::GetOutputTextMetrics
CDC::GetPath
CDC::GetPixel
CDC::GetPolyFillMode
CDC::GetROP2
CDC::GetSafeHdc
CDC::GetStretchBltMode
CDC::GetTabbedTextExtent
CDC::GetTextAlign
CDC::GetTextCharacterExtra
CDC::GetTextColor
CDC::GetTextExtent
CDC::GetTextExtentExPointI
CDC::GetTextExtentPointI
CDC::GetTextFace
CDC::GetTextMetrics
CDC::GetViewportExt
CDC::GetViewportOrg
CDC::GetWindow
CDC::GetWindowExt
CDC::GetWindowOrg
CDC::GetWorldTransform
CDC::GradientFill
CDC::GrayString
CDC::HIMETRICtoDP
CDC::HIMETRICtoLP
CDC::IntersectClipRect
CDC::InvertRect
CDC::InvertRgn
CDC::IsPrinting
CDC::LineTo
CDC::LPtoDP
CDC::LPtoHIMETRIC
CDC::m_hAttribDC
CDC::m_hDC
CDC::MaskBlt
CDC::ModifyWorldTransform
CDC::MoveTo
CDC::OffsetClipRgn
CDC::OffsetViewportOrg
CDC::OffsetWindowOrg
CDC::operator HDC
CDC::PaintRgn
CDC::PatBlt
CDC::Pie
CDC::PlayMetaFile
CDC::PlgBlt
CDC::PolyBezier
CDC::PolyBezierTo
CDC::PolyDraw
CDC::Polygon
CDC::Polyline
CDC::PolylineTo
CDC::PolyPolygon
CDC::PolyPolyline
CDC::PtVisible
CDC::QueryAbort
CDC::RealizePalette
CDC::Rectangle
CDC::RectVisible
CDC::ReleaseAttribDC
CDC::ReleaseOutputDC
CDC::ResetDC
CDC::RestoreDC
CDC::RoundRect
CDC::SaveDC
CDC::ScaleViewportExt
CDC::ScaleWindowExt
CDC::ScrollDC
CDC::SelectClipPath
CDC::SelectClipRgn
CDC::SelectObject
CDC::SelectPalette
CDC::SelectStockObject
CDC::SetAbortProc
CDC::SetArcDirection
CDC::SetAttribDC
CDC::SetBkColor
CDC::SetBkMode
CDC::SetBoundsRect
CDC::SetBrushOrg
CDC::SetColorAdjustment
CDC::SetDCBrushColor
CDC::SetDCPenColor
CDC::SetGraphicsMode
CDC::SetLayout
CDC::SetMapMode
CDC::SetMapperFlags
CDC::SetMiterLimit
CDC::SetOutputDC
CDC::SetPixel
CDC::SetPixelV
CDC::SetPolyFillMode
CDC::SetROP2
CDC::SetStretchBltMode
CDC::SetTextAlign
CDC::SetTextCharacterExtra
CDC::SetTextColor
CDC::SetTextJustification
CDC::SetViewportExt
CDC::SetViewportOrg
CDC::SetWindowExt
CDC::SetWindowOrg
CDC::SetWorldTransform
CDC::StartDoc
CDC::StartPage
CDC::StretchBlt
CDC::StrokeAndFillPath
CDC::StrokePath
CDC::TabbedTextOut
CDC::TextOut
CDC::TransparentBlt
CDC::UpdateColors
CDC::WidenPath
Expand Minimize
This topic has not yet been rated - Rate this topic

CDC::GetCharacterPlacement

Visual Studio 2012

Retrieves various types of information on a character string.

Copy 
DWORD GetCharacterPlacement( 
   LPCTSTR lpString, 
   int nCount, 
   int nMaxExtent, 
   LPGCP_RESULTS lpResults, 
   DWORD dwFlags 
) const; 
DWORD GetCharacterPlacement( 
   CString& str, 
   int nMaxExtent, 
   LPGCP_RESULTS lpResults, 
   DWORD dwFlags 
) const;
lpString

A pointer to the character string to process.

nCount

Specifies the length of the string. For the ANSI version, it is a BYTE count and for the Unicode function it is a WORD count. For more information, see GetCharacterPlacement.

nMaxExtent

Specifies the maximum extent (in logical units) to which the string is processed. Characters that, if processed, would exceed this extent are ignored. Computations for any required ordering or glyph arrays apply only to the included characters. This parameter is used only if the GCP_MAXEXTENT value is specified in the dwFlags parameter. As the function processes the input string, each character and its extent is added to the output, extent, and other arrays only if the total extent has not yet exceeded the maximum. Once the limit is reached, processing will stop.

lpResults

Pointer to a GCP_RESULTS structure that receives the results of the function.

dwFlags

Specifies how to process the string into the required arrays. This parameter can be one or more of the values listed in the dwFlags section of the GetCharacterPlacement topic.

str

A pointer to a CString object to process.

If the function succeeds, the return value is the width and height of the string in logical units.

If the function fails, the return value is zero.

This member function emulates the functionality of the function GetCharacterPlacement, as described in the Windows SDK.

Header: afxwin.h

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.