EngSetPointerShape 函式 (winddi.h)

EngSetPointerShape函式會設定呼叫驅動程式的指標圖形。

語法

ENGAPI ULONG EngSetPointerShape(
  [in] SURFOBJ  *pso,
  [in] SURFOBJ  *psoMask,
  [in] SURFOBJ  *psoColor,
  [in] XLATEOBJ *pxlo,
  [in] LONG     xHot,
  [in] LONG     yHot,
  [in] LONG     x,
  [in] LONG     y,
  [in] RECTL    *prcl,
  [in] FLONG    fl
);

參數

[in] pso

SURFOBJ結構的指標，描述要繪製的介面。

[in] psoMask

SURFOBJ 結構的指標，定義要套用至指標點陣圖的 AND-XOR 遮罩。 點陣圖的上半部會指定單色 AND 遮罩，下半部則指定單色 XOR 遮罩。 指標的寬度與 psoMask 所指向遮罩高度的一半相同。 指標大小沒有隱含的條件約束，但最佳指標大小為 32 x 32、48 x 48 和 64 x 64 圖元。 如果此參數為 Null，則指標為透明。

[in] psoColor

SURFOBJ 結構的指標，定義色彩指標的色彩。 此點陣圖的寬度和 psoMask 點的點陣圖高度相同，且色彩格式與 pso 點的介面相同。 如果此參數為 Null，則指標為單色。

[in] pxlo

XLATEOBJ結構的指標，定義psoColor中的色彩。

[in] xHot

指定相對於指標左上方圖元之作用點的 X 座標。 作用點所指示的圖元應該位於新的指標位置。

[in] yHot

指定指標作用點相對於其左上方圖元的 Y 座標。 作用點所指示的圖元應該位於新的指標位置。

[in] x

指定新指標位置的 x 座標。

[in] y

指定新指標位置的 Y 座標。

[in] prcl

RECTL結構的指標。 如果為非Null，驅動程式提供了一個矩形，此矩形會限定顯示上指標所影響的所有圖元。 GDI 可避免在此矩形上繪製，而不需要先將指標移出。

[in] fl

指定 GDI 應該用來處理此呼叫的一組旗標。 此參數可以是下列一或多個預先定義的值：

傳回值

EngSetPointerShape 會傳回下列其中一個值：

備註

驅動程式可以呼叫 EngSetPointerShape ，讓 GDI 管理軟體資料指標。

psoMask指向的單色點陣圖有兩個部分。 第一個部分會定義指標的 AND 遮罩，而第二個部分則定義 XOR 遮罩。 結合在一起，這些遮罩會為指標影像的每個圖元提供兩個位資訊。 下列事實資料表會決定 AND 和 XOR 遮罩中不同值的顯示器上所繪製的 GDI：

這項機制提供黑白影像，同時允許透明度和反轉組成指標的圖元。

規格需求

另請參閱

DrvSetPointerShape

EngMovePointer

SURFOBJ

XLATEOBJ