IDWriteLocalizedStrings::GetStringLength-Methode (dwrite.h)
Ruft die Länge der Zeichenfolge mit dem angegebenen Index in Zeichen (ohne NULL-Abschlusszeichen) ab.
Syntax
HRESULT GetStringLength(
UINT32 index,
[out] UINT32 *length
);
Parameter
index
Typ: UINT32
Ein nullbasierter Index des Sprach-/Zeichenfolgenpaars.
[out] length
Typ: UINT32*
Die Länge in Zeichen der Zeichenfolge, ohne den NULL-Abschlusszeichen, aus dem Sprach-/Zeichenfolgenpaar.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Verwenden Sie GetStringLength , um die Zeichenfolgenlänge abzurufen, bevor Sie die IDWriteLocalizedStrings::GetString-Methode aufrufen, wie im folgenden Code gezeigt.
UINT32 length = 0;
// Get the string length.
if (SUCCEEDED(hr))
{
hr = pFamilyNames->GetStringLength(index, &length);
}
// Allocate a string big enough to hold the name.
wchar_t* name = new (std::nothrow) wchar_t[length+1];
if (name == NULL)
{
hr = E_OUTOFMEMORY;
}
// Get the family name.
if (SUCCEEDED(hr))
{
hr = pFamilyNames->GetString(index, name, length+1);
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |