Schowek

schowek to zestaw funkcji i komunikatów, które umożliwiają aplikacjom przesyłanie danych. Ponieważ wszystkie aplikacje mają dostęp do schowka, dane można łatwo przesyłać między aplikacjami lub w aplikacji.

To omówienie nie opisuje sposobu kopiowania i wklejania połączonych lub osadzonych obiektów. Aby uzyskać informacje na temat tych tematów, zobacz dokumentację modelu obiektów składowych (COM).

W tym dziale

Poniższe tematy dostarczają informacji na temat schowka, formatów schowka, operacji na schowku oraz komunikatów związanych ze schowkiem. Dokumentacja referencyjna interfejsu API zawiera funkcje i komunikaty służące do pracy ze schowkiem.

Nazwa	Opis
Informacje o Schowku	Omawia schowek.
Formaty schowka	Omówienie na temat formatów schowka. Okno może umieścić więcej niż jeden obiekt w schowku, z których każdy reprezentuje te same informacje w innym formacie schowka. Użytkownicy nie muszą pamiętać o formatach schowka używanych dla obiektu w schowku.
Operacje schowka	Omówienie operacji schowka. Okno powinno używać schowka podczas wycinania, kopiowania lub wklejania danych. Okno umieszcza dane w schowku na potrzeby operacji wycinania i kopiowania oraz pobiera dane ze schowka na potrzeby operacji wklejania.
Format schowka HTML	Omówienie formatu Schowka HTML.
Korzystanie ze Schowka	Okno podglądu schowka wyświetla bieżącą zawartość schowka i odbiera komunikaty, gdy zawartość schowka się zmienia.
Dokumentacja schowka	Zawiera dokumentację interfejsu API.

Funkcje schowka

W poniższej tabeli wymieniono funkcje, których można użyć do pracy ze schowkiem:

Nazwa	Opis
AddClipboardFormatListener	Umieszcza podane okno na liście odbiorników formatu schowka obsługiwanego przez system.
ChangeClipboardChain	Usuwa określone okno z łańcucha przeglądarek schowka.
CloseClipboard	Zamyka schowek.
CountClipboardFormats	Pobiera liczbę różnych formatów danych obecnie w schowku.
EmptyClipboard	Opróżnia schowek i zwalnia uchwyty do danych w schowku. Następnie funkcja przypisuje własność schowka do okna, które obecnie ma otwarty schowek.
EnumClipboardFormats	Wylicza formaty danych, które są obecnie dostępne w schowku. Formaty danych w schowku są przechowywane na uporządkowanej liście. Aby przeprowadzić enumerację formatów danych schowka, wykonaj serię wywołań funkcji EnumClipboardFormats. Dla każdego wywołania parametr formatu określa dostępny format schowka, a funkcja zwraca następny dostępny format schowka.
GetClipboardData	Pobiera dane w określonym formacie ze schowka. Schowek musi być wcześniej otwarty.
GetClipboardFormatName	Pobiera ze schowka nazwę określonego zarejestrowanego formatu. Funkcja kopiuje nazwę do określonego buforu.
GetClipboardOwner	Pobiera uchwyt okna bieżącego właściciela schowka.
GetClipboardSequenceNumber	Pobiera numer sekwencji schowka dla bieżącej stacji okien.
GetClipboardViewer	Pobiera uchwyt do pierwszego okna w łańcuchu przeglądarki schowka.
GetOpenClipboardWindow	Pobiera uchwyt do okna, w ramach którego jest obecnie otwarty schowek.
GetPriorityClipboardFormat	Pobiera pierwszy dostępny format schowka z określonej listy.
GetUpdatedClipboardFormats	Pobiera aktualnie obsługiwane formaty Schowka.
IsClipboardFormatAvailable	Określa, czy schowek zawiera dane w określonym formacie.
OpenClipboard	Otwiera schowek do analizy i blokuje innym aplikacjom możliwość modyfikacji jego zawartości.
RegisterClipboardFormat	Rejestruje nowy format schowka. Ten format można następnie użyć jako prawidłowego formatu schowka.
RemoveClipboardFormatListener	Usuwa podane okno z listy słuchaczy formatu schowka obsługiwanej przez system.
SetClipboardData	Umieszcza dane w schowku w formacie określonym dla schowka. Okno musi być bieżącym właścicielem schowka, a aplikacja musi wywołać funkcję OpenClipboard. (Podczas odpowiadania na komunikat WM_RENDERFORMAT właściciel schowka nie może wywołać funkcji OpenClipboard przed wywołaniem funkcji SetClipboardData.)
SetClipboardViewer	Dodaje określone okno do łańcucha osób przeglądających schowek. Okna podglądu Schowka otrzymują komunikat WM_DRAWCLIPBOARD za każdym razem, gdy zawartość schowka ulegnie zmianie.

Komunikaty schowka

W poniższej tabeli wymieniono wszystkie komunikaty, które są wysyłane do okien podglądu schowka:

Nazwa	Opis
WM_CLEAR	Wysłane do kontrolki edycji lub pola kombi, aby usunąć (wyczyść) bieżące zaznaczenie, jeśli istnieje, z kontrolki edycji.
WM_COPY	Wysłane do kontrolki edycji lub pola kombi w celu skopiowania bieżącego zaznaczenia do schowka w formacie CF_TEXT .
WM_CUT	Wysłane do kontrolki edycji lub pola kombi, aby usunąć bieżące zaznaczenie, jeśli istnieje, w kontrolce edycji i skopiować usunięty tekst do schowka w formacie CF_TEXT.
WM_PASTE	Wysłane do kontrolki edycji lub pola kombinowanego w celu skopiowania aktualnej zawartości schowka do kontrolki edycji przy aktualnej pozycji kursora. Dane zostaną wstawione tylko wtedy, gdy schowek zawiera dane w formacie CF_TEXT.

Powiadomienia schowka

W poniższej tabeli wymieniono komunikaty powiadomień schowka wysyłane do okna przeglądarki schowka:

Nazwa	Opis
WM_ASKCBFORMATNAME	Wysłane do właściciela schowka przez okno przeglądarki schowka w celu zażądania nazwy formatu schowka CF_OWNERDISPLAY .
WM_CHANGECBCHAIN	Wysłanie do pierwszego okna w łańcuchu przeglądarki schowka, gdy okno jest usuwane z łańcucha.
WM_CLIPBOARDUPDATE	Wysłane, gdy zawartość schowka uległa zmianie.
WM_DESTROYCLIPBOARD	Wiadomość zostaje wysłana do właściciela schowka, gdy wywołanie funkcji EmptyClipboard opróżnia schowek.
WM_DRAWCLIPBOARD	Wysłane do pierwszego okna w łańcuchu przeglądarki schowka po zmianie zawartości schowka. Dzięki temu okno przeglądarki schowka może wyświetlać nową zawartość schowka.
WM_HSCROLLCLIPBOARD	Wysłane do właściciela schowka przez okno przeglądarki schowka. Dzieje się tak, gdy schowek zawiera dane w formacie CF_OWNERDISPLAY, a zdarzenie występuje na poziomym pasku przewijania przeglądarki schowka. Właściciel powinien przewinąć zawartość schowka i zaktualizować wartości paska przewijania.
WM_PAINTCLIPBOARD	Wysłane do właściciela schowka przez okno przeglądarki schowka, gdy schowek zawiera dane w formacie CF_OWNERDISPLAY , a obszar klienta przeglądarki schowka wymaga przemalowania.
WM_RENDERALLFORMATS	Wysłane do właściciela schowka przed jego usunięciem, jeśli właściciel schowka opóźnił renderowanie co najmniej jednego z formatów schowka. Aby zawartość schowka pozostała dostępna dla innych aplikacji, właściciel schowka musi renderować dane we wszystkich formatach, które może wygenerować, i umieścić dane w schowku, wywołując funkcję SetClipboardData .
WM_RENDERFORMAT	Wysłane do właściciela schowka, jeśli renderowanie określonego formatu schowka zostało opóźnione i aplikacja zażądała danych w tym formacie. Właściciel schowka musi renderować dane w określonym formacie i umieścić je w schowku, wywołując funkcję SetClipboardData .
WM_SIZECLIPBOARD	Wysłane do właściciela schowka przez okno przeglądarki schowka, gdy schowek zawiera dane w formacie CF_OWNERDISPLAY, a obszar klienta okna przeglądarki schowka zmienił rozmiar.
WM_VSCROLLCLIPBOARD	Wysłane do właściciela schowka przez okno przeglądarki schowka, gdy schowek zawiera dane w formacie CF_OWNERDISPLAY , a zdarzenie występuje na pionowym pasku przewijania przeglądarki schowka. Właściciel powinien przewinąć zawartość schowka i zaktualizować wartości paska przewijania.

Struktur

W poniższej tabeli wymieniono struktury używane w schowku:

Nazwa	Opis
METAFILEPICT	Definiuje format obrazu metapliku używany do wymiany danych metapliku za pośrednictwem schowka.