Klasa COleServerItemCOleServerItem Class

Udostępnia interfejs serwera do elementów OLE.Provides the server interface to OLE items.

SkładniaSyntax

class COleServerItem : public CDocItem

Elementy członkowskieMembers

Konstruktory chronioneProtected Constructors

NazwaName OpisDescription
COleServerItem:: COleServerItemCOleServerItem::COleServerItem Konstruuje COleServerItem obiekt.Constructs a COleServerItem object.

Metody publicznePublic Methods

NazwaName OpisDescription
COleServerItem:: AddOtherClipboardDataCOleServerItem::AddOtherClipboardData Umieszcza w obiekcie formaty prezentacji i konwersji COleDataSource .Places presentation and conversion formats in a COleDataSource object.
COleServerItem:: CopyToClipboardCOleServerItem::CopyToClipboard Kopiuje element do Schowka.Copies the item to the Clipboard.
COleServerItem::D oDragDropCOleServerItem::DoDragDrop Wykonuje operację przeciągania i upuszczania.Performs a drag-and-drop operation.
COleServerItem:: GetClipboardDataCOleServerItem::GetClipboardData Pobiera źródło danych do użycia w transferze danych (przeciągnij i upuść lub Clipboard).Gets the data source for use in data transfer (drag and drop or Clipboard).
COleServerItem:: GetDocumentCOleServerItem::GetDocument Zwraca dokument serwera, który zawiera element.Returns the server document that contains the item.
COleServerItem:: GetEmbedSourceDataCOleServerItem::GetEmbedSourceData Pobiera CF_EMBEDSOURCE dane dla elementu OLE.Gets the CF_EMBEDSOURCE data for an OLE item.
COleServerItem:: getitemnameCOleServerItem::GetItemName Zwraca nazwę elementu.Returns the name of the item. Używany tylko do elementów połączonych.Used for linked items only.
COleServerItem:: GetLinkSourceDataCOleServerItem::GetLinkSourceData Pobiera CF_LINKSOURCE dane dla elementu OLE.Gets the CF_LINKSOURCE data for an OLE item.
COleServerItem:: GetObjectDescriptorDataCOleServerItem::GetObjectDescriptorData Pobiera CF_OBJECTDESCRIPTOR dane dla elementu OLE.Gets the CF_OBJECTDESCRIPTOR data for an OLE item.
COleServerItem:: IsConnectedCOleServerItem::IsConnected Wskazuje, czy element jest obecnie dołączony do aktywnego kontenera.Indicates whether the item is currently attached to an active container.
COleServerItem:: IsLinkedItemCOleServerItem::IsLinkedItem Wskazuje, czy element reprezentuje połączony element OLE.Indicates whether the item represents a linked OLE item.
COleServerItem:: NotifyChangedCOleServerItem::NotifyChanged Aktualizuje wszystkie kontenery za pomocą automatycznej aktualizacji łącza.Updates all containers with automatic link update.
COleServerItem:: OnDoVerbCOleServerItem::OnDoVerb Wywołuje się, by wykonać czasownik.Called to execute a verb.
COleServerItem:: OnDrawCOleServerItem::OnDraw Wywołuje się, gdy kontener przeprosi o narysowanie elementu; wymagana implementacja.Called when the container requests to draw the item; implementation required.
COleServerItem:: przesłonięcie ondrawexCOleServerItem::OnDrawEx Wywołuje się, by uzyskać wyspecjalizowany rysunek elementu.Called for specialized item drawing.
COleServerItem:: OnGetClipboardDataCOleServerItem::OnGetClipboardData Wywoływane przez platformę, aby pobrać dane, które zostaną skopiowane do Schowka.Called by the framework to get the data that would be copied to the Clipboard.
COleServerItem:: OnGetExtentCOleServerItem::OnGetExtent Wywoływane przez platformę, by pobrać rozmiar elementu OLE.Called by the framework to retrieve the size of the OLE item.
COleServerItem:: OnInitFromDataCOleServerItem::OnInitFromData Wywoływane przez platformę, by zainicjować element OLE przy użyciu zawartości określonego obiektu transferu danych.Called by the framework to initialize an OLE item using the contents of the data transfer object specified.
COleServerItem:: OnQueryUpdateItemsCOleServerItem::OnQueryUpdateItems Wywołuje się, by określić, czy wszystkie elementy połączone wymagają aktualizacji.Called to determine whether any linked items require updating.
COleServerItem:: OnRenderDataCOleServerItem::OnRenderData Pobiera dane w ramach opóźnionego renderowania.Retrieves data as part of delayed rendering.
COleServerItem:: OnRenderFileDataCOleServerItem::OnRenderFileData Pobiera dane do CFile obiektu w ramach opóźnionego renderowania.Retrieves data into a CFile object as part of delayed rendering.
COleServerItem:: OnRenderGlobalDataCOleServerItem::OnRenderGlobalData Pobiera dane do HGLOBAL w ramach opóźnionego renderowania.Retrieves data into an HGLOBAL as part of delayed rendering.
COleServerItem:: OnSetColorSchemeCOleServerItem::OnSetColorScheme Wywołuje się, by ustawić schemat kolorów elementu.Called to set the item's color scheme.
COleServerItem:: OnSetDataCOleServerItem::OnSetData Wywołuje się, by ustawić dane elementu.Called to set the item's data.
COleServerItem:: OnSetExtentCOleServerItem::OnSetExtent Wywoływane przez platformę, aby ustawić rozmiar elementu OLE.Called by the framework to set the size of the OLE item.
COleServerItem:: OnUpdateCOleServerItem::OnUpdate Wywoływana, gdy część dokumentu, w której znajduje się element, jest zmieniana.Called when some portion of the document the item belongs in is changed.
COleServerItem:: OnUpdateItemsCOleServerItem::OnUpdateItems Wywołuje się, by zaktualizować pamięć podręczną prezentacji dla wszystkich elementów w dokumencie serwera.Called to update the presentation cache of all items in the server document.
COleServerItem:: setitemnameCOleServerItem::SetItemName Ustawia nazwę elementu.Sets the name of the item. Używany tylko do elementów połączonych.Used for linked items only.

Metody chronioneProtected Methods

NazwaName OpisDescription
COleServerItem:: GetDataSourceCOleServerItem::GetDataSource Pobiera obiekt używany do przechowywania formatów konwersji.Gets the object used to store conversion formats.
COleServerItem:: OnHideCOleServerItem::OnHide Wywoływane przez platformę, by ukryć element OLE.Called by the framework to hide the OLE item.
COleServerItem:: OnOpenCOleServerItem::OnOpen Wywoływane przez platformę, by wyświetlić element OLE w osobnym oknie najwyższego poziomu.Called by the framework to display the OLE item in its own top-level window.
COleServerItem:: OnShowCOleServerItem::OnShow Wywoływana, gdy kontener żąda pokazywania elementu.Called when the container requests to show the item.

Publiczne elementy członkowskie danychPublic Data Members

NazwaName OpisDescription
COleServerItem:: m_sizeExtentCOleServerItem::m_sizeExtent Informuje serwer o tym, ile elementów OLE jest widocznych.Informs the server about how much of the OLE item is visible.

UwagiRemarks

Połączony element może reprezentować niektóre lub wszystkie dokumenty serwera.A linked item can represent some or all of a server document. Element osadzony zawsze reprezentuje cały dokument serwera.An embedded item always represents an entire server document.

COleServerItemKlasa definiuje kilka funkcji składowych, które są wywoływane przez dynamicznie dołączane biblioteki (dll) systemu OLE, zazwyczaj w odpowiedzi na żądania z aplikacji kontenera.The COleServerItem class defines several overridable member functions that are called by the OLE system dynamic-link libraries (DLLs), usually in response to requests from the container application. Te funkcje Członkowskie umożliwiają aplikacji kontenera przetwarzać element pośrednio na różne sposoby, takie jak wyświetlanie, wykonywanie zleceń lub pobieranie danych w różnych formatach.These member functions allow the container application to manipulate the item indirectly in various ways, such as by displaying it, executing its verbs, or retrieving its data in various formats.

Aby użyć COleServerItem , należy utworzyć z niej klasę i zaimplementować OnDraw i serializować funkcje składowe.To use COleServerItem, derive a class from it and implement the OnDraw and Serialize member functions. OnDrawFunkcja zapewnia reprezentację elementu w postaci metapliku, umożliwiając jego wyświetlenie, gdy aplikacja kontenera otwiera dokument złożony.The OnDraw function provides the metafile representation of an item, allowing it to be displayed when a container application opens a compound document. SerializeFunkcja programu CObject zapewnia natywną reprezentację elementu, umożliwiając przeniesienie osadzonego elementu między aplikacjami serwera i kontenera.The Serialize function of CObject provides the native representation of an item, allowing an embedded item to be transferred between the server and container applications. OnGetExtent zapewnia naturalny rozmiar elementu do kontenera, co umożliwia kontenerowi rozmiar elementu.OnGetExtent provides the natural size of the item to the container, enabling the container to size the item.

Aby uzyskać więcej informacji o serwerach i powiązanych tematach, zobacz artykuł serwery: implementowanie serwera i "Tworzenie aplikacji kontenera/serwera" w kontenerze artykułu: funkcje zaawansowane.For more information about servers and related topics, see the article Servers: Implementing a Server and "Creating a Container/Server Application" in the article Containers: Advanced Features.

Hierarchia dziedziczeniaInheritance Hierarchy

CObjectCObject

CCmdTargetCCmdTarget

CDocItemCDocItem

COleServerItem

WymaganiaRequirements

Nagłówek: Afxole. hHeader: afxole.h

COleServerItem:: AddOtherClipboardDataCOleServerItem::AddOtherClipboardData

Wywołaj tę funkcję, aby umieścić prezentację i formaty konwersji dla elementu OLE w określonym COleDataSource obiekcie.Call this function to place the presentation and conversion formats for the OLE item in the specified COleDataSource object.

void AddOtherClipboardData(COleDataSource* pDataSource);

ParametryParameters

pDataSourcepDataSource
Wskaźnik do COleDataSource obiektu, w którym należy umieścić dane.Pointer to the COleDataSource object in which the data should be placed.

UwagiRemarks

Funkcja członkowska OnDraw musi być zaimplementowana w celu udostępnienia formatu prezentacji (obrazu metapliku) dla elementu.You must have implemented the OnDraw member function to provide the presentation format (a metafile picture) for the item. Aby obsługiwać inne formaty konwersji, należy zarejestrować je przy użyciu obiektu by uzyskać COleDataSource zwróconego przez GetDataSource i zastąpić funkcję członkowską OnRenderData w celu zapewnienia danych w formatach, które mają być obsługiwane.To support other conversion formats, register them using the COleDataSource object returned by GetDataSource and override the OnRenderData member function to provide data in the formats you want to support.

COleServerItem:: COleServerItemCOleServerItem::COleServerItem

Konstruuje COleServerItem obiekt i dodaje go do kolekcji dokumentów dokumentu na serwerze.Constructs a COleServerItem object and adds it to the server document's collection of document items.

COleServerItem(
    COleServerDoc* pServerDoc,
    BOOL bAutoDelete);

ParametryParameters

pServerDocpServerDoc
Wskaźnik do dokumentu, który będzie zawierać nowy element.Pointer to the document that will contain the new item.

bAutoDeletebAutoDelete
Flaga oznaczająca, czy obiekt może zostać usunięty po wydaniu linku do niego.Flag indicating whether the object can be deleted when a link to it is released. Ustaw tę wartość na FALSE, jeśli COleServerItem obiekt jest integralną częścią danych dokumentu, które należy usunąć.Set this to FALSE if the COleServerItem object is an integral part of your document's data which you must delete. Ustaw tę wartość na TRUE, jeśli obiekt jest strukturą pomocniczą służącą do identyfikowania zakresu w danych dokumentu, który może zostać usunięty przez platformę.Set this to TRUE if the object is a secondary structure used to identify a range in your document's data that can be deleted by the framework.

COleServerItem:: CopyToClipboardCOleServerItem::CopyToClipboard

Wywołaj tę funkcję, aby skopiować element OLE do Schowka.Call this function to copy the OLE item to the Clipboard.

void CopyToClipboard(BOOL bIncludeLink = FALSE);

ParametryParameters

bIncludeLinkbIncludeLink
Ustaw tę wartość na TRUE, jeśli dane łącza mają zostać skopiowane do Schowka.Set this to TRUE if link data should be copied to the Clipboard. Ustaw tę wartość na FALSE, jeśli aplikacja serwera nie obsługuje linków.Set this to FALSE if your server application does not support links.

UwagiRemarks

Funkcja używa funkcji składowej OnGetClipboardData do tworzenia obiektu by uzyskać COleDataSource zawierającego dane elementu OLE w obsługiwanych formatach.The function uses the OnGetClipboardData member function to create a COleDataSource object containing the OLE item's data in the formats supported. Funkcja umieszcza COleDataSource obiekt w schowku przy użyciu funkcji by uzyskać COleDataSource:: setClipboard .The function then places the COleDataSource object on the Clipboard by using the COleDataSource::SetClipboard function. COleDataSourceObiekt zawiera dane natywne elementu i jego reprezentację w formacie CF_METAFILEPICT, a także dane w dowolnym formacie konwersji, który ma być obsługiwany.The COleDataSource object includes the item's native data and its representation in CF_METAFILEPICT format, as well as data in any conversion formats you choose to support. Aby ta funkcja członkowska działała, musisz mieć zaimplementowane funkcje serializacji i OnDraw .You must have implemented Serialize and OnDraw for this member function to work.

COleServerItem::D oDragDropCOleServerItem::DoDragDrop

Wywołaj DoDragDrop funkcję elementu członkowskiego, aby wykonać operację przeciągania i upuszczania.Call the DoDragDrop member function to perform a drag-and-drop operation.

DROPEFFECT DoDragDrop(
    LPCRECT lpRectItem,
    CPoint ptOffset,
    BOOL bIncludeLink = FALSE,
    DWORD dwEffects = DROPEFFECT_COPY | DROPEFFECT_MOVE,
    LPCRECT lpRectStartDrag = NULL);

ParametryParameters

lpRectItemlpRectItem
Prostokąt elementu na ekranie (w pikselach) względem obszaru klienckiego.The item's rectangle on screen, in pixels, relative to the client area.

ptOffsetptOffset
Przesunięcie od lpItemRect , w którym położenie myszy było w czasie przeciągania.The offset from lpItemRect where the mouse position was at the time of the drag.

bIncludeLinkbIncludeLink
Ustaw tę wartość na TRUE, jeśli dane łącza mają zostać skopiowane do Schowka.Set this to TRUE if link data should be copied to the Clipboard. Ustaw wartość FALSE, jeśli aplikacja nie obsługuje linków.Set it to FALSE if your application does not support links.

dwEffectsdwEffects
Określa wpływ, przez który Źródło przeciągane będzie dozwolone w operacji przeciągania (kombinacji kopiowania, przenoszenia i łączenia).Determines the effects that the drag source will allow in the drag operation (a combination of Copy, Move, and Link).

lpRectStartDraglpRectStartDrag
Wskaźnik do prostokąta, który definiuje, gdzie w rzeczywistości zostanie rozpoczęte przeciąganie.Pointer to the rectangle that defines where the drag actually starts. Aby uzyskać więcej informacji zobacz następujące sekcji uwag.For more information, see the following Remarks section.

Wartość zwracanaReturn Value

Wartość z wyliczenia DROPEFFECT.A value from the DROPEFFECT enumeration. W przypadku DROPEFFECT_MOVE należy usunąć oryginalne dane.If it is DROPEFFECT_MOVE, the original data should be removed.

UwagiRemarks

Operacja przeciągania i upuszczania nie rozpocznie się natychmiast.The drag-and-drop operation does not start immediately. Czeka, aż kursor myszy opuści prostokąt określony przez lpRectStartDrag lub dopóki nie upłynie określona liczba milisekund.It waits until the mouse cursor leaves the rectangle specified by lpRectStartDrag or until a specified number of milliseconds have passed. Jeśli lpRectStartDrag ma wartość null, używany jest prostokąt domyślny, aby przeciągać się, gdy wskaźnik myszy zostanie przesunięty o jeden piksel.If lpRectStartDrag is NULL, a default rectangle is used so that the drag starts when the mouse cursor moves one pixel.

Czas opóźnienia jest określany przez ustawienie klucza rejestru.The delay time is specified by a registry key setting. Można zmienić czas opóźnienia przez wywołanie CWinApp:: WriteProfileString lub CWinApp:: WriteProfileInt.You can change the delay time by calling CWinApp::WriteProfileString or CWinApp::WriteProfileInt. Jeśli czas opóźnienia nie zostanie określony, zostanie użyta wartość domyślna 200 milisekund.If you do not specify the delay time, a default value of 200 milliseconds is used. Czas opóźnienia przeciągania jest przechowywany w następujący sposób:Drag delay time is stored as follows:

  • Czas opóźnienia przeciągania systemu Windows NT jest przechowywany w HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\NT\CurrentVersion\IniFileMapping\win.ini \Windows\DragDelay.Windows NT Drag delay time is stored in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay.

  • Czas opóźnienia przeciągania systemu Windows 3. x jest przechowywany w pliku WIN.INI w sekcji [Windows}.Windows 3.x Drag delay time is stored in the WIN.INI file, under the [Windows} section.

  • Czas opóźnienia przeciągania systemu Windows 95/98 jest przechowywany w buforowanej wersji WIN.INI.Windows 95/98 Drag delay time is stored in a cached version of WIN.INI.

Aby uzyskać więcej informacji na temat sposobu przechowywania informacji o opóźnieniu przeciągania w rejestrze lub. Plik INI, zobacz WriteProfileString w Windows SDK.For more information about how drag delay information is stored in either the registry or the .INI file, see WriteProfileString in the Windows SDK.

COleServerItem:: GetClipboardDataCOleServerItem::GetClipboardData

Wywołaj tę funkcję, aby wypełnić określony obiekt by uzyskać COleDataSource wszystkimi danymi, które zostałyby skopiowane do Schowka w przypadku wywołania CopyToClipboard (te same dane byłyby transferowane także w przypadku wywołania DoDragDrop).Call this function to fill the specified COleDataSource object with all the data that would be copied to the Clipboard if you called CopyToClipboard (the same data would also be transferred if you called DoDragDrop).

void GetClipboardData(
    COleDataSource* pDataSource,
    BOOL bIncludeLink = FALSE,
    LPPOINT lpOffset = NULL,
    LPSIZE lpSize = NULL);

ParametryParameters

pDataSourcepDataSource
Wskaźnik do COleDataSource obiektu, który będzie otrzymywał dane elementu OLE we wszystkich obsługiwanych formatach.Pointer to the COleDataSource object that will receive the OLE item's data in all supported formats.

bIncludeLinkbIncludeLink
Ma wartość TRUE, jeśli dane łącza mają zostać skopiowane do Schowka.TRUE if link data should be copied to the Clipboard. FAŁSZ, jeśli aplikacja serwera nie obsługuje linków.FALSE if your server application does not support links.

lpOffsetlpOffset
Przesunięcie (w pikselach) kursora myszy od początku obiektu.The offset, in pixels, of the mouse cursor from the origin of the object.

lpSizelpSize
Rozmiar obiektu w pikselach.The size of the object in pixels.

UwagiRemarks

Ta funkcja wywołuje funkcję elementu członkowskiego GetEmbedSourceData , aby uzyskać dane natywne dla elementu OLE i wywołuje funkcję członkowską AddOtherClipboardData w celu pobrania formatu prezentacji i wszystkich obsługiwanych formatów konwersji.This function calls the GetEmbedSourceData member function to get the native data for the OLE item and calls the AddOtherClipboardData member function to get the presentation format and any supported conversion formats. Jeśli bIncludeLink ma wartość true, funkcja wywołuje również GetLinkSourceData w celu pobrania danych linku dla elementu.If bIncludeLink is TRUE, the function also calls GetLinkSourceData to get the link data for the item.

Zastąp tę funkcję, jeśli chcesz umieścić formaty w COleDataSource obiekcie przed lub po tych formatach dostarczonych przez CopyToClipboard .Override this function if you want to put formats in a COleDataSource object before or after those formats supplied by CopyToClipboard.

COleServerItem:: GetDataSourceCOleServerItem::GetDataSource

Wywołaj tę funkcję, aby uzyskać obiekt by uzyskać COleDataSource używany do przechowywania formatów konwersji obsługiwanych przez aplikację serwera.Call this function to get the COleDataSource object used to store the conversion formats that the server application supports.

COleDataSource* GetDataSource();

Wartość zwracanaReturn Value

Wskaźnik do COleDataSource obiektu używanego do przechowywania formatów konwersji.A pointer to the COleDataSource object used to store the conversion formats.

UwagiRemarks

Jeśli aplikacja serwera ma oferować dane w różnych formatach podczas operacji transferu danych, należy zarejestrować te formaty przy użyciu COleDataSource obiektu zwróconego przez tę funkcję.If you want your server application to offer data in a variety of formats during data transfer operations, register those formats with the COleDataSource object returned by this function. Na przykład, jeśli chcesz podać CF_TEXT reprezentację elementu OLE dla Schowka lub operacji przeciągania i upuszczania, należy zarejestrować format z COleDataSource obiektem zwracanym przez tę funkcję, a następnie zastąpić OnRenderXxxData funkcję członkowską, aby zapewnić dane.For example, if you want to supply a CF_TEXT representation of the OLE item for Clipboard or drag-and-drop operations, you would register the format with the COleDataSource object this function returns, and then override the OnRenderXxxData member function to provide the data.

COleServerItem:: GetDocumentCOleServerItem::GetDocument

Wywołaj tę funkcję, aby uzyskać wskaźnik do dokumentu zawierającego element.Call this function to get a pointer to the document that contains the item.

COleServerDoc* GetDocument() const;

Wartość zwracanaReturn Value

Wskaźnik do dokumentu zawierającego element; Wartość NULL, jeśli element nie jest częścią dokumentu.A pointer to the document that contains the item; NULL if the item is not part of a document.

UwagiRemarks

Pozwala to na dostęp do dokumentu serwera, który został przesłany jako argument do COleServerItem konstruktora.This allows access to the server document that you passed as an argument to the COleServerItem constructor.

COleServerItem:: GetEmbedSourceDataCOleServerItem::GetEmbedSourceData

Wywołaj tę funkcję, aby uzyskać CF_EMBEDSOURCE dane dla elementu OLE.Call this function to get the CF_EMBEDSOURCE data for an OLE item.

void GetEmbedSourceData(LPSTGMEDIUM lpStgMedium);

ParametryParameters

lpStgMediumlpStgMedium
Wskaźnik do struktury STGMEDIUM , która będzie odbierać CF_EMBEDSOURCE dane dla elementu OLE.Pointer to the STGMEDIUM structure that will receive the CF_EMBEDSOURCE data for the OLE item.

UwagiRemarks

Ten format zawiera dane natywne elementu.This format includes the item's native data. SerializeAby ta funkcja działała poprawnie, musi być zaimplementowana funkcja członkowska.You must have implemented the Serialize member function for this function to work properly.

Następnie można dodać wynik do źródła danych przy użyciu by uzyskać COleDataSource:: CacheData.The result can then be added to a data source by using COleDataSource::CacheData. Ta funkcja jest wywoływana automatycznie przez COleServerItem:: OnGetClipboardData.This function is called automatically by COleServerItem::OnGetClipboardData.

Aby uzyskać więcej informacji, zobacz STGMEDIUM w Windows SDK.For more information, see STGMEDIUM in the Windows SDK.

COleServerItem:: getitemnameCOleServerItem::GetItemName

Wywołaj tę funkcję, aby pobrać nazwę elementu.Call this function to get the name of the item.

const CString& GetItemName() const;

Wartość zwracanaReturn Value

Nazwa elementu .The name of the item.

UwagiRemarks

Ta funkcja jest zazwyczaj wywoływana tylko dla połączonych elementów.You typically call this function only for linked items.

COleServerItem:: GetLinkSourceDataCOleServerItem::GetLinkSourceData

Wywołaj tę funkcję, aby uzyskać CF_LINKSOURCE dane dla elementu OLE.Call this function to get the CF_LINKSOURCE data for an OLE item.

BOOL GetLinkSourceData(LPSTGMEDIUM lpStgMedium);

ParametryParameters

lpStgMediumlpStgMedium
Wskaźnik do struktury STGMEDIUM , która będzie odbierać CF_LINKSOURCE dane dla elementu OLE.Pointer to the STGMEDIUM structure that will receive the CF_LINKSOURCE data for the OLE item.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Ten format obejmuje CLSID opisujące typ elementu OLE i informacje, które są konieczne do zlokalizowania dokumentu zawierającego element OLE.This format includes the CLSID describing the type of the OLE item and the information needed to locate the document containing the OLE item.

Następnie można dodać wynik do źródła danych z by uzyskać COleDataSource:: CacheData.The result can then be added to a data source with COleDataSource::CacheData. Ta funkcja jest wywoływana automatycznie przez OnGetClipboardData.This function is called automatically by OnGetClipboardData.

Aby uzyskać więcej informacji, zobacz STGMEDIUM w Windows SDK.For more information, see STGMEDIUM in the Windows SDK.

COleServerItem:: GetObjectDescriptorDataCOleServerItem::GetObjectDescriptorData

Wywołaj tę funkcję, aby uzyskać CF_OBJECTDESCRIPTOR dane dla elementu OLE.Call this function to get the CF_OBJECTDESCRIPTOR data for an OLE item.

void GetObjectDescriptorData(
    LPPOINT lpOffset,
    LPSIZE lpSize,
    LPSTGMEDIUM lpStgMedium);

ParametryParameters

lpOffsetlpOffset
Przesunięcie kliknięcia myszą w lewym górnym rogu elementu OLE.Offset of the mouse click from the upper-left corner of the OLE item. Może mieć wartość NULL.Can be NULL.

lpSizelpSize
Rozmiar elementu OLE.Size of the OLE item. Może mieć wartość NULL.Can be NULL.

lpStgMediumlpStgMedium
Wskaźnik do struktury STGMEDIUM , która będzie odbierać CF_OBJECTDESCRIPTOR dane dla elementu OLE.Pointer to the STGMEDIUM structure that will receive the CF_OBJECTDESCRIPTOR data for the OLE item.

UwagiRemarks

Informacje są kopiowane do STGMEDIUM struktury wskazywanej przez lpStgMedium.The information is copied into the STGMEDIUM structure pointed to by lpStgMedium. Ten format zawiera informacje, które są zbędne w oknie dialogowym wklejanie specjalne.This format includes the information needed for the Paste Special dialog.

Aby uzyskać więcej informacji, zobacz STGMEDIUM w Windows SDK.For more information, see STGMEDIUM in the Windows SDK.

COleServerItem:: IsConnectedCOleServerItem::IsConnected

Wywołaj tę funkcję, aby sprawdzić, czy element OLE jest połączony.Call this function to see if the OLE item is connected.

BOOL IsConnected() const;

Wartość zwracanaReturn Value

Niezerowe, jeśli element jest połączony; w przeciwnym razie 0.Nonzero if the item is connected; otherwise 0.

UwagiRemarks

Element OLE jest traktowany jako połączony, jeśli jeden lub więcej kontenerów zawiera odwołania do elementu.An OLE item is considered connected if one or more containers have references to the item. Element jest połączony, jeśli jego liczba odwołań jest większa niż 0 lub jeśli jest elementem osadzonym.An item is connected if its reference count is greater than 0 or if it is an embedded item.

COleServerItem:: IsLinkedItemCOleServerItem::IsLinkedItem

Wywołaj tę funkcję, aby zobaczyć, czy element OLE jest elementem połączonym.Call this function to see if the OLE item is a linked item.

BOOL IsLinkedItem() const;

Wartość zwracanaReturn Value

Niezerowe, jeśli element jest elementem połączonym; w przeciwnym razie 0.Nonzero if the item is a linked item; otherwise 0.

UwagiRemarks

Element jest połączony, jeśli element jest prawidłowy i nie jest zwracany na liście elementów osadzonych dokumentu.An item is linked if the item is valid and is not returned in the document's list of embedded items. Połączony element może lub nie może być połączony z kontenerem.A linked item might or might not be connected to a container.

Często należy używać tej samej klasy dla elementów połączonych i osadzonych.It is common to use the same class for both linked and embedded items. IsLinkedItem umożliwia tworzenie elementów połączonych w sposób inny niż elementy osadzone, chociaż wiele razy jest powszechny kod.IsLinkedItem allows you to make linked items behave differently than embedded items, although many times the code is common.

COleServerItem:: m_sizeExtentCOleServerItem::m_sizeExtent

Ten element członkowski informuje serwer o tym, ile z obiektów jest widocznych w dokumencie kontenera.This member tells the server how much of the object is visible in the container document.

CSize m_sizeExtent;

UwagiRemarks

Domyślna implementacja OnSetExtent ustawia ten element członkowski.The default implementation of OnSetExtent sets this member.

COleServerItem:: NotifyChangedCOleServerItem::NotifyChanged

Wywołaj tę funkcję po zmianie połączonego elementu.Call this function after the linked item has been changed.

void NotifyChanged(DVASPECT nDrawAspect = DVASPECT_CONTENT);

ParametryParameters

nDrawAspectnDrawAspect
Wartość z wyliczenia DVASPECT, która wskazuje, który aspekt elementu OLE został zmieniony.A value from the DVASPECT enumeration that indicates which aspect of the OLE item has changed. Ten parametr może mieć jedną z następujących wartości:This parameter can have any of the following values:

  • Element DVASPECT_CONTENT jest reprezentowany w taki sposób, że może być wyświetlany jako osadzony obiekt wewnątrz jego kontenera.DVASPECT_CONTENT Item is represented in such a way that it can be displayed as an embedded object inside its container.

  • Element DVASPECT_THUMBNAIL jest renderowany w reprezentacji "miniatury", dzięki czemu będzie można go wyświetlić w narzędziu do przeglądania.DVASPECT_THUMBNAIL Item is rendered in a "thumbnail" representation so that it can be displayed in a browsing tool.

  • Element DVASPECT_ICON jest reprezentowany przez ikonę.DVASPECT_ICON Item is represented by an icon.

  • Element DVASPECT_DOCPRINT jest reprezentowany tak, jakby był wydrukowany przy użyciu polecenia Drukuj z menu plik.DVASPECT_DOCPRINT Item is represented as if it were printed using the Print command from the File menu.

UwagiRemarks

Jeśli element kontenera jest połączony z dokumentem z automatycznym łączem, element zostanie zaktualizowany w celu odzwierciedlenia zmian.If a container item is linked to the document with an automatic link, the item is updated to reflect the changes. W przypadku aplikacji kontenera pisanych przy użyciu biblioteka MFC COleClientItem:: OnChange jest wywoływana w odpowiedzi.In container applications written using the Microsoft Foundation Class Library, COleClientItem::OnChange is called in response.

COleServerItem:: OnDoVerbCOleServerItem::OnDoVerb

Wywoływane przez platformę, by wykonać określone zlecenie.Called by the framework to execute the specified verb.

virtual void OnDoVerb(LONG iVerb);

ParametryParameters

iVerbiVerb
Określa zlecenie do wykonania.Specifies the verb to execute. Może to być jeden z następujących:It can be any one of the following:

WartośćValue ZnaczenieMeaning SymbolSymbol
00 Primary — ZleceniePrimary verb OLEIVERB_PRIMARYOLEIVERB_PRIMARY
11 Zlecenie pomocniczeSecondary verb (Brak)(None)
-1- 1 Wyświetl element do edycjiDisplay item for editing OLEIVERB_SHOWOLEIVERB_SHOW
-2- 2 Edytuj element w osobnym oknieEdit item in separate window OLEIVERB_OPENOLEIVERB_OPEN
-3- 3 Ukryj elementHide item OLEIVERB_HIDEOLEIVERB_HIDE

Wartość-1 jest zwykle aliasem dla innego zlecenia.The -1 value is typically an alias for another verb. Jeśli Edycja Open nie jest obsługiwana, wartość-2 ma ten sam skutek co-1.If open editing is not supported, -2 has the same effect as -1. Aby uzyskać dodatkowe wartości, zobacz IOleObject::D overb w Windows SDK.For additional values, see IOleObject::DoVerb in the Windows SDK.

UwagiRemarks

Jeśli aplikacja kontenera została zapisywana przy użyciu biblioteka MFC, ta funkcja jest wywoływana, gdy wywoływana jest funkcja członkowska COleClientItem:: Activate dla odpowiedniego COleClientItem obiektu.If the container application was written with the Microsoft Foundation Class Library, this function is called when the COleClientItem::Activate member function of the corresponding COleClientItem object is called. Domyślna implementacja wywołuje funkcję elementu członkowskiego OnShow , jeśli określono zlecenie podstawowe lub OLEIVERB_SHOW, OnOpen , jeśli określono zlecenie pomocnicze lub OLEIVERB_OPEN, i onhide , jeśli określono OLEIVERB_HIDE.The default implementation calls the OnShow member function if the primary verb or OLEIVERB_SHOW is specified, OnOpen if the secondary verb or OLEIVERB_OPEN is specified, and OnHide if OLEIVERB_HIDE is specified. Domyślne wywołania implementacji, OnShow Jeśli iVerb nie jest jednym z czasowników wymienionych powyżej.The default implementation calls OnShow if iVerb is not one of the verbs listed above.

Przesłoń tę funkcję, jeśli zlecenie podstawowe nie wyświetla elementu.Override this function if your primary verb does not show the item. Na przykład jeśli element jest nagraniem dźwiękowym i jego podstawowe zlecenie jest odtwarzane, nie trzeba wyświetlać aplikacji serwerowej w celu odtwarzania elementu.For example, if the item is a sound recording and its primary verb is Play, you would not have to display the server application to play the item.

Aby uzyskać więcej informacji, zobacz IOleObject::D overb w Windows SDK.For more information, see IOleObject::DoVerb in the Windows SDK.

COleServerItem:: OnDrawCOleServerItem::OnDraw

Wywoływane przez platformę, aby renderować element OLE w metaplik.Called by the framework to render the OLE item into a metafile.

virtual BOOL OnDraw(
    CDC* pDC,
    CSize& rSize) = 0;

ParametryParameters

DomenypDC
Wskaźnik do obiektu przechwytywania , na którym ma zostać narysowany element.A pointer to the CDC object on which to draw the item. Kontekst wyświetlania jest automatycznie połączony z kontekstem wyświetlania atrybutów, aby można było wywoływać funkcje atrybutów, mimo że spowodowałoby to specyficzny dla urządzenia metaplik.The display context is automatically connected to the attribute display context so you can call attribute functions, although doing so would make the metafile device-specific.

Elementu rsizerSize
Rozmiar w jednostkach HIMETRIC, w którym ma zostać narysowany metaplik.Size, in HIMETRIC units, in which to draw the metafile.

Wartość zwracanaReturn Value

Niezerowe, jeśli element został pomyślnie narysowany; w przeciwnym razie 0.Nonzero if the item was successfully drawn; otherwise 0.

UwagiRemarks

Reprezentacja elementu OLE w postaci metapliku jest używana do wyświetlania elementu w aplikacji kontenera.The metafile representation of the OLE item is used to display the item in the container application. Jeśli aplikacja kontenera została zapisywana przy użyciu biblioteka MFC, metaplik jest używany przez funkcję rysowania elementu członkowskiego odpowiedniego obiektu COleClientItem .If the container application was written with the Microsoft Foundation Class Library, the metafile is used by the Draw member function of the corresponding COleClientItem object. Nie istnieje domyślna implementacja.There is no default implementation. Należy zastąpić tę funkcję, aby narysować element w określonym kontekście urządzenia.You must override this function to draw the item into the device context specified.

COleServerItem:: przesłonięcie ondrawexCOleServerItem::OnDrawEx

Wywoływane przez platformę dla całego rysunku.Called by the framework for all drawing.

virtual BOOL OnDrawEx(
    CDC* pDC,
    DVASPECT nDrawAspect,
    CSize& rSize);

ParametryParameters

DomenypDC
Wskaźnik do obiektu przechwytywania , na którym ma zostać narysowany element.A pointer to the CDC object on which to draw the item. Kontroler domeny jest automatycznie połączony z atrybutem DC, aby można było wywoływać funkcje atrybutów, mimo że spowodowałoby to specyficzny dla urządzenia metaplik.The DC is automatically connected to the attribute DC so you can call attribute functions, although doing so would make the metafile device-specific.

nDrawAspectnDrawAspect
Wartość z wyliczenia DVASPECT.A value from the DVASPECT enumeration. Ten parametr może mieć jedną z następujących wartości:This parameter can have any of the following values:

  • Element DVASPECT_CONTENT jest reprezentowany w taki sposób, że może być wyświetlany jako osadzony obiekt wewnątrz jego kontenera.DVASPECT_CONTENT Item is represented in such a way that it can be displayed as an embedded object inside its container.

  • Element DVASPECT_THUMBNAIL jest renderowany w reprezentacji "miniatury", dzięki czemu będzie można go wyświetlić w narzędziu do przeglądania.DVASPECT_THUMBNAIL Item is rendered in a "thumbnail" representation so that it can be displayed in a browsing tool.

  • Element DVASPECT_ICON jest reprezentowany przez ikonę.DVASPECT_ICON Item is represented by an icon.

  • Element DVASPECT_DOCPRINT jest reprezentowany tak, jakby był wydrukowany przy użyciu polecenia Drukuj z menu plik.DVASPECT_DOCPRINT Item is represented as if it were printed using the Print command from the File menu.

Elementu rsizerSize
Rozmiar elementu w jednostkach HIMETRIC.Size of the item in HIMETRIC units.

Wartość zwracanaReturn Value

Niezerowe, jeśli element został pomyślnie narysowany; w przeciwnym razie 0.Nonzero if the item was successfully drawn; otherwise 0.

UwagiRemarks

Domyślne wywołania implementacji, OnDraw gdy DVASPECT jest równe DVASPECT_CONTENT; w przeciwnym razie kończy się niepowodzeniem.The default implementation calls OnDraw when DVASPECT is equal to DVASPECT_CONTENT; otherwise it fails.

Zastąp tę funkcję, aby udostępnić dane prezentacji dla aspektów innych niż DVASPECT_CONTENT, takich jak DVASPECT_ICON lub DVASPECT_THUMBNAIL.Override this function to provide presentation data for aspects other than DVASPECT_CONTENT, such as DVASPECT_ICON or DVASPECT_THUMBNAIL.

COleServerItem:: OnGetClipboardDataCOleServerItem::OnGetClipboardData

Wywoływane przez platformę, aby uzyskać COleDataSource obiekt zawierający wszystkie dane, które byłyby umieszczane w schowku przez wywołanie funkcji składowej CopyToClipboard .Called by the framework to get a COleDataSource object containing all the data that would be placed on the Clipboard by a call to the CopyToClipboard member function.

virtual COleDataSource* OnGetClipboardData(
    BOOL bIncludeLink,
    LPPOINT lpOffset,
    LPSIZE lpSize);

ParametryParameters

bIncludeLinkbIncludeLink
Ustaw tę wartość na TRUE, jeśli dane łącza mają zostać skopiowane do Schowka.Set this to TRUE if link data should be copied to the Clipboard. Ustaw tę wartość na FALSE, jeśli aplikacja serwera nie obsługuje linków.Set this to FALSE if your server application does not support links.

lpOffsetlpOffset
Przesunięcie kursora myszy od początku obiektu w pikselach.The offset of the mouse cursor from the origin of the object in pixels.

lpSizelpSize
Rozmiar obiektu w pikselach.The size of the object in pixels.

Wartość zwracanaReturn Value

Wskaźnik do obiektu by uzyskać COleDataSource zawierającego dane ze schowka.A pointer to a COleDataSource object containing the Clipboard data.

UwagiRemarks

Domyślna implementacja tej funkcji wywołuje GetClipboardData.The default implementation of this function calls GetClipboardData.

COleServerItem:: OnGetExtentCOleServerItem::OnGetExtent

Wywoływane przez platformę, by pobrać rozmiar (w jednostkach HIMETRIC) elementu OLE.Called by the framework to retrieve the size, in HIMETRIC units, of the OLE item.

virtual BOOL OnGetExtent(
    DVASPECT nDrawAspect,
    CSize& rSize);

ParametryParameters

nDrawAspectnDrawAspect
Określa aspekt elementu OLE, którego granice mają zostać pobrane.Specifies the aspect of the OLE item whose bounds are to be retrieved. Ten parametr może mieć jedną z następujących wartości:This parameter can have any of the following values:

  • Element DVASPECT_CONTENT jest reprezentowany w taki sposób, że może być wyświetlany jako osadzony obiekt wewnątrz jego kontenera.DVASPECT_CONTENT Item is represented in such a way that it can be displayed as an embedded object inside its container.

  • Element DVASPECT_THUMBNAIL jest renderowany w reprezentacji "miniatury", dzięki czemu będzie można go wyświetlić w narzędziu do przeglądania.DVASPECT_THUMBNAIL Item is rendered in a "thumbnail" representation so that it can be displayed in a browsing tool.

  • Element DVASPECT_ICON jest reprezentowany przez ikonę.DVASPECT_ICON Item is represented by an icon.

  • Element DVASPECT_DOCPRINT jest reprezentowany tak, jakby był wydrukowany przy użyciu polecenia Drukuj z menu plik.DVASPECT_DOCPRINT Item is represented as if it were printed using the Print command from the File menu.

Elementu rsizerSize
Odwołanie do CSize obiektu, który będzie otrzymywał rozmiar elementu OLE.Reference to a CSize object that will receive the size of the OLE item.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Jeśli aplikacja kontenera została zapisywana przy użyciu biblioteka MFC, ta funkcja jest wywoływana, gdy wywoływana jest funkcja członkowska getzakres odpowiedniego COleClientItem obiektu.If the container application was written with the Microsoft Foundation Class Library, this function is called when the GetExtent member function of the corresponding COleClientItem object is called. Domyślna implementacja nie robi nic.The default implementation does nothing. Należy zaimplementować ją samodzielnie.You must implement it yourself. Zastąp tę funkcję, jeśli chcesz przeprowadzić przetwarzanie specjalne podczas obsługi żądania rozmiaru elementu OLE.Override this function if you want to perform special processing when handling a request for the size of the OLE item.

COleServerItem:: OnHideCOleServerItem::OnHide

Wywoływane przez platformę, by ukryć element OLE.Called by the framework to hide the OLE item.

virtual void OnHide();

UwagiRemarks

Wywołania domyślne COleServerDoc::OnShowDocument( FALSE ) .The default calls COleServerDoc::OnShowDocument( FALSE ). Funkcja powiadamia również kontener, że element OLE został ukryty.The function also notifies the container that the OLE item has been hidden. Przesłoń tę funkcję, jeśli chcesz przeprowadzić przetwarzanie specjalne podczas ukrywania elementu OLE.Override this function if you want to perform special processing when hiding an OLE item.

COleServerItem:: OnInitFromDataCOleServerItem::OnInitFromData

Wywoływane przez platformę, by zainicjować element OLE przy użyciu zawartości pDataObject.Called by the framework to initialize an OLE item using the contents of pDataObject.

virtual BOOL OnInitFromData(
    COleDataObject* pDataObject,
    BOOL bCreation);

ParametryParameters

pDataObjectpDataObject
Wskaźnik do obiektu danych OLE zawierającego dane w różnych formatach do inicjowania elementu OLE.Pointer to an OLE data object containing data in various formats for initializing the OLE item.

bCreationbCreation
Ma wartość TRUE, jeśli funkcja jest wywoływana w celu zainicjowania elementu OLE, który jest nowo utworzony przez aplikację kontenera.TRUE if the function is called to initialize an OLE item being newly created by a container application. FAŁSZ, jeśli funkcja jest wywoływana, aby zastąpić zawartość już istniejącego elementu OLE.FALSE if the function is called to replace the contents of an already existing OLE item.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Jeśli bCreation ma wartość true, ta funkcja jest wywoływana, jeśli kontener implementuje nowy obiekt w oparciu o bieżące zaznaczenie.If bCreation is TRUE, this function is called if a container implements Insert New Object based on the current selection. Wybrane dane są używane podczas tworzenia nowego elementu OLE.The data selected is used when creating the new OLE item. Na przykład podczas wybierania zakresu komórek w programie arkusza kalkulacyjnego, a następnie przy użyciu Wstaw nowy obiekt do tworzenia wykresu na podstawie wartości z wybranego zakresu.For example, when selecting a range of cells in a spreadsheet program and then using the Insert New Object to create a chart based on the values in the selected range. Domyślna implementacja nie robi nic.The default implementation does nothing. Przesłoń tę funkcję, aby wybrać akceptowalny format od tych oferowanych przez pDataObject i ZAINICJOWAĆ element OLE na podstawie dostarczonych danych.Override this function to choose an acceptable format from those offered by pDataObject and initialize the OLE item based on the data provided. Jest to zaawansowany możliwy do zaawansowania.This is an advanced overridable.

Aby uzyskać więcej informacji, zobacz IOleObject:: InitFromData w Windows SDK.For more information, see IOleObject::InitFromData in the Windows SDK.

COleServerItem:: OnOpenCOleServerItem::OnOpen

Wywoływane przez platformę, by wyświetlić element OLE w osobnym wystąpieniu aplikacji serwera, a nie na miejscu.Called by the framework to display the OLE item in a separate instance of the server application, rather than in place.

virtual void OnOpen();

UwagiRemarks

Domyślna implementacja uaktywnia pierwsze okno ramki zawierające dokument zawierający element OLE; Jeśli aplikacja jest serwerem mini, domyślna implementacja pokazuje okno główne.The default implementation activates the first frame window displaying the document that contains the OLE item; if the application is a mini-server, the default implementation shows the main window. Funkcja powiadamia również kontener, że element OLE został otwarty.The function also notifies the container that the OLE item has been opened.

Przesłoń tę funkcję, jeśli chcesz przeprowadzić przetwarzanie specjalne podczas otwierania elementu OLE.Override this function if you want to perform special processing when opening an OLE item. Jest to szczególnie typowe w przypadku elementów połączonych, w których wybór ma zostać ustawiony na link, gdy zostanie on otwarty.This is especially common with linked items where you want to set the selection to the link when it is opened.

Aby uzyskać więcej informacji, zobacz IOleClientSite:: OnShowWindow w Windows SDK.For more information, see IOleClientSite::OnShowWindow in the Windows SDK.

COleServerItem:: OnQueryUpdateItemsCOleServerItem::OnQueryUpdateItems

Wywoływane przez platformę, aby określić, czy dowolne połączone elementy w bieżącym dokumencie serwera są nieaktualne.Called by the framework to determine whether any linked items in the current server document are out of date.

virtual BOOL OnQueryUpdateItems();

Wartość zwracanaReturn Value

Niezerowe, jeśli dokument zawiera elementy wymagające aktualizacji; 0, jeśli wszystkie elementy są aktualne.Nonzero if the document has items needing updates; 0 if all items are up to date.

UwagiRemarks

Element jest nieaktualny, jeśli jego dokument źródłowy został zmieniony, ale połączony element nie został zaktualizowany w celu odzwierciedlenia zmian w dokumencie.An item is out of date if its source document has been changed but the linked item has not been updated to reflect the changes in the document.

COleServerItem:: OnRenderDataCOleServerItem::OnRenderData

Wywoływane przez platformę, by pobrać dane w określonym formacie.Called by the framework to retrieve data in the specified format.

virtual BOOL OnRenderData(
    LPFORMATETC lpFormatEtc,
    LPSTGMEDIUM lpStgMedium);

ParametryParameters

lpFormatEtclpFormatEtc
Wskazuje strukturę FORMATETC , określając format, w którym informacje są żądane.Points to the FORMATETC structure specifying the format in which information is requested.

lpStgMediumlpStgMedium
Wskazuje strukturę STGMEDIUM , w której mają zostać zwrócone dane.Points to a STGMEDIUM structure in which the data is to be returned.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Określony format jest jednym wcześniej umieszczonym w COleDataSource obiekcie przy użyciu funkcji składowej DelayRenderData lub DelayRenderFileData na potrzeby opóźnionego renderowania.The specified format is one previously placed in the COleDataSource object using the DelayRenderData or DelayRenderFileData member function for delayed rendering. Domyślna implementacja tej funkcji wywołuje odpowiednio OnRenderFileData lub OnRenderGlobalData, jeśli dostarczony nośnik magazynu jest plikiem lub pamięcią.The default implementation of this function calls OnRenderFileData or OnRenderGlobalData, respectively, if the supplied storage medium is either a file or memory. Jeśli żaden z tych formatów nie zostanie podany, domyślna implementacja zwróci wartość 0 i nic nie robi.If neither of these formats is supplied, the default implementation returns 0 and does nothing.

Jeśli lpStgMedium -> TYMED jest TYMED_NULL, STGMEDIUM powinno być przydzielone i wypełniane jako określone przez lpFormatEtc->TYMED.If lpStgMedium-> tymed is TYMED_NULL, the STGMEDIUM should allocated and filled as specified by lpFormatEtc->tymed. Jeśli nie TYMED_NULL, STGMEDIUM powinny być wypełnione danymi.If not TYMED_NULL, the STGMEDIUM should be filled in place with the data.

Jest to zaawansowany możliwy do zaawansowania.This is an advanced overridable. Zastąp tę funkcję, aby zapewnić dane w żądanym formacie i średnim.Override this function to provide your data in the requested format and medium. W zależności od danych warto zamiast tego zastąpić jedną z innych wersji tej funkcji.Depending on your data, you may want to override one of the other versions of this function instead. Jeśli dane są małe i stały się w rozmiarze, Przesłoń OnRenderGlobalData .If your data is small and fixed in size, override OnRenderGlobalData. Jeśli dane są w pliku lub mają zmienny rozmiar, Przesłoń OnRenderFileData .If your data is in a file, or is of variable size, override OnRenderFileData.

Aby uzyskać więcej informacji, zobacz IDataObject:: GetData, STGMEDIUM, FORMATETCi TYMED w Windows SDK.For more information, see IDataObject::GetData, STGMEDIUM, FORMATETC, and TYMED in the Windows SDK.

COleServerItem:: OnRenderFileDataCOleServerItem::OnRenderFileData

Wywoływane przez platformę, by pobrać dane w określonym formacie, gdy nośnik magazynu jest plikiem.Called by the framework to retrieve data in the specified format when the storage medium is a file.

virtual BOOL OnRenderFileData(
    LPFORMATETC lpFormatEtc,
    CFile* pFile);

ParametryParameters

lpFormatEtclpFormatEtc
Wskazuje strukturę FORMATETC , określając format, w którym informacje są żądane.Points to the FORMATETC structure specifying the format in which information is requested.

pFilepFile
Wskazuje obiekt, CFile w którym mają być renderowane dane.Points to a CFile object in which the data is to be rendered.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Określony format jest jednym wcześniej umieszczonym w COleDataSource obiekcie przy użyciu funkcji składowej DelayRenderData do opóźnionego renderowania.The specified format is one previously placed in the COleDataSource object using the DelayRenderData member function for delayed rendering. Domyślna implementacja tej funkcji po prostu zwraca wartość FALSE.The default implementation of this function simply returns FALSE.

Jest to zaawansowany możliwy do zaawansowania.This is an advanced overridable. Zastąp tę funkcję, aby zapewnić dane w żądanym formacie i średnim.Override this function to provide your data in the requested format and medium. W zależności od danych warto zamiast tego zastąpić jedną z innych wersji tej funkcji.Depending on your data, you might want to override one of the other versions of this function instead. Jeśli chcesz obsłużyć wiele nośników magazynowania, Zastąp OnRenderData.If you want to handle multiple storage mediums, override OnRenderData. Jeśli dane są w pliku lub mają zmienny rozmiar, Przesłoń OnRenderFileData.If your data is in a file, or is of variable size, override OnRenderFileData.

Aby uzyskać więcej informacji, zobacz IDataObject:: GetData i FORMATETC w Windows SDK.For more information, see IDataObject::GetData and FORMATETC in the Windows SDK.

COleServerItem:: OnRenderGlobalDataCOleServerItem::OnRenderGlobalData

Wywoływane przez platformę, aby pobrać dane w określonym formacie, gdy określony nośnik magazynu ma pamięć globalną.Called by the framework to retrieve data in the specified format when the specified storage medium is global memory.

virtual BOOL OnRenderGlobalData(
    LPFORMATETC lpFormatEtc,
    HGLOBAL* phGlobal);

ParametryParameters

lpFormatEtclpFormatEtc
Wskazuje strukturę FORMATETC , określając format, w którym informacje są żądane.Points to the FORMATETC structure specifying the format in which information is requested.

phGlobalphGlobal
Wskazuje dojście do pamięci globalnej, w której mają zostać zwrócone dane.Points to a handle to global memory in which the data is to be returned. Jeśli żadna pamięć nie została przypisana, ten parametr może mieć wartość NULL.If no memory has been allocated, this parameter can be NULL.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Określony format jest jednym wcześniej umieszczonym w COleDataSource obiekcie przy użyciu funkcji składowej DelayRenderData do opóźnionego renderowania.The specified format is one previously placed in the COleDataSource object using the DelayRenderData member function for delayed rendering. Domyślna implementacja tej funkcji po prostu zwraca wartość FALSE.The default implementation of this function simply returns FALSE.

Jeśli phGlobal ma wartość null, należy alokować i zwrócić nową HGLOBAL w phGlobal.If phGlobal is NULL, then a new HGLOBAL should be allocated and returned in phGlobal. W przeciwnym razie HGLOBAL określona przez phGlobal powinna być wypełniony danymi.Otherwise, the HGLOBAL specified by phGlobal should be filled with the data. Ilość danych umieszczonych w HGLOBAL nie może przekraczać bieżącego rozmiaru bloku pamięci.The amount of data placed in the HGLOBAL must not exceed the current size of the memory block. Ponadto nie można zmienić przydziału bloku na większy rozmiar.Also, the block cannot be reallocated to a larger size.

Jest to zaawansowany możliwy do zaawansowania.This is an advanced overridable. Zastąp tę funkcję, aby zapewnić dane w żądanym formacie i średnim.Override this function to provide your data in the requested format and medium. W zależności od danych warto zamiast tego zastąpić jedną z innych wersji tej funkcji.Depending on your data, you may want to override one of the other versions of this function instead. Jeśli chcesz obsłużyć wiele nośników magazynowania, Zastąp OnRenderData.If you want to handle multiple storage mediums, override OnRenderData. Jeśli dane są w pliku lub mają zmienny rozmiar, Przesłoń OnRenderFileData.If your data is in a file, or is of variable size, override OnRenderFileData.

Aby uzyskać więcej informacji, zobacz IDataObject:: GetData i FORMATETC w Windows SDK.For more information, see IDataObject::GetData and FORMATETC in the Windows SDK.

COleServerItem:: OnSetColorSchemeCOleServerItem::OnSetColorScheme

Wywoływane przez platformę, by określić paletę kolorów, która będzie używana podczas edytowania elementu OLE.Called by the framework to specify a color palette to be used when editing the OLE item.

virtual BOOL OnSetColorScheme(const LOGPALETTE* lpLogPalette);

ParametryParameters

lpLogPalettelpLogPalette
Wskaźnik do struktury LOGPALETTE systemu Windows.Pointer to a Windows LOGPALETTE structure.

Wartość zwracanaReturn Value

Różne od zera, jeśli jest używana paleta kolorów; w przeciwnym razie 0.Nonzero if the color palette is used; otherwise 0.

UwagiRemarks

Jeśli aplikacja kontenera została zapisywana przy użyciu biblioteka MFC, ta funkcja jest wywoływana, gdy wywoływana jest funkcja IOleObject:: SetColorScheme odpowiedniego COleClientItem obiektu.If the container application was written using the Microsoft Foundation Class Library, this function is called when the IOleObject::SetColorScheme function of the corresponding COleClientItem object is called. Domyślna implementacja zwraca wartość FALSE.The default implementation returns FALSE. Zastąp tę funkcję, jeśli chcesz użyć zalecanej palety.Override this function if you want to use the recommended palette. Aplikacja serwera nie jest wymagana do korzystania z sugerowanej palety.The server application is not required to use the suggested palette.

Aby uzyskać więcej informacji, zobacz IOleObject:: SetColorScheme w Windows SDK.For more information, see IOleObject::SetColorScheme in the Windows SDK.

COleServerItem:: OnSetDataCOleServerItem::OnSetData

Wywoływane przez platformę, aby zastąpić dane elementu OLE określonymi danymi.Called by the framework to replace the OLE item's data with the specified data.

virtual BOOL OnSetData(
    LPFORMATETC lpFormatEtc,
    LPSTGMEDIUM lpStgMedium,
    BOOL bRelease);

ParametryParameters

lpFormatEtclpFormatEtc
Wskaźnik do struktury FORMATETC , który określa format danych.Pointer to a FORMATETC structure specifying the format of the data.

lpStgMediumlpStgMedium
Wskaźnik do struktury STGMEDIUM , w której znajdują się dane.Pointer to a STGMEDIUM structure in which the data resides.

bReleasebRelease
Wskazuje, kto ma własność nośnika magazynu po zakończeniu wywołania funkcji.Indicates who has ownership of the storage medium after completing the function call. Obiekt wywołujący decyduje, kto jest odpowiedzialny za wydanie zasobów przyznanych w imieniu nośnika magazynu.The caller decides who is responsible for releasing the resources allocated on behalf of the storage medium. Obiekt wywołujący robi to przez ustawienie bRelease.The caller does this by setting bRelease. Jeśli bRelease jest różna od zera, element serwera przejmuje własność, zwalniając nośnik po zakończeniu jego używania.If bRelease is nonzero, the server item takes ownership, freeing the medium when it has finished using it. Gdy bRelease jest równa 0, obiekt wywołujący zachowuje własność, a element serwera może korzystać z nośnika magazynu tylko w czasie trwania wywołania.When bRelease is 0, the caller retains ownership and the server item can use the storage medium only for the duration of the call.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Element serwera nie przejmuje własności danych do momentu jego pomyślnego uzyskania.The server item does not take ownership of the data until it has successfully obtained it. Oznacza to, że nie przyjmuje własności, jeśli zwróci wartość 0.That is, it does not take ownership if it returns 0. Jeśli źródło danych przejmuje własność, zwalnia nośnik magazynu przez wywołanie funkcji ReleaseStgMedium .If the data source takes ownership, it frees the storage medium by calling the ReleaseStgMedium function.

Domyślna implementacja nie robi nic.The default implementation does nothing. Zastąp tę funkcję, aby zastąpić dane elementu OLE określonymi danymi.Override this function to replace the OLE item's data with the specified data. Jest to zaawansowany możliwy do zaawansowania.This is an advanced overridable.

Aby uzyskać więcej informacji, zobacz STGMEDIUM, FORMATETCi ReleaseStgMedium w Windows SDK.For more information, see STGMEDIUM, FORMATETC, and ReleaseStgMedium in the Windows SDK.

COleServerItem:: OnSetExtentCOleServerItem::OnSetExtent

Wywoływane przez platformę w celu poinformowania elementu OLE o ile miejsca jest dostępne w dokumencie kontenera.Called by the framework to tell the OLE item how much space is available to it in the container document.

virtual BOOL OnSetExtent(
    DVASPECT nDrawAspect,
    const CSize& size);

ParametryParameters

nDrawAspectnDrawAspect
Określa aspekt elementu OLE, którego granice są określone.Specifies the aspect of the OLE item whose bounds are being specified. Ten parametr może mieć jedną z następujących wartości:This parameter can have any of the following values:

  • Element DVASPECT_CONTENT jest reprezentowany w taki sposób, że może być wyświetlany jako osadzony obiekt wewnątrz jego kontenera.DVASPECT_CONTENT Item is represented in such a way that it can be displayed as an embedded object inside its container.

  • Element DVASPECT_THUMBNAIL jest renderowany w reprezentacji "miniatury", dzięki czemu będzie można go wyświetlić w narzędziu do przeglądania.DVASPECT_THUMBNAIL Item is rendered in a "thumbnail" representation so that it can be displayed in a browsing tool.

  • Element DVASPECT_ICON jest reprezentowany przez ikonę.DVASPECT_ICON Item is represented by an icon.

  • Element DVASPECT_DOCPRINT jest reprezentowany tak, jakby był wydrukowany przy użyciu polecenia Drukuj z menu plik.DVASPECT_DOCPRINT Item is represented as if it were printed using the Print command from the File menu.

zmieniasize
Struktura CSizea określająca nowy rozmiar elementu OLE.A CSize structure specifying the new size of the OLE item.

Wartość zwracanaReturn Value

Niezerowe, jeśli pomyślne; w przeciwnym razie 0.Nonzero if successful; otherwise 0.

UwagiRemarks

Jeśli aplikacja kontenera została zapisywana przy użyciu biblioteka MFC, ta funkcja jest wywoływana, gdy wywoływana jest funkcja członkowska setzakres odpowiedniego COleClientItem obiektu.If the container application was written with the Microsoft Foundation Class Library, this function is called when the SetExtent member function of the corresponding COleClientItem object is called. Domyślna implementacja ustawia element członkowski m_sizeExtent na określony rozmiar, jeśli nDrawAspect jest DVASPECT_CONTENT; w przeciwnym razie zwraca wartość 0.The default implementation sets the m_sizeExtent member to the specified size if nDrawAspect is DVASPECT_CONTENT; otherwise it returns 0. Przesłoń tę funkcję, aby przeprowadzić przetwarzanie specjalne w przypadku zmiany rozmiaru elementu.Override this function to perform special processing when you change the size of the item.

COleServerItem:: OnShowCOleServerItem::OnShow

Wywoływane przez platformę, by nakazać aplikacji serwera wyświetlanie elementu OLE w miejscu.Called by the framework to instruct the server application to display the OLE item in place.

virtual void OnShow();

UwagiRemarks

Ta funkcja jest zazwyczaj wywoływana, gdy użytkownik aplikacji kontenera tworzy element lub wykonuje zlecenie, takie jak Edit, które wymaga wyświetlenia elementu.This function is typically called when the user of the container application creates an item or executes a verb, such as Edit, that requires the item to be shown. Domyślna implementacja aktywacji w miejscu.The default implementation attempts in-place activation. Jeśli to się nie powiedzie, funkcja wywołuje OnOpen funkcję członkowską, aby wyświetlić element OLE w osobnym oknie.If this fails, the function calls the OnOpen member function to display the OLE item in a separate window.

Zastąp tę funkcję, jeśli chcesz przeprowadzić przetwarzanie specjalne w przypadku wyświetlenia elementu OLE.Override this function if you want to perform special processing when an OLE item is shown.

COleServerItem:: OnUpdateCOleServerItem::OnUpdate

Wywoływane przez platformę, gdy element został zmodyfikowany.Called by the framework when an item has been modified.

virtual void OnUpdate(
    COleServerItem* pSender,
    LPARAM lHint,
    CObject* pHint,
    DVASPECT nDrawAspect);

ParametryParameters

pSenderpSender
Wskaźnik do elementu, który zmodyfikował dokument.Pointer to the item that modified the document. Może mieć wartość NULL.Can be NULL.

lHintlHint
Zawiera informacje na temat modyfikacji.Contains information about the modification.

pHintpHint
Wskaźnik do obiektu przechowującego informacje o modyfikacji.Pointer to an object storing information about the modification.

nDrawAspectnDrawAspect
Wartość z wyliczenia DVASPECT.A value from the DVASPECT enumeration. Ten parametr może mieć jedną z następujących wartości:This parameter can have any one of the following values:

  • Element DVASPECT_CONTENT jest reprezentowany w taki sposób, że może być wyświetlany jako osadzony obiekt wewnątrz jego kontenera.DVASPECT_CONTENT Item is represented in such a way that it can be displayed as an embedded object inside its container.

  • Element DVASPECT_THUMBNAIL jest renderowany w reprezentacji "miniatury", dzięki czemu będzie można go wyświetlić w narzędziu do przeglądania.DVASPECT_THUMBNAIL Item is rendered in a "thumbnail" representation so that it can be displayed in a browsing tool.

  • Element DVASPECT_ICON jest reprezentowany przez ikonę.DVASPECT_ICON Item is represented by an icon.

  • Element DVASPECT_DOCPRINT jest reprezentowany tak, jakby był wydrukowany przy użyciu polecenia Drukuj z menu plik.DVASPECT_DOCPRINT Item is represented as if it were printed using the Print command from the File menu.

UwagiRemarks

Domyślne wywołania implementacji NotifyChanged, niezależnie od wskazówki lub nadawcy.The default implementation calls NotifyChanged, regardless of the hint or sender.

COleServerItem:: OnUpdateItemsCOleServerItem::OnUpdateItems

Wywoływane przez platformę, by zaktualizować wszystkie elementy w dokumencie serwera.Called by the framework to update all items in the server document.

virtual void OnUpdateItems();

UwagiRemarks

Domyślne wywołania implementacji UpdateLink dla wszystkich COleClientItem obiektów w dokumencie.The default implementation calls UpdateLink for all COleClientItem objects in the document.

COleServerItem:: setitemnameCOleServerItem::SetItemName

Wywołaj tę funkcję podczas tworzenia połączonego elementu, aby ustawić jego nazwę.Call this function when you create a linked item to set its name.

void SetItemName(LPCTSTR lpszItemName);

ParametryParameters

lpszItemNamelpszItemName
Wskaźnik na nową nazwę elementu.Pointer to the new name of the item.

UwagiRemarks

Nazwa musi być unikatowa w obrębie dokumentu.The name must be unique within the document. Gdy aplikacja serwera jest wywoływana w celu edytowania elementu połączonego, aplikacja używa tej nazwy do znajdowania elementu.When a server application is called to edit a linked item, the application uses this name to find the item. Nie trzeba wywoływać tej funkcji dla elementów osadzonych.You do not need to call this function for embedded items.

Zobacz teżSee also

Przykład HIERSVR MFCMFC Sample HIERSVR
Klasa CDocItemCDocItem Class
Wykres hierarchiiHierarchy Chart
Klasa COleClientItemCOleClientItem Class
Klasa COleServerDocCOleServerDoc Class
Klasa element COleTemplateServerCOleTemplateServer Class