CEdit::SetHandle
Wywołanie tej funkcji, aby ustawić dojście do pamięci lokalnej, który będzie używany przez wielu linii formantu edycyjnego.
void SetHandle(
HLOCAL hBuffer
);
Parametry
- hBuffer
Zawiera dojście do pamięci lokalnej.Ten uchwyt należy utworzony przez poprzednie wywołanie LocalAlloc za pomocą funkcji Windows LMEM_MOVEABLE flagi.Przyjęto, że pamięć zawierają ciąg zakończony znakiem null.Jeśli nie pierwszy bajt alokacji pamięci należy ustawić na 0.
Uwagi
Formant edycji użyje tego buforu do przechowywania aktualnie wyświetlanego tekstu zamiast przydzielania buforu własne.
Ta funkcja Członkowskim jest przetwarzany tylko przez formanty edycji wielu linii.
Zanim aplikacja ustawia nowy uchwyt pamięci, należy użyć GetHandle Członkowskich funkcji, aby uzyskać dojścia do bufora pamięci bieżącego i wolne, iż przy użyciu pamięci funkcji LocalFree funkcji systemu Windows.
SetHandleCzyści bufor Cofnij ( CanUndo Członkowskich funkcja zwraca 0) i flagi wewnętrznego modyfikacji ( GetModify Członkowskich funkcja zwraca 0).Okno edycji formantu jest odświeżana.
Można użyć tej funkcji Członkowskich w formancie edycji wielu linii w oknie dialogowym tylko wtedy, gdy utworzono okno dialogowe z DS_LOCALEDIT styl z ustawioną flagą.
[!UWAGA]
GetHandle nie działa z systemem Windows 95 i 98.Jeśli zadzwonisz GetHandle w systemie Windows 95/98, zwróci NULL.GetHandle będzie działać jak udokumentowane w systemie Windows NT w wersji 3.51 lub nowszej.
Aby uzyskać więcej informacji, zobacz EM_SETHANDLE, LocalAlloc, i funkcji LocalFree w Windows SDK.
Przykład
// The string to set in the edit control.
CString strString(_T("George Frideric"));
// Initialize the new local handle.
size_t cbSize = (strString.GetLength() + 1) * sizeof(TCHAR);
HLOCAL h = ::LocalAlloc(LHND, cbSize);
LPTSTR lpszText = (LPTSTR) ::LocalLock(h);
_tcsncpy_s(lpszText, cbSize / sizeof(TCHAR), strString, _TRUNCATE);
::LocalUnlock(h);
// Free the current text handle of the edit control.
::LocalFree(m_myEdit.GetHandle());
// Set the new text handle.
m_myEdit.SetHandle(h);
Wymagania
Nagłówek: afxwin.h