IDirectManipulationViewport::GetTag-Methode (directmanipulation.h)

Ruft den Tagwert eines Viewports ab.

Syntax

HRESULT GetTag(
  [in]            REFIID riid,
  [out, optional] void   **object,
  [out, optional] UINT32 *id
);

Parameter

[in] riid

IID für die Schnittstelle.

[out, optional] object

Der Objektteil des Tags.

[out, optional] id

Der Bezeichnerteil des Tags.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein Tag ist eine Kopplung einer ganzzahligen ID mit einem COM-Objekt (Component Object Model). Sie kann von einer App verwendet werden, um den Viewport zu identifizieren.

Die out-Parameter sind optional, sodass die Methode eine ID, das Viewport-Objekt oder beides zurückgeben kann.

Beispiele

Im folgenden Beispiel wird die Verwendung dieser Methode veranschaulicht.

IUnknown* pUnk;
UINT32 id;

HRESULT hr = pRegion->GetTag(IID_PPV_ARGS(&pUnk), &id); 

Anforderungen

Weitere Informationen

IDirectManipulationViewport