XPS OM に画像を配置する
XPS OM に画像を配置する方法について説明します。
XPS OM に画像を配置するには、画像の場所とアウトラインを定義するパス オブジェクトを作成し、画像ブラシを使用してパスを塗りつぶします。 作成したパス オブジェクトをページまたはキャンバスのビジュアル オブジェクトの一覧に追加して、他のビジュアル コンテンツでレンダリングできるようにします。
これらのコード例をプログラムで使用する前に、「一般的な XPS ドキュメント プログラミング タスク」の免責事項をお読みください。
コード例
画像リソースを作成する
XPS OM でソース画像を画像リソースとして使用できない場合は、まず画像リソースを作成します:
HRESULT hr = S_OK;
IStreamPtr imageStream; // the resulting image stream
IOpcPartUri *imagePartUri;
IXpsOMImageResource *imageResource;
XPS_RECT rect = {0.0f, 0.0f, 0.0f, 0.0f}; // set to image size
hr = xpsFactory->CreateReadOnlyStreamOnFile (
imageFileName, &imageStream );
hr = xpsFactory->CreatePartUri( imagePartName, &imagePartUri );
imageType; // set to type of image being read in
hr = xpsFactory->CreateImageResource (
imageStream,
imageType,
imagePartUri,
&imageResource);
imagePartUri->Release();
imageStream->Release();
// imageResource can now be used by other parts in the XPS OM.
画像をビジュアル コレクションに配置する
ソース画像が XPS OM で画像リソースとして使用できる場合は、画像ブラシ オブジェクトを作成し、ページ内の画像の場所とサイズを記述するパスに塗りつぶしブラシとして追加できます。
// These variables are initialized outside of this code example,
// for example, as the parameters of a method or from some
// preceding program code.
// dimensions of the image in pixels
XPS_SIZE bmpDim = {0,0} ;
// DPI resolution values obtained from image
FLOAT dpiX = 96.0f;
FLOAT dpiY = 96.0f;
// initialize viewport values
XPS_RECT viewPort = {0.0,0.0,0.0,0.0};
// initialize viewbox values
XPS_RECT viewBox = {0.0,0.0,0.0,0.0};
// These are part of this code example.
IXpsOMPath *imageRectPath;
IXpsOMImageBrush *imageBrush;
IXpsOMVisualCollection *pageVisuals;
// Describe image source dimensions and set viewbox to be the
// entire image DIP width of image.
// Example:
// 600 image pixels, 300 dpi -> 2 inches -> 2 * 96 = 192 DIP width
viewBox.width = FLOAT((double)bmpDim.width * 96.0 / dpiX);
viewBox.height = FLOAT((double)bmpDim.height * 96.0 / dpiY);
// Describe the size and position of the image destination.
// rect is an XPS_RECT structure that is initialized outside
// of this sample for example, it might be passed in as a parameter.
// destination rectangle
viewPort.x = rect.x;
viewPort.y = rect.y;
viewPort.width = rect.width;
viewPort.height = rect.height;
// Create the image brush.
hr = xpsFactory->CreateImageBrush(imageResource, &viewBox, &viewPort,
reinterpret_cast<IXpsOMImageBrush**>(&imageBrush));
// Create the path that describes the outline of the image on the page.
// This step uses the function described in the next code example.
hr = CreateRectanglePath(xpsFactory, &rect,
reinterpret_cast<IXpsOMPath**>(&imageRectPath));
// Set the accessibility description for the path object as required.
hr = imageRectPath->SetAccessibilityShortDescription( shortDescText );
// Set the image brush to be the fill brush for this path.
hr = imageRectPath->SetFillBrushLocal( imageBrush );
// Get the list of visuals for this page...
hr = xpsPage->GetVisuals( &pageVisuals );
// ...and add the completed path to the list.
hr = pageVisuals->Append( imageRectPath );
// Release locally created interfaces.
if (NULL != pageVisuals) pageVisuals->Release();
if (NULL != imageRectPath) imageRectPath->Release();
if (NULL != imageBrush) imageBrush->Release();
画像のパス オブジェクトを作成する
次のメソッドは、XPS_RECT 構造体を受け取り、四角形のパスを作成します。
HRESULT
CreateRectanglePath(
__in IXpsOMObjectFactory *xpsFactory,
__in const XPS_RECT *rect,
__out IXpsOMPath **rectPath
)
{
HRESULT hr = S_OK;
IXpsOMGeometryFigure *rectFigure;
IXpsOMGeometry *imageRectGeometry;
IXpsOMGeometryFigureCollection *geomFigureCollection;
// Define start point and three of the four sides of the rectangle.
// The fourth side is implied by setting the path type to CLOSED.
XPS_POINT startPoint = {rect->x, rect->y};
XPS_SEGMENT_TYPE segmentTypes[3] = {
XPS_SEGMENT_TYPE_LINE,
XPS_SEGMENT_TYPE_LINE,
XPS_SEGMENT_TYPE_LINE
};
FLOAT segmentData[6] = {
rect->x, rect->y+rect->height,
rect->x+rect->width, rect->y+rect->height,
rect->x+rect->width, rect->y
};
BOOL segmentStrokes[3] = {
TRUE, TRUE, TRUE
};
// Create a closed geometry figure using the three
// segments defined above.
hr = xpsFactory->CreateGeometryFigure( &startPoint, &rectFigure );
hr = rectFigure->SetIsClosed( TRUE );
hr = rectFigure->SetIsFilled( TRUE );
hr = rectFigure->SetSegments( 3, 6,
segmentTypes, segmentData, segmentStrokes );
// Create a geometry that consists of the figure created above.
hr = xpsFactory->CreateGeometry( &imageRectGeometry );
hr = imageRectGeometry->GetFigures( &geomFigureCollection );
hr = geomFigureCollection->Append( rectFigure );
// Create the path that consists of the geometry created above
// and return the pointer in the parameter passed in to the function.
hr = xpsFactory->CreatePath( reinterpret_cast<IXpsOMPath**>(rectPath) );
hr = (*rectPath)->SetGeometryLocal( imageRectGeometry );
// The calling method will release these interfaces when
// it is done with them.
return hr;
}
関連トピック
-
次のステップ
-
このページで使用
-
詳細情報
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示