Sdílet prostřednictvím


CDC::GetCharacterPlacement

Načte různé typy informací v řetězci znaků.

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;

Parametry

  • lpString
    Ukazatel na textový řetězec, který má být zpracován.

  • nCount
    Určuje délku řetězce.Pro verzi ANSI je to počet BAJTŮ a pro funkci Unicode je to počet SLOV.Další informace najdete v části GetCharacterPlacement.

  • nMaxExtent
    Určuje maximální rozsah (v logických jednotkách), ve kterém je řetězec zpracován.Znaky, které by při zpracování způsobily překročení tohoto rozsahu, jsou ignorovány.Výpočty pro všechna požadovaná pole řazení nebo glyfů se použijí pouze na zahrnuté znaky.Tento parametr se používá pouze tehdy, pokud je zadána hodnota GCP_MAXEXTENT v parametru dwFlags.Jako funkce zpracovává vstupní řetězec, každý znak a jeho rozsah je přidán do výstupu, rozsahu a jiných polí pouze v případě, že celková rozloha ještě nepřekročila maximální.Po dosažení limitu se zpracování zastaví.

  • lpResults
    Vložte ukazatel na strukturu GCP_Results, která přijímá výsledky funkce.

  • dwFlags
    Určuje způsob zpracování řetězce do požadovaných polí.Tento parametr může být jedna nebo více hodnot uvedených v oddílu dwFlags tématu GetCharacterPlacement.

  • str
    Ukazatel na objekt CString ke zpracování.

Vrácená hodnota

Pokud je funkce úspěšná, vrácená hodnota je šířka a výška řetězce v logických jednotkách.

Pokud selže funkce, vrácená hodnota je nula.

Poznámky

Tato funkce člena emuluje funkčnost funkce GetCharacterPlacement podle popisu v Windows SDK.

Požadavky

Hlavička: afxwin.h

Viz také

Referenční dokumentace

Třída Nemocnosti

Graf hierarchie

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics