Effect：：GetAuxData 方法 (gdipluseffects.h)

Effect：：GetAuxData會取得一組由先前呼叫Bitmap：：ApplyEffect方法所建立之查閱表格的指標。

Syntax

VOID * GetAuxData();

傳回值

這個方法會傳回先前呼叫 Bitmap：：ApplyEffect所建立的一組查閱表格指標。 如果沒有可用的查閱表格，則傳回值為 Null。

備註

您可以藉由建立 Effect 類別的其中一個子系實例，並將該子代的位址傳遞至 Bitmap：：ApplyEffect 方法，將效果套用至點陣圖。 對於 Effect的特定子系，ApplyEffect 會建立查閱表格，並將這些資料表的位址傳回給子代物件。 例如，您可以擷取 BrightnessContrast 物件的查閱表格，如下所示：

1. 建立 BrightnessContrast 物件並呼叫其 SetParameters 方法。
2. 將TRUE傳遞至BrightnessContrast物件的Effect：：UseAuxData方法。
3. 將 BrightnessContrast 物件的位址傳遞至 Bitmap：：ApplyEffect 方法。
4. 呼叫BrightnessContrast物件的Effect：：GetAuxData方法，以取得ApplyEffect所建立查閱資料表的指標。 查閱資料表的緩衝區是由 ApplyEffect 所配置;您不負責釋放緩衝區。

ApplyEffect 可以傳回 Effect 類別下列子代的查閱表格位址。

• BrightnessContrast
• HueSaturationLightness
• 層級
• ColorBalance
• ColorCurve

範例

下列程式碼會將 BrightnessContrast 物件的位址傳遞至 Bitmap：：ApplyEffect 方法。 然後程式碼會列印 ApplyEffect 所建立的藍色通道查閱表格。

Bitmap bm(L"Picture.bmp");

BrightnessContrastParams briConParams;
briConParams.brightnessLevel = 0;
briConParams.contrastLevel = 25;

BrightnessContrast briCon;
briCon.SetParameters(&briConParams);
briCon.UseAuxData(TRUE);
	
bm.ApplyEffect(&briCon, NULL);

VOID* data = briCon.GetAuxData();

// You know the size is 1024, but check to make sure.
INT size = briCon.GetAuxDataSize();

if(1024 != size || NULL == data)
   return;

// Cast the data pointer as a ColorLUTParams pointer so that it
// will be easy to examine the individual tables.
ColorLUTParams* tables = (ColorLUTParams*)data;
   
// Print the lookup table for the blue channel.
for(UINT j = 0; j < 256; ++j)
{
   printf("%u, %u\n", j, tables->lutB[j]);
}

需求

另請參閱

ColorLUTParams

效果

Effect：：GetAuxDataSize

Effect：：UseAuxData